Skip to content

How the page's components are grouped and ordered.

GET
/status_page/{status_page_id}/layout
curl --request GET \
--url https://api.siteqwality.com/status_page/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/layout \
--header 'Authorization: Bearer <token>'
status_page_id
required
string format: uuid

Status page identifier

The page layout, hidden components included

Media type application/json
object
ungrouped
required

Shown first, above the groups.

Array<object>

A component on the page, as the page shows it.

object
id
required

What the layout and the component routes call it: the HTTP job, browser check or cron job id, or the manual component’s own id.

string format: uuid
monitor_id
required

The same value as id, kept for clients that predate manual components.

string format: uuid
kind
required
string
Allowed values: http_job browser_check cron_job manual
friendly_name
required
string
description

One line shown under the name, or null.

string | null
hidden
required

A hidden component stays on the page’s list but is left off the public page.

boolean
show_uptime
required

False shows the status only, with no uptime bars or percentage. Heartbeats and manual components never show uptime.

boolean
status
One of:

The status the owner set on a manual component; null for every other kind.

string
Allowed values: operational degraded down maintenance
status_override
One of:

The override in force, or null. One past its expiry reads as null.

object
status
required

What the owner says a component is doing: a manual component’s status, or an override on any component. Stored as text (status_page_components.manual_status, *.override_status).

string
Allowed values: operational degraded down maintenance
note
string | null
expires_at

When it lapses on its own, or null to keep it until cleared.

string | null format: date-time
set_at
string | null format: date-time
groups
required

In the order the page shows them.

Array<object>
object
id
required
string format: uuid
name
required
string
description
string | null
components
required

In the order the page shows them.

Array<object>

A component on the page, as the page shows it.

object
id
required

What the layout and the component routes call it: the HTTP job, browser check or cron job id, or the manual component’s own id.

string format: uuid
monitor_id
required

The same value as id, kept for clients that predate manual components.

string format: uuid
kind
required
string
Allowed values: http_job browser_check cron_job manual
friendly_name
required
string
description

One line shown under the name, or null.

string | null
hidden
required

A hidden component stays on the page’s list but is left off the public page.

boolean
show_uptime
required

False shows the status only, with no uptime bars or percentage. Heartbeats and manual components never show uptime.

boolean
status
One of:

The status the owner set on a manual component; null for every other kind.

string
Allowed values: operational degraded down maintenance
status_override
One of:

The override in force, or null. One past its expiry reads as null.

object
status
required

What the owner says a component is doing: a manual component’s status, or an override on any component. Stored as text (status_page_components.manual_status, *.override_status).

string
Allowed values: operational degraded down maintenance
note
string | null
expires_at

When it lapses on its own, or null to keep it until cleared.

string | null format: date-time
set_at
string | null format: date-time
Example
{
"ungrouped": [
{
"kind": "http_job",
"status": "operational",
"status_override": {
"status": "operational"
}
}
],
"groups": [
{
"components": [
{
"kind": "http_job",
"status": "operational",
"status_override": {
"status": "operational"
}
}
]
}
]
}

Missing or invalid authentication

Status page not found

Internal server error