Re-check a hostname

Asks RedirHub to re-run its checks for the hostname — useful straight after a DNS change instead of waiting for the next scheduled pass.

Base URL: https://api.redirhub.com/v1
Auth: Bearer token
Idempotent: No
Returns: application/json

The request

Call POST /host/{host}/refresh with your bearer token. The host path segment identifies the record.

# Re-check a hostname
curl -X POST "https://api.redirhub.com/v1/host/go.acme.com/refresh" \
  -H "Authorization: Bearer $REDIRHUB_TOKEN"

Path parameters

Parameter	Description
hostRequiredstring

The response

A 200 returns the record as JSON.

{
  "host": "go.acme.com",
  "domain": "string",
  "correct": true,
  "connection_mode": "string",
  "status": "sync_stopped",
  "integration": "string",
  "default_require": "ip",
  "require": [
    "string"
  ],
  "current": [
    "string"
  ],
  "errors": [
    {
      "scope": "string",
      "code": "string",
      "message": "The given data was invalid.",
      "updated_at": "2026-08-01T09:14:22Z"
    }
  ],
  "counts": [
    "string"
  ],
  "https_requested": true,
  "force_https": true,
  "ssl_renews_at": "string",
  "ssl_issued_at": "string",
  "connected_via": "string",
  "connected_at": "string",
  "dns_verified_at": "string",
  "created_by": {
    "id": "9f2a7c31-4b8e-4a02-9d1f-0c6b7e5a1d44",
    "name": "Acme"
  },
  "short_links_enabled": true,
  "public": true,
  "notice": "string",
  "checked_at": "string",
  "created_at": "2026-08-01T09:14:22Z",
  "updated_at": "2026-08-01T09:14:22Z"
}

Status codes

200

SuccessThe hostname after a re-check of its DNS, or of its check path for an integration. Checks are rate limited, so the state may still be the previous one.

401

UnauthenticatedUnauthenticated

409

ConflictA request with the same Idempotency-Key is still running

429

Too many requestsToo many requests

What usually comes next

One call is rarely the whole job. These are the endpoints most integrations reach for around this one.

Before thisGET /host/{host}What usually comes nextGET /host