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

# Get a procedure

> Returns comprehensive information about a procedure execution, including events and output.



## OpenAPI

````yaml api-reference/openapi3.json get /procedures/{procedure_id}
openapi: 3.0.0
info:
  title: Operator API
  version: '2025-06-19'
  description: API for Operator
servers:
  - url: https://api.operator.xyz
security: []
paths:
  /procedures/{procedure_id}:
    get:
      tags:
        - Procedures
      summary: Get a procedure
      description: >-
        Returns comprehensive information about a procedure execution, including
        events and output.
      parameters:
        - name: Operator-Version
          in: header
          required: true
          schema:
            type: string
            enum:
              - '2025-06-19'
          description: The API version to use.
          example: '2025-06-19'
        - name: procedure_id
          in: path
          required: true
          schema:
            description: The ID of the procedure to retrieve
            type: string
          description: The ID of the procedure to retrieve
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                properties:
                  id:
                    description: Unique identifier for the procedure
                    type: string
                  livemode:
                    description: Whether the procedure was run in live mode
                    type: boolean
                  name:
                    description: Name of the procedure
                    type: string
                  agent_id:
                    type: string
                    default: null
                    description: ID of the procedural agent that ran this procedure
                  agent_version_id:
                    type: string
                    default: null
                    description: Version ID of the procedural agent that ran this procedure
                  conversation_id:
                    description: ID of the conversation this procedure was run for
                    type: string
                  created_at:
                    description: Timestamp when the procedure was created
                    format: date-time
                    type: string
                  status:
                    description: Current status of the procedure
                    enum:
                      - pending
                      - running
                      - success
                      - failed
                      - skipped
                      - cancelled
                    type: string
                  error:
                    type: string
                    default: null
                    description: Error message if the procedure failed
                  input:
                    additionalProperties: true
                    type: object
                    default: null
                    description: Input data to the procedure
                  output:
                    additionalProperties: true
                    type: object
                    default: null
                    description: Output data from the procedure
                  summary:
                    type: string
                    default: null
                    description: Summary of the procedure execution
                required:
                  - id
                  - livemode
                  - name
                  - conversation_id
                  - created_at
                  - status
                type: object
        '404':
          description: The requested resource was not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  data: {}
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key

````