Status Page Reports API
Manage your status page reports and scheduled maintenances using a simple HTTP API.
Do you need help with the integration?
Let us know at [email protected]

Obtaining an API token

get
https://betteruptime.com
/api/v2/status-pages/:status_page_id/status-reports
Listing existing reports on a status page
Example cURL
1
curl --request GET \
2
--url https://betteruptime.com/api/v2/status-pages/123456/status-reports \
3
--header 'Authorization: Bearer YOUR_API_TOKEN'
Copied!
get
https://betteruptime.com
/api/v2/status-pages/:status_page_id/status-reports/:status_report_id
Getting a single status page report
Example cURL
1
curl --request GET \
2
--url https://betteruptime.com/api/v2/status-pages/123456/status-reports/12345 \
3
--header 'Authorization: Bearer YOUR_API_TOKEN'
Copied!
post
https://betteruptime.com
/api/v2/status-pages/:status_page_id/status-reports
Creating a new status page report (with an associated status update)
Example cURL
1
curl --request POST \
2
--url https://betteruptime.com/api/v2/status-pages/123456/status-reports \
3
--header 'Authorization: Bearer YOUR_API_TOKEN' \
4
--header 'Content-Type: application/json' \
5
--data '{
6
"title": "Status report title",
7
"message": "Status update message",
8
"report_type": "manual",
9
"affected_resources": [{"status_page_resource_id": "12345", "status": "downtime"}]
10
}'
Copied!
patch
https://betteruptime.com
/api/v2/status-pages/:status_page_id/status-reports/status_report_id
Updating an existing status page report
Example cURL
1
curl --request PATCH \
2
--url https://betteruptime.com/api/v2/status-pages/123456/status-reports/12345 \
3
--header 'Authorization: Bearer YOUR_API_TOKEN' \
4
--header 'Content-Type: application/json' \
5
--data '{"title": "Updated status report title"}'
Copied!
delete
https://betteruptime.com
/api/v2/status-pages/:status_page_id/status-reports/status_report_id
Deleting an existing status page report
Example cURL
1
curl --request DELETE \
2
--url https://betteruptime.com/api/v2/status-pages/123456/status-reports/12345 \
3
--header 'Authorization: Bearer YOUR_API_TOKEN'
Copied!
Last modified 8h ago