Skip to Content
Uptimeify Docs
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)

FieldTypeDescription
typestringpagerduty or pushover for dedicated handlers
configobjectPagerDuty config {routingKey} or Pushover config {userKey, apiToken}
webhookUrlstringOverride webhook URL for test
webhookMethodstringOverride webhook method
webhookHeadersobjectOverride webhook headers. Same block list as on PATCH: Host answers 400 webhookHostHeaderForbidden; Authorization, Cookie, X-Forwarded-* and Proxy-* answer 400 invalidRequestBody.
webhookBodyTemplatestringOverride webhook body template
webhookTimeoutnumberOverride webhook timeout
expectedStatusCodesstringOverride 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 Unauthorized when not authenticated
  • 400 (organizationIdRequired) when the organization id is missing or not a positive integer. Checked after authentication since 20.10.2026; before, it answered 400 even 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, matching GET and PATCH.

On this page