curl "https://kodostatus.com/api/v1/status-pages/<page-id>/design/versions?limit=20" \
-H "X-API-Key: your_api_key"
{
"versions": [
{
"id": "82c7d7cd-d31b-4c2d-a9b4-b2ca56d24f90",
"status_page_id": "a04cc0eb-35ef-4d7d-a6da-ef79ecb7ff3f",
"version_number": 4,
"state": "published",
"base_version_id": "2ca20538-6293-49a4-a7ba-7d38a16e4fd8",
"template_mode": "default",
"summary": "Brand refresh",
"created_by": "api_key:abcd1234",
"created_at": "2026-02-18T02:00:00.000Z",
"published_at": "2026-02-18T02:02:00.000Z"
}
],
"next_cursor": null,
"current_version_id": "82c7d7cd-d31b-4c2d-a9b4-b2ca56d24f90",
"draft_version_id": null
}
Status Page Design
List Design Versions
List design versions in descending version order with cursor pagination
GET
/
status-pages
/
{id}
/
design
/
versions
curl "https://kodostatus.com/api/v1/status-pages/<page-id>/design/versions?limit=20" \
-H "X-API-Key: your_api_key"
{
"versions": [
{
"id": "82c7d7cd-d31b-4c2d-a9b4-b2ca56d24f90",
"status_page_id": "a04cc0eb-35ef-4d7d-a6da-ef79ecb7ff3f",
"version_number": 4,
"state": "published",
"base_version_id": "2ca20538-6293-49a4-a7ba-7d38a16e4fd8",
"template_mode": "default",
"summary": "Brand refresh",
"created_by": "api_key:abcd1234",
"created_at": "2026-02-18T02:00:00.000Z",
"published_at": "2026-02-18T02:02:00.000Z"
}
],
"next_cursor": null,
"current_version_id": "82c7d7cd-d31b-4c2d-a9b4-b2ca56d24f90",
"draft_version_id": null
}
Path Parameters
string
required
Status page ID.
Query Parameters
integer
default:"20"
Page size clamped to
1..100.integer
Return rows where
version_number < cursor.Response
array
Compact version list with fields:
id, status_page_id, version_number, state, base_version_id, template_mode, summary, created_by, created_at, published_at.Valid state values: draft, published, archived.integer | null
Cursor for the next page.
string | null
Current published pointer.
string | null
Current draft pointer.
curl "https://kodostatus.com/api/v1/status-pages/<page-id>/design/versions?limit=20" \
-H "X-API-Key: your_api_key"
{
"versions": [
{
"id": "82c7d7cd-d31b-4c2d-a9b4-b2ca56d24f90",
"status_page_id": "a04cc0eb-35ef-4d7d-a6da-ef79ecb7ff3f",
"version_number": 4,
"state": "published",
"base_version_id": "2ca20538-6293-49a4-a7ba-7d38a16e4fd8",
"template_mode": "default",
"summary": "Brand refresh",
"created_by": "api_key:abcd1234",
"created_at": "2026-02-18T02:00:00.000Z",
"published_at": "2026-02-18T02:02:00.000Z"
}
],
"next_cursor": null,
"current_version_id": "82c7d7cd-d31b-4c2d-a9b4-b2ca56d24f90",
"draft_version_id": null
}