Skip to content

Re-run the DNS target check for a redirect

POST
/api/organizations/{organizationId}/redirects/{id}/dns-check

Triggers an immediate, on-demand DNS verification of the redirect's source hostname: the DNS check counter is reset, a live lookup resolves the observed value, and dnsTargetStatus, dnsObservedValue, and dnsLastCheckedAt are updated. The next automatic check is rescheduled based on the resulting status. No request body is expected; returns 200 with the refreshed DNS fields.

Authorizations

ApiToken

Long-lived API token created via POST /api/api-tokens (returned once in plaintext).

Type
API Key (header: X-API-TOKEN)
or
JWT

JWT access token obtained via POST /api/auth/login. Send as: Authorization: Bearer .

Type
HTTP (bearer)

Parameters

Path Parameters

organizationId*

Organization identifier

Type
string
Required
id*

redirect identifier

Type
string
Required

Responses

redirect resource created

JSON
{
  
"@context": "string",
  
"@id": "string",
  
"@type": "string",
  
"id": 42,
  
"targetHostname": "www.example.com",
  
"mode": "path",
  
"createdAt": "2026-07-01T12:34:56+00:00",
  
"updatedAt": "2026-07-01T12:34:56+00:00",
  
"sourceHostname": "old.example.com",
  
"cnameTarget": "abc123.cname.smoxy.eu",
  
"dnsTargetStatus": "pending",
  
"dnsObservedValue": "abc123.cname.smoxy.eu",
  
"dnsLastCheckedAt": "2026-07-01T12:34:56+00:00"
}

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI