---
title: "Update Escalation Config"
method: PATCH
path: "/api/escalation-config/{id}"
tags: ["Escalation Config"]
---

# Update Escalation Config

`PATCH /api/escalation-config/{id}`

## Request

- Base URL: `https://uptimeify.io`
- URL: `https://uptimeify.io/api/escalation-config/{id}`
- Auth: HTTP bearer

PATCH /api/escalation-config/:id

## Path parameters

- `id` string, required

## Request body

- object
  - `webhookUrl` string, nullable: null switches the organization webhook channel off.
  - `webhookMethod` 'POST' | 'PUT' | 'PATCH'
  - `webhookHeaders` union
    - object
    - string
  - `webhookBodyTemplate` string: JSON template with placeholders such as {{websiteName}}.
  - `webhookTimeout` integer: Seconds.
  - `webhookRetryAttempts` integer
  - `webhookRetryDelay` integer: Seconds.
  - `expectedStatusCodes` string: Comma-separated, e.g. 200,201,202,204.
  - `isActive` boolean
  - `defaultEmail` union: Creates or updates the organization email channel; empty leaves it alone.
    - string, email
    - ''
  - `defaultPhoneNumber` string: Creates or updates the organization SMS channel; empty leaves it alone.

## Response `200`

Successful response

- object: Creates the configuration from the defaults on first write. isActive false deactivates only the organization webhook channel (no websiteId, no customerId).
  - `id` integer, required
  - `organizationId` integer, required
  - `webhookUrl` string, nullable, required
  - `webhookMethod` string, nullable, required: POST, PUT or PATCH.
  - `webhookHeaders` object, nullable, required
  - `webhookBodyTemplate` string, nullable, required
  - `webhookTimeout` integer, nullable, required
  - `webhookRetryAttempts` integer, nullable, required
  - `webhookRetryDelay` integer, nullable, required
  - `expectedStatusCodes` string, nullable, required
  - `lastTestedAt` string, date-time, nullable, required
  - `lastTestStatus` 'success' | 'failed', nullable, required
  - `lastTestError` string, nullable, required
  - `isActive` boolean, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: Invalid or missing parameters.
- `401`: Missing, invalid or expired API token.
- `404`: No such resource, or not visible to this token.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api.md) · [All operations](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/revisions/2129a771ee7e?raw)