OpsGenie

OpsGenie Escalations API

Operations for creating, retrieving, updating, and deleting escalation policies.

Documentation GitHub OpenAPI

Operations 5

POST /v2/escalations Create escalation #

GET /v2/escalations List escalations #

GET /v2/escalations/{identifier} Get escalation #

PATCH /v2/escalations/{identifier} Update escalation #

DELETE /v2/escalations/{identifier} Delete escalation #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/opsgenie-escalations-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: OpsGenie Escalation Escalations API
  description: The OpsGenie Escalation API allows developers to manage escalation policies that define how alerts are routed when initial responders do not acknowledge them. It provides endpoints for creating, updating, retrieving, and deleting escalation configurations. Escalation rules define the sequence of notifications sent to teams, users, and schedules with configurable delay intervals to ensure incidents are addressed in a timely manner.
  version: 2.0.0
  contact:
    name: Atlassian Support
    url: https://support.atlassian.com/opsgenie/
  termsOfService: https://www.atlassian.com/legal/cloud-terms-of-service
servers:
- url: https://api.opsgenie.com
  description: Production Server
- url: https://api.eu.opsgenie.com
  description: EU Production Server
security:
- genieKey: []
tags:
- name: Escalations
  description: Operations for creating, retrieving, updating, and deleting escalation policies.
paths:
  /v2/escalations:
    post:
      operationId: createEscalation
      summary: Create escalation
      description: Creates a new escalation policy with the specified rules and notification sequence.
      tags:
      - Escalations
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateEscalationRequest'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    get:
      operationId: listEscalations
      summary: List escalations
      description: Returns a list of all escalation policies in the account.
      tags:
      - Escalations
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListEscalationsResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /v2/escalations/{identifier}:
    get:
      operationId: getEscalation
      summary: Get escalation
      description: Retrieves the details of a specific escalation policy.
      tags:
      - Escalations
      parameters:
      - $ref: '#/components/parameters/EscalationIdentifier'
      - $ref: '#/components/parameters/IdentifierType'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetEscalationResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    patch:
      operationId: updateEscalation
      summary: Update escalation
      description: Updates the specified escalation policy.
      tags:
      - Escalations
      parameters:
      - $ref: '#/components/parameters/EscalationIdentifier'
      - $ref: '#/components/parameters/IdentifierType'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateEscalationRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    delete:
      operationId: deleteEscalation
      summary: Delete escalation
      description: Deletes the specified escalation policy.
      tags:
      - Escalations
      parameters:
      - $ref: '#/components/parameters/EscalationIdentifier'
      - $ref: '#/components/parameters/IdentifierType'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    Escalation:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier.
        name:
          type: string
          description: Name of the escalation.
        description:
          type: string
          description: Description.
        ownerTeam:
          type: object
          properties:
            id:
              type: string
              description: Team ID.
            name:
              type: string
              description: Team name.
          description: Owner team.
        rules:
          type: array
          items:
            $ref: '#/components/schemas/EscalationRule'
          description: Escalation rules.
        repeat:
          type: object
          properties:
            waitInterval:
              type: integer
              description: Wait interval in minutes.
            count:
              type: integer
              description: Repeat count.
            resetRecipientStates:
              type: boolean
              description: Reset recipient states.
            closeAlertAfterAll:
              type: boolean
              description: Close alert after all repeats.
          description: Repeat configuration.
    GetEscalationResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/Escalation'
        took:
          type: number
          description: Time taken in seconds.
        requestId:
          type: string
          description: Unique identifier for the request.
    SuccessResponse:
      type: object
      properties:
        result:
          type: string
          description: Result message.
        took:
          type: number
          description: Time taken in seconds.
        requestId:
          type: string
          description: Unique identifier for the request.
    CreateEscalationRequest:
      type: object
      required:
      - name
      - rules
      properties:
        name:
          type: string
          description: Name of the escalation policy.
        description:
          type: string
          description: Description of the escalation policy.
        ownerTeam:
          type: object
          description: Team that owns the escalation.
          properties:
            id:
              type: string
              description: Team ID.
            name:
              type: string
              description: Team name.
        rules:
          type: array
          description: Escalation rules defining the notification sequence.
          items:
            $ref: '#/components/schemas/EscalationRule'
        repeat:
          type: object
          description: Repeat configuration for the escalation.
          properties:
            waitInterval:
              type: integer
              description: Wait interval in minutes before repeating.
            count:
              type: integer
              description: Number of times to repeat.
            resetRecipientStates:
              type: boolean
              description: Whether to reset recipient notification states on repeat.
            closeAlertAfterAll:
              type: boolean
              description: Whether to close the alert after all repeats.
    ListEscalationsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Escalation'
          description: List of escalations.
        took:
          type: number
          description: Time taken in seconds.
        requestId:
          type: string
          description: Unique identifier for the request.
    UpdateEscalationRequest:
      type: object
      properties:
        name:
          type: string
          description: Updated name.
        description:
          type: string
          description: Updated description.
        ownerTeam:
          type: object
          description: Updated owner team.
          properties:
            id:
              type: string
              description: Team ID.
            name:
              type: string
              description: Team name.
        rules:
          type: array
          description: Updated escalation rules.
          items:
            $ref: '#/components/schemas/EscalationRule'
        repeat:
          type: object
          description: Updated repeat configuration.
          properties:
            waitInterval:
              type: integer
              description: Wait interval in minutes.
            count:
              type: integer
              description: Number of times to repeat.
            resetRecipientStates:
              type: boolean
              description: Reset states on repeat.
            closeAlertAfterAll:
              type: boolean
              description: Close alert after all repeats.
    ErrorResponse:
      type: object
      properties:
        message:
          type: string
          description: Error message.
        took:
          type: number
          description: Time taken in seconds.
        requestId:
          type: string
          description: Unique identifier for the request.
    EscalationRule:
      type: object
      required:
      - condition
      - notifyType
      - delay
      - recipient
      properties:
        condition:
          type: string
          enum:
          - if-not-acked
          - if-not-closed
          description: Condition that triggers the escalation rule.
        notifyType:
          type: string
          enum:
          - default
          - next
          - previous
          - users
          - admins
          - random
          - all
          description: Type of notification to send.
        delay:
          type: object
          description: Delay before this rule is triggered.
          properties:
            timeAmount:
              type: integer
              description: Amount of time to wait.
            timeUnit:
              type: string
              enum:
              - minutes
              - hours
              - days
              description: Unit of time for the delay.
        recipient:
          type: object
          description: Recipient of the escalation notification.
          properties:
            id:
              type: string
              description: Recipient ID.
            name:
              type: string
              description: Recipient name.
            username:
              type: string
              description: Username for user recipients.
            type:
              type: string
              enum:
              - user
              - team
              - schedule
              description: Type of recipient.
  parameters:
    IdentifierType:
      name: identifierType
      in: query
      description: Type of the identifier. Possible values are id or name.
      schema:
        type: string
        enum:
        - id
        - name
        default: id
    EscalationIdentifier:
      name: identifier
      in: path
      required: true
      description: Identifier of the escalation, which can be the ID or name.
      schema:
        type: string
  securitySchemes:
    genieKey:
      type: apiKey
      in: header
      name: Authorization
      description: API key authentication using the GenieKey scheme.
externalDocs:
  description: OpsGenie Escalation API Documentation
  url: https://docs.opsgenie.com/docs/escalation-api