Escalation
Test Escalation Config
Tests the escalation config by sending a test webhook, PagerDuty event, or Pushover notification. All body fields are optional and override DB values for testing.
POST /api/escalation-config/:id/test
Request Body (all optional)
| Field | Type | Description |
|---|---|---|
type | string | pagerduty or pushover for dedicated handlers |
config | object | PagerDuty config {routingKey} or Pushover config {userKey, apiToken} |
webhookUrl | string | Override webhook URL for test |
webhookMethod | string | Override webhook method |
webhookHeaders | object | Override webhook headers. Same block list as on PATCH: Host answers 400 webhookHostHeaderForbidden; Authorization, Cookie, X-Forwarded-* and Proxy-* answer 400 invalidRequestBody. |
webhookBodyTemplate | string | Override webhook body template |
webhookTimeout | number | Override webhook timeout |
expectedStatusCodes | string | Override expected status codes |
Example (cURL): Webhook test
curl -X POST "$BASE_URL/api/escalation-config/1/test" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"webhookUrl": "https://httpbin.org/post",
"webhookMethod": "POST",
"webhookTimeout": 15
}'Example (cURL): PagerDuty test
curl -X POST "$BASE_URL/api/escalation-config/1/test" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"type": "pagerduty",
"config": { "routingKey": "your-routing-key-here" }
}'Response (webhook)
{ "success": true, "statusCode": 200, "message": "Webhook delivered successfully" }Response (PagerDuty)
{ "success": true, "message": "PagerDuty event enqueued successfully" }Common errors
401 Unauthorizedwhen not authenticated400(organizationIdRequired) when the organization id is missing or not a positive integer. Checked after authentication since 20.10.2026; before, it answered400even without a session.403 Forbidden(forbidden) unless you are an organization admin, or (customerScopedTokenForbidden) when your scope is restricted to customers. The second case is new since 20.10.2026, matchingGETandPATCH.
Get Escalation Config
Returns the escalation config for an organization. The :id parameter is the organization ID. If no config is saved yet, the inactive defaults are returned (`id`, `createdAt` and `updatedAt` are `null`) and nothing is created; the first PATCH stores them.
Update Escalation Config
Updates the escalation config. The :id parameter is the organization ID. If no config exists, one is upserted.