> ## 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.

# POST /procedures



## OpenAPI

````yaml api-reference/openapi3.json post /procedures
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:
    post:
      tags:
        - Conversations
      summary: POST /procedures
      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'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                agent_id:
                  description: >-
                    The agent that should handle the procedure. Use
                    `pa_8qm9JBCiTe7` for the released version or
                    `pa_8qm9JBCiTe7@v2` for a specific version.
                  type: string
                conversation_id:
                  description: >-
                    The conversation that should be used to create the
                    procedure.
                  type: string
                livemode:
                  default: true
                  description: Whether the conversation should be created in live mode.
                  type: boolean
              required:
                - agent_id
                - conversation_id
              type: object
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                properties:
                  id:
                    description: >-
                      Unique identifier for the procedure, e.g.
                      `trun_8qm9JBCiTe7`.
                    type: string
                required:
                  - id
                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

````