v1
latestOpenAPI 3.0.02026-07-141,4077,1665.2 MBStatus Pages
Create degradation
Creates a new degradation.
post/api/v2/statuspages/{page_id}/degradations
Path parameters
page_idstring uuid required
Example:1234abcd-12ab-34cd-56ef-123456abcdef
The ID of the status page.
Query parameters
notify_subscribersboolean
Whether to notify page subscribers of the degradation.
includestring
Comma-separated list of resources to include. Supported values: created_by_user, last_modified_by_user, status_page.
Request body
Example request
{
"data": {
"attributes": {
"components_affected": [
{
"id": "1234abcd-12ab-34cd-56ef-123456abcdef",
"status": "degraded"
}
],
"description": "Our API is experiencing elevated latency. We are investigating the issue.",
"status": "investigating",
"title": "Elevated API Latency"
},
"type": "degradations"
}
}Response
Created
Example response
{
"data": {
"attributes": {
"components_affected": [
{
"id": "1234abcd-12ab-34cd-56ef-123456abcdef",
"status": "operational"
}
],
"source": {
"type": "incident"
},
"status": "investigating",
"updates": [
{
"components_affected": [
{
"id": "1234abcd-12ab-34cd-56ef-123456abcdef",
"status": "operational"
}
],
"status": "investigating"
}
]
},
"relationships": {
"created_by_user": {
"data": {
"type": "users"
}
},
"last_modified_by_user": {
"data": {
"type": "users"
}
},
"status_page": {
"data": {
"id": "1234abcd-12ab-34cd-56ef-123456abcdef",
"type": "status_pages"
}
}
},
"type": "degradations"
},
"included": [
{
"type": "users"
}
]
}