> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omegas.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# List escalations

> The org's escalation attempts, newest first.



## OpenAPI

````yaml /schemas/operator.json get /v1/escalations
openapi: 3.1.0
info:
  title: Omegas Operator API
  version: 0.1.0
  description: >-
    The public /v1 machine surface: cloud browser devices, tasks, live-view
    sessions, escalations, usage, webhook endpoints, and the audit trail.
    Generated from the same OpenAPI document the Rust API is checked against.
servers:
  - url: https://api.omegas.dev
    description: Production
security: []
paths:
  /v1/escalations:
    get:
      tags:
        - Endpoints
      summary: List escalations
      description: The org's escalation attempts, newest first.
      operationId: list_escalations
      parameters:
        - name: space_id
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: cursor
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: limit
          in: query
          required: false
          schema:
            type:
              - integer
              - 'null'
            format: int64
      responses:
        '200':
          description: A page of escalations
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EscalationList'
        '401':
          description: invalid_api_key
        '403':
          description: insufficient_scope or product_not_entitled
        '429':
          description: rate_limited
      security:
        - bearer_operator: []
components:
  schemas:
    EscalationList:
      type: object
      required:
        - data
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Escalation'
        next_cursor:
          type:
            - string
            - 'null'
    Escalation:
      type: object
      description: >-
        One escalation attempt as read back.


        There is deliberately NO field that could carry the resume token — not
        even its digest. The token

        is generated once, delivered to the destination, and thereafter exists
        in this product only as a

        hash used to verify a callback. A test walks these keys to keep it that
        way.
      required:
        - id
        - object
        - status
        - kind
        - urgency
        - subject_kind
        - reason
        - attempt
        - expires_at
        - created_at
      properties:
        answer:
          type:
            - string
            - 'null'
          description: The human's answer, if they gave one.
        attempt:
          type: integer
          format: int32
          description: 1-based attempt number for this subject.
        cleared:
          type:
            - boolean
            - 'null'
        created_at:
          type: string
        device_id:
          type:
            - string
            - 'null'
        expires_at:
          type: string
        id:
          type: string
          description: '`esc_<uuid>`.'
        kind:
          type: string
          description: '`clear_wall` | `question`.'
        object:
          type: string
          description: Always `"escalation"`.
        reason:
          type: string
        resolved_at:
          type:
            - string
            - 'null'
        resolved_by:
          type:
            - string
            - 'null'
          description: Opaque label supplied by the destination — NOT an Omega principal.
        status:
          type: string
        subject_kind:
          type: string
          description: '`task` | `credential_request`.'
        task_id:
          type:
            - string
            - 'null'
        urgency:
          type: string
          description: >-
            `blocking-expiring` | `blocking` | `can-wait`. What we DECLARED;
            never a channel.
  securitySchemes:
    bearer_operator:
      type: http
      scheme: bearer
      bearerFormat: Opaque

````