Toggle email domain allowlist — StatusDashboard Docs

PATCH /app/dashboards/{id}/subscriptions/email-domain-allowlist

Enables or disables the email domain allowlist without replacing the stored domain list. Requires the Email plan capability (emailEnabled).

When enabled with an empty domain list, all public email signups are blocked until at least one domain is added.

Path parameters

Parameter	Description
`id`	The UUID of the dashboard.

Request

See API Basics for required headers.

Request body

Field	Type	Description
`enabled`	`boolean`	`true` to enforce the allowlist on public subscribe, `false` to allow any domain (subject to channel availability).

Sample request

curl -X PATCH https://api.statusdashboard.com/app/dashboards/a1b2c3d4-e5f6-7890-abcd-ef1234567890/subscriptions/email-domain-allowlist \
  -H "Authorization: Bearer bcf847abf5c6:def456" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": true }'

Sample response

Status: 200 OK

{
  "enabled": true
}

Error responses

Status	When
`400`	Invalid body
`403`	Org plan does not include email
`404`	Dashboard not found or not owned by your organization