Skip to main content
API Explorer|API Explorer
Alerting & Response/On-Call
POSTOnCallSince 1.0SynchronousAuth Required

CreateEscalationPolicy

Create a new escalation policy with rules and notification targets

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Request Inputs

Body Fields

  • nameStringRequired

    Name of the escalation policy to create

    Example: Critical Alert Policy

  • descriptionStringRequired

    Description of the escalation policy

    Example: Escalation policy for P0 incidents

  • rulesListRequired

    Ordered list of escalation rules for this policy

    Example: (nested array)

    • levelInteger

      Escalation level number (starting from 1)

      Example: 1

    • targetsList

      List of user or group IDs to notify at this escalation level

      Example: item1,item2

    • timeoutString

      Duration to wait before escalating to the next level

      Example: 15m

    • notifyMethodsList

      Notification channels used at this escalation level

      Example: item1,item2

  • repeatCountIntegerRequired

    Number of times to repeat the full escalation cycle if unacknowledged

    Example: 3

Responses

200 OK

On success, this API returns the following response structure.

  • uuidString

    Unique identifier of the escalation policy

    Example: pol-11223344

  • nameString

    Human-readable name of the escalation policy

    Example: Critical Alert Policy

  • descriptionString

    Description of when this escalation policy is used

    Example: Escalation policy for P0 incidents

  • rulesList

    Ordered list of escalation rules in this policy

    Example: (nested array)

    • levelInteger

      Escalation level number (starting from 1)

      Example: 1

    • targetsList

      List of user or group IDs to notify at this escalation level

      Example: item1,item2

    • timeoutString

      Duration to wait before escalating to the next level

      Example: 15m

    • notifyMethodsList

      Notification channels used at this escalation level

      Example: item1,item2

  • repeatCountInteger

    Number of times to repeat the full escalation cycle if unacknowledged

    Example: 3

  • createDateString

    Timestamp when the escalation policy was created

    Example: 2026-01-15T08:00:00Z

  • lastOpDateString

    Timestamp of the last modification to the escalation policy

    Example: 2026-01-15T08:00:00Z

Endpoint

POST/api/v1/oncall/escalation-policies

/api/v1/oncall/escalation-policies

Operation ID

CreateEscalationPolicy

Permalink

Request Example

curl -X POST '{host}/api/v1/oncall/escalation-policies' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"name":"Critical Alert Policy","description":"Escalation policy for P0 incidents","rules":"(nested array)","repeatCount":3}'

Response Example

200
{
  "uuid": "pol-11223344",
  "name": "Critical Alert Policy",
  "description": "Escalation policy for P0 incidents",
  "rules": [
    {}
  ],
  "repeatCount": 3,
  "createDate": "example",
  "lastOpDate": "example"
}

Change History

This API has no change history records yet.

View all change history