Skip to main content
POST

Path Parameters

string
required
Status page ID.

Body Parameters

Body is optional:
  • No body: validates current draft/base state.
  • With body: validates merged candidate payload.
Body fields match PUT /status-pages/{id}/design/draft.
Send no body to validate the current draft. Sending {} is invalid because at least one field is required when a body is present.

Response

boolean
true when no blocking errors were found.
array
Blocking issues with code, path, message, severity.
array
Non-blocking issues with code, path, message, severity.

Common Errors

Plan-restricted features (e.g. template_mode: custom on Starter) return PLAN_RESTRICTED errors inside the errors array in a 200 response, not as a 403 status code.