Skip to main content
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

​
id
string
required
Status page ID.

​
Query Parameters

​
limit
integer
default:"20"
Page size clamped to 1..100.
​
cursor
integer
Return rows where version_number < cursor.

​
Response

​
versions
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.
​
next_cursor
integer | null
Cursor for the next page.
​
current_version_id
string | null
Current published pointer.
​
draft_version_id
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
}