Get dashboard API config — StatusDashboard Docs

GET /app/dashboards/{id}/api

Returns the public status JSON API toggle for a dashboard. Also includes the dashboard's subdomain and customDomain fields needed to build the public endpoint URL. Requires the API access feature entitlement.

Path parameters

Parameter	Description
`id`	The UUID of the dashboard.

Request

See API Basics for required headers.

This endpoint takes no request body.

Sample request

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

Sample response

Status: 200 OK

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

The subdomain, customDomain, and customDomainStatus fields are included for the admin console only (to copy the public endpoint URL). They are not part of the customer-facing JSON contract at GET /api/status on the status page host — see the Status API platform guide.

Response fields

Field	Type	Description
`enabled`	boolean	Same as Update dashboard API config.
`subdomain`	string	Dashboard subdomain slug (e.g. `acme`). Included so you can build the public API URL.
`customDomain`	string \| omitted	Custom domain when configured. Omitted when unset.
`customDomainStatus`	string \| omitted	One of `awaiting_dns`, `validating`, `active`, `removing`, `failed`. Omitted when no custom domain is set. See Get dashboard domains.

Error responses

Status	When
`403`	Insufficient permissions, or the API access feature is not enabled.
`404`	Dashboard not found or does not belong to the caller's organization.