---
title: "Update Incoming Call Policy Escalation Rule"
method: PUT
path: "/incoming-call-policy-escalation-rule/{id}"
tags: ["Incoming Call Policy Escalation Rule"]
---

# Update Incoming Call Policy Escalation Rule

`PUT /incoming-call-policy-escalation-rule/{id}`

## Request

- Base URL: `https://oneuptime.com/api`
- URL: `https://oneuptime.com/api/incoming-call-policy-escalation-rule/{id}`
- Auth: API key in header `APIKey`
- TypeScript: <https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/docs/incoming-call-policy-escalation-rule/:id/put.ts> (a function with typed inputs; its response is checked against the schema)

Endpoint to update an existing Incoming Call Policy Escalation Rule

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `data` IncomingCallPolicyEscalationRuleUpdateSchema, required: Update schema for IncomingCallPolicyEscalationRule model. Update
    - `name` string: Rule name (e.g., 'Primary On-Call', 'Backup Engineer'). Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Incoming Call Policy Escalation Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Incoming Call Policy Escalation Rule]
    - `description` string: Optional description of this escalation rule. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Incoming Call Policy Escalation Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Incoming Call Policy Escalation Rule]
    - `order` number: Where this rule sits in the escalation, lowest number first. A new rule is added to the end of the list. Setting a number another one already has puts it in that place, and the ones in the way move one place along to make room. In the dashboard, drag the rows to reorder them. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Incoming Call Policy Escalation Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Incoming Call Policy Escalation Rule]
    - `escalateAfterSeconds` number: How long, in seconds, the phone rings before the call moves on to the next rule. 20 when left out; a time below 5 or above 600 rings for 5 or 600, the limits Twilio takes. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Incoming Call Policy Escalation Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Incoming Call Policy Escalation Rule]
    - `onCallDutyPolicyScheduleId` string, uuid: ID of the on-call schedule to route to (mutually exclusive with userId). Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Incoming Call Policy Escalation Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Incoming Call Policy Escalation Rule]
    - `userId` string, uuid: ID of the user to route to directly (mutually exclusive with onCallDutyPolicyScheduleId). Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Incoming Call Policy Escalation Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Incoming Call Policy Escalation Rule]

## Response `200`

Updated successfully

- object
  - `data` IncomingCallPolicyEscalationRuleReadSchema: Read schema for IncomingCallPolicyEscalationRule model. Read
    - `_id` string, uuid: ID of this object. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Incoming Call Policy Escalation Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Incoming Call Policy Escalation Rule]
    - `createdAt` object: Date and Time when the object was created. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Incoming Call Policy Escalation Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Incoming Call Policy Escalation Rule]
    - `updatedAt` object: Date and Time when the object was updated. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Incoming Call Policy Escalation Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Incoming Call Policy Escalation Rule]
    - `deletedAt` object: Date and Time when the object was deleted. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Incoming Call Policy Escalation Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Incoming Call Policy Escalation Rule]
    - `projectId` string, uuid: ID of your OneUptime Project in which this object belongs. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Incoming Call Policy Escalation Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [No access - you don't have permission for this operation]
    - `incomingCallPolicyId` string, uuid, required: ID of the parent Incoming Call Policy. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Incoming Call Policy Escalation Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [No access - you don't have permission for this operation]
    - `name` string: Rule name (e.g., 'Primary On-Call', 'Backup Engineer'). Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Incoming Call Policy Escalation Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Incoming Call Policy Escalation Rule]
    - `description` string: Optional description of this escalation rule. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Incoming Call Policy Escalation Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Incoming Call Policy Escalation Rule]
    - `order` number: Where this rule sits in the escalation, lowest number first. A new rule is added to the end of the list. Setting a number another one already has puts it in that place, and the ones in the way move one place along to make room. In the dashboard, drag the rows to reorder them. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Incoming Call Policy Escalation Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Incoming Call Policy Escalation Rule]
    - `escalateAfterSeconds` number: How long, in seconds, the phone rings before the call moves on to the next rule. 20 when left out; a time below 5 or above 600 rings for 5 or 600, the limits Twilio takes. Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Incoming Call Policy Escalation Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Incoming Call Policy Escalation Rule]
    - `onCallDutyPolicyScheduleId` string, uuid: ID of the on-call schedule to route to (mutually exclusive with userId). Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Incoming Call Policy Escalation Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Incoming Call Policy Escalation Rule]
    - `userId` string, uuid: ID of the user to route to directly (mutually exclusive with onCallDutyPolicyScheduleId). Permissions - Create: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Create Incoming Call Policy Escalation Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [Project Owner, Project Admin, Project Member, Settings Admin, Settings Member, Edit Incoming Call Policy Escalation Rule]
    - `createdByUserId` string, uuid: User ID who created this object (if this object was created by a User). Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Settings Admin, Settings Member, Settings Viewer, Read Incoming Call Policy Escalation Rule], Update: [No access - you don't have permission for this operation]

## Other responses

- `400`: Bad request. This response indicates that the request was malformed or contained invalid data.
- `401`: Unauthorized. This response indicates that the request requires user authentication.
- `402`: Payment Required. This response indicates that the request requires payment or a valid subscription.
- `403`: Forbidden. This response indicates that the server understood the request, but refuses to authorize it.
- `404`: Not found. The record does not exist, belongs to another project, or is one you may not read - the same answer for each.
- `405`: Project not found. This response indicates that the requested project does not exist or is not accessible.
- `408`: Request Timeout. This response indicates that the server timed out waiting for the request.
- `415`: Unable to reach server. This response indicates that the server is currently unreachable or down.
- `422`: Not authorized. This response indicates that the user does not have permission to access the requested resource.
- `500`: Internal Server Error. This response indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.

---

[API](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification.md) - [All operations](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/revisions/ba3307d00304?raw)