On-Call

List On-Call escalation policies

Retrieve a paginated list of On-Call escalation policies, sorted by name.

get/api/v2/on-call/escalation-policies

Request

Query parameters

page[size]integer
Example:20

Number of escalation policies to return per page. The maximum allowed value is 50.

page[number]integer

Specific page number to return.

filter[query]string

Search query to filter escalation policies. Supports free-text search on the policy name (case-insensitive) and structured filters on team.id and tags. When set, filter[team_id], filter[user_id], and filter[schedule_id] are ignored. Can't be combined with filter[tags] or filter[tags_any].

filter[team_id]string
Example:00000000-da3a-0000-0000-000000000000

Comma-separated list of team IDs. Returns escalation policies that belong to any of these teams or have a step targeting any of them.

filter[user_id]string
Example:00000000-aba1-0000-0000-000000000000

Comma-separated list of user IDs. Returns escalation policies with a step targeting any of these users.

filter[schedule_id]string
Example:00000000-aba2-0000-0000-000000000000

Comma-separated list of schedule IDs. Returns escalation policies with a step targeting any of these schedules.

filter[tags]string
Example:env:prod

Comma-separated list of key:value tags. Returns escalation policies that have all of these tags.

filter[tags_any]string
Example:env:prod,env:staging

Comma-separated list of key:value tags. Returns escalation policies that have at least one of these tags.

includestring

Comma-separated list of included relationships to be returned. Allowed values: teams, steps, steps.targets, steps.targets.schedule, user.color. user.color populates the color attribute of users included through steps.targets.

Response

OK

Changes

Changes to this operation have not been checked yet.