List custom domains of a status page

GET

/status-pages/{id}/domains

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

• Production

Returns the custom domains configured for the status page with verification status, CNAME target, certificate state, and the last error if any. Requires project management rights. Accepts API keys with the status-pages:read scope, subject to current role and resource grants.

Authorizations

• bearer

Parameters

Path Parameters

id

required

string

Responses

200

Request succeeded. The response body contains the result.

Media typeapplication/json

Array<object>

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.