Check a connection's DNS now, and report what public DNS answered
Resolves every record the connection is verified against in-request, against live public DNS, and returns a per-record verdict — this is the verb behind a "check now" button, as opposed to GET /connections/{id}, which only reports what the background propagation poller last saw.
It also advances the connection: a pending or propagating connection whose records are all visible is promoted to live here rather than on the poller's next pass, and a failed connection is re-entered into verification (failed → pending) with its lifecycle timeout clock re-based off the retry — without that re-basing the retry would re-fail immediately, since the connection is failed precisely because it aged past that window. A live connection is reported on but never transitioned: records_resolved: false on a live connection is a drift signal.
Idempotent and safe to call repeatedly.
Short-lived widget JWT minted server-side via POST /v1/tokens. Scoped to one application (and optionally one domain).
In: header
Path Parameters
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/connections/string:recheck"{ "id": "string", "application_id": "string", "domain": "string", "host": "string", "provider_id": "string", "setup_type": "automatic", "status": "pending", "managed": true, "created_at": "2019-08-24T14:15:22Z", "last_checked_at": "2019-08-24T14:15:22Z", "www_redirect": true, "override_spf": true, "validate_dmarc": true, "validate_caa": true, "monitor": true, "batch_id": "string", "end_user_ref": "string", "secure_root_domain": true, "redirect_to": "http://example.com", "power_root_path_access": [ "string" ], "error_code": "string", "error_message": "string", "records": [ { "type": "CNAME", "host": "string", "value": "string", "ttl": 3600, "priority": 0, "applied": true } ], "checked": [ { "type": "CNAME", "host": "string", "value": "string", "ttl": 3600, "priority": 0, "applied": true, "resolved": true } ], "records_resolved": true, "retried": true, "previous_status": "pending"}{ "code": "string", "title": "string", "details": "string"}{ "code": "string", "title": "string", "details": "string"}