Skip to content

Discard a downtime as false alarm

POST
/organizations/{org_id}/incidents/{incident_id}/discard-downtime
curl --request POST \
--url https://api.perstat.io/organizations/example/incidents/example/discard-downtime \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "delete_incident": true, "reason": "example" }'

Marks a finished downtime window as a false alarm so it is excluded from uptime percentages, day bars, and the status badge; optionally the incident entry is hidden as well. This changes SLA-effective numbers. Requires an owner or admin role and a reason of at least 5 characters; the action is audited and reversible, and returns 409 if the downtime is still open or already discarded. 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
object
delete_incident

Zugehörige Incident-Meldung ebenfalls aus der öffentlichen Historie entfernen.

boolean
reason
required

Pflicht-Begründung (Audit-Trail).

string
Examplegenerated
{
"delete_incident": true,
"reason": "example"
}

Request succeeded. The response has no body.

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

Authentication is missing or invalid.

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

No accessible resource matches the supplied identifier.

Läuft noch oder bereits verworfen