Skip to content

Change the account's notification settings. Absent fields are unchanged.

PUT
/account/notification_settings
curl --request PUT \
--url https://api.siteqwality.com/account/notification_settings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "flap_hold": true, "outage_ack_stops_repeats": true }'
Media type application/json

PUT /account/notification_settings. Absent fields are unchanged.

object
flap_hold
boolean | null
outage_ack_stops_repeats
boolean | null
Example generated
{
"flap_hold": true,
"outage_ack_stops_repeats": true
}

Notification settings saved

Media type application/json

GET and PUT /account/notification_settings.

object
flap_hold
required

Hold alerts while a monitor flaps. Monitors follow it unless they set their own.

boolean
outage_ack_stops_repeats
required

Acknowledging an outage stops its repeat alerts. When false, an acknowledgment only records who is on it.

boolean
updated_at

When the settings were last saved; null while they are the defaults.

string | null format: date-time
updated_by_user_id

Who saved them last, when a member did.

string | null format: uuid
updated_by_name

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

string | null
Example generated
{
"flap_hold": true,
"outage_ack_stops_repeats": true,
"updated_at": "2026-04-15T12:00:00Z",
"updated_by_user_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"updated_by_name": "example"
}

No fields to update, or an invalid body

Missing or invalid authentication

The caller’s role cannot change settings

Internal server error