Skip to content

Acknowledge an outage. The first acknowledgment wins; later calls return it unchanged.

POST
/monitors/{monitor_id}/outages/{transition_id}/acknowledge
curl --request POST \
--url https://api.siteqwality.com/monitors/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/outages/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/acknowledge \
--header 'Authorization: Bearer <token>'
monitor_id
required
string format: uuid

Monitor identifier (http, cron or browser)

transition_id
required
string format: uuid

The outage: the DOWN transition id from the alert history

The outage’s acknowledgment

Media type application/json

One outage’s acknowledgment. The first one wins and never changes.

object
transition_id
required

The outage: the monitor’s DOWN state transition.

string format: uuid
monitor_id
required
string format: uuid
monitor_type
required

http, cron or browser.

string
acknowledged_at
required
string format: date-time
acknowledged_by_user_id

null for an email link or an API key.

string | null format: uuid
acknowledged_by_name

The member’s name, or their email when they have no name.

string | null
source
required

console, api, mcp, email_link or incident.

string
recipient

The alert email address, for email_link.

string | null
Example generated
{
"transition_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"monitor_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"monitor_type": "example",
"acknowledged_at": "2026-04-15T12:00:00Z",
"acknowledged_by_user_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"acknowledged_by_name": "example",
"source": "example",
"recipient": "example"
}

Malformed monitor or transition id

Missing or invalid authentication

No such outage on this monitor

The outage has already ended

Internal server error