Get dashboard domains — StatusDashboard Docs

GET /app/dashboards/{id}/domains

Returns the current subdomain and custom domain configuration for a dashboard. Requires admin role.

Path parameters

Parameter	Description
`id`	The UUID of the dashboard.

See API Basics for required headers.

This endpoint takes no request body.

curl https://api.statusdashboard.com/app/dashboards/a1b2c3d4-e5f6-7890-abcd-ef1234567890/domains \
  -H "Authorization: Bearer bcf847abf5c6:def456"

Status: 200 OK

{
  "subdomain": "acme",
  "customDomain": "status.acme.com",
  "customDomainStatus": "active"
}

Field	Type	Description
`subdomain`	string	The subdomain slug (e.g. `acme` maps to `acme.yourdomain.com`).
`customDomain`	string	The custom domain, if configured. Absent when no custom domain is set.
`customDomainStatus`	string	One of `awaiting_dns`, `validating`, `active`, `removing`, `failed`. Absent when no custom domain is set.
`customDomainError`	string	Human-readable error when `customDomainStatus` is `failed`, or when verification was lost and status is `awaiting_dns`.
`customDomainCreatedAt`	string	ISO 8601 timestamp when the custom domain was first saved.
`customDomainUpdatedAt`	string	ISO 8601 timestamp of the last custom domain status change.
`cloudFrontTenantId`	string	Internal provisioning identifier. Present after activation has been requested at least once.

Status	When
`403`	Insufficient permissions.
`404`	Dashboard not found or does not belong to the caller's organization.