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

# Get one pause record

> Fetch one pause record with its full audit trail: scope and target, `cause`, `reason`, who opened it and when, any scheduled resume and its extensions, and — once released — who released it and when. Readable by any organization member. Cross-tenant access returns 404, never 403.



## OpenAPI

````yaml /openapi.json get /admin/dispatch/pauses/{pause_id}
openapi: 3.1.0
info:
  title: GetDialed Flows API
  version: 0.1.0
servers:
  - url: https://api.getdialed.ai/flows
    description: Production
security: []
paths:
  /admin/dispatch/pauses/{pause_id}:
    get:
      tags:
        - dispatch
      summary: Get one pause record
      description: >-
        Fetch one pause record with its full audit trail: scope and target,
        `cause`, `reason`, who opened it and when, any scheduled resume and its
        extensions, and — once released — who released it and when. Readable by
        any organization member. Cross-tenant access returns 404, never 403.
      operationId: get_dispatch_pause_admin_dispatch_pauses__pause_id__get
      parameters:
        - name: pause_id
          in: path
          required: true
          schema:
            type: string
            title: Pause Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DispatchPauseResponse'
        '401':
          description: Missing or invalid authentication
          content:
            application/json:
              example:
                detail: Authentication required
        '404':
          description: >-
            No such pause for this organization (cross-tenant access also
            returns 404)
          content:
            application/json:
              example:
                detail: Pause not found
        '422':
          description: >-
            The body failed validation — an out-of-range duration, an over-long
            reason, an unknown lane or bucket, or lane/bucket scoping on the
            break-glass endpoint.
          content:
            application/json:
              example:
                detail: >-
                  The global pause holds every Domain at once — use the Domain
                  pause endpoints for lane or bucket scoping.
        '429':
          description: Rate limit exceeded — retry after the Retry-After header
          headers:
            Retry-After:
              description: Seconds to wait before retrying
              schema:
                type: integer
          content:
            application/json:
              example:
                detail: 'Rate limit exceeded: 100 per 1 minute'
      security:
        - APIKeyHeader: []
        - HTTPBearer: []
components:
  schemas:
    DispatchPauseResponse:
      properties:
        id:
          type: string
          title: Id
        scope:
          type: string
          title: Scope
        tenancy_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Tenancy Id
        bucket:
          anyOf:
            - type: string
            - type: 'null'
          title: Bucket
        lane:
          anyOf:
            - type: string
            - type: 'null'
          title: Lane
        batch_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Batch Id
        status:
          type: string
          title: Status
        cause:
          type: string
          title: Cause
        reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Reason
        created_by:
          type: string
          title: Created By
        created_at:
          type: string
          format: date-time
          title: Created At
        expires_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Expires At
        released_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Released At
        released_by:
          anyOf:
            - type: string
            - type: 'null'
          title: Released By
        extensions:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Extensions
      type: object
      required:
        - id
        - scope
        - tenancy_id
        - bucket
        - lane
        - batch_id
        - status
        - cause
        - reason
        - created_by
        - created_at
        - expires_at
        - released_at
        - released_by
        - extensions
      title: DispatchPauseResponse
      description: |-
        One hold on dispatch — an admin hold or an automatic backoff.

        Both kinds share this one shape, so a single listing shows everything
        currently holding dispatch. `scope` says how much is held and the
        matching target field (`tenancy_id`, `lane`, `bucket`, or `batch_id`)
        says exactly what. `cause` is the machine-readable origin
        (`admin_request` for a human hold, the provider fault tag for an
        automatic backoff) and `reason` is the human note, if any. A released
        pause keeps its record: `released_at` and `released_by` complete the
        audit trail, and `extensions` lists every time a scheduled resume was
        pushed out.
      example:
        cause: admin_request
        created_at: '2026-07-29T12:00:00Z'
        created_by: user_11223344
        expires_at: '2026-07-29T13:00:00Z'
        extensions: []
        id: pause_9f2c1a7b3d4e5f60
        reason: Provider maintenance window
        scope: global
        status: active
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    HTTPBearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````