Skip to main content
These endpoints are available at https://kodostatus.com/api/v1 and support API key auth via X-API-Key.

​
Workflow

  1. Read current state: GET /status-pages/{id}/design
  2. Create or update draft: PUT /status-pages/{id}/design/draft
  3. Validate draft: POST /status-pages/{id}/design/draft/validate
  4. Publish draft: POST /status-pages/{id}/design/publish
  5. Audit history: GET /status-pages/{id}/design/versions

​
Endpoints

MethodEndpointDocs
GET/status-pages/{id}/designGet Design State
PUT/status-pages/{id}/design/draftUpsert Design Draft
POST/status-pages/{id}/design/draft/validateValidate Design Draft
POST/status-pages/{id}/design/publishPublish Design Draft
GET/status-pages/{id}/design/versionsList Design Versions
GET/status-pages/{id}/design/versions/{versionId}Get Design Version

​
Notes

  • Custom template mode is plan-gated (PLAN_RESTRICTED if unavailable).
  • Publish uses optimistic locking with expected_draft_version_id and executes via an atomic database transaction.
  • theme_tokens and layout use strict validation — unknown fields are rejected with a 400 error.
  • Version history uses cursor pagination by version_number.
  • Valid version states: draft, published, archived.