Skip to main content
POST
/
status-pages
/
{id}
/
design
/
publish
curl -X POST "https://kodostatus.com/api/v1/status-pages/<page-id>/design/publish" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "expected_draft_version_id": "05cc0f5e-c333-4e16-a7f7-67d8c3758f02" }'

{
  "success": true,
  "status_page_id": "a04cc0eb-35ef-4d7d-a6da-ef79ecb7ff3f",
  "current_version_id": "05cc0f5e-c333-4e16-a7f7-67d8c3758f02",
  "warnings": []
}

​
Path Parameters

​
id
string
required
Status page ID.

​
Body Parameters

​
expected_draft_version_id
string
required
Draft version UUID the client expects to publish.

​
Response

​
success
boolean
true when publish succeeds.
​
status_page_id
string
Status page ID.
​
current_version_id
string
Now-published version UUID.
​
warnings
array
Validation warnings from publish-time validation.
curl -X POST "https://kodostatus.com/api/v1/status-pages/<page-id>/design/publish" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "expected_draft_version_id": "05cc0f5e-c333-4e16-a7f7-67d8c3758f02" }'

{
  "success": true,
  "status_page_id": "a04cc0eb-35ef-4d7d-a6da-ef79ecb7ff3f",
  "current_version_id": "05cc0f5e-c333-4e16-a7f7-67d8c3758f02",
  "warnings": []
}

​
Common Errors

StatusCodeMeaning
400INVALID_SCHEMARequest body invalid or draft failed publish validation
403PLAN_RESTRICTEDCustom template publish blocked by plan. Response includes upgrade_required: true.
404DRAFT_NOT_FOUNDNo draft exists for page
409DRAFT_VERSION_MISMATCHDraft changed since client last read it. Response includes current_draft_version_id.
500-Publish failed. Possible causes: “Failed to publish design version” (RPC atomic transaction failure) or “Failed to apply published design to status page” (sync failure).