Skip to content

Get a status page's layout.

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

Groups and components in page order, hidden ones 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 credentials

Media type application/problem+json

An RFC 9457 problem, the body of every /v1 error.

object
type
required

https://docs.siteqwality.com/errors/ and the failure’s code, such as not_found.

string
title
required
string
status
required
integer format: int32
detail
string | null
instance

urn:uuid: and the request id.

string | null
errors

The invalid fields, when the request body was refused.

array | null

One validation failure; pointer is an RFC 6901 pointer into the request body.

object
pointer
required
string
detail
required
string
Example generated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example",
"errors": [
{
"pointer": "example",
"detail": "example"
}
]
}

The key or member may not do this, or lacks the scope it needs

Media type application/problem+json

An RFC 9457 problem, the body of every /v1 error.

object
type
required

https://docs.siteqwality.com/errors/ and the failure’s code, such as not_found.

string
title
required
string
status
required
integer format: int32
detail
string | null
instance

urn:uuid: and the request id.

string | null
errors

The invalid fields, when the request body was refused.

array | null

One validation failure; pointer is an RFC 6901 pointer into the request body.

object
pointer
required
string
detail
required
string
Example generated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example",
"errors": [
{
"pointer": "example",
"detail": "example"
}
]
}

No such status page in this account

Media type application/problem+json

An RFC 9457 problem, the body of every /v1 error.

object
type
required

https://docs.siteqwality.com/errors/ and the failure’s code, such as not_found.

string
title
required
string
status
required
integer format: int32
detail
string | null
instance

urn:uuid: and the request id.

string | null
errors

The invalid fields, when the request body was refused.

array | null

One validation failure; pointer is an RFC 6901 pointer into the request body.

object
pointer
required
string
detail
required
string
Example generated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example",
"errors": [
{
"pointer": "example",
"detail": "example"
}
]
}

Too many requests; wait for the time in Retry-After

Media type application/problem+json

An RFC 9457 problem, the body of every /v1 error.

object
type
required

https://docs.siteqwality.com/errors/ and the failure’s code, such as not_found.

string
title
required
string
status
required
integer format: int32
detail
string | null
instance

urn:uuid: and the request id.

string | null
errors

The invalid fields, when the request body was refused.

array | null

One validation failure; pointer is an RFC 6901 pointer into the request body.

object
pointer
required
string
detail
required
string
Example generated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example",
"errors": [
{
"pointer": "example",
"detail": "example"
}
]
}