Uptimeify Docs
Escalation

Get Escalation Config

Returns the escalation config for an organization. The :id parameter is the organization ID. If no config exists, one is auto-created with defaults.

GET /api/escalation-config/:id

Also returns the organization's default notification settings and all notification channels.

Example (cURL)

curl -X GET "$BASE_URL/api/escalation-config/1" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Response

{
  "id": 1,
  "organizationId": 1,
  "webhookUrl": "https://example.com/webhook",
  "webhookMethod": "POST",
  "webhookHeaders": { "Content-Type": "application/json" },
  "webhookBodyTemplate": "{\"websiteName\":\"{{websiteName}}\",...}",
  "webhookTimeout": 30,
  "webhookRetryAttempts": 3,
  "webhookRetryDelay": 60,
  "expectedStatusCodes": "200,201,202,204",
  "isActive": false,
  "lastTestedAt": null,
  "lastTestStatus": null,
  "lastTestError": null,
  "organization": {
    "defaultEmail": "ops@example.com",
    "defaultPhoneNumber": "+1234567890",
    "defaultNotificationChannels": null,
    "defaultNotificationTargets": null,
    "defaultNotificationRules": null
  },
  "notificationChannels": []
}

Common errors

  • 401 Unauthorized when not authenticated
  • 403 Forbidden with insufficient permissions

Escalation Config

Manage organization-level webhook escalation settings and default notification channels.

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.

On this page

Example (cURL)ResponseCommon errors