Add a level to an escalation policy.

POST

/escalation_policy/{policy_id}/level/

curl --request POST \
  --url https://api.siteqwality.com/escalation_policy/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/level/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "level_number": 1, "timeout_minutes": 1, "target_user_ids": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ], "target_schedule_ids": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ] }'

• Production

Authorizations

• bearer_auth

Parameters

Path Parameters

policy_id

required

string format: uuid

Escalation policy identifier

Request Body ^required

Media type application/json

object

level_number

integer | null format: int32

timeout_minutes

required

integer format: int32

target_user_ids

array | null

target_schedule_ids

array | null

Example ^generated

{
  "level_number": 1,
  "timeout_minutes": 1,
  "target_user_ids": [
    "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
  ],
  "target_schedule_ids": [
    "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
  ]
}

Responses

200

Level created

Media type application/json

object

id

required

string format: uuid

escalation_policy_id

required

string format: uuid

level_number

required

integer format: int32

timeout_minutes

required

integer format: int32

target_user_ids

required

Array<string>

target_schedule_ids

required

Array<string>

created_at

required

string format: date-time

Example ^generated

{
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "escalation_policy_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "level_number": 1,
  "timeout_minutes": 1,
  "target_user_ids": [
    "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
  ],
  "target_schedule_ids": [
    "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
  ],
  "created_at": "2026-04-15T12:00:00Z"
}

400

Invalid request body

401

Missing or invalid authentication

500

Internal server error