---
title: "Update escalation"
method: PATCH
path: "/api/{cloudId}/v1/teams/{teamId}/escalations/{id}"
tags: ["Escalations"]
---

# Update escalation

`PATCH /api/{cloudId}/v1/teams/{teamId}/escalations/{id}`

Updates an escalation with given id in the request.

## Path parameters

- `teamId` string, required
- `id` string, required

## Request body

- UpdateEscalationRequest
  - `name` string — Name of the escalation.
  - `description` string — Description of the escalation.
  - `rules` EscalationRule[] — List of the escalation rules.
    - `condition` 'if-not-acked' | 'if-not-closed', required — The condition for notifying the recipient of escalation rule that is based on the alert state.
    - `notifyType` 'default' | 'next' | 'previous' | 'users' | 'admins' | 'all' | 'random', required — Recipient calculation logic for escalations. Possible values are: <br /> <b>default</b>: on call users <br /> <b>next</b>: next users in rotation <br /> <b>previous</b>: previous users on rotation <br /> <b>users</b>: users of the team <br /> <b>admins</b>: admins of the team <br /> <b>random</b>: randomly in the team <br /> <b>all</b>: all members of the team.
    - `delay` integer, required — Time delay of the escalation rule in minutes.
    - `recipient` Recipient, required — Object of schedule, team, or users which will be notified in escalation.
      - `id` string
      - `type` 'user' | 'schedule' | 'team', required
  - `enabled` boolean
  - `repeat` EscalationRepeat — Repeat preferences of the escalation including repeat interval, count, reverting acknowledge and seen states back and closing an alert automatically as soon as repeats are completed.
    - `waitInterval` integer — The duration in minutes to repeat the escalation rules after processing the last escalation rule. It is mandatory if you would like to add or remove repeat option. 0 should be given as a value to disable repeat option.
    - `count` integer — Repeat time indicating how many times the repeat action will be performed.
    - `resetRecipientStates` boolean — It is for reverting <b>acknowledge</b> and <b>seen</b> states back on each repeat turn if an alert is not closed.
    - `closeAlertAfterAll` boolean — It is to close the alert automatically if escalation repeats are completed.

## Response `200`

Returned if the request is successful.

- EscalationResponse
  - `id` string — Identifier of the escalation.
  - `name` string — Name of the escalation.
  - `description` string — Description of the escalation.
  - `rules` EscalationRuleResponse[] — List of the escalation rules.
    - `condition` 'if-not-acked' | 'if-not-closed' — The condition for notifying the recipient of escalation rule that is based on the alert state.
    - `notifyType` 'default' | 'next' | 'previous' | 'users' | 'admins' | 'all' | 'random' — Recipient calculation logic for escalations. Possible values are: <br /> <b>default</b>: on call users <br /> <b>next</b>: next users in rotation <br /> <b>previous</b>: previous users on rotation <br /> <b>users</b>: users of the team <br /> <b>admins</b>: admins of the team <br /> <b>random</b>: randomly in the team <br /> <b>all</b>: all members of the team.
    - `delay` integer — Time delay of the escalation rule in minutes.
    - `recipient` object — Object of schedule, team, or users which will be notified in escalation.
      - `id` string
      - `type` 'user' | 'schedule' | 'team'
  - `enabled` boolean
  - `repeat` EscalationRepeat — Repeat preferences of the escalation including repeat interval, count, reverting acknowledge and seen states back and closing an alert automatically as soon as repeats are completed.
    - `waitInterval` integer — The duration in minutes to repeat the escalation rules after processing the last escalation rule. It is mandatory if you would like to add or remove repeat option. 0 should be given as a value to disable repeat option.
    - `count` integer — Repeat time indicating how many times the repeat action will be performed.
    - `resetRecipientStates` boolean — It is for reverting <b>acknowledge</b> and <b>seen</b> states back on each repeat turn if an alert is not closed.
    - `closeAlertAfterAll` boolean — It is to close the alert automatically if escalation repeats are completed.

## Other responses

- `401` — Returned if the authentication credentials are incorrect.
- `403` — Returned if the request user does not have permission to update escalation.
- `422` — Returned if the payload cannot be validated.

---

[API](https://skmtc.net/atlassian/apis/jsm-operations-api.md) · [All operations](https://skmtc.net/atlassian/apis/jsm-operations-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/jsm-operations-api/versions/ed65f017bcb8/schema)