Verify a custom domain

POST

/status-pages/{id}/domains/{domain_id}/verify

curl --request POST \
  --url https://api.perstat.io/status-pages/example/domains/example/verify \
  --header 'Authorization: Bearer <token>'

• Production

Runs the DNS verification for a custom domain synchronously: the domain’s CNAME record is checked against its unique target, and on success the domain is marked verified and activated for serving. Returns the current domain state either way. Requires project management rights. Accepts API keys with the status-pages:write scope, subject to current role and resource grants.

Authorizations

• bearer

Parameters

Path Parameters

id

required

string

domain_id

required

string

Responses

200

Request succeeded. The response body contains the result.

Media typeapplication/json

object

cert_status

Vom Edge gemeldeter Cert-Status.

string | null

cname_target

required

CNAME-Ziel, das der Kunde setzen soll.

string

domain

required

string

edge_synced

required

true, sobald die Domain erfolgreich als VHost an die Edge gepusht wurde. Eine verifizierte Domain mit edge_synced=false ist noch in Bereitstellung (Edge-Push steht aus / wird vom Reconcile nachgezogen) und serviert noch nicht.

boolean

id

required

Public_id (spd_…).

string

last_error

string | null

status

required

pending | verified | failed.

string

verification_method

required

cname | txt.

string

verification_token

required

Wert für den TXT-Record _datargo-verify.<domain>.

string

verified_at

Unix-Sekunden der Verifikation.

integer | null format: int64

Example^generated

{
  "cert_status": "example",
  "cname_target": "example",
  "domain": "example",
  "edge_synced": true,
  "id": "example",
  "last_error": "example",
  "status": "example",
  "verification_method": "example",
  "verification_token": "example",
  "verified_at": 1
}

401

Authentication is missing or invalid.

403

The authenticated caller does not have permission to perform this operation.

404

No accessible resource matches the supplied identifier.