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
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
  • 403 Forbidden with insufficient permissions

On this page