Skip to content

Link an incident to status pages

POST
/organizations/{org_id}/incidents/{incident_id}/pages
curl --request POST \
--url https://api.perstat.io/organizations/example/incidents/example/pages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "status_page_ids": [ "example" ] }'

Links the incident to one or more of the organization’s status pages so it appears there. Linking is additive and idempotent; use the unlink operation to remove a link. Page ids that do not belong to the organization return 400. Requires the incident command plan capability, otherwise 402. Accepts API keys with the incidents:write scope, subject to current role and resource grants.

org_id
required
string
incident_id
required
string
Media typeapplication/json

Incident explizit auf gewählte Status-Seiten publizieren (Public-IDs).

object
status_page_ids
required
Array<string>
Examplegenerated
{
"status_page_ids": [
"example"
]
}

Request succeeded. The response body contains the result.

The request is invalid. Check the supplied fields and values.

Authentication is missing or invalid.

The request exceeds an entitlement or limit of the current plan.

The authenticated caller does not have permission to perform this operation.

No accessible resource matches the supplied identifier.