llama-stack-mirror/client-sdks/stainless/openapi.yml

openapi: 3.1.0
info:
  title: Llama Stack API - Stable & Experimental APIs
  description: "A comprehensive API for building and deploying AI applications\n\n**🔗 COMBINED**: This specification includes both stable production-ready APIs and experimental pre-release APIs. Use stable APIs for production deployments and experimental APIs for testing new features."
  version: 1.0.0
servers:
- url: https://api.llamastack.com
  description: Production server
- url: https://staging-api.llamastack.com
  description: Staging server
paths:
  /v1/batches:
    get:
      responses:
        '200':
          description: A list of batch objects.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListBatchesResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Batches
      summary: List all batches for the current user.
      description: List all batches for the current user.
      parameters:
        - name: after
          in: query
          description: >-
            A cursor for pagination; returns batches after this batch ID.
          required: false
          schema:
            type: string
        - name: limit
          in: query
          description: >-
            Number of batches to return (default 20, max 100).
          required: true
          schema:
            type: integer
      deprecated: false
    post:
      responses:
        '200':
          description: The created batch object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Batch'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Batches
      summary: >-
        Create a new batch for processing multiple API requests.
      description: >-
        Create a new batch for processing multiple API requests.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateBatchRequest'
        required: true
      deprecated: false
  /v1/batches/{batch_id}:
    get:
      responses:
        '200':
          description: The batch object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Batch'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Batches
      summary: >-
        Retrieve information about a specific batch.
      description: >-
        Retrieve information about a specific batch.
      parameters:
        - name: batch_id
          in: path
          description: The ID of the batch to retrieve.
          required: true
          schema:
            type: string
      deprecated: false
  /v1/batches/{batch_id}/cancel:
    post:
      responses:
        '200':
          description: The updated batch object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Batch'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Batches
      summary: Cancel a batch that is in progress.
      description: Cancel a batch that is in progress.
      parameters:
        - name: batch_id
          in: path
          description: The ID of the batch to cancel.
          required: true
          schema:
            type: string
      deprecated: false
  /v1/chat/completions:
    get:
      responses:
        '200':
          description: A ListOpenAIChatCompletionResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListOpenAIChatCompletionResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Inference
      summary: List chat completions.
      description: >-
        List chat completions.

        :param after: The ID of the last chat completion to return.
                :param limit: The maximum number of chat completions to return.
                :param model: The model to filter by.
                :param order: The order to sort the chat completions by: "asc" or
        "desc". Defaults to "desc".
                :returns: A ListOpenAIChatCompletionResponse.
      parameters:
        - name: after
          description: >-
            The ID of the last chat completion to return.
          required: false
          schema:
            type: string
          in: query
        - name: limit
          description: >-
            The maximum number of chat completions to return.
          required: false
          schema:
            type: integer
          in: query
        - name: model
          description: The model to filter by.
          required: false
          schema:
            type: string
          in: query
        - name: order
          description: >-
            The order to sort the chat completions by: "asc" or "desc". Defaults to
            "desc".
          required: false
          schema:
            $ref: '#/components/schemas/Order'
          in: query
      deprecated: false
    post:
      responses:
        '200':
          description: An OpenAIChatCompletion.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/llama_stack.apis.inference.inference.OpenAIChatCompletion
                  | collections.abc.AsyncIterator[llama_stack.apis.inference.inference.OpenAIChatCompletionChunk]'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Inference
      summary: Create chat completions.
      description: >-
        Create chat completions.

        Generate an OpenAI-compatible chat completion for the given messages using
        the specified model.
                :returns: An OpenAIChatCompletion.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              id: Annotated
        required: true
      deprecated: false
  /v1/chat/completions/{completion_id}:
    get:
      responses:
        '200':
          description: A OpenAICompletionWithInputMessages.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAICompletionWithInputMessages'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Inference
      summary: Get chat completion.
      description: >-
        Get chat completion.

        Describe a chat completion by its ID.

                :param completion_id: ID of the chat completion.
                :returns: A OpenAICompletionWithInputMessages.
      parameters:
        - name: completion_id
          description: ID of the chat completion.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/completions:
    post:
      responses:
        '200':
          description: An OpenAICompletion.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAICompletion'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Inference
      summary: Create completion.
      description: >-
        Create completion.

        Generate an OpenAI-compatible completion for the given prompt using the specified
        model.
                :returns: An OpenAICompletion.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              id: Annotated
        required: true
      deprecated: false
  /v1/conversations:
    post:
      responses:
        '200':
          description: The created conversation object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Conversation'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Conversations
      summary: Create a conversation.
      description: >-
        Create a conversation.

        Create a conversation.

                :param items: Initial items to include in the conversation context.
                :param metadata: Set of key-value pairs that can be attached to an
        object.
                :returns: The created conversation object.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateConversationRequest'
        required: true
      deprecated: false
  /v1/conversations/{conversation_id}:
    get:
      responses:
        '200':
          description: The conversation object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Conversation'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Conversations
      summary: Retrieve a conversation.
      description: >-
        Retrieve a conversation.

        Get a conversation with the given ID.

                :param conversation_id: The conversation identifier.
                :returns: The conversation object.
      parameters:
        - name: conversation_id
          description: The conversation identifier.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
    post:
      responses:
        '200':
          description: The updated conversation object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Conversation'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Conversations
      summary: Update a conversation.
      description: >-
        Update a conversation.

        Update a conversation's metadata with the given ID.

                :param conversation_id: The conversation identifier.
                :param metadata: Set of key-value pairs that can be attached to an
        object.
                :returns: The updated conversation object.
      parameters:
        - name: conversation_id
          description: The conversation identifier.
          required: true
          schema:
            type: string
          in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateConversationRequest'
        required: true
      deprecated: false
    delete:
      responses:
        '200':
          description: The deleted conversation resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationDeletedResource'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Conversations
      summary: Delete a conversation.
      description: >-
        Delete a conversation.

        Delete a conversation with the given ID.

                :param conversation_id: The conversation identifier.
                :returns: The deleted conversation resource.
      parameters:
        - name: conversation_id
          description: The conversation identifier.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/conversations/{conversation_id}/items:
    get:
      responses:
        '200':
          description: List of conversation items.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationItemList'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Conversations
      summary: List items.
      description: >-
        List items.

        List items in the conversation.

                :param conversation_id: The conversation identifier.
                :param after: An item ID to list items after, used in pagination.
                :param include: Specify additional output data to include in the response.
                :param limit: A limit on the number of objects to be returned (1-100,
        default 20).
                :param order: The order to return items in (asc or desc, default desc).
                :returns: List of conversation items.
      parameters:
        - name: conversation_id
          description: The conversation identifier.
          required: true
          schema:
            type: string
          in: path
        - name: after
          description: >-
            An item ID to list items after, used in pagination.
          required: false
          schema:
            type: string
          in: query
        - name: include
          description: >-
            Specify additional output data to include in the response.
          required: false
          schema:
            $ref: '#/components/schemas/list'
          in: query
        - name: limit
          description: >-
            A limit on the number of objects to be returned (1-100, default 20).
          required: false
          schema:
            type: integer
          in: query
        - name: order
          description: >-
            The order to return items in (asc or desc, default desc).
          required: false
          schema:
            $ref: '#/components/schemas/Literal'
          in: query
      deprecated: false
    post:
      responses:
        '200':
          description: List of created items.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationItemList'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Conversations
      summary: Create items.
      description: >-
        Create items.

        Create items in the conversation.

                :param conversation_id: The conversation identifier.
                :param items: Items to include in the conversation context.
                :returns: List of created items.
      parameters:
        - name: conversation_id
          description: The conversation identifier.
          required: true
          schema:
            type: string
          in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddItemsRequest'
        required: true
      deprecated: false
  /v1/conversations/{conversation_id}/items/{item_id}:
    get:
      responses:
        '200':
          description: The conversation item.
          content:
            application/json:
              schema:
                id: Annotated
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Conversations
      summary: Retrieve an item.
      description: >-
        Retrieve an item.

        Retrieve a conversation item.

                :param conversation_id: The conversation identifier.
                :param item_id: The item identifier.
                :returns: The conversation item.
      parameters:
        - name: conversation_id
          description: The conversation identifier.
          required: true
          schema:
            type: string
          in: path
        - name: item_id
          description: The item identifier.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
    delete:
      responses:
        '200':
          description: The deleted item resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationItemDeletedResource'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Conversations
      summary: Delete an item.
      description: >-
        Delete an item.

        Delete a conversation item.

                :param conversation_id: The conversation identifier.
                :param item_id: The item identifier.
                :returns: The deleted item resource.
      parameters:
        - name: conversation_id
          description: The conversation identifier.
          required: true
          schema:
            type: string
          in: path
        - name: item_id
          description: The item identifier.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/embeddings:
    post:
      responses:
        '200':
          description: >-
            An OpenAIEmbeddingsResponse containing the embeddings.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIEmbeddingsResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Inference
      summary: Create embeddings.
      description: >-
        Create embeddings.

        Generate OpenAI-compatible embeddings for the given input using the specified
        model.
                :returns: An OpenAIEmbeddingsResponse containing the embeddings.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              id: Annotated
        required: true
      deprecated: false
  /v1/files:
    get:
      responses:
        '200':
          description: >-
            An ListOpenAIFileResponse containing the list of files.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListOpenAIFileResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Files
      summary: List files.
      description: >-
        List files.

        Returns a list of files that belong to the user's organization.

                :param after: A cursor for use in pagination. `after` is an object
        ID that defines your place in the list. For instance, if you make a list request
        and receive 100 objects, ending with obj_foo, your subsequent call can include
        after=obj_foo in order to fetch the next page of the list.
                :param limit: A limit on the number of objects to be returned. Limit
        can range between 1 and 10,000, and the default is 10,000.
                :param order: Sort order by the `created_at` timestamp of the objects.
        `asc` for ascending order and `desc` for descending order.
                :param purpose: Only return files with the given purpose.
                :returns: An ListOpenAIFileResponse containing the list of files.
      parameters:
        - name: after
          description: >-
            A cursor for use in pagination. `after` is an object ID that defines your
            place in the list. For instance, if you make a list request and receive
            100 objects, ending with obj_foo, your subsequent call can include after=obj_foo
            in order to fetch the next page of the list.
          required: false
          schema:
            type: string
          in: query
        - name: limit
          description: >-
            A limit on the number of objects to be returned. Limit can range between
            1 and 10,000, and the default is 10,000.
          required: false
          schema:
            type: integer
          in: query
        - name: order
          description: >-
            Sort order by the `created_at` timestamp of the objects. `asc` for ascending
            order and `desc` for descending order.
          required: false
          schema:
            $ref: '#/components/schemas/Order'
          in: query
        - name: purpose
          description: >-
            Only return files with the given purpose.
          required: false
          schema:
            $ref: '#/components/schemas/OpenAIFilePurpose'
          in: query
      deprecated: false
    post:
      responses:
        '200':
          description: >-
            An OpenAIFileObject representing the uploaded file.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIFileObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Files
      summary: Upload file.
      description: >-
        Upload file.

        Upload a file that can be used across various endpoints.

                The file upload should be a multipart form request with:
                - file: The File object (not file name) to be uploaded.
                - purpose: The intended purpose of the uploaded file.
                - expires_after: Optional form values describing expiration for the
        file.

                :param file: The uploaded file object containing content and metadata
        (filename, content_type, etc.).
                :param purpose: The intended purpose of the uploaded file (e.g., "assistants",
        "fine-tune").
                :param expires_after: Optional form values describing expiration for
        the file.
                :returns: An OpenAIFileObject representing the uploaded file.
      parameters: []
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  type: string
                  format: binary
                purpose:
                  $ref: '#/components/schemas/OpenAIFilePurpose'
                expires_after:
                  $ref: '#/components/schemas/ExpiresAfter'
              required:
                - file
                - purpose
        required: true
      deprecated: false
  /v1/files/{file_id}:
    get:
      responses:
        '200':
          description: >-
            An OpenAIFileObject containing file information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIFileObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Files
      summary: Retrieve file.
      description: >-
        Retrieve file.

        Returns information about a specific file.

                :param file_id: The ID of the file to use for this request.
                :returns: An OpenAIFileObject containing file information.
      parameters:
        - name: file_id
          description: >-
            The ID of the file to use for this request.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
    delete:
      responses:
        '200':
          description: >-
            An OpenAIFileDeleteResponse indicating successful deletion.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIFileDeleteResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Files
      summary: Delete file.
      description: >-
        Delete file.

        :param file_id: The ID of the file to use for this request.
                :returns: An OpenAIFileDeleteResponse indicating successful deletion.
      parameters:
        - name: file_id
          description: >-
            The ID of the file to use for this request.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/files/{file_id}/content:
    get:
      responses:
        '200':
          description: >-
            The raw file content as a binary response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Files
      summary: Retrieve file content.
      description: >-
        Retrieve file content.

        Returns the contents of the specified file.

                :param file_id: The ID of the file to use for this request.
                :returns: The raw file content as a binary response.
      parameters:
        - name: file_id
          description: >-
            The ID of the file to use for this request.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/health:
    get:
      responses:
        '200':
          description: >-
            Health information indicating if the service is operational.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthInfo'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Inspect
      summary: Get health status.
      description: >-
        Get health status.

        Get the current health status of the service.

                :returns: Health information indicating if the service is operational.
      parameters: []
      deprecated: false
  /v1/inspect/routes:
    get:
      responses:
        '200':
          description: >-
            Response containing information about all available routes.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListRoutesResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Inspect
      summary: List routes.
      description: >-
        List routes.

        List all available API routes with their methods and implementing providers.
      parameters:
        - name: api_filter
          in: query
          description: >-
            Optional filter to control which routes are returned. Can be an API level
            ('v1', 'v1alpha', 'v1beta') to show non-deprecated routes at that level,
            or 'deprecated' to show deprecated routes across all levels. If not specified,
            returns only non-deprecated v1 routes.
          required: false
          schema:
            type: string
            enum:
              - v1
              - v1alpha
              - v1beta
              - deprecated
      deprecated: false
  /v1/models:
    get:
      responses:
        '200':
          description: A OpenAIListModelsResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIListModelsResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Models
      summary: List models using the OpenAI API.
      description: List models using the OpenAI API.
      parameters: []
      deprecated: false
    post:
      responses:
        '200':
          description: A Model.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Model'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Models
      summary: Register model.
      description: >-
        Register model.

        Register a model.

                :param model_id: The identifier of the model to register.
                :param provider_model_id: The identifier of the model in the provider.
                :param provider_id: The identifier of the provider.
                :param metadata: Any additional metadata for this model.
                :param model_type: The type of model to register.
                :returns: A Model.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterModelRequest'
        required: true
      deprecated: false
  /v1/models/{model_id}:
    get:
      responses:
        '200':
          description: A Model.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Model'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Models
      summary: Get model.
      description: >-
        Get model.

        Get a model by its identifier.

                :param model_id: The identifier of the model to get.
                :returns: A Model.
      parameters:
        - name: model_id
          description: The identifier of the model to get.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
    delete:
      responses:
        '200':
          description: OK
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Models
      summary: Unregister model.
      description: >-
        Unregister model.

        Unregister a model.

                :param model_id: The identifier of the model to unregister.
      parameters:
        - name: model_id
          description: >-
            The identifier of the model to unregister.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/moderations:
    post:
      responses:
        '200':
          description: A moderation object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModerationObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Safety
      summary: Create moderation.
      description: >-
        Create moderation.

        Classifies if text and/or image inputs are potentially harmful.
                :param input: Input (or inputs) to classify.
                Can be a single string, an array of strings, or an array of multi-modal
        input objects similar to other models.
                :param model: (Optional) The content moderation model you would like
        to use.
                :returns: A moderation object.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RunModerationRequest'
        required: true
      deprecated: false
  /v1/prompts:
    get:
      responses:
        '200':
          description: >-
            A ListPromptsResponse containing all prompts.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListPromptsResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Prompts
      summary: List all prompts.
      description: >-
        List all prompts.

        :returns: A ListPromptsResponse containing all prompts.
      parameters: []
      deprecated: false
    post:
      responses:
        '200':
          description: The created Prompt resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Prompt'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Prompts
      summary: Create prompt.
      description: >-
        Create prompt.

        Create a new prompt.

                :param prompt: The prompt text content with variable placeholders.
                :param variables: List of variable names that can be used in the prompt
        template.
                :returns: The created Prompt resource.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePromptRequest'
        required: true
      deprecated: false
  /v1/prompts/{prompt_id}:
    get:
      responses:
        '200':
          description: A Prompt resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Prompt'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Prompts
      summary: Get prompt.
      description: >-
        Get prompt.

        Get a prompt by its identifier and optional version.

                :param prompt_id: The identifier of the prompt to get.
                :param version: The version of the prompt to get (defaults to latest).
                :returns: A Prompt resource.
      parameters:
        - name: prompt_id
          description: The identifier of the prompt to get.
          required: true
          schema:
            type: string
          in: path
        - name: version
          description: >-
            The version of the prompt to get (defaults to latest).
          required: false
          schema:
            type: integer
          in: query
      deprecated: false
    post:
      responses:
        '200':
          description: >-
            The updated Prompt resource with incremented version.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Prompt'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Prompts
      summary: Update prompt.
      description: >-
        Update prompt.

        Update an existing prompt (increments version).

                :param prompt_id: The identifier of the prompt to update.
                :param prompt: The updated prompt text content.
                :param version: The current version of the prompt being updated.
                :param variables: Updated list of variable names that can be used
        in the prompt template.
                :param set_as_default: Set the new version as the default (default=True).
                :returns: The updated Prompt resource with incremented version.
      parameters:
        - name: prompt_id
          description: The identifier of the prompt to update.
          required: true
          schema:
            type: string
          in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdatePromptRequest'
        required: true
      deprecated: false
    delete:
      responses:
        '200':
          description: OK
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Prompts
      summary: Delete prompt.
      description: >-
        Delete prompt.

        Delete a prompt.

                :param prompt_id: The identifier of the prompt to delete.
      parameters:
        - name: prompt_id
          description: The identifier of the prompt to delete.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/prompts/{prompt_id}/set-default-version:
    post:
      responses:
        '200':
          description: >-
            The prompt with the specified version now set as default.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Prompt'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Prompts
      summary: Set prompt version.
      description: >-
        Set prompt version.

        Set which version of a prompt should be the default in get_prompt (latest).

                :param prompt_id: The identifier of the prompt.
                :param version: The version to set as default.
                :returns: The prompt with the specified version now set as default.
      parameters:
        - name: prompt_id
          description: The identifier of the prompt.
          required: true
          schema:
            type: string
          in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SetDefaultVersionRequest'
        required: true
      deprecated: false
  /v1/prompts/{prompt_id}/versions:
    get:
      responses:
        '200':
          description: >-
            A ListPromptsResponse containing all versions of the prompt.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListPromptsResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Prompts
      summary: List prompt versions.
      description: >-
        List prompt versions.

        List all versions of a specific prompt.

                :param prompt_id: The identifier of the prompt to list versions for.
                :returns: A ListPromptsResponse containing all versions of the prompt.
      parameters:
        - name: prompt_id
          description: >-
            The identifier of the prompt to list versions for.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/providers:
    get:
      responses:
        '200':
          description: >-
            A ListProvidersResponse containing information about all providers.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListProvidersResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Providers
      summary: List providers.
      description: >-
        List providers.

        List all available providers.

                :returns: A ListProvidersResponse containing information about all
        providers.
      parameters: []
      deprecated: false
  /v1/providers/{provider_id}:
    get:
      responses:
        '200':
          description: >-
            A ProviderInfo object containing the provider's details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProviderInfo'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Providers
      summary: Get provider.
      description: >-
        Get provider.

        Get detailed information about a specific provider.

                :param provider_id: The ID of the provider to inspect.
                :returns: A ProviderInfo object containing the provider's details.
      parameters:
        - name: provider_id
          description: The ID of the provider to inspect.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/responses:
    get:
      responses:
        '200':
          description: A ListOpenAIResponseObject.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListOpenAIResponseObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Agents
      summary: List all responses.
      description: >-
        List all responses.

        :param after: The ID of the last response to return.
                :param limit: The number of responses to return.
                :param model: The model to filter responses by.
                :param order: The order to sort responses by when sorted by created_at
        ('asc' or 'desc').
                :returns: A ListOpenAIResponseObject.
      parameters:
        - name: after
          description: The ID of the last response to return.
          required: false
          schema:
            type: string
          in: query
        - name: limit
          description: The number of responses to return.
          required: false
          schema:
            type: integer
          in: query
        - name: model
          description: The model to filter responses by.
          required: false
          schema:
            type: string
          in: query
        - name: order
          description: >-
            The order to sort responses by when sorted by created_at ('asc' or 'desc').
          required: false
          schema:
            $ref: '#/components/schemas/Order'
          in: query
      deprecated: false
    post:
      responses:
        '200':
          description: An OpenAIResponseObject.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIResponseObject'
            text/event-stream:
              schema:
                $ref: '#/components/schemas/AsyncIterator'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Agents
      summary: Create a model response.
      description: >-
        Create a model response.

        :param input: Input message(s) to create the response.
                :param model: The underlying LLM used for completions.
                :param previous_response_id: (Optional) if specified, the new response
        will be a continuation of the previous response. This can be used to easily
        fork-off new responses from existing responses.
                :param conversation: (Optional) The ID of a conversation to add the
        response to. Must begin with 'conv_'. Input and output messages will be automatically
        added to the conversation.
                :param include: (Optional) Additional fields to include in the response.
                :param guardrails: (Optional) List of guardrails to apply during response
        generation. Can be guardrail IDs (strings) or guardrail specifications.
                :returns: An OpenAIResponseObject.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateOpenaiResponseRequest'
        required: true
      deprecated: false
      x-llama-stack-extra-body-params:
        - name: guardrails
          schema:
            id: Annotated
          description: >-
            List of guardrails to apply during response generation. Guardrails provide
            safety and content moderation.
          required: true
  /v1/responses/{response_id}:
    get:
      responses:
        '200':
          description: An OpenAIResponseObject.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIResponseObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Agents
      summary: Get a model response.
      description: >-
        Get a model response.

        :param response_id: The ID of the OpenAI response to retrieve.
                :returns: An OpenAIResponseObject.
      parameters:
        - name: response_id
          description: >-
            The ID of the OpenAI response to retrieve.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
    delete:
      responses:
        '200':
          description: An OpenAIDeleteResponseObject
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIDeleteResponseObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Agents
      summary: Delete a response.
      description: >-
        Delete a response.

        :param response_id: The ID of the OpenAI response to delete.
                :returns: An OpenAIDeleteResponseObject
      parameters:
        - name: response_id
          description: The ID of the OpenAI response to delete.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/responses/{response_id}/input_items:
    get:
      responses:
        '200':
          description: An ListOpenAIResponseInputItem.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListOpenAIResponseInputItem'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Agents
      summary: List input items.
      description: >-
        List input items.

        :param response_id: The ID of the response to retrieve input items for.
                :param after: An item ID to list items after, used for pagination.
                :param before: An item ID to list items before, used for pagination.
                :param include: Additional fields to include in the response.
                :param limit: A limit on the number of objects to be returned. Limit
        can range between 1 and 100, and the default is 20.
                :param order: The order to return the input items in. Default is desc.
                :returns: An ListOpenAIResponseInputItem.
      parameters:
        - name: response_id
          description: >-
            The ID of the response to retrieve input items for.
          required: true
          schema:
            type: string
          in: path
        - name: after
          description: >-
            An item ID to list items after, used for pagination.
          required: false
          schema:
            type: string
          in: query
        - name: before
          description: >-
            An item ID to list items before, used for pagination.
          required: false
          schema:
            type: string
          in: query
        - name: include
          description: >-
            Additional fields to include in the response.
          required: false
          schema:
            $ref: '#/components/schemas/list'
          in: query
        - name: limit
          description: >-
            A limit on the number of objects to be returned. Limit can range between
            1 and 100, and the default is 20.
          required: false
          schema:
            type: integer
          in: query
        - name: order
          description: >-
            The order to return the input items in. Default is desc.
          required: false
          schema:
            $ref: '#/components/schemas/Order'
          in: query
      deprecated: false
  /v1/safety/run-shield:
    post:
      responses:
        '200':
          description: A RunShieldResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RunShieldResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Safety
      summary: Run shield.
      description: >-
        Run shield.

        Run a shield.

                :param shield_id: The identifier of the shield to run.
                :param messages: The messages to run the shield on.
                :param params: The parameters of the shield.
                :returns: A RunShieldResponse.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RunShieldRequest'
        required: true
      deprecated: false
  /v1/scoring-functions:
    get:
      responses:
        '200':
          description: A ListScoringFunctionsResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListScoringFunctionsResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - ScoringFunctions
      summary: List all scoring functions.
      description: >-
        List all scoring functions.

        :returns: A ListScoringFunctionsResponse.
      parameters: []
      deprecated: false
    post:
      responses:
        '200':
          description: OK
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - ScoringFunctions
      summary: Register a scoring function.
      description: >-
        Register a scoring function.

        :param scoring_fn_id: The ID of the scoring function to register.
                :param description: The description of the scoring function.
                :param return_type: The return type of the scoring function.
                :param provider_scoring_fn_id: The ID of the provider scoring function
        to use for the scoring function.
                :param provider_id: The ID of the provider to use for the scoring
        function.
                :param params: The parameters for the scoring function for benchmark
        eval, these can be overridden for app eval.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterScoringFunctionRequest'
        required: true
      deprecated: false
  /v1/scoring-functions/{scoring_fn_id}:
    get:
      responses:
        '200':
          description: A ScoringFn.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScoringFn'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - ScoringFunctions
      summary: Get a scoring function by its ID.
      description: >-
        Get a scoring function by its ID.

        :param scoring_fn_id: The ID of the scoring function to get.
                :returns: A ScoringFn.
      parameters:
        - name: scoring_fn_id
          description: The ID of the scoring function to get.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
    delete:
      responses:
        '200':
          description: OK
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - ScoringFunctions
      summary: Unregister a scoring function.
      description: >-
        Unregister a scoring function.

        :param scoring_fn_id: The ID of the scoring function to unregister.
      parameters:
        - name: scoring_fn_id
          description: >-
            The ID of the scoring function to unregister.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/scoring/score:
    post:
      responses:
        '200':
          description: >-
            A ScoreResponse object containing rows and aggregated results.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScoreResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Scoring
      summary: Score a list of rows.
      description: >-
        Score a list of rows.

        :param input_rows: The rows to score.
                :param scoring_functions: The scoring functions to use for the scoring.
                :returns: A ScoreResponse object containing rows and aggregated results.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ScoreRequest'
        required: true
      deprecated: false
  /v1/scoring/score-batch:
    post:
      responses:
        '200':
          description: A ScoreBatchResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScoreBatchResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Scoring
      summary: Score a batch of rows.
      description: >-
        Score a batch of rows.

        :param dataset_id: The ID of the dataset to score.
                :param scoring_functions: The scoring functions to use for the scoring.
                :param save_results_dataset: Whether to save the results to a dataset.
                :returns: A ScoreBatchResponse.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ScoreBatchRequest'
        required: true
      deprecated: false
  /v1/shields:
    get:
      responses:
        '200':
          description: A ListShieldsResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListShieldsResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Shields
      summary: List all shields.
      description: >-
        List all shields.

        :returns: A ListShieldsResponse.
      parameters: []
      deprecated: false
    post:
      responses:
        '200':
          description: A Shield.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Shield'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Shields
      summary: Register a shield.
      description: >-
        Register a shield.

        :param shield_id: The identifier of the shield to register.
                :param provider_shield_id: The identifier of the shield in the provider.
                :param provider_id: The identifier of the provider.
                :param params: The parameters of the shield.
                :returns: A Shield.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterShieldRequest'
        required: true
      deprecated: false
  /v1/shields/{identifier}:
    get:
      responses:
        '200':
          description: A Shield.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Shield'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Shields
      summary: Get a shield by its identifier.
      description: >-
        Get a shield by its identifier.

        :param identifier: The identifier of the shield to get.
                :returns: A Shield.
      parameters:
        - name: identifier
          description: The identifier of the shield to get.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
    delete:
      responses:
        '200':
          description: OK
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Shields
      summary: Unregister a shield.
      description: >-
        Unregister a shield.

        :param identifier: The identifier of the shield to unregister.
      parameters:
        - name: identifier
          description: >-
            The identifier of the shield to unregister.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/tool-runtime/invoke:
    post:
      responses:
        '200':
          description: A ToolInvocationResult.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolInvocationResult'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - ToolRuntime
      summary: Run a tool with the given arguments.
      description: >-
        Run a tool with the given arguments.

        :param tool_name: The name of the tool to invoke.
                :param kwargs: A dictionary of arguments to pass to the tool.
                :returns: A ToolInvocationResult.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InvokeToolRequest'
        required: true
      deprecated: false
  /v1/tool-runtime/list-tools:
    get:
      responses:
        '200':
          description: A ListToolDefsResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListToolDefsResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - ToolRuntime
      summary: List all tools in the runtime.
      description: >-
        List all tools in the runtime.

        :param tool_group_id: The ID of the tool group to list tools for.
                :param mcp_endpoint: The MCP endpoint to use for the tool group.
                :returns: A ListToolDefsResponse.
      parameters:
        - name: tool_group_id
          description: >-
            The ID of the tool group to list tools for.
          required: false
          schema:
            type: string
          in: query
        - name: mcp_endpoint
          description: >-
            The MCP endpoint to use for the tool group.
          required: false
          schema:
            $ref: '#/components/schemas/URL'
          in: query
      deprecated: false
  /v1/tool-runtime/rag-tool/insert:
    post:
      responses:
        '200':
          description: OK
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - ToolRuntime
      summary: >-
        Index documents so they can be used by the RAG system.
      description: >-
        Index documents so they can be used by the RAG system.

        :param documents: List of documents to index in the RAG system
                :param vector_store_id: ID of the vector database to store the document
        embeddings
                :param chunk_size_in_tokens: (Optional) Size in tokens for document
        chunking during indexing
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InsertRequest'
        required: true
      deprecated: false
  /v1/tool-runtime/rag-tool/query:
    post:
      responses:
        '200':
          description: >-
            RAGQueryResult containing the retrieved content and metadata
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RAGQueryResult'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - ToolRuntime
      summary: >-
        Query the RAG system for context; typically invoked by the agent.
      description: >-
        Query the RAG system for context; typically invoked by the agent.

        :param content: The query content to search for in the indexed documents
                :param vector_store_ids: List of vector database IDs to search within
                :param query_config: (Optional) Configuration parameters for the query
        operation
                :returns: RAGQueryResult containing the retrieved content and metadata
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/QueryRequest'
        required: true
      deprecated: false
  /v1/toolgroups:
    get:
      responses:
        '200':
          description: A ListToolGroupsResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListToolGroupsResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - ToolGroups
      summary: List tool groups with optional provider.
      description: >-
        List tool groups with optional provider.

        :returns: A ListToolGroupsResponse.
      parameters: []
      deprecated: false
    post:
      responses:
        '200':
          description: OK
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - ToolGroups
      summary: Register a tool group.
      description: >-
        Register a tool group.

        :param toolgroup_id: The ID of the tool group to register.
                :param provider_id: The ID of the provider to use for the tool group.
                :param mcp_endpoint: The MCP endpoint to use for the tool group.
                :param args: A dictionary of arguments to pass to the tool group.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterToolGroupRequest'
        required: true
      deprecated: false
  /v1/toolgroups/{toolgroup_id}:
    get:
      responses:
        '200':
          description: A ToolGroup.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolGroup'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - ToolGroups
      summary: Get a tool group by its ID.
      description: >-
        Get a tool group by its ID.

        :param toolgroup_id: The ID of the tool group to get.
                :returns: A ToolGroup.
      parameters:
        - name: toolgroup_id
          description: The ID of the tool group to get.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
    delete:
      responses:
        '200':
          description: OK
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - ToolGroups
      summary: Unregister a tool group.
      description: >-
        Unregister a tool group.

        :param toolgroup_id: The ID of the tool group to unregister.
      parameters:
        - name: toolgroup_id
          description: The ID of the tool group to unregister.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/tools:
    get:
      responses:
        '200':
          description: A ListToolDefsResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListToolDefsResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - ToolGroups
      summary: List tools with optional tool group.
      description: >-
        List tools with optional tool group.

        :param toolgroup_id: The ID of the tool group to list tools for.
                :returns: A ListToolDefsResponse.
      parameters:
        - name: toolgroup_id
          description: >-
            The ID of the tool group to list tools for.
          required: false
          schema:
            type: string
          in: query
      deprecated: false
  /v1/tools/{tool_name}:
    get:
      responses:
        '200':
          description: A ToolDef.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolDef'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - ToolGroups
      summary: Get a tool by its name.
      description: >-
        Get a tool by its name.

        :param tool_name: The name of the tool to get.
                :returns: A ToolDef.
      parameters:
        - name: tool_name
          description: The name of the tool to get.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/vector-io/insert:
    post:
      responses:
        '200':
          description: OK
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - VectorIO
      summary: Insert chunks into a vector database.
      description: >-
        Insert chunks into a vector database.

        :param vector_store_id: The identifier of the vector database to insert the
        chunks into.
                :param chunks: The chunks to insert. Each `Chunk` should contain content
        which can be interleaved text, images, or other types.
                    `metadata`: `dict[str, Any]` and `embedding`: `List[float]` are
        optional.
                    If `metadata` is provided, you configure how Llama Stack formats
        the chunk during generation.
                    If `embedding` is not provided, it will be computed later.
                :param ttl_seconds: The time to live of the chunks.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InsertChunksRequest'
        required: true
      deprecated: false
  /v1/vector-io/query:
    post:
      responses:
        '200':
          description: A QueryChunksResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueryChunksResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - VectorIO
      summary: Query chunks from a vector database.
      description: >-
        Query chunks from a vector database.

        :param vector_store_id: The identifier of the vector database to query.
                :param query: The query to search for.
                :param params: The parameters of the query.
                :returns: A QueryChunksResponse.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/QueryChunksRequest'
        required: true
      deprecated: false
  /v1/vector_stores:
    get:
      responses:
        '200':
          description: >-
            A VectorStoreListResponse containing the list of vector stores.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreListResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - VectorIO
      summary: Returns a list of vector stores.
      description: >-
        Returns a list of vector stores.

        :param limit: A limit on the number of objects to be returned. Limit can range
        between 1 and 100, and the default is 20.
                :param order: Sort order by the `created_at` timestamp of the objects.
        `asc` for ascending order and `desc` for descending order.
                :param after: A cursor for use in pagination. `after` is an object
        ID that defines your place in the list.
                :param before: A cursor for use in pagination. `before` is an object
        ID that defines your place in the list.
                :returns: A VectorStoreListResponse containing the list of vector
        stores.
      parameters:
        - name: limit
          description: >-
            A limit on the number of objects to be returned. Limit can range between
            1 and 100, and the default is 20.
          required: false
          schema:
            type: integer
          in: query
        - name: order
          description: >-
            Sort order by the `created_at` timestamp of the objects. `asc` for ascending
            order and `desc` for descending order.
          required: false
          schema:
            type: string
          in: query
        - name: after
          description: >-
            A cursor for use in pagination. `after` is an object ID that defines your
            place in the list.
          required: false
          schema:
            type: string
          in: query
        - name: before
          description: >-
            A cursor for use in pagination. `before` is an object ID that defines
            your place in the list.
          required: false
          schema:
            type: string
          in: query
      deprecated: false
    post:
      responses:
        '200':
          description: >-
            A VectorStoreObject representing the created vector store.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - VectorIO
      summary: Creates a vector store.
      description: >-
        Creates a vector store.

        Generate an OpenAI-compatible vector store with the given parameters.
                :returns: A VectorStoreObject representing the created vector store.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              id: Annotated
        required: true
      deprecated: false
  /v1/vector_stores/{vector_store_id}:
    get:
      responses:
        '200':
          description: >-
            A VectorStoreObject representing the vector store.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - VectorIO
      summary: Retrieves a vector store.
      description: >-
        Retrieves a vector store.

        :param vector_store_id: The ID of the vector store to retrieve.
                :returns: A VectorStoreObject representing the vector store.
      parameters:
        - name: vector_store_id
          description: The ID of the vector store to retrieve.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
    post:
      responses:
        '200':
          description: >-
            A VectorStoreObject representing the updated vector store.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - VectorIO
      summary: Updates a vector store.
      description: >-
        Updates a vector store.

        :param vector_store_id: The ID of the vector store to update.
                :param name: The name of the vector store.
                :param expires_after: The expiration policy for a vector store.
                :param metadata: Set of 16 key-value pairs that can be attached to
        an object.
                :returns: A VectorStoreObject representing the updated vector store.
      parameters:
        - name: vector_store_id
          description: The ID of the vector store to update.
          required: true
          schema:
            type: string
          in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenaiUpdateVectorStoreRequest'
        required: true
      deprecated: false
    delete:
      responses:
        '200':
          description: >-
            A VectorStoreDeleteResponse indicating the deletion status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreDeleteResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - VectorIO
      summary: Delete a vector store.
      description: >-
        Delete a vector store.

        :param vector_store_id: The ID of the vector store to delete.
                :returns: A VectorStoreDeleteResponse indicating the deletion status.
      parameters:
        - name: vector_store_id
          description: The ID of the vector store to delete.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/vector_stores/{vector_store_id}/file_batches:
    post:
      responses:
        '200':
          description: >-
            A VectorStoreFileBatchObject representing the created file batch.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreFileBatchObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - VectorIO
      summary: Create a vector store file batch.
      description: >-
        Create a vector store file batch.

        Generate an OpenAI-compatible vector store file batch for the given vector
        store.
                :param vector_store_id: The ID of the vector store to create the file
        batch for.
                :returns: A VectorStoreFileBatchObject representing the created file
        batch.
      parameters:
        - name: vector_store_id
          description: >-
            The ID of the vector store to create the file batch for.
          required: true
          schema:
            type: string
          in: path
      requestBody:
        content:
          application/json:
            schema:
              id: Annotated
        required: true
      deprecated: false
  /v1/vector_stores/{vector_store_id}/file_batches/{batch_id}:
    get:
      responses:
        '200':
          description: >-
            A VectorStoreFileBatchObject representing the file batch.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreFileBatchObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - VectorIO
      summary: Retrieve a vector store file batch.
      description: >-
        Retrieve a vector store file batch.

        :param batch_id: The ID of the file batch to retrieve.
                :param vector_store_id: The ID of the vector store containing the
        file batch.
                :returns: A VectorStoreFileBatchObject representing the file batch.
      parameters:
        - name: batch_id
          description: The ID of the file batch to retrieve.
          required: true
          schema:
            type: string
          in: path
        - name: vector_store_id
          description: >-
            The ID of the vector store containing the file batch.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/vector_stores/{vector_store_id}/file_batches/{batch_id}/cancel:
    post:
      responses:
        '200':
          description: >-
            A VectorStoreFileBatchObject representing the cancelled file batch.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreFileBatchObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - VectorIO
      summary: Cancels a vector store file batch.
      description: >-
        Cancels a vector store file batch.

        :param batch_id: The ID of the file batch to cancel.
                :param vector_store_id: The ID of the vector store containing the
        file batch.
                :returns: A VectorStoreFileBatchObject representing the cancelled
        file batch.
      parameters:
        - name: batch_id
          description: The ID of the file batch to cancel.
          required: true
          schema:
            type: string
          in: path
        - name: vector_store_id
          description: >-
            The ID of the vector store containing the file batch.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/vector_stores/{vector_store_id}/file_batches/{batch_id}/files:
    get:
      responses:
        '200':
          description: >-
            A VectorStoreFilesListInBatchResponse containing the list of files in
            the batch.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreFilesListInBatchResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - VectorIO
      summary: >-
        Returns a list of vector store files in a batch.
      description: >-
        Returns a list of vector store files in a batch.

        :param batch_id: The ID of the file batch to list files from.
                :param vector_store_id: The ID of the vector store containing the
        file batch.
                :param after: A cursor for use in pagination. `after` is an object
        ID that defines your place in the list.
                :param before: A cursor for use in pagination. `before` is an object
        ID that defines your place in the list.
                :param filter: Filter by file status. One of in_progress, completed,
        failed, cancelled.
                :param limit: A limit on the number of objects to be returned. Limit
        can range between 1 and 100, and the default is 20.
                :param order: Sort order by the `created_at` timestamp of the objects.
        `asc` for ascending order and `desc` for descending order.
                :returns: A VectorStoreFilesListInBatchResponse containing the list
        of files in the batch.
      parameters:
        - name: batch_id
          description: >-
            The ID of the file batch to list files from.
          required: true
          schema:
            type: string
          in: path
        - name: vector_store_id
          description: >-
            The ID of the vector store containing the file batch.
          required: true
          schema:
            type: string
          in: path
        - name: after
          description: >-
            A cursor for use in pagination. `after` is an object ID that defines your
            place in the list.
          required: false
          schema:
            type: string
          in: query
        - name: before
          description: >-
            A cursor for use in pagination. `before` is an object ID that defines
            your place in the list.
          required: false
          schema:
            type: string
          in: query
        - name: filter
          description: >-
            Filter by file status. One of in_progress, completed, failed, cancelled.
          required: false
          schema:
            type: string
          in: query
        - name: limit
          description: >-
            A limit on the number of objects to be returned. Limit can range between
            1 and 100, and the default is 20.
          required: false
          schema:
            type: integer
          in: query
        - name: order
          description: >-
            Sort order by the `created_at` timestamp of the objects. `asc` for ascending
            order and `desc` for descending order.
          required: false
          schema:
            type: string
          in: query
      deprecated: false
  /v1/vector_stores/{vector_store_id}/files:
    get:
      responses:
        '200':
          description: >-
            A VectorStoreListFilesResponse containing the list of files.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreListFilesResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - VectorIO
      summary: List files in a vector store.
      description: >-
        List files in a vector store.

        :param vector_store_id: The ID of the vector store to list files from.
                :param limit: (Optional) A limit on the number of objects to be returned.
        Limit can range between 1 and 100, and the default is 20.
                :param order: (Optional) Sort order by the `created_at` timestamp
        of the objects. `asc` for ascending order and `desc` for descending order.
                :param after: (Optional) A cursor for use in pagination. `after` is
        an object ID that defines your place in the list.
                :param before: (Optional) A cursor for use in pagination. `before`
        is an object ID that defines your place in the list.
                :param filter: (Optional) Filter by file status to only return files
        with the specified status.
                :returns: A VectorStoreListFilesResponse containing the list of files.
      parameters:
        - name: vector_store_id
          description: >-
            The ID of the vector store to list files from.
          required: true
          schema:
            type: string
          in: path
        - name: limit
          description: >-
            (Optional) A limit on the number of objects to be returned. Limit can
            range between 1 and 100, and the default is 20.
          required: false
          schema:
            type: integer
          in: query
        - name: order
          description: >-
            (Optional) Sort order by the `created_at` timestamp of the objects. `asc`
            for ascending order and `desc` for descending order.
          required: false
          schema:
            type: string
          in: query
        - name: after
          description: >-
            (Optional) A cursor for use in pagination. `after` is an object ID that
            defines your place in the list.
          required: false
          schema:
            type: string
          in: query
        - name: before
          description: >-
            (Optional) A cursor for use in pagination. `before` is an object ID that
            defines your place in the list.
          required: false
          schema:
            type: string
          in: query
        - name: filter
          description: >-
            (Optional) Filter by file status to only return files with the specified
            status.
          required: false
          schema:
            id: Union
          in: query
      deprecated: false
    post:
      responses:
        '200':
          description: >-
            A VectorStoreFileObject representing the attached file.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreFileObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - VectorIO
      summary: Attach a file to a vector store.
      description: >-
        Attach a file to a vector store.

        :param vector_store_id: The ID of the vector store to attach the file to.
                :param file_id: The ID of the file to attach to the vector store.
                :param attributes: The key-value attributes stored with the file,
        which can be used for filtering.
                :param chunking_strategy: The chunking strategy to use for the file.
                :returns: A VectorStoreFileObject representing the attached file.
      parameters:
        - name: vector_store_id
          description: >-
            The ID of the vector store to attach the file to.
          required: true
          schema:
            type: string
          in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenaiAttachFileToVectorStoreRequest'
        required: true
      deprecated: false
  /v1/vector_stores/{vector_store_id}/files/{file_id}:
    get:
      responses:
        '200':
          description: >-
            A VectorStoreFileObject representing the file.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreFileObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - VectorIO
      summary: Retrieves a vector store file.
      description: >-
        Retrieves a vector store file.

        :param vector_store_id: The ID of the vector store containing the file to
        retrieve.
                :param file_id: The ID of the file to retrieve.
                :returns: A VectorStoreFileObject representing the file.
      parameters:
        - name: vector_store_id
          description: >-
            The ID of the vector store containing the file to retrieve.
          required: true
          schema:
            type: string
          in: path
        - name: file_id
          description: The ID of the file to retrieve.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
    post:
      responses:
        '200':
          description: >-
            A VectorStoreFileObject representing the updated file.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreFileObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - VectorIO
      summary: Updates a vector store file.
      description: >-
        Updates a vector store file.

        :param vector_store_id: The ID of the vector store containing the file to
        update.
                :param file_id: The ID of the file to update.
                :param attributes: The updated key-value attributes to store with
        the file.
                :returns: A VectorStoreFileObject representing the updated file.
      parameters:
        - name: vector_store_id
          description: >-
            The ID of the vector store containing the file to update.
          required: true
          schema:
            type: string
          in: path
        - name: file_id
          description: The ID of the file to update.
          required: true
          schema:
            type: string
          in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenaiUpdateVectorStoreFileRequest'
        required: true
      deprecated: false
    delete:
      responses:
        '200':
          description: >-
            A VectorStoreFileDeleteResponse indicating the deletion status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreFileDeleteResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - VectorIO
      summary: Delete a vector store file.
      description: >-
        Delete a vector store file.

        :param vector_store_id: The ID of the vector store containing the file to
        delete.
                :param file_id: The ID of the file to delete.
                :returns: A VectorStoreFileDeleteResponse indicating the deletion
        status.
      parameters:
        - name: vector_store_id
          description: >-
            The ID of the vector store containing the file to delete.
          required: true
          schema:
            type: string
          in: path
        - name: file_id
          description: The ID of the file to delete.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/vector_stores/{vector_store_id}/files/{file_id}/content:
    get:
      responses:
        '200':
          description: >-
            A list of InterleavedContent representing the file contents.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreFileContentsResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - VectorIO
      summary: >-
        Retrieves the contents of a vector store file.
      description: >-
        Retrieves the contents of a vector store file.

        :param vector_store_id: The ID of the vector store containing the file to
        retrieve.
                :param file_id: The ID of the file to retrieve.
                :returns: A list of InterleavedContent representing the file contents.
      parameters:
        - name: vector_store_id
          description: >-
            The ID of the vector store containing the file to retrieve.
          required: true
          schema:
            type: string
          in: path
        - name: file_id
          description: The ID of the file to retrieve.
          required: true
          schema:
            type: string
          in: path
      deprecated: false
  /v1/vector_stores/{vector_store_id}/search:
    post:
      responses:
        '200':
          description: >-
            A VectorStoreSearchResponse containing the search results.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreSearchResponsePage'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - VectorIO
      summary: Search for chunks in a vector store.
      description: >-
        Search for chunks in a vector store.

        Searches a vector store for relevant chunks based on a query and optional
        file attribute filters.

                :param vector_store_id: The ID of the vector store to search.
                :param query: The query string or array for performing the search.
                :param filters: Filters based on file attributes to narrow the search
        results.
                :param max_num_results: Maximum number of results to return (1 to
        50 inclusive, default 10).
                :param ranking_options: Ranking options for fine-tuning the search
        results.
                :param rewrite_query: Whether to rewrite the natural language query
        for vector search (default false)
                :param search_mode: The search mode to use - "keyword", "vector",
        or "hybrid" (default "vector")
                :returns: A VectorStoreSearchResponse containing the search results.
      parameters:
        - name: vector_store_id
          description: The ID of the vector store to search.
          required: true
          schema:
            type: string
          in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenaiSearchVectorStoreRequest'
        required: true
      deprecated: false
  /v1/version:
    get:
      responses:
        '200':
          description: >-
            Version information containing the service version number.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VersionInfo'
        '400':
          $ref: '#/components/responses/BadRequest400'
        '429':
          $ref: >-
            #/components/responses/TooManyRequests429
        '500':
          $ref: >-
            #/components/responses/InternalServerError500
        default:
          $ref: '#/components/responses/DefaultError'
      tags:
        - Inspect
      summary: Get version.
      description: >-
        Get version.

        Get the version of the service.

                :returns: Version information containing the service version number.
      parameters: []
      deprecated: false
  /v1beta/datasetio/append-rows/{dataset_id}:
    post:
      tags:
      - V1Beta
      summary: Append rows to a dataset.
      description: Generic endpoint - this would be replaced with actual implementation.
      operationId: append_rows_v1beta_datasetio_append_rows__dataset_id__post
      parameters:
      - name: args
        in: query
        required: true
        schema:
          title: Args
      - name: kwargs
        in: query
        required: true
        schema:
          title: Kwargs
      - name: dataset_id
        in: path
        required: true
        schema:
          type: string
        description: 'Path parameter: dataset_id'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1beta/datasetio/iterrows/{dataset_id}:
    get:
      tags:
      - V1Beta
      summary: Get a paginated list of rows from a dataset.
      description: Query endpoint for proper schema generation.
      operationId: iterrows_v1beta_datasetio_iterrows__dataset_id__get
      parameters:
      - name: limit
        in: query
        required: true
        schema:
          type: integer
          title: Limit
      - name: start_index
        in: query
        required: true
        schema:
          type: integer
          title: Start Index
      - name: dataset_id
        in: path
        required: true
        schema:
          type: string
          title: Dataset Id
      responses:
        '200':
          description: A PaginatedResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1beta/datasets:
    get:
      tags:
      - V1Beta
      summary: List all datasets.
      description: Response-only endpoint for proper schema generation.
      operationId: list_datasets_v1beta_datasets_get
      responses:
        '200':
          description: A ListDatasetsResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListDatasetsResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
    post:
      tags:
      - V1Beta
      summary: Register a new dataset.
      description: Typed endpoint for proper schema generation.
      operationId: register_dataset_v1beta_datasets_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/__main_____datasets_Request'
        required: true
      responses:
        '200':
          description: A Dataset.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dataset'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1beta/datasets/{dataset_id}:
    delete:
      tags:
      - V1Beta
      summary: Unregister a dataset by its ID.
      description: Generic endpoint - this would be replaced with actual implementation.
      operationId: unregister_dataset_v1beta_datasets__dataset_id__delete
      parameters:
      - name: args
        in: query
        required: true
        schema:
          title: Args
      - name: kwargs
        in: query
        required: true
        schema:
          title: Kwargs
      - name: dataset_id
        in: path
        required: true
        schema:
          type: string
        description: 'Path parameter: dataset_id'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    get:
      tags:
      - V1Beta
      summary: Get a dataset by its ID.
      description: Query endpoint for proper schema generation.
      operationId: get_dataset_v1beta_datasets__dataset_id__get
      parameters:
      - name: dataset_id
        in: path
        required: true
        schema:
          type: string
          title: Dataset Id
      responses:
        '200':
          description: A Dataset.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dataset'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1alpha/agents:
    get:
      tags:
      - V1Alpha
      summary: List all agents.
      description: Query endpoint for proper schema generation.
      operationId: list_agents_v1alpha_agents_get
      parameters:
      - name: limit
        in: query
        required: true
        schema:
          type: integer
          title: Limit
      - name: start_index
        in: query
        required: true
        schema:
          type: integer
          title: Start Index
      responses:
        '200':
          description: A PaginatedResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    post:
      tags:
      - V1Alpha
      summary: Create an agent with the given configuration.
      description: Typed endpoint for proper schema generation.
      operationId: create_agent_v1alpha_agents_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentConfig'
      responses:
        '200':
          description: An AgentCreateResponse with the agent ID.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentCreateResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1alpha/agents/{agent_id}:
    delete:
      tags:
      - V1Alpha
      summary: Delete an agent by its ID and its associated sessions and turns.
      description: Generic endpoint - this would be replaced with actual implementation.
      operationId: delete_agent_v1alpha_agents__agent_id__delete
      parameters:
      - name: args
        in: query
        required: true
        schema:
          title: Args
      - name: kwargs
        in: query
        required: true
        schema:
          title: Kwargs
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the agent to delete.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    get:
      tags:
      - V1Alpha
      summary: Describe an agent by its ID.
      description: Query endpoint for proper schema generation.
      operationId: get_agent_v1alpha_agents__agent_id__get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
        description: ID of the agent.
      responses:
        '200':
          description: An Agent of the agent.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Agent'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1alpha/agents/{agent_id}/session:
    post:
      tags:
      - V1Alpha
      summary: Create a new session for an agent.
      description: Typed endpoint for proper schema generation.
      operationId: create_agent_session_v1alpha_agents__agent_id__session_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/__main_____agents_agent_id_session_Request'
        required: true
      responses:
        '200':
          description: An AgentSessionCreateResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentSessionCreateResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the agent to create the session for.
  /v1alpha/agents/{agent_id}/session/{session_id}:
    delete:
      tags:
      - V1Alpha
      summary: Delete an agent session by its ID and its associated turns.
      description: Generic endpoint - this would be replaced with actual implementation.
      operationId: delete_agents_session_v1alpha_agents__agent_id__session__session_id__delete
      parameters:
      - name: args
        in: query
        required: true
        schema:
          title: Args
      - name: kwargs
        in: query
        required: true
        schema:
          title: Kwargs
      - name: session_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the session to delete.
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the agent to delete the session for.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    get:
      tags:
      - V1Alpha
      summary: Retrieve an agent session by its ID.
      description: Query endpoint for proper schema generation.
      operationId: get_agents_session_v1alpha_agents__agent_id__session__session_id__get
      parameters:
      - name: turn_ids
        in: query
        required: true
        schema:
          type: string
          title: Turn Ids
      - name: session_id
        in: path
        required: true
        schema:
          type: string
          title: Session Id
        description: The ID of the session to get.
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
        description: The ID of the agent to get the session for.
      responses:
        '200':
          description: A Session.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Session'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1alpha/agents/{agent_id}/session/{session_id}/turn:
    post:
      tags:
      - V1Alpha
      summary: Create a new turn for an agent.
      description: Typed endpoint for proper schema generation.
      operationId: create_agent_turn_v1alpha_agents__agent_id__session__session_id__turn_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/__main_____agents_agent_id_session_session_id_turn_Request'
        required: true
      responses:
        '200':
          description: If stream=False, returns a Turn object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Turn'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the agent to create the turn for.
      - name: session_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the session to create the turn for.
  /v1alpha/agents/{agent_id}/session/{session_id}/turn/{turn_id}:
    get:
      tags:
      - V1Alpha
      summary: Retrieve an agent turn by its ID.
      description: Query endpoint for proper schema generation.
      operationId: get_agents_turn_v1alpha_agents__agent_id__session__session_id__turn__turn_id__get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
        description: The ID of the agent to get the turn for.
      - name: session_id
        in: path
        required: true
        schema:
          type: string
          title: Session Id
        description: The ID of the session to get the turn for.
      - name: turn_id
        in: path
        required: true
        schema:
          type: string
          title: Turn Id
        description: The ID of the turn to get.
      responses:
        '200':
          description: A Turn.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Turn'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1alpha/agents/{agent_id}/session/{session_id}/turn/{turn_id}/resume:
    post:
      tags:
      - V1Alpha
      summary: Resume an agent turn with executed tool call responses.
      description: Typed endpoint for proper schema generation.
      operationId: resume_agent_turn_v1alpha_agents__agent_id__session__session_id__turn__turn_id__resume_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/__main_____agents_agent_id_session_session_id_turn_turn_id_resume_Request'
        required: true
      responses:
        '200':
          description: A Turn object if stream is False, otherwise an AsyncIterator of AgentTurnResponseStreamChunk objects.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Turn'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the agent to resume.
      - name: session_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the session to resume.
      - name: turn_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the turn to resume.
  /v1alpha/agents/{agent_id}/session/{session_id}/turn/{turn_id}/step/{step_id}:
    get:
      tags:
      - V1Alpha
      summary: Retrieve an agent step by its ID.
      description: Query endpoint for proper schema generation.
      operationId: get_agents_step_v1alpha_agents__agent_id__session__session_id__turn__turn_id__step__step_id__get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
        description: The ID of the agent to get the step for.
      - name: session_id
        in: path
        required: true
        schema:
          type: string
          title: Session Id
        description: The ID of the session to get the step for.
      - name: turn_id
        in: path
        required: true
        schema:
          type: string
          title: Turn Id
        description: The ID of the turn to get the step for.
      - name: step_id
        in: path
        required: true
        schema:
          type: string
          title: Step Id
        description: The ID of the step to get.
      responses:
        '200':
          description: An AgentStepResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentStepResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1alpha/agents/{agent_id}/sessions:
    get:
      tags:
      - V1Alpha
      summary: List all session(s) of a given agent.
      description: Query endpoint for proper schema generation.
      operationId: list_agent_sessions_v1alpha_agents__agent_id__sessions_get
      parameters:
      - name: limit
        in: query
        required: true
        schema:
          type: integer
          title: Limit
      - name: start_index
        in: query
        required: true
        schema:
          type: integer
          title: Start Index
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
        description: The ID of the agent to list sessions for.
      responses:
        '200':
          description: A PaginatedResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1alpha/eval/benchmarks:
    get:
      tags:
      - V1Alpha
      summary: List all benchmarks.
      description: Response-only endpoint for proper schema generation.
      operationId: list_benchmarks_v1alpha_eval_benchmarks_get
      responses:
        '200':
          description: A ListBenchmarksResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListBenchmarksResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    post:
      tags:
      - V1Alpha
      summary: Register a benchmark.
      description: Generic endpoint - this would be replaced with actual implementation.
      operationId: register_benchmark_v1alpha_eval_benchmarks_post
      parameters:
      - name: args
        in: query
        required: true
        schema:
          title: Args
      - name: kwargs
        in: query
        required: true
        schema:
          title: Kwargs
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1alpha/eval/benchmarks/{benchmark_id}:
    delete:
      tags:
      - V1Alpha
      summary: Unregister a benchmark.
      description: Generic endpoint - this would be replaced with actual implementation.
      operationId: unregister_benchmark_v1alpha_eval_benchmarks__benchmark_id__delete
      parameters:
      - name: args
        in: query
        required: true
        schema:
          title: Args
      - name: kwargs
        in: query
        required: true
        schema:
          title: Kwargs
      - name: benchmark_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the benchmark to unregister.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    get:
      tags:
      - V1Alpha
      summary: Get a benchmark by its ID.
      description: Query endpoint for proper schema generation.
      operationId: get_benchmark_v1alpha_eval_benchmarks__benchmark_id__get
      parameters:
      - name: benchmark_id
        in: path
        required: true
        schema:
          type: string
          title: Benchmark Id
        description: The ID of the benchmark to get.
      responses:
        '200':
          description: A Benchmark.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Benchmark'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1alpha/eval/benchmarks/{benchmark_id}/evaluations:
    post:
      tags:
      - V1Alpha
      summary: Evaluate a list of rows on a benchmark.
      description: Typed endpoint for proper schema generation.
      operationId: evaluate_rows_v1alpha_eval_benchmarks__benchmark_id__evaluations_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BenchmarkConfig'
        required: true
      responses:
        '200':
          description: EvaluateResponse object containing generations and scores.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EvaluateResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
      parameters:
      - name: benchmark_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the benchmark to run the evaluation on.
  /v1alpha/eval/benchmarks/{benchmark_id}/jobs:
    post:
      tags:
      - V1Alpha
      summary: Run an evaluation on a benchmark.
      description: Typed endpoint for proper schema generation.
      operationId: run_eval_v1alpha_eval_benchmarks__benchmark_id__jobs_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BenchmarkConfig'
        required: true
      responses:
        '200':
          description: The job that was created to run the evaluation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Job'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
      parameters:
      - name: benchmark_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the benchmark to run the evaluation on.
  /v1alpha/eval/benchmarks/{benchmark_id}/jobs/{job_id}:
    delete:
      tags:
      - V1Alpha
      summary: Cancel a job.
      description: Generic endpoint - this would be replaced with actual implementation.
      operationId: job_cancel_v1alpha_eval_benchmarks__benchmark_id__jobs__job_id__delete
      parameters:
      - name: args
        in: query
        required: true
        schema:
          title: Args
      - name: kwargs
        in: query
        required: true
        schema:
          title: Kwargs
      - name: benchmark_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the benchmark to run the evaluation on.
      - name: job_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the job to cancel.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    get:
      tags:
      - V1Alpha
      summary: Get the status of a job.
      description: Query endpoint for proper schema generation.
      operationId: job_status_v1alpha_eval_benchmarks__benchmark_id__jobs__job_id__get
      parameters:
      - name: benchmark_id
        in: path
        required: true
        schema:
          type: string
          title: Benchmark Id
        description: The ID of the benchmark to run the evaluation on.
      - name: job_id
        in: path
        required: true
        schema:
          type: string
          title: Job Id
        description: The ID of the job to get the status of.
      responses:
        '200':
          description: The status of the evaluation job.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Job'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1alpha/eval/benchmarks/{benchmark_id}/jobs/{job_id}/result:
    get:
      tags:
      - V1Alpha
      summary: Get the result of a job.
      description: Query endpoint for proper schema generation.
      operationId: job_result_v1alpha_eval_benchmarks__benchmark_id__jobs__job_id__result_get
      parameters:
      - name: benchmark_id
        in: path
        required: true
        schema:
          type: string
          title: Benchmark Id
        description: The ID of the benchmark to run the evaluation on.
      - name: job_id
        in: path
        required: true
        schema:
          type: string
          title: Job Id
        description: The ID of the job to get the result of.
      responses:
        '200':
          description: The result of the job.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EvaluateResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1alpha/inference/rerank:
    post:
      tags:
      - V1Alpha
      summary: Rerank a list of documents based on their relevance to a query.
      description: Typed endpoint for proper schema generation.
      operationId: rerank_v1alpha_inference_rerank_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_inference_rerank_Request'
        required: true
      responses:
        '200':
          description: RerankResponse with indices sorted by relevance score (descending).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RerankResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1alpha/post-training/job/artifacts:
    get:
      tags:
      - V1Alpha
      summary: Get the artifacts of a training job.
      description: Query endpoint for proper schema generation.
      operationId: get_training_job_artifacts_v1alpha_post_training_job_artifacts_get
      parameters:
      - name: job_uuid
        in: query
        required: true
        schema:
          type: string
          title: Job Uuid
      responses:
        '200':
          description: A PostTrainingJobArtifactsResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostTrainingJobArtifactsResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1alpha/post-training/job/cancel:
    post:
      tags:
      - V1Alpha
      summary: Cancel a training job.
      description: Generic endpoint - this would be replaced with actual implementation.
      operationId: cancel_training_job_v1alpha_post_training_job_cancel_post
      parameters:
      - name: args
        in: query
        required: true
        schema:
          title: Args
      - name: kwargs
        in: query
        required: true
        schema:
          title: Kwargs
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1alpha/post-training/job/status:
    get:
      tags:
      - V1Alpha
      summary: Get the status of a training job.
      description: Query endpoint for proper schema generation.
      operationId: get_training_job_status_v1alpha_post_training_job_status_get
      parameters:
      - name: job_uuid
        in: query
        required: true
        schema:
          type: string
          title: Job Uuid
      responses:
        '200':
          description: A PostTrainingJobStatusResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostTrainingJobStatusResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1alpha/post-training/jobs:
    get:
      tags:
      - V1Alpha
      summary: Get all training jobs.
      description: Response-only endpoint for proper schema generation.
      operationId: get_training_jobs_v1alpha_post_training_jobs_get
      responses:
        '200':
          description: A ListPostTrainingJobsResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListPostTrainingJobsResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1alpha/post-training/preference-optimize:
    post:
      tags:
      - V1Alpha
      summary: Run preference optimization of a model.
      description: Typed endpoint for proper schema generation.
      operationId: preference_optimize_v1alpha_post_training_preference_optimize_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DPOAlignmentConfig'
        required: true
      responses:
        '200':
          description: A PostTrainingJob.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostTrainingJob'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1alpha/post-training/supervised-fine-tune:
    post:
      tags:
      - V1Alpha
      summary: Run supervised fine-tuning of a model.
      description: Typed endpoint for proper schema generation.
      operationId: supervised_fine_tune_v1alpha_post_training_supervised_fine_tune_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TrainingConfig'
        required: true
      responses:
        '200':
          description: A PostTrainingJob.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostTrainingJob'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1/batches:
    get:
      tags:
      - V1
      summary: List all batches for the current user.
      description: Query endpoint for proper schema generation.
      operationId: list_batches_v1_batches_get
      parameters:
      - name: after
        in: query
        required: true
        schema:
          type: string
          title: After
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 20
          title: Limit
      responses:
        '200':
          description: A list of batch objects.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListBatchesResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    post:
      tags:
      - V1
      summary: Create a new batch for processing multiple API requests.
      description: Typed endpoint for proper schema generation.
      operationId: create_batch_v1_batches_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_batches_Request'
      responses:
        '200':
          description: The created batch object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Batch'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/batches/{batch_id}:
    get:
      tags:
      - V1
      summary: Retrieve information about a specific batch.
      description: Query endpoint for proper schema generation.
      operationId: retrieve_batch_v1_batches__batch_id__get
      parameters:
      - name: batch_id
        in: path
        required: true
        schema:
          type: string
          title: Batch Id
        description: The ID of the batch to retrieve.
      responses:
        '200':
          description: The batch object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Batch'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/batches/{batch_id}/cancel:
    post:
      tags:
      - V1
      summary: Cancel a batch that is in progress.
      description: Typed endpoint for proper schema generation.
      operationId: cancel_batch_v1_batches__batch_id__cancel_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_batches_batch_id_cancel_Request'
        required: true
      responses:
        '200':
          description: The updated batch object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Batch'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
      parameters:
      - name: batch_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the batch to cancel.
  /v1/chat/completions:
    get:
      tags:
      - V1
      summary: List chat completions.
      description: Query endpoint for proper schema generation.
      operationId: list_chat_completions_v1_chat_completions_get
      parameters:
      - name: after
        in: query
        required: true
        schema:
          type: string
          title: After
      - name: model
        in: query
        required: true
        schema:
          type: string
          title: Model
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 20
          title: Limit
      - name: order
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/Order'
          default: desc
      responses:
        '200':
          description: A ListOpenAIChatCompletionResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListOpenAIChatCompletionResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    post:
      tags:
      - V1
      summary: Create chat completions.
      description: Typed endpoint for proper schema generation.
      operationId: openai_chat_completion_v1_chat_completions_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenAIChatCompletionRequestWithExtraBody'
      responses:
        '200':
          description: An OpenAIChatCompletion.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIChatCompletion'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/chat/completions/{completion_id}:
    get:
      tags:
      - V1
      summary: Get chat completion.
      description: Query endpoint for proper schema generation.
      operationId: get_chat_completion_v1_chat_completions__completion_id__get
      parameters:
      - name: completion_id
        in: path
        required: true
        schema:
          type: string
          title: Completion Id
        description: ID of the chat completion.
      responses:
        '200':
          description: A OpenAICompletionWithInputMessages.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAICompletionWithInputMessages'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/completions:
    post:
      tags:
      - V1
      summary: Create completion.
      description: Typed endpoint for proper schema generation.
      operationId: openai_completion_v1_completions_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenAICompletionRequestWithExtraBody'
        required: true
      responses:
        '200':
          description: An OpenAICompletion.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAICompletion'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1/conversations:
    post:
      tags:
      - V1
      summary: Create a conversation.
      description: Typed endpoint for proper schema generation.
      operationId: create_conversation_v1_conversations_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_conversations_Request'
        required: true
      responses:
        '200':
          description: The created conversation object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Conversation'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1/conversations/{conversation_id}:
    delete:
      tags:
      - V1
      summary: Delete a conversation.
      description: Query endpoint for proper schema generation.
      operationId: openai_delete_conversation_v1_conversations__conversation_id__delete
      parameters:
      - name: conversation_id
        in: path
        required: true
        schema:
          type: string
          title: Conversation Id
        description: The conversation identifier.
      responses:
        '200':
          description: The deleted conversation resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationDeletedResource'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    get:
      tags:
      - V1
      summary: Retrieve a conversation.
      description: Query endpoint for proper schema generation.
      operationId: get_conversation_v1_conversations__conversation_id__get
      parameters:
      - name: conversation_id
        in: path
        required: true
        schema:
          type: string
          title: Conversation Id
        description: The conversation identifier.
      responses:
        '200':
          description: The conversation object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Conversation'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    post:
      tags:
      - V1
      summary: Update a conversation.
      description: Typed endpoint for proper schema generation.
      operationId: update_conversation_v1_conversations__conversation_id__post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_conversations_conversation_id_Request'
      responses:
        '200':
          description: The updated conversation object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Conversation'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
      parameters:
      - name: conversation_id
        in: path
        required: true
        schema:
          type: string
        description: The conversation identifier.
  /v1/conversations/{conversation_id}/items:
    get:
      tags:
      - V1
      summary: List items.
      description: Query endpoint for proper schema generation.
      operationId: list_items_v1_conversations__conversation_id__items_get
      parameters:
      - name: after
        in: query
        required: true
        schema:
          type: string
          title: After
      - name: include
        in: query
        required: true
        schema:
          $ref: '#/components/schemas/ConversationItemInclude'
      - name: limit
        in: query
        required: true
        schema:
          type: integer
          title: Limit
      - name: order
        in: query
        required: true
        schema:
          type: string
          title: Order
      - name: conversation_id
        in: path
        required: true
        schema:
          type: string
          title: Conversation Id
        description: The conversation identifier.
      responses:
        '200':
          description: List of conversation items.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationItemList'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    post:
      tags:
      - V1
      summary: Create items.
      description: Typed endpoint for proper schema generation.
      operationId: add_items_v1_conversations__conversation_id__items_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_conversations_conversation_id_items_Request'
      responses:
        '200':
          description: List of created items.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationItemList'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
      parameters:
      - name: conversation_id
        in: path
        required: true
        schema:
          type: string
        description: The conversation identifier.
  /v1/conversations/{conversation_id}/items/{item_id}:
    delete:
      tags:
      - V1
      summary: Delete an item.
      description: Query endpoint for proper schema generation.
      operationId: openai_delete_conversation_item_v1_conversations__conversation_id__items__item_id__delete
      parameters:
      - name: conversation_id
        in: path
        required: true
        schema:
          type: string
          title: Conversation Id
        description: The conversation identifier.
      - name: item_id
        in: path
        required: true
        schema:
          type: string
          title: Item Id
        description: The item identifier.
      responses:
        '200':
          description: The deleted item resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationItemDeletedResource'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    get:
      tags:
      - V1
      summary: Retrieve an item.
      description: Query endpoint for proper schema generation.
      operationId: retrieve_v1_conversations__conversation_id__items__item_id__get
      parameters:
      - name: conversation_id
        in: path
        required: true
        schema:
          type: string
          title: Conversation Id
        description: The conversation identifier.
      - name: item_id
        in: path
        required: true
        schema:
          type: string
          title: Item Id
        description: The item identifier.
      responses:
        '200':
          description: The conversation item.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIResponseMessage'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/embeddings:
    post:
      tags:
      - V1
      summary: Create embeddings.
      description: Typed endpoint for proper schema generation.
      operationId: openai_embeddings_v1_embeddings_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenAIEmbeddingsRequestWithExtraBody'
        required: true
      responses:
        '200':
          description: An OpenAIEmbeddingsResponse containing the embeddings.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIEmbeddingsResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1/files:
    get:
      tags:
      - V1
      summary: List files.
      description: Query endpoint for proper schema generation.
      operationId: openai_list_files_v1_files_get
      parameters:
      - name: after
        in: query
        required: true
        schema:
          type: string
          title: After
      - name: purpose
        in: query
        required: true
        schema:
          $ref: '#/components/schemas/OpenAIFilePurpose'
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 10000
          title: Limit
      - name: order
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/Order'
          default: desc
      responses:
        '200':
          description: An ListOpenAIFileResponse containing the list of files.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListOpenAIFileResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    post:
      tags:
      - V1
      summary: Upload file.
      description: Response-only endpoint for proper schema generation.
      operationId: openai_upload_file_v1_files_post
      responses:
        '200':
          description: An OpenAIFileObject representing the uploaded file.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIFileObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/files/{file_id}:
    delete:
      tags:
      - V1
      summary: Delete file.
      description: Query endpoint for proper schema generation.
      operationId: openai_delete_file_v1_files__file_id__delete
      parameters:
      - name: file_id
        in: path
        required: true
        schema:
          type: string
          title: File Id
        description: The ID of the file to use for this request.
      responses:
        '200':
          description: An OpenAIFileDeleteResponse indicating successful deletion.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIFileDeleteResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    get:
      tags:
      - V1
      summary: Retrieve file.
      description: Query endpoint for proper schema generation.
      operationId: openai_retrieve_file_v1_files__file_id__get
      parameters:
      - name: file_id
        in: path
        required: true
        schema:
          type: string
          title: File Id
        description: The ID of the file to use for this request.
      responses:
        '200':
          description: An OpenAIFileObject containing file information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIFileObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/files/{file_id}/content:
    get:
      tags:
      - V1
      summary: Retrieve file content.
      description: Generic endpoint - this would be replaced with actual implementation.
      operationId: openai_retrieve_file_content_v1_files__file_id__content_get
      parameters:
      - name: args
        in: query
        required: true
        schema:
          title: Args
      - name: kwargs
        in: query
        required: true
        schema:
          title: Kwargs
      - name: file_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the file to use for this request.
      responses:
        '200':
          description: The raw file content as a binary response.
          content:
            application/json:
              schema: {}
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/health:
    get:
      tags:
      - V1
      summary: Get health status.
      description: Response-only endpoint for proper schema generation.
      operationId: health_v1_health_get
      responses:
        '200':
          description: Health information indicating if the service is operational.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthInfo'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1/inspect/routes:
    get:
      tags:
      - V1
      summary: List routes.
      description: Response-only endpoint for proper schema generation.
      operationId: list_routes_v1_inspect_routes_get
      responses:
        '200':
          description: Response containing information about all available routes.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListRoutesResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1/models:
    get:
      tags:
      - V1
      summary: List all models.
      description: Response-only endpoint for proper schema generation.
      operationId: list_models_v1_models_get
      responses:
        '200':
          description: A ListModelsResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListModelsResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
    post:
      tags:
      - V1
      summary: Register model.
      description: Typed endpoint for proper schema generation.
      operationId: register_model_v1_models_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_models_Request'
        required: true
      responses:
        '200':
          description: A Model.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Model'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1/models/{model_id}:
    delete:
      tags:
      - V1
      summary: Unregister model.
      description: Generic endpoint - this would be replaced with actual implementation.
      operationId: unregister_model_v1_models__model_id__delete
      parameters:
      - name: args
        in: query
        required: true
        schema:
          title: Args
      - name: kwargs
        in: query
        required: true
        schema:
          title: Kwargs
      - name: model_id
        in: path
        required: true
        schema:
          type: string
        description: 'Path parameter: model_id'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    get:
      tags:
      - V1
      summary: Get model.
      description: Query endpoint for proper schema generation.
      operationId: get_model_v1_models__model_id__get
      parameters:
      - name: model_id
        in: path
        required: true
        schema:
          type: string
          title: Model Id
      responses:
        '200':
          description: A Model.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Model'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/moderations:
    post:
      tags:
      - V1
      summary: Create moderation.
      description: Typed endpoint for proper schema generation.
      operationId: run_moderation_v1_moderations_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_moderations_Request'
        required: true
      responses:
        '200':
          description: A moderation object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModerationObject'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1/prompts:
    get:
      tags:
      - V1
      summary: List all prompts.
      description: Response-only endpoint for proper schema generation.
      operationId: list_prompts_v1_prompts_get
      responses:
        '200':
          description: A ListPromptsResponse containing all prompts.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListPromptsResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
    post:
      tags:
      - V1
      summary: Create prompt.
      description: Typed endpoint for proper schema generation.
      operationId: create_prompt_v1_prompts_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_prompts_Request'
        required: true
      responses:
        '200':
          description: The created Prompt resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Prompt'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1/prompts/{prompt_id}:
    delete:
      tags:
      - V1
      summary: Delete prompt.
      description: Generic endpoint - this would be replaced with actual implementation.
      operationId: delete_prompt_v1_prompts__prompt_id__delete
      parameters:
      - name: args
        in: query
        required: true
        schema:
          title: Args
      - name: kwargs
        in: query
        required: true
        schema:
          title: Kwargs
      - name: prompt_id
        in: path
        required: true
        schema:
          type: string
        description: The identifier of the prompt to delete.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    get:
      tags:
      - V1
      summary: Get prompt.
      description: Query endpoint for proper schema generation.
      operationId: get_prompt_v1_prompts__prompt_id__get
      parameters:
      - name: version
        in: query
        required: true
        schema:
          type: integer
          title: Version
      - name: prompt_id
        in: path
        required: true
        schema:
          type: string
          title: Prompt Id
        description: The identifier of the prompt to get.
      responses:
        '200':
          description: A Prompt resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Prompt'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    post:
      tags:
      - V1
      summary: Update prompt.
      description: Typed endpoint for proper schema generation.
      operationId: update_prompt_v1_prompts__prompt_id__post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_prompts_prompt_id_Request'
      responses:
        '200':
          description: The updated Prompt resource with incremented version.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Prompt'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
      parameters:
      - name: prompt_id
        in: path
        required: true
        schema:
          type: string
        description: The identifier of the prompt to update.
  /v1/prompts/{prompt_id}/set-default-version:
    post:
      tags:
      - V1
      summary: Set prompt version.
      description: Typed endpoint for proper schema generation.
      operationId: set_default_version_v1_prompts__prompt_id__set_default_version_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_prompts_prompt_id_set_default_version_Request'
        required: true
      responses:
        '200':
          description: The prompt with the specified version now set as default.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Prompt'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
      parameters:
      - name: prompt_id
        in: path
        required: true
        schema:
          type: string
        description: The identifier of the prompt.
  /v1/prompts/{prompt_id}/versions:
    get:
      tags:
      - V1
      summary: List prompt versions.
      description: Query endpoint for proper schema generation.
      operationId: list_prompt_versions_v1_prompts__prompt_id__versions_get
      parameters:
      - name: prompt_id
        in: path
        required: true
        schema:
          type: string
          title: Prompt Id
        description: The identifier of the prompt to list versions for.
      responses:
        '200':
          description: A ListPromptsResponse containing all versions of the prompt.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListPromptsResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/providers:
    get:
      tags:
      - V1
      summary: List providers.
      description: Response-only endpoint for proper schema generation.
      operationId: list_providers_v1_providers_get
      responses:
        '200':
          description: A ListProvidersResponse containing information about all providers.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListProvidersResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1/providers/{provider_id}:
    get:
      tags:
      - V1
      summary: Get provider.
      description: Query endpoint for proper schema generation.
      operationId: inspect_provider_v1_providers__provider_id__get
      parameters:
      - name: provider_id
        in: path
        required: true
        schema:
          type: string
          title: Provider Id
        description: The ID of the provider to inspect.
      responses:
        '200':
          description: A ProviderInfo object containing the provider's details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProviderInfo'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/responses:
    get:
      tags:
      - V1
      summary: List all responses.
      description: Query endpoint for proper schema generation.
      operationId: list_openai_responses_v1_responses_get
      parameters:
      - name: after
        in: query
        required: true
        schema:
          type: string
          title: After
      - name: model
        in: query
        required: true
        schema:
          type: string
          title: Model
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 50
          title: Limit
      - name: order
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/Order'
          default: desc
      responses:
        '200':
          description: A ListOpenAIResponseObject.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListOpenAIResponseObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    post:
      tags:
      - V1
      summary: Create a model response.
      description: Typed endpoint for proper schema generation.
      operationId: create_openai_response_v1_responses_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_responses_Request'
      responses:
        '200':
          description: An OpenAIResponseObject.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIResponseObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/responses/{response_id}:
    delete:
      tags:
      - V1
      summary: Delete a response.
      description: Query endpoint for proper schema generation.
      operationId: delete_openai_response_v1_responses__response_id__delete
      parameters:
      - name: response_id
        in: path
        required: true
        schema:
          type: string
          title: Response Id
        description: The ID of the OpenAI response to delete.
      responses:
        '200':
          description: An OpenAIDeleteResponseObject
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIDeleteResponseObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    get:
      tags:
      - V1
      summary: Get a model response.
      description: Query endpoint for proper schema generation.
      operationId: get_openai_response_v1_responses__response_id__get
      parameters:
      - name: response_id
        in: path
        required: true
        schema:
          type: string
          title: Response Id
        description: The ID of the OpenAI response to retrieve.
      responses:
        '200':
          description: An OpenAIResponseObject.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIResponseObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/responses/{response_id}/input_items:
    get:
      tags:
      - V1
      summary: List input items.
      description: Query endpoint for proper schema generation.
      operationId: list_openai_response_input_items_v1_responses__response_id__input_items_get
      parameters:
      - name: after
        in: query
        required: true
        schema:
          type: string
          title: After
      - name: before
        in: query
        required: true
        schema:
          type: string
          title: Before
      - name: include
        in: query
        required: true
        schema:
          type: string
          title: Include
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 20
          title: Limit
      - name: order
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/Order'
          default: desc
      - name: response_id
        in: path
        required: true
        schema:
          type: string
          title: Response Id
        description: The ID of the response to retrieve input items for.
      responses:
        '200':
          description: An ListOpenAIResponseInputItem.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListOpenAIResponseInputItem'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/safety/run-shield:
    post:
      tags:
      - V1
      summary: Run shield.
      description: Typed endpoint for proper schema generation.
      operationId: run_shield_v1_safety_run_shield_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_safety_run_shield_Request'
        required: true
      responses:
        '200':
          description: A RunShieldResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RunShieldResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1/scoring-functions:
    get:
      tags:
      - V1
      summary: List all scoring functions.
      description: Response-only endpoint for proper schema generation.
      operationId: list_scoring_functions_v1_scoring_functions_get
      responses:
        '200':
          description: A ListScoringFunctionsResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListScoringFunctionsResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    post:
      tags:
      - V1
      summary: Register a scoring function.
      description: Generic endpoint - this would be replaced with actual implementation.
      operationId: register_scoring_function_v1_scoring_functions_post
      parameters:
      - name: args
        in: query
        required: true
        schema:
          title: Args
      - name: kwargs
        in: query
        required: true
        schema:
          title: Kwargs
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/scoring-functions/{scoring_fn_id}:
    delete:
      tags:
      - V1
      summary: Unregister a scoring function.
      description: Generic endpoint - this would be replaced with actual implementation.
      operationId: unregister_scoring_function_v1_scoring_functions__scoring_fn_id__delete
      parameters:
      - name: args
        in: query
        required: true
        schema:
          title: Args
      - name: kwargs
        in: query
        required: true
        schema:
          title: Kwargs
      - name: scoring_fn_id
        in: path
        required: true
        schema:
          type: string
        description: 'Path parameter: scoring_fn_id'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    get:
      tags:
      - V1
      summary: Get a scoring function by its ID.
      description: Query endpoint for proper schema generation.
      operationId: get_scoring_function_v1_scoring_functions__scoring_fn_id__get
      parameters:
      - name: scoring_fn_id
        in: path
        required: true
        schema:
          type: string
          title: Scoring Fn Id
      responses:
        '200':
          description: A ScoringFn.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScoringFn'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/scoring/score:
    post:
      tags:
      - V1
      summary: Score a list of rows.
      description: Typed endpoint for proper schema generation.
      operationId: score_v1_scoring_score_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_scoring_score_Request'
        required: true
      responses:
        '200':
          description: A ScoreResponse object containing rows and aggregated results.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScoreResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1/scoring/score-batch:
    post:
      tags:
      - V1
      summary: Score a batch of rows.
      description: Typed endpoint for proper schema generation.
      operationId: score_batch_v1_scoring_score_batch_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_scoring_score_batch_Request'
        required: true
      responses:
        '200':
          description: A ScoreBatchResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScoreBatchResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1/shields:
    get:
      tags:
      - V1
      summary: List all shields.
      description: Response-only endpoint for proper schema generation.
      operationId: list_shields_v1_shields_get
      responses:
        '200':
          description: A ListShieldsResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListShieldsResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
    post:
      tags:
      - V1
      summary: Register a shield.
      description: Typed endpoint for proper schema generation.
      operationId: register_shield_v1_shields_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_shields_Request'
        required: true
      responses:
        '200':
          description: A Shield.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Shield'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1/shields/{identifier}:
    delete:
      tags:
      - V1
      summary: Unregister a shield.
      description: Generic endpoint - this would be replaced with actual implementation.
      operationId: unregister_shield_v1_shields__identifier__delete
      parameters:
      - name: args
        in: query
        required: true
        schema:
          title: Args
      - name: kwargs
        in: query
        required: true
        schema:
          title: Kwargs
      - name: identifier
        in: path
        required: true
        schema:
          type: string
        description: 'Path parameter: identifier'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    get:
      tags:
      - V1
      summary: Get a shield by its identifier.
      description: Query endpoint for proper schema generation.
      operationId: get_shield_v1_shields__identifier__get
      parameters:
      - name: identifier
        in: path
        required: true
        schema:
          type: string
          title: Identifier
      responses:
        '200':
          description: A Shield.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Shield'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/tool-runtime/invoke:
    post:
      tags:
      - V1
      summary: Run a tool with the given arguments.
      description: Typed endpoint for proper schema generation.
      operationId: invoke_tool_v1_tool_runtime_invoke_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_tool_runtime_invoke_Request'
        required: true
      responses:
        '200':
          description: A ToolInvocationResult.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolInvocationResult'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1/tool-runtime/list-tools:
    get:
      tags:
      - V1
      summary: List all tools in the runtime.
      description: Query endpoint for proper schema generation.
      operationId: list_runtime_tools_v1_tool_runtime_list_tools_get
      parameters:
      - name: tool_group_id
        in: query
        required: true
        schema:
          type: string
          title: Tool Group Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/URL'
      responses:
        '200':
          description: A ListToolDefsResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListToolDefsResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/tool-runtime/rag-tool/insert:
    post:
      tags:
      - V1
      summary: Index documents so they can be used by the RAG system.
      description: Generic endpoint - this would be replaced with actual implementation.
      operationId: rag_tool_insert_v1_tool_runtime_rag_tool_insert_post
      parameters:
      - name: args
        in: query
        required: true
        schema:
          title: Args
      - name: kwargs
        in: query
        required: true
        schema:
          title: Kwargs
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/tool-runtime/rag-tool/query:
    post:
      tags:
      - V1
      summary: Query the RAG system for context; typically invoked by the agent.
      description: Typed endpoint for proper schema generation.
      operationId: rag_tool_query_v1_tool_runtime_rag_tool_query_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_tool_runtime_rag_tool_query_Request'
        required: true
      responses:
        '200':
          description: RAGQueryResult containing the retrieved content and metadata
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RAGQueryResult'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1/toolgroups:
    get:
      tags:
      - V1
      summary: List tool groups with optional provider.
      description: Response-only endpoint for proper schema generation.
      operationId: list_tool_groups_v1_toolgroups_get
      responses:
        '200':
          description: A ListToolGroupsResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListToolGroupsResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    post:
      tags:
      - V1
      summary: Register a tool group.
      description: Generic endpoint - this would be replaced with actual implementation.
      operationId: register_tool_group_v1_toolgroups_post
      parameters:
      - name: args
        in: query
        required: true
        schema:
          title: Args
      - name: kwargs
        in: query
        required: true
        schema:
          title: Kwargs
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/toolgroups/{toolgroup_id}:
    delete:
      tags:
      - V1
      summary: Unregister a tool group.
      description: Generic endpoint - this would be replaced with actual implementation.
      operationId: unregister_toolgroup_v1_toolgroups__toolgroup_id__delete
      parameters:
      - name: args
        in: query
        required: true
        schema:
          title: Args
      - name: kwargs
        in: query
        required: true
        schema:
          title: Kwargs
      - name: toolgroup_id
        in: path
        required: true
        schema:
          type: string
        description: 'Path parameter: toolgroup_id'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    get:
      tags:
      - V1
      summary: Get a tool group by its ID.
      description: Query endpoint for proper schema generation.
      operationId: get_tool_group_v1_toolgroups__toolgroup_id__get
      parameters:
      - name: toolgroup_id
        in: path
        required: true
        schema:
          type: string
          title: Toolgroup Id
      responses:
        '200':
          description: A ToolGroup.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolGroup'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/tools:
    get:
      tags:
      - V1
      summary: List tools with optional tool group.
      description: Query endpoint for proper schema generation.
      operationId: list_tools_v1_tools_get
      parameters:
      - name: toolgroup_id
        in: query
        required: true
        schema:
          type: string
          title: Toolgroup Id
      responses:
        '200':
          description: A ListToolDefsResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListToolDefsResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/tools/{tool_name}:
    get:
      tags:
      - V1
      summary: Get a tool by its name.
      description: Query endpoint for proper schema generation.
      operationId: get_tool_v1_tools__tool_name__get
      parameters:
      - name: tool_name
        in: path
        required: true
        schema:
          type: string
          title: Tool Name
      responses:
        '200':
          description: A ToolDef.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolDef'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/vector-io/insert:
    post:
      tags:
      - V1
      summary: Insert chunks into a vector database.
      description: Generic endpoint - this would be replaced with actual implementation.
      operationId: insert_chunks_v1_vector_io_insert_post
      parameters:
      - name: args
        in: query
        required: true
        schema:
          title: Args
      - name: kwargs
        in: query
        required: true
        schema:
          title: Kwargs
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/vector-io/query:
    post:
      tags:
      - V1
      summary: Query chunks from a vector database.
      description: Typed endpoint for proper schema generation.
      operationId: query_chunks_v1_vector_io_query_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_vector_io_query_Request'
        required: true
      responses:
        '200':
          description: A QueryChunksResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueryChunksResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
  /v1/vector_stores:
    get:
      tags:
      - V1
      summary: Returns a list of vector stores.
      description: Query endpoint for proper schema generation.
      operationId: openai_list_vector_stores_v1_vector_stores_get
      parameters:
      - name: after
        in: query
        required: true
        schema:
          type: string
          title: After
      - name: before
        in: query
        required: true
        schema:
          type: string
          title: Before
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 20
          title: Limit
      - name: order
        in: query
        required: false
        schema:
          type: string
          default: desc
          title: Order
      responses:
        '200':
          description: A VectorStoreListResponse containing the list of vector stores.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreListResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    post:
      tags:
      - V1
      summary: Creates a vector store.
      description: Typed endpoint for proper schema generation.
      operationId: openai_create_vector_store_v1_vector_stores_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenAICreateVectorStoreRequestWithExtraBody'
      responses:
        '200':
          description: A VectorStoreObject representing the created vector store.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/vector_stores/{vector_store_id}:
    delete:
      tags:
      - V1
      summary: Delete a vector store.
      description: Query endpoint for proper schema generation.
      operationId: openai_delete_vector_store_v1_vector_stores__vector_store_id__delete
      parameters:
      - name: vector_store_id
        in: path
        required: true
        schema:
          type: string
          title: Vector Store Id
        description: The ID of the vector store to delete.
      responses:
        '200':
          description: A VectorStoreDeleteResponse indicating the deletion status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreDeleteResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    get:
      tags:
      - V1
      summary: Retrieves a vector store.
      description: Query endpoint for proper schema generation.
      operationId: openai_retrieve_vector_store_v1_vector_stores__vector_store_id__get
      parameters:
      - name: vector_store_id
        in: path
        required: true
        schema:
          type: string
          title: Vector Store Id
        description: The ID of the vector store to retrieve.
      responses:
        '200':
          description: A VectorStoreObject representing the vector store.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    post:
      tags:
      - V1
      summary: Updates a vector store.
      description: Typed endpoint for proper schema generation.
      operationId: openai_update_vector_store_v1_vector_stores__vector_store_id__post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_vector_stores_vector_store_id_Request'
      responses:
        '200':
          description: A VectorStoreObject representing the updated vector store.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
      parameters:
      - name: vector_store_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the vector store to update.
  /v1/vector_stores/{vector_store_id}/file_batches:
    post:
      tags:
      - V1
      summary: Create a vector store file batch.
      description: Typed endpoint for proper schema generation.
      operationId: openai_create_vector_store_file_batch_v1_vector_stores__vector_store_id__file_batches_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenAICreateVectorStoreFileBatchRequestWithExtraBody'
        required: true
      responses:
        '200':
          description: A VectorStoreFileBatchObject representing the created file batch.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreFileBatchObject'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
      parameters:
      - name: vector_store_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the vector store to create the file batch for.
  /v1/vector_stores/{vector_store_id}/file_batches/{batch_id}:
    get:
      tags:
      - V1
      summary: Retrieve a vector store file batch.
      description: Query endpoint for proper schema generation.
      operationId: openai_retrieve_vector_store_file_batch_v1_vector_stores__vector_store_id__file_batches__batch_id__get
      parameters:
      - name: batch_id
        in: path
        required: true
        schema:
          type: string
          title: Batch Id
        description: The ID of the file batch to retrieve.
      - name: vector_store_id
        in: path
        required: true
        schema:
          type: string
          title: Vector Store Id
        description: The ID of the vector store containing the file batch.
      responses:
        '200':
          description: A VectorStoreFileBatchObject representing the file batch.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreFileBatchObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/vector_stores/{vector_store_id}/file_batches/{batch_id}/cancel:
    post:
      tags:
      - V1
      summary: Cancels a vector store file batch.
      description: Typed endpoint for proper schema generation.
      operationId: openai_cancel_vector_store_file_batch_v1_vector_stores__vector_store_id__file_batches__batch_id__cancel_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_vector_stores_vector_store_id_file_batches_batch_id_cancel_Request'
        required: true
      responses:
        '200':
          description: A VectorStoreFileBatchObject representing the cancelled file batch.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreFileBatchObject'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
      parameters:
      - name: batch_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the file batch to cancel.
      - name: vector_store_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the vector store containing the file batch.
  /v1/vector_stores/{vector_store_id}/file_batches/{batch_id}/files:
    get:
      tags:
      - V1
      summary: Returns a list of vector store files in a batch.
      description: Query endpoint for proper schema generation.
      operationId: openai_list_files_in_vector_store_file_batch_v1_vector_stores__vector_store_id__file_batches__batch_id__files_get
      parameters:
      - name: after
        in: query
        required: true
        schema:
          type: string
          title: After
      - name: before
        in: query
        required: true
        schema:
          type: string
          title: Before
      - name: filter
        in: query
        required: true
        schema:
          type: string
          title: Filter
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 20
          title: Limit
      - name: order
        in: query
        required: false
        schema:
          type: string
          default: desc
          title: Order
      - name: batch_id
        in: path
        required: true
        schema:
          type: string
          title: Batch Id
        description: The ID of the file batch to list files from.
      - name: vector_store_id
        in: path
        required: true
        schema:
          type: string
          title: Vector Store Id
        description: The ID of the vector store containing the file batch.
      responses:
        '200':
          description: A VectorStoreFilesListInBatchResponse containing the list of files in the batch.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreFilesListInBatchResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/vector_stores/{vector_store_id}/files:
    get:
      tags:
      - V1
      summary: List files in a vector store.
      description: Query endpoint for proper schema generation.
      operationId: openai_list_files_in_vector_store_v1_vector_stores__vector_store_id__files_get
      parameters:
      - name: after
        in: query
        required: true
        schema:
          type: string
          title: After
      - name: before
        in: query
        required: true
        schema:
          type: string
          title: Before
      - name: filter
        in: query
        required: true
        schema:
          type: string
          title: Filter
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 20
          title: Limit
      - name: order
        in: query
        required: false
        schema:
          type: string
          default: desc
          title: Order
      - name: vector_store_id
        in: path
        required: true
        schema:
          type: string
          title: Vector Store Id
        description: The ID of the vector store to list files from.
      responses:
        '200':
          description: A VectorStoreListFilesResponse containing the list of files.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreListFilesResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    post:
      tags:
      - V1
      summary: Attach a file to a vector store.
      description: Typed endpoint for proper schema generation.
      operationId: openai_attach_file_to_vector_store_v1_vector_stores__vector_store_id__files_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_vector_stores_vector_store_id_files_Request'
      responses:
        '200':
          description: A VectorStoreFileObject representing the attached file.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreFileObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
      parameters:
      - name: vector_store_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the vector store to attach the file to.
  /v1/vector_stores/{vector_store_id}/files/{file_id}:
    delete:
      tags:
      - V1
      summary: Delete a vector store file.
      description: Query endpoint for proper schema generation.
      operationId: openai_delete_vector_store_file_v1_vector_stores__vector_store_id__files__file_id__delete
      parameters:
      - name: vector_store_id
        in: path
        required: true
        schema:
          type: string
          title: Vector Store Id
        description: The ID of the vector store containing the file to delete.
      - name: file_id
        in: path
        required: true
        schema:
          type: string
          title: File Id
        description: The ID of the file to delete.
      responses:
        '200':
          description: A VectorStoreFileDeleteResponse indicating the deletion status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreFileDeleteResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    get:
      tags:
      - V1
      summary: Retrieves a vector store file.
      description: Query endpoint for proper schema generation.
      operationId: openai_retrieve_vector_store_file_v1_vector_stores__vector_store_id__files__file_id__get
      parameters:
      - name: vector_store_id
        in: path
        required: true
        schema:
          type: string
          title: Vector Store Id
        description: The ID of the vector store containing the file to retrieve.
      - name: file_id
        in: path
        required: true
        schema:
          type: string
          title: File Id
        description: The ID of the file to retrieve.
      responses:
        '200':
          description: A VectorStoreFileObject representing the file.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreFileObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
    post:
      tags:
      - V1
      summary: Updates a vector store file.
      description: Typed endpoint for proper schema generation.
      operationId: openai_update_vector_store_file_v1_vector_stores__vector_store_id__files__file_id__post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_vector_stores_vector_store_id_files_file_id_Request'
      responses:
        '200':
          description: A VectorStoreFileObject representing the updated file.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreFileObject'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
      parameters:
      - name: vector_store_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the vector store containing the file to update.
      - name: file_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the file to update.
  /v1/vector_stores/{vector_store_id}/files/{file_id}/content:
    get:
      tags:
      - V1
      summary: Retrieves the contents of a vector store file.
      description: Query endpoint for proper schema generation.
      operationId: openai_retrieve_vector_store_file_contents_v1_vector_stores__vector_store_id__files__file_id__content_get
      parameters:
      - name: vector_store_id
        in: path
        required: true
        schema:
          type: string
          title: Vector Store Id
        description: The ID of the vector store containing the file to retrieve.
      - name: file_id
        in: path
        required: true
        schema:
          type: string
          title: File Id
        description: The ID of the file to retrieve.
      responses:
        '200':
          description: A list of InterleavedContent representing the file contents.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreFileContentsResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
  /v1/vector_stores/{vector_store_id}/search:
    post:
      tags:
      - V1
      summary: Search for chunks in a vector store.
      description: Typed endpoint for proper schema generation.
      operationId: openai_search_vector_store_v1_vector_stores__vector_store_id__search_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_vector_stores_vector_store_id_search_Request'
        required: true
      responses:
        '200':
          description: A VectorStoreSearchResponse containing the search results.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStoreSearchResponsePage'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
      parameters:
      - name: vector_store_id
        in: path
        required: true
        schema:
          type: string
        description: The ID of the vector store to search.
  /v1/version:
    get:
      tags:
      - V1
      summary: Get version.
      description: Response-only endpoint for proper schema generation.
      operationId: version_v1_version_get
      responses:
        '200':
          description: Version information containing the service version number.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VersionInfo'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
components:
  schemas:
    AgentCandidate:
      properties:
        type:
          type: string
          const: agent
          title: Type
          default: agent
        config:
          $ref: '#/components/schemas/AgentConfig'
      type: object
      required:
      - config
      title: AgentCandidate
      description: An agent candidate for evaluation.
    AgentConfig:
      properties:
        sampling_params:
          $ref: '#/components/schemas/SamplingParams'
        input_shields:
          title: Input Shields
          items:
            type: string
          type: array
        output_shields:
          title: Output Shields
          items:
            type: string
          type: array
        toolgroups:
          title: Toolgroups
          items:
            anyOf:
            - type: string
            - $ref: '#/components/schemas/AgentToolGroupWithArgs'
          type: array
        client_tools:
          title: Client Tools
          items:
            $ref: '#/components/schemas/ToolDef'
          type: array
        tool_choice:
          deprecated: true
          $ref: '#/components/schemas/ToolChoice'
        tool_prompt_format:
          deprecated: true
          $ref: '#/components/schemas/ToolPromptFormat'
        tool_config:
          $ref: '#/components/schemas/ToolConfig'
        max_infer_iters:
          title: Max Infer Iters
          default: 10
          type: integer
        model:
          type: string
          title: Model
        instructions:
          type: string
          title: Instructions
        name:
          title: Name
          type: string
        enable_session_persistence:
          title: Enable Session Persistence
          default: false
          type: boolean
        response_format:
          title: Response Format
          oneOf:
          - $ref: '#/components/schemas/JsonSchemaResponseFormat'
          - $ref: '#/components/schemas/GrammarResponseFormat'
          discriminator:
            propertyName: type
            mapping:
              grammar: '#/components/schemas/GrammarResponseFormat'
              json_schema: '#/components/schemas/JsonSchemaResponseFormat'
      type: object
      required:
      - model
      - instructions
      title: AgentConfig
      description: Configuration for an agent.
    AgentCreateResponse:
      properties:
        agent_id:
          type: string
          title: Agent Id
      type: object
      required:
      - agent_id
      title: AgentCreateResponse
      description: Response returned when creating a new agent.
    AgentSessionCreateResponse:
      properties:
        session_id:
          type: string
          title: Session Id
      type: object
      required:
      - session_id
      title: AgentSessionCreateResponse
      description: Response returned when creating a new agent session.
    AgentToolGroupWithArgs:
      properties:
        name:
          type: string
          title: Name
        args:
          additionalProperties: true
          type: object
          title: Args
      type: object
      required:
      - name
      - args
      title: AgentToolGroupWithArgs
    AgentTurnInputType:
      properties:
        type:
          type: string
          const: agent_turn_input
          title: Type
          default: agent_turn_input
      type: object
      title: AgentTurnInputType
      description: Parameter type for agent turn input.
    AggregationFunctionType:
      type: string
      enum:
      - average
      - weighted_average
      - median
      - categorical_count
      - accuracy
      title: AggregationFunctionType
      description: Types of aggregation functions for scoring results.
    AllowedToolsFilter:
      properties:
        tool_names:
          title: Tool Names
          items:
            type: string
          type: array
      type: object
      title: AllowedToolsFilter
      description: Filter configuration for restricting which MCP tools can be used.
    ApprovalFilter:
      properties:
        always:
          title: Always
          items:
            type: string
          type: array
        never:
          title: Never
          items:
            type: string
          type: array
      type: object
      title: ApprovalFilter
      description: Filter configuration for MCP tool approval requirements.
    ArrayType:
      properties:
        type:
          type: string
          const: array
          title: Type
          default: array
      type: object
      title: ArrayType
      description: Parameter type for array values.
    Attachment-Output:
      properties:
        content:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Output'
            - $ref: '#/components/schemas/TextContentItem'
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Output'
                text: '#/components/schemas/TextContentItem'
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Output'
              - $ref: '#/components/schemas/TextContentItem'
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Output'
                  text: '#/components/schemas/TextContentItem'
            type: array
          - $ref: '#/components/schemas/URL'
          title: Content
        mime_type:
          type: string
          title: Mime Type
      type: object
      required:
      - content
      - mime_type
      title: Attachment
      description: An attachment to an agent turn.
    BasicScoringFnParams:
      properties:
        type:
          type: string
          const: basic
          title: Type
          default: basic
        aggregation_functions:
          items:
            $ref: '#/components/schemas/AggregationFunctionType'
          type: array
          title: Aggregation Functions
          description: Aggregation functions to apply to the scores of each row
      type: object
      title: BasicScoringFnParams
      description: Parameters for basic scoring function configuration.
    Batch:
      properties:
        id:
          type: string
          title: Id
        completion_window:
          type: string
          title: Completion Window
        created_at:
          type: integer
          title: Created At
        endpoint:
          type: string
          title: Endpoint
        input_file_id:
          type: string
          title: Input File Id
        object:
          type: string
          const: batch
          title: Object
        status:
          type: string
          enum:
          - validating
          - failed
          - in_progress
          - finalizing
          - completed
          - expired
          - cancelling
          - cancelled
          title: Status
        cancelled_at:
          title: Cancelled At
          type: integer
        cancelling_at:
          title: Cancelling At
          type: integer
        completed_at:
          title: Completed At
          type: integer
        error_file_id:
          title: Error File Id
          type: string
        errors:
          $ref: '#/components/schemas/Errors'
        expired_at:
          title: Expired At
          type: integer
        expires_at:
          title: Expires At
          type: integer
        failed_at:
          title: Failed At
          type: integer
        finalizing_at:
          title: Finalizing At
          type: integer
        in_progress_at:
          title: In Progress At
          type: integer
        metadata:
          title: Metadata
          additionalProperties:
            type: string
          type: object
        model:
          title: Model
          type: string
        output_file_id:
          title: Output File Id
          type: string
        request_counts:
          $ref: '#/components/schemas/BatchRequestCounts'
        usage:
          $ref: '#/components/schemas/BatchUsage'
      additionalProperties: true
      type: object
      required:
      - id
      - completion_window
      - created_at
      - endpoint
      - input_file_id
      - object
      - status
      title: Batch
    BatchError:
      properties:
        code:
          title: Code
          type: string
        line:
          title: Line
          type: integer
        message:
          title: Message
          type: string
        param:
          title: Param
          type: string
      additionalProperties: true
      type: object
      title: BatchError
    BatchRequestCounts:
      properties:
        completed:
          type: integer
          title: Completed
        failed:
          type: integer
          title: Failed
        total:
          type: integer
          title: Total
      additionalProperties: true
      type: object
      required:
      - completed
      - failed
      - total
      title: BatchRequestCounts
    BatchUsage:
      properties:
        input_tokens:
          type: integer
          title: Input Tokens
        input_tokens_details:
          $ref: '#/components/schemas/InputTokensDetails'
        output_tokens:
          type: integer
          title: Output Tokens
        output_tokens_details:
          $ref: '#/components/schemas/OutputTokensDetails'
        total_tokens:
          type: integer
          title: Total Tokens
      additionalProperties: true
      type: object
      required:
      - input_tokens
      - input_tokens_details
      - output_tokens
      - output_tokens_details
      - total_tokens
      title: BatchUsage
    Benchmark:
      properties:
        identifier:
          type: string
          title: Identifier
          description: Unique identifier for this resource in llama stack
        provider_resource_id:
          title: Provider Resource Id
          description: Unique identifier for this resource in the provider
          type: string
        provider_id:
          type: string
          title: Provider Id
          description: ID of the provider that owns this resource
        type:
          type: string
          const: benchmark
          title: Type
          default: benchmark
        dataset_id:
          type: string
          title: Dataset Id
        scoring_functions:
          items:
            type: string
          type: array
          title: Scoring Functions
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
          description: Metadata for this evaluation task
      type: object
      required:
      - identifier
      - provider_id
      - dataset_id
      - scoring_functions
      title: Benchmark
      description: A benchmark resource for evaluating model performance.
    BenchmarkConfig:
      properties:
        eval_candidate:
          oneOf:
          - $ref: '#/components/schemas/ModelCandidate'
          - $ref: '#/components/schemas/AgentCandidate'
          title: Eval Candidate
          discriminator:
            propertyName: type
            mapping:
              agent: '#/components/schemas/AgentCandidate'
              model: '#/components/schemas/ModelCandidate'
        scoring_params:
          additionalProperties:
            oneOf:
            - $ref: '#/components/schemas/LLMAsJudgeScoringFnParams'
            - $ref: '#/components/schemas/RegexParserScoringFnParams'
            - $ref: '#/components/schemas/BasicScoringFnParams'
            discriminator:
              propertyName: type
              mapping:
                basic: '#/components/schemas/BasicScoringFnParams'
                llm_as_judge: '#/components/schemas/LLMAsJudgeScoringFnParams'
                regex_parser: '#/components/schemas/RegexParserScoringFnParams'
          type: object
          title: Scoring Params
          description: Map between scoring function id and parameters for each scoring function you want to run
        num_examples:
          title: Num Examples
          description: Number of examples to evaluate (useful for testing), if not provided, all examples in the dataset will be evaluated
          type: integer
      type: object
      required:
      - eval_candidate
      title: BenchmarkConfig
      description: A benchmark configuration for evaluation.
    BooleanType:
      properties:
        type:
          type: string
          const: boolean
          title: Type
          default: boolean
      type: object
      title: BooleanType
      description: Parameter type for boolean values.
    BuiltinTool:
      type: string
      enum:
      - brave_search
      - wolfram_alpha
      - photogen
      - code_interpreter
      title: BuiltinTool
    ChatCompletionInputType:
      properties:
        type:
          type: string
          const: chat_completion_input
          title: Type
          default: chat_completion_input
      type: object
      title: ChatCompletionInputType
      description: Parameter type for chat completion input.
    Chunk-Output:
      properties:
        content:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Output'
            - $ref: '#/components/schemas/TextContentItem'
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Output'
                text: '#/components/schemas/TextContentItem'
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Output'
              - $ref: '#/components/schemas/TextContentItem'
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Output'
                  text: '#/components/schemas/TextContentItem'
            type: array
          title: Content
        chunk_id:
          type: string
          title: Chunk Id
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
        embedding:
          title: Embedding
          items:
            type: number
          type: array
        chunk_metadata:
          $ref: '#/components/schemas/ChunkMetadata'
      type: object
      required:
      - content
      - chunk_id
      title: Chunk
      description: A chunk of content that can be inserted into a vector database.
    ChunkMetadata:
      properties:
        chunk_id:
          title: Chunk Id
          type: string
        document_id:
          title: Document Id
          type: string
        source:
          title: Source
          type: string
        created_timestamp:
          title: Created Timestamp
          type: integer
        updated_timestamp:
          title: Updated Timestamp
          type: integer
        chunk_window:
          title: Chunk Window
          type: string
        chunk_tokenizer:
          title: Chunk Tokenizer
          type: string
        chunk_embedding_model:
          title: Chunk Embedding Model
          type: string
        chunk_embedding_dimension:
          title: Chunk Embedding Dimension
          type: integer
        content_token_count:
          title: Content Token Count
          type: integer
        metadata_token_count:
          title: Metadata Token Count
          type: integer
      type: object
      title: ChunkMetadata
      description: "`ChunkMetadata` is backend metadata for a `Chunk` that is used to store additional information about the chunk that\n    will not be used in the context during inference, but is required for backend functionality. The `ChunkMetadata`\n    is set during chunk creation in `MemoryToolRuntimeImpl().insert()`and is not expected to change after.\n    Use `Chunk.metadata` for metadata that will be used in the context during inference."
    CompletionInputType:
      properties:
        type:
          type: string
          const: completion_input
          title: Type
          default: completion_input
      type: object
      title: CompletionInputType
      description: Parameter type for completion input.
    CompletionMessage-Output:
      properties:
        role:
          type: string
          const: assistant
          title: Role
          default: assistant
        content:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Output'
            - $ref: '#/components/schemas/TextContentItem'
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Output'
                text: '#/components/schemas/TextContentItem'
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Output'
              - $ref: '#/components/schemas/TextContentItem'
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Output'
                  text: '#/components/schemas/TextContentItem'
            type: array
          title: Content
        stop_reason:
          $ref: '#/components/schemas/StopReason'
        tool_calls:
          title: Tool Calls
          items:
            $ref: '#/components/schemas/ToolCall'
          type: array
      type: object
      required:
      - content
      - stop_reason
      title: CompletionMessage
      description: A message containing the model's (assistant) response in a chat conversation.
    Conversation:
      properties:
        id:
          type: string
          title: Id
          description: The unique ID of the conversation.
        object:
          type: string
          const: conversation
          title: Object
          description: The object type, which is always conversation.
          default: conversation
        created_at:
          type: integer
          title: Created At
          description: The time at which the conversation was created, measured in seconds since the Unix epoch.
        metadata:
          title: Metadata
          description: Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard.
          additionalProperties:
            type: string
          type: object
        items:
          title: Items
          description: Initial items to include in the conversation context. You may add up to 20 items at a time.
          items:
            additionalProperties: true
            type: object
          type: array
      type: object
      required:
      - id
      - created_at
      title: Conversation
      description: OpenAI-compatible conversation object.
    ConversationItemInclude:
      type: string
      enum:
      - web_search_call.action.sources
      - code_interpreter_call.outputs
      - computer_call_output.output.image_url
      - file_search_call.results
      - message.input_image.image_url
      - message.output_text.logprobs
      - reasoning.encrypted_content
      title: ConversationItemInclude
      description: Specify additional output data to include in the model response.
    ConversationItemList:
      properties:
        object:
          type: string
          title: Object
          description: Object type
          default: list
        data:
          items:
            oneOf:
            - $ref: '#/components/schemas/OpenAIResponseMessage-Output'
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
            - $ref: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
            - $ref: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
            - $ref: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
            discriminator:
              propertyName: type
              mapping:
                file_search_call: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
                function_call: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
                function_call_output: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
                mcp_approval_request: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
                mcp_approval_response: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
                mcp_call: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
                mcp_list_tools: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
                message: '#/components/schemas/OpenAIResponseMessage-Output'
                web_search_call: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
          type: array
          title: Data
          description: List of conversation items
        first_id:
          title: First Id
          description: The ID of the first item in the list
          type: string
        last_id:
          title: Last Id
          description: The ID of the last item in the list
          type: string
        has_more:
          type: boolean
          title: Has More
          description: Whether there are more items available
          default: false
      type: object
      required:
      - data
      title: ConversationItemList
      description: List of conversation items with pagination.
    DPOAlignmentConfig:
      properties:
        beta:
          type: number
          title: Beta
        loss_type:
          $ref: '#/components/schemas/DPOLossType'
          default: sigmoid
      type: object
      required:
      - beta
      title: DPOAlignmentConfig
      description: Configuration for Direct Preference Optimization (DPO) alignment.
    DPOLossType:
      type: string
      enum:
      - sigmoid
      - hinge
      - ipo
      - kto_pair
      title: DPOLossType
    DataConfig:
      properties:
        dataset_id:
          type: string
          title: Dataset Id
        batch_size:
          type: integer
          title: Batch Size
        shuffle:
          type: boolean
          title: Shuffle
        data_format:
          $ref: '#/components/schemas/DatasetFormat'
        validation_dataset_id:
          title: Validation Dataset Id
          type: string
        packed:
          title: Packed
          default: false
          type: boolean
        train_on_input:
          title: Train On Input
          default: false
          type: boolean
      type: object
      required:
      - dataset_id
      - batch_size
      - shuffle
      - data_format
      title: DataConfig
      description: Configuration for training data and data loading.
    Dataset:
      properties:
        identifier:
          type: string
          title: Identifier
          description: Unique identifier for this resource in llama stack
        provider_resource_id:
          title: Provider Resource Id
          description: Unique identifier for this resource in the provider
          type: string
        provider_id:
          type: string
          title: Provider Id
          description: ID of the provider that owns this resource
        type:
          type: string
          const: dataset
          title: Type
          default: dataset
        purpose:
          $ref: '#/components/schemas/DatasetPurpose'
        source:
          oneOf:
          - $ref: '#/components/schemas/URIDataSource'
          - $ref: '#/components/schemas/RowsDataSource'
          title: Source
          discriminator:
            propertyName: type
            mapping:
              rows: '#/components/schemas/RowsDataSource'
              uri: '#/components/schemas/URIDataSource'
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
          description: Any additional metadata for this dataset
      type: object
      required:
      - identifier
      - provider_id
      - purpose
      - source
      title: Dataset
      description: Dataset resource for storing and accessing training or evaluation data.
    DatasetFormat:
      type: string
      enum:
      - instruct
      - dialog
      title: DatasetFormat
      description: Format of the training dataset.
    DatasetPurpose:
      type: string
      enum:
      - post-training/messages
      - eval/question-answer
      - eval/messages-answer
      title: DatasetPurpose
      description: Purpose of the dataset. Each purpose has a required input data schema.
    DefaultRAGQueryGeneratorConfig:
      properties:
        type:
          type: string
          const: default
          title: Type
          default: default
        separator:
          type: string
          title: Separator
          default: ' '
      type: object
      title: DefaultRAGQueryGeneratorConfig
      description: Configuration for the default RAG query generator.
    Document:
      properties:
        content:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Input'
            - $ref: '#/components/schemas/TextContentItem'
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Input'
                text: '#/components/schemas/TextContentItem'
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Input'
              - $ref: '#/components/schemas/TextContentItem'
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Input'
                  text: '#/components/schemas/TextContentItem'
            type: array
          - $ref: '#/components/schemas/URL'
          title: Content
        mime_type:
          type: string
          title: Mime Type
      type: object
      required:
      - content
      - mime_type
      title: Document
      description: A document to be used by an agent.
    EfficiencyConfig:
      properties:
        enable_activation_checkpointing:
          title: Enable Activation Checkpointing
          default: false
          type: boolean
        enable_activation_offloading:
          title: Enable Activation Offloading
          default: false
          type: boolean
        memory_efficient_fsdp_wrap:
          title: Memory Efficient Fsdp Wrap
          default: false
          type: boolean
        fsdp_cpu_offload:
          title: Fsdp Cpu Offload
          default: false
          type: boolean
      type: object
      title: EfficiencyConfig
      description: Configuration for memory and compute efficiency optimizations.
    Errors:
      properties:
        data:
          title: Data
          items:
            $ref: '#/components/schemas/BatchError'
          type: array
        object:
          title: Object
          type: string
      additionalProperties: true
      type: object
      title: Errors
    EvaluateResponse:
      properties:
        generations:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Generations
        scores:
          additionalProperties:
            $ref: '#/components/schemas/ScoringResult'
          type: object
          title: Scores
      type: object
      required:
      - generations
      - scores
      title: EvaluateResponse
      description: The response from an evaluation.
    GrammarResponseFormat:
      properties:
        type:
          type: string
          const: grammar
          title: Type
          default: grammar
        bnf:
          additionalProperties: true
          type: object
          title: Bnf
      type: object
      required:
      - bnf
      title: GrammarResponseFormat
      description: Configuration for grammar-guided response generation.
    GreedySamplingStrategy:
      properties:
        type:
          type: string
          const: greedy
          title: Type
          default: greedy
      type: object
      title: GreedySamplingStrategy
      description: Greedy sampling strategy that selects the highest probability token at each step.
    HealthInfo:
      properties:
        status:
          $ref: '#/components/schemas/HealthStatus'
      type: object
      required:
      - status
      title: HealthInfo
      description: Health status information for the service.
    HealthStatus:
      type: string
      enum:
      - OK
      - Error
      - Not Implemented
      title: HealthStatus
    ImageContentItem-Input:
      properties:
        type:
          type: string
          const: image
          title: Type
          default: image
        image:
          $ref: '#/components/schemas/_URLOrData'
      type: object
      required:
      - image
      title: ImageContentItem
      description: A image content item
    ImageContentItem-Output:
      properties:
        type:
          type: string
          const: image
          title: Type
          default: image
        image:
          $ref: '#/components/schemas/_URLOrData'
      type: object
      required:
      - image
      title: ImageContentItem
      description: A image content item
    InferenceStep-Output:
      properties:
        turn_id:
          type: string
          title: Turn Id
        step_id:
          type: string
          title: Step Id
        started_at:
          title: Started At
          type: string
          format: date-time
        completed_at:
          title: Completed At
          type: string
          format: date-time
        step_type:
          type: string
          const: inference
          title: Step Type
          default: inference
        model_response:
          $ref: '#/components/schemas/CompletionMessage-Output'
      type: object
      required:
      - turn_id
      - step_id
      - model_response
      title: InferenceStep
      description: An inference step in an agent turn.
    InputTokensDetails:
      properties:
        cached_tokens:
          type: integer
          title: Cached Tokens
      additionalProperties: true
      type: object
      required:
      - cached_tokens
      title: InputTokensDetails
    Job:
      properties:
        job_id:
          type: string
          title: Job Id
        status:
          $ref: '#/components/schemas/JobStatus'
      type: object
      required:
      - job_id
      - status
      title: Job
      description: A job execution instance with status tracking.
    JobStatus:
      type: string
      enum:
      - completed
      - in_progress
      - failed
      - scheduled
      - cancelled
      title: JobStatus
      description: Status of a job execution.
    JsonSchemaResponseFormat:
      properties:
        type:
          type: string
          const: json_schema
          title: Type
          default: json_schema
        json_schema:
          additionalProperties: true
          type: object
          title: Json Schema
      type: object
      required:
      - json_schema
      title: JsonSchemaResponseFormat
      description: Configuration for JSON schema-guided response generation.
    JsonType:
      properties:
        type:
          type: string
          const: json
          title: Type
          default: json
      type: object
      title: JsonType
      description: Parameter type for JSON values.
    LLMAsJudgeScoringFnParams:
      properties:
        type:
          type: string
          const: llm_as_judge
          title: Type
          default: llm_as_judge
        judge_model:
          type: string
          title: Judge Model
        prompt_template:
          title: Prompt Template
          type: string
        judge_score_regexes:
          items:
            type: string
          type: array
          title: Judge Score Regexes
          description: Regexes to extract the answer from generated response
        aggregation_functions:
          items:
            $ref: '#/components/schemas/AggregationFunctionType'
          type: array
          title: Aggregation Functions
          description: Aggregation functions to apply to the scores of each row
      type: object
      required:
      - judge_model
      title: LLMAsJudgeScoringFnParams
      description: Parameters for LLM-as-judge scoring function configuration.
    LLMRAGQueryGeneratorConfig:
      properties:
        type:
          type: string
          const: llm
          title: Type
          default: llm
        model:
          type: string
          title: Model
        template:
          type: string
          title: Template
      type: object
      required:
      - model
      - template
      title: LLMRAGQueryGeneratorConfig
      description: Configuration for the LLM-based RAG query generator.
    ListBenchmarksResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/Benchmark'
          type: array
          title: Data
      type: object
      required:
      - data
      title: ListBenchmarksResponse
    ListDatasetsResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/Dataset'
          type: array
          title: Data
      type: object
      required:
      - data
      title: ListDatasetsResponse
      description: Response from listing datasets.
    ListModelsResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/Model'
          type: array
          title: Data
      type: object
      required:
      - data
      title: ListModelsResponse
    ListPostTrainingJobsResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/PostTrainingJob'
          type: array
          title: Data
      type: object
      required:
      - data
      title: ListPostTrainingJobsResponse
    ListPromptsResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/Prompt'
          type: array
          title: Data
      type: object
      required:
      - data
      title: ListPromptsResponse
      description: Response model to list prompts.
    ListProvidersResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/ProviderInfo'
          type: array
          title: Data
      type: object
      required:
      - data
      title: ListProvidersResponse
      description: Response containing a list of all available providers.
    ListRoutesResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/RouteInfo'
          type: array
          title: Data
      type: object
      required:
      - data
      title: ListRoutesResponse
      description: Response containing a list of all available API routes.
    ListScoringFunctionsResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/ScoringFn-Output'
          type: array
          title: Data
      type: object
      required:
      - data
      title: ListScoringFunctionsResponse
    ListShieldsResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/Shield'
          type: array
          title: Data
      type: object
      required:
      - data
      title: ListShieldsResponse
    ListToolGroupsResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/ToolGroup'
          type: array
          title: Data
      type: object
      required:
      - data
      title: ListToolGroupsResponse
      description: Response containing a list of tool groups.
    MCPListToolsTool:
      properties:
        input_schema:
          additionalProperties: true
          type: object
          title: Input Schema
        name:
          type: string
          title: Name
        description:
          title: Description
          type: string
      type: object
      required:
      - input_schema
      - name
      title: MCPListToolsTool
      description: Tool definition returned by MCP list tools operation.
    MemoryRetrievalStep-Output:
      properties:
        turn_id:
          type: string
          title: Turn Id
        step_id:
          type: string
          title: Step Id
        started_at:
          title: Started At
          type: string
          format: date-time
        completed_at:
          title: Completed At
          type: string
          format: date-time
        step_type:
          type: string
          const: memory_retrieval
          title: Step Type
          default: memory_retrieval
        vector_store_ids:
          type: string
          title: Vector Store Ids
        inserted_context:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Output'
            - $ref: '#/components/schemas/TextContentItem'
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Output'
                text: '#/components/schemas/TextContentItem'
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Output'
              - $ref: '#/components/schemas/TextContentItem'
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Output'
                  text: '#/components/schemas/TextContentItem'
            type: array
          title: Inserted Context
      type: object
      required:
      - turn_id
      - step_id
      - vector_store_ids
      - inserted_context
      title: MemoryRetrievalStep
      description: A memory retrieval step in an agent turn.
    Model:
      properties:
        identifier:
          type: string
          title: Identifier
          description: Unique identifier for this resource in llama stack
        provider_resource_id:
          title: Provider Resource Id
          description: Unique identifier for this resource in the provider
          type: string
        provider_id:
          type: string
          title: Provider Id
          description: ID of the provider that owns this resource
        type:
          type: string
          const: model
          title: Type
          default: model
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
          description: Any additional metadata for this model
        model_type:
          $ref: '#/components/schemas/ModelType'
          default: llm
      type: object
      required:
      - identifier
      - provider_id
      title: Model
      description: A model resource representing an AI model registered in Llama Stack.
    ModelCandidate:
      properties:
        type:
          type: string
          const: model
          title: Type
          default: model
        model:
          type: string
          title: Model
        sampling_params:
          $ref: '#/components/schemas/SamplingParams'
        system_message:
          $ref: '#/components/schemas/SystemMessage'
      type: object
      required:
      - model
      - sampling_params
      title: ModelCandidate
      description: A model candidate for evaluation.
    ModelType:
      type: string
      enum:
      - llm
      - embedding
      - rerank
      title: ModelType
      description: Enumeration of supported model types in Llama Stack.
    ModerationObject:
      properties:
        id:
          type: string
          title: Id
        model:
          type: string
          title: Model
        results:
          items:
            $ref: '#/components/schemas/ModerationObjectResults'
          type: array
          title: Results
      type: object
      required:
      - id
      - model
      - results
      title: ModerationObject
      description: A moderation object.
    ModerationObjectResults:
      properties:
        flagged:
          type: boolean
          title: Flagged
        categories:
          title: Categories
          additionalProperties:
            type: boolean
          type: object
        category_applied_input_types:
          title: Category Applied Input Types
          additionalProperties:
            items:
              type: string
            type: array
          type: object
        category_scores:
          title: Category Scores
          additionalProperties:
            type: number
          type: object
        user_message:
          title: User Message
          type: string
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
      type: object
      required:
      - flagged
      title: ModerationObjectResults
      description: A moderation object.
    NumberType:
      properties:
        type:
          type: string
          const: number
          title: Type
          default: number
      type: object
      title: NumberType
      description: Parameter type for numeric values.
    ObjectType:
      properties:
        type:
          type: string
          const: object
          title: Type
          default: object
      type: object
      title: ObjectType
      description: Parameter type for object values.
    OpenAIAssistantMessageParam-Input:
      properties:
        role:
          type: string
          const: assistant
          title: Role
          default: assistant
        content:
          anyOf:
          - type: string
          - items:
              $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
            type: array
          title: Content
        name:
          title: Name
          type: string
        tool_calls:
          title: Tool Calls
          items:
            $ref: '#/components/schemas/OpenAIChatCompletionToolCall'
          type: array
      type: object
      title: OpenAIAssistantMessageParam
      description: A message containing the model's (assistant) response in an OpenAI-compatible chat completion request.
    OpenAIAssistantMessageParam-Output:
      properties:
        role:
          type: string
          const: assistant
          title: Role
          default: assistant
        content:
          anyOf:
          - type: string
          - items:
              $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
            type: array
          title: Content
        name:
          title: Name
          type: string
        tool_calls:
          title: Tool Calls
          items:
            $ref: '#/components/schemas/OpenAIChatCompletionToolCall'
          type: array
      type: object
      title: OpenAIAssistantMessageParam
      description: A message containing the model's (assistant) response in an OpenAI-compatible chat completion request.
    OpenAIChatCompletion:
      properties:
        id:
          type: string
          title: Id
        choices:
          items:
            $ref: '#/components/schemas/OpenAIChoice-Output'
          type: array
          title: Choices
        object:
          type: string
          const: chat.completion
          title: Object
          default: chat.completion
        created:
          type: integer
          title: Created
        model:
          type: string
          title: Model
        usage:
          $ref: '#/components/schemas/OpenAIChatCompletionUsage'
      type: object
      required:
      - id
      - choices
      - created
      - model
      title: OpenAIChatCompletion
      description: Response from an OpenAI-compatible chat completion request.
    OpenAIChatCompletionContentPartImageParam:
      properties:
        type:
          type: string
          const: image_url
          title: Type
          default: image_url
        image_url:
          $ref: '#/components/schemas/OpenAIImageURL'
      type: object
      required:
      - image_url
      title: OpenAIChatCompletionContentPartImageParam
      description: Image content part for OpenAI-compatible chat completion messages.
    OpenAIChatCompletionContentPartTextParam:
      properties:
        type:
          type: string
          const: text
          title: Type
          default: text
        text:
          type: string
          title: Text
      type: object
      required:
      - text
      title: OpenAIChatCompletionContentPartTextParam
      description: Text content part for OpenAI-compatible chat completion messages.
    OpenAIChatCompletionRequestWithExtraBody:
      properties:
        model:
          type: string
          title: Model
        messages:
          items:
            oneOf:
            - $ref: '#/components/schemas/OpenAIUserMessageParam-Input'
            - $ref: '#/components/schemas/OpenAISystemMessageParam'
            - $ref: '#/components/schemas/OpenAIAssistantMessageParam-Input'
            - $ref: '#/components/schemas/OpenAIToolMessageParam'
            - $ref: '#/components/schemas/OpenAIDeveloperMessageParam'
            discriminator:
              propertyName: role
              mapping:
                assistant: '#/components/schemas/OpenAIAssistantMessageParam-Input'
                developer: '#/components/schemas/OpenAIDeveloperMessageParam'
                system: '#/components/schemas/OpenAISystemMessageParam'
                tool: '#/components/schemas/OpenAIToolMessageParam'
                user: '#/components/schemas/OpenAIUserMessageParam-Input'
          type: array
          minItems: 1
          title: Messages
        frequency_penalty:
          title: Frequency Penalty
          type: number
        function_call:
          anyOf:
          - type: string
          - additionalProperties: true
            type: object
          title: Function Call
        functions:
          title: Functions
          items:
            additionalProperties: true
            type: object
          type: array
        logit_bias:
          title: Logit Bias
          additionalProperties:
            type: number
          type: object
        logprobs:
          title: Logprobs
          type: boolean
        max_completion_tokens:
          title: Max Completion Tokens
          type: integer
        max_tokens:
          title: Max Tokens
          type: integer
        n:
          title: N
          type: integer
        parallel_tool_calls:
          title: Parallel Tool Calls
          type: boolean
        presence_penalty:
          title: Presence Penalty
          type: number
        response_format:
          title: Response Format
          oneOf:
          - $ref: '#/components/schemas/OpenAIResponseFormatText'
          - $ref: '#/components/schemas/OpenAIResponseFormatJSONSchema'
          - $ref: '#/components/schemas/OpenAIResponseFormatJSONObject'
          discriminator:
            propertyName: type
            mapping:
              json_object: '#/components/schemas/OpenAIResponseFormatJSONObject'
              json_schema: '#/components/schemas/OpenAIResponseFormatJSONSchema'
              text: '#/components/schemas/OpenAIResponseFormatText'
        seed:
          title: Seed
          type: integer
        stop:
          anyOf:
          - type: string
          - items:
              type: string
            type: array
          title: Stop
        stream:
          title: Stream
          type: boolean
        stream_options:
          title: Stream Options
          additionalProperties: true
          type: object
        temperature:
          title: Temperature
          type: number
        tool_choice:
          anyOf:
          - type: string
          - additionalProperties: true
            type: object
          title: Tool Choice
        tools:
          title: Tools
          items:
            additionalProperties: true
            type: object
          type: array
        top_logprobs:
          title: Top Logprobs
          type: integer
        top_p:
          title: Top P
          type: number
        user:
          title: User
          type: string
      additionalProperties: true
      type: object
      required:
      - model
      - messages
      title: OpenAIChatCompletionRequestWithExtraBody
      description: Request parameters for OpenAI-compatible chat completion endpoint.
    OpenAIChatCompletionToolCall:
      properties:
        index:
          title: Index
          type: integer
        id:
          title: Id
          type: string
        type:
          type: string
          const: function
          title: Type
          default: function
        function:
          $ref: '#/components/schemas/OpenAIChatCompletionToolCallFunction'
      type: object
      title: OpenAIChatCompletionToolCall
      description: Tool call specification for OpenAI-compatible chat completion responses.
    OpenAIChatCompletionToolCallFunction:
      properties:
        name:
          title: Name
          type: string
        arguments:
          title: Arguments
          type: string
      type: object
      title: OpenAIChatCompletionToolCallFunction
      description: Function call details for OpenAI-compatible tool calls.
    OpenAIChatCompletionUsage:
      properties:
        prompt_tokens:
          type: integer
          title: Prompt Tokens
        completion_tokens:
          type: integer
          title: Completion Tokens
        total_tokens:
          type: integer
          title: Total Tokens
        prompt_tokens_details:
          $ref: '#/components/schemas/OpenAIChatCompletionUsagePromptTokensDetails'
        completion_tokens_details:
          $ref: '#/components/schemas/OpenAIChatCompletionUsageCompletionTokensDetails'
      type: object
      required:
      - prompt_tokens
      - completion_tokens
      - total_tokens
      title: OpenAIChatCompletionUsage
      description: Usage information for OpenAI chat completion.
    OpenAIChatCompletionUsageCompletionTokensDetails:
      properties:
        reasoning_tokens:
          title: Reasoning Tokens
          type: integer
      type: object
      title: OpenAIChatCompletionUsageCompletionTokensDetails
      description: Token details for output tokens in OpenAI chat completion usage.
    OpenAIChatCompletionUsagePromptTokensDetails:
      properties:
        cached_tokens:
          title: Cached Tokens
          type: integer
      type: object
      title: OpenAIChatCompletionUsagePromptTokensDetails
      description: Token details for prompt tokens in OpenAI chat completion usage.
    OpenAIChoice-Output:
      properties:
        message:
          oneOf:
          - $ref: '#/components/schemas/OpenAIUserMessageParam-Output'
          - $ref: '#/components/schemas/OpenAISystemMessageParam'
          - $ref: '#/components/schemas/OpenAIAssistantMessageParam-Output'
          - $ref: '#/components/schemas/OpenAIToolMessageParam'
          - $ref: '#/components/schemas/OpenAIDeveloperMessageParam'
          title: Message
          discriminator:
            propertyName: role
            mapping:
              assistant: '#/components/schemas/OpenAIAssistantMessageParam-Output'
              developer: '#/components/schemas/OpenAIDeveloperMessageParam'
              system: '#/components/schemas/OpenAISystemMessageParam'
              tool: '#/components/schemas/OpenAIToolMessageParam'
              user: '#/components/schemas/OpenAIUserMessageParam-Output'
        finish_reason:
          type: string
          title: Finish Reason
        index:
          type: integer
          title: Index
        logprobs:
          $ref: '#/components/schemas/OpenAIChoiceLogprobs-Output'
      type: object
      required:
      - message
      - finish_reason
      - index
      title: OpenAIChoice
      description: A choice from an OpenAI-compatible chat completion response.
    OpenAIChoiceLogprobs-Output:
      properties:
        content:
          title: Content
          items:
            $ref: '#/components/schemas/OpenAITokenLogProb'
          type: array
        refusal:
          title: Refusal
          items:
            $ref: '#/components/schemas/OpenAITokenLogProb'
          type: array
      type: object
      title: OpenAIChoiceLogprobs
      description: The log probabilities for the tokens in the message from an OpenAI-compatible chat completion response.
    OpenAICompletion:
      properties:
        id:
          type: string
          title: Id
        choices:
          items:
            $ref: '#/components/schemas/OpenAICompletionChoice-Output'
          type: array
          title: Choices
        created:
          type: integer
          title: Created
        model:
          type: string
          title: Model
        object:
          type: string
          const: text_completion
          title: Object
          default: text_completion
      type: object
      required:
      - id
      - choices
      - created
      - model
      title: OpenAICompletion
      description: Response from an OpenAI-compatible completion request.
    OpenAICompletionChoice-Output:
      properties:
        finish_reason:
          type: string
          title: Finish Reason
        text:
          type: string
          title: Text
        index:
          type: integer
          title: Index
        logprobs:
          $ref: '#/components/schemas/OpenAIChoiceLogprobs-Output'
      type: object
      required:
      - finish_reason
      - text
      - index
      title: OpenAICompletionChoice
      description: A choice from an OpenAI-compatible completion response.
    OpenAICompletionRequestWithExtraBody:
      properties:
        model:
          type: string
          title: Model
        prompt:
          anyOf:
          - type: string
          - items:
              type: string
            type: array
          - items:
              type: integer
            type: array
          - items:
              items:
                type: integer
              type: array
            type: array
          title: Prompt
        best_of:
          title: Best Of
          type: integer
        echo:
          title: Echo
          type: boolean
        frequency_penalty:
          title: Frequency Penalty
          type: number
        logit_bias:
          title: Logit Bias
          additionalProperties:
            type: number
          type: object
        logprobs:
          title: Logprobs
          type: boolean
        max_tokens:
          title: Max Tokens
          type: integer
        n:
          title: N
          type: integer
        presence_penalty:
          title: Presence Penalty
          type: number
        seed:
          title: Seed
          type: integer
        stop:
          anyOf:
          - type: string
          - items:
              type: string
            type: array
          title: Stop
        stream:
          title: Stream
          type: boolean
        stream_options:
          title: Stream Options
          additionalProperties: true
          type: object
        temperature:
          title: Temperature
          type: number
        top_p:
          title: Top P
          type: number
        user:
          title: User
          type: string
        suffix:
          title: Suffix
          type: string
      additionalProperties: true
      type: object
      required:
      - model
      - prompt
      title: OpenAICompletionRequestWithExtraBody
      description: Request parameters for OpenAI-compatible completion endpoint.
    OpenAICreateVectorStoreFileBatchRequestWithExtraBody:
      properties:
        file_ids:
          items:
            type: string
          type: array
          title: File Ids
        attributes:
          title: Attributes
          additionalProperties: true
          type: object
        chunking_strategy:
          title: Chunking Strategy
          oneOf:
          - $ref: '#/components/schemas/VectorStoreChunkingStrategyAuto'
          - $ref: '#/components/schemas/VectorStoreChunkingStrategyStatic'
          discriminator:
            propertyName: type
            mapping:
              auto: '#/components/schemas/VectorStoreChunkingStrategyAuto'
              static: '#/components/schemas/VectorStoreChunkingStrategyStatic'
      additionalProperties: true
      type: object
      required:
      - file_ids
      title: OpenAICreateVectorStoreFileBatchRequestWithExtraBody
      description: Request to create a vector store file batch with extra_body support.
    OpenAICreateVectorStoreRequestWithExtraBody:
      properties:
        name:
          title: Name
          type: string
        file_ids:
          title: File Ids
          items:
            type: string
          type: array
        expires_after:
          title: Expires After
          additionalProperties: true
          type: object
        chunking_strategy:
          title: Chunking Strategy
          additionalProperties: true
          type: object
        metadata:
          title: Metadata
          additionalProperties: true
          type: object
      additionalProperties: true
      type: object
      title: OpenAICreateVectorStoreRequestWithExtraBody
      description: Request to create a vector store with extra_body support.
    OpenAIDeveloperMessageParam:
      properties:
        role:
          type: string
          const: developer
          title: Role
          default: developer
        content:
          anyOf:
          - type: string
          - items:
              $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
            type: array
          title: Content
        name:
          title: Name
          type: string
      type: object
      required:
      - content
      title: OpenAIDeveloperMessageParam
      description: A message from the developer in an OpenAI-compatible chat completion request.
    OpenAIEmbeddingData:
      properties:
        object:
          type: string
          const: embedding
          title: Object
          default: embedding
        embedding:
          anyOf:
          - items:
              type: number
            type: array
          - type: string
          title: Embedding
        index:
          type: integer
          title: Index
      type: object
      required:
      - embedding
      - index
      title: OpenAIEmbeddingData
      description: A single embedding data object from an OpenAI-compatible embeddings response.
    OpenAIEmbeddingUsage:
      properties:
        prompt_tokens:
          type: integer
          title: Prompt Tokens
        total_tokens:
          type: integer
          title: Total Tokens
      type: object
      required:
      - prompt_tokens
      - total_tokens
      title: OpenAIEmbeddingUsage
      description: Usage information for an OpenAI-compatible embeddings response.
    OpenAIEmbeddingsRequestWithExtraBody:
      properties:
        model:
          type: string
          title: Model
        input:
          anyOf:
          - type: string
          - items:
              type: string
            type: array
          title: Input
        encoding_format:
          title: Encoding Format
          default: float
          type: string
        dimensions:
          title: Dimensions
          type: integer
        user:
          title: User
          type: string
      additionalProperties: true
      type: object
      required:
      - model
      - input
      title: OpenAIEmbeddingsRequestWithExtraBody
      description: Request parameters for OpenAI-compatible embeddings endpoint.
    OpenAIEmbeddingsResponse:
      properties:
        object:
          type: string
          const: list
          title: Object
          default: list
        data:
          items:
            $ref: '#/components/schemas/OpenAIEmbeddingData'
          type: array
          title: Data
        model:
          type: string
          title: Model
        usage:
          $ref: '#/components/schemas/OpenAIEmbeddingUsage'
      type: object
      required:
      - data
      - model
      - usage
      title: OpenAIEmbeddingsResponse
      description: Response from an OpenAI-compatible embeddings request.
    OpenAIFile:
      properties:
        type:
          type: string
          const: file
          title: Type
          default: file
        file:
          $ref: '#/components/schemas/OpenAIFileFile'
      type: object
      required:
      - file
      title: OpenAIFile
    OpenAIFileFile:
      properties:
        file_data:
          title: File Data
          type: string
        file_id:
          title: File Id
          type: string
        filename:
          title: Filename
          type: string
      type: object
      title: OpenAIFileFile
    OpenAIFileObject:
      properties:
        object:
          type: string
          const: file
          title: Object
          default: file
        id:
          type: string
          title: Id
        bytes:
          type: integer
          title: Bytes
        created_at:
          type: integer
          title: Created At
        expires_at:
          type: integer
          title: Expires At
        filename:
          type: string
          title: Filename
        purpose:
          $ref: '#/components/schemas/OpenAIFilePurpose'
      type: object
      required:
      - id
      - bytes
      - created_at
      - expires_at
      - filename
      - purpose
      title: OpenAIFileObject
      description: OpenAI File object as defined in the OpenAI Files API.
    OpenAIFilePurpose:
      type: string
      enum:
      - assistants
      - batch
      title: OpenAIFilePurpose
      description: Valid purpose values for OpenAI Files API.
    OpenAIImageURL:
      properties:
        url:
          type: string
          title: Url
        detail:
          title: Detail
          type: string
      type: object
      required:
      - url
      title: OpenAIImageURL
      description: Image URL specification for OpenAI-compatible chat completion messages.
    OpenAIJSONSchema:
      properties:
        name:
          type: string
          title: Name
        description:
          title: Description
          type: string
        strict:
          title: Strict
          type: boolean
        schema:
          title: Schema
          additionalProperties: true
          type: object
      type: object
      title: OpenAIJSONSchema
      description: JSON schema specification for OpenAI-compatible structured response format.
    OpenAIResponseAnnotationCitation:
      properties:
        type:
          type: string
          const: url_citation
          title: Type
          default: url_citation
        end_index:
          type: integer
          title: End Index
        start_index:
          type: integer
          title: Start Index
        title:
          type: string
          title: Title
        url:
          type: string
          title: Url
      type: object
      required:
      - end_index
      - start_index
      - title
      - url
      title: OpenAIResponseAnnotationCitation
      description: URL citation annotation for referencing external web resources.
    OpenAIResponseAnnotationContainerFileCitation:
      properties:
        type:
          type: string
          const: container_file_citation
          title: Type
          default: container_file_citation
        container_id:
          type: string
          title: Container Id
        end_index:
          type: integer
          title: End Index
        file_id:
          type: string
          title: File Id
        filename:
          type: string
          title: Filename
        start_index:
          type: integer
          title: Start Index
      type: object
      required:
      - container_id
      - end_index
      - file_id
      - filename
      - start_index
      title: OpenAIResponseAnnotationContainerFileCitation
    OpenAIResponseAnnotationFileCitation:
      properties:
        type:
          type: string
          const: file_citation
          title: Type
          default: file_citation
        file_id:
          type: string
          title: File Id
        filename:
          type: string
          title: Filename
        index:
          type: integer
          title: Index
      type: object
      required:
      - file_id
      - filename
      - index
      title: OpenAIResponseAnnotationFileCitation
      description: File citation annotation for referencing specific files in response content.
    OpenAIResponseAnnotationFilePath:
      properties:
        type:
          type: string
          const: file_path
          title: Type
          default: file_path
        file_id:
          type: string
          title: File Id
        index:
          type: integer
          title: Index
      type: object
      required:
      - file_id
      - index
      title: OpenAIResponseAnnotationFilePath
    OpenAIResponseContentPartRefusal:
      properties:
        type:
          type: string
          const: refusal
          title: Type
          default: refusal
        refusal:
          type: string
          title: Refusal
      type: object
      required:
      - refusal
      title: OpenAIResponseContentPartRefusal
      description: Refusal content within a streamed response part.
    OpenAIResponseError:
      properties:
        code:
          type: string
          title: Code
        message:
          type: string
          title: Message
      type: object
      required:
      - code
      - message
      title: OpenAIResponseError
      description: Error details for failed OpenAI response requests.
    OpenAIResponseFormatJSONObject:
      properties:
        type:
          type: string
          const: json_object
          title: Type
          default: json_object
      type: object
      title: OpenAIResponseFormatJSONObject
      description: JSON object response format for OpenAI-compatible chat completion requests.
    OpenAIResponseFormatJSONSchema:
      properties:
        type:
          type: string
          const: json_schema
          title: Type
          default: json_schema
        json_schema:
          $ref: '#/components/schemas/OpenAIJSONSchema'
      type: object
      required:
      - json_schema
      title: OpenAIResponseFormatJSONSchema
      description: JSON schema response format for OpenAI-compatible chat completion requests.
    OpenAIResponseFormatText:
      properties:
        type:
          type: string
          const: text
          title: Type
          default: text
      type: object
      title: OpenAIResponseFormatText
      description: Text response format for OpenAI-compatible chat completion requests.
    OpenAIResponseInputFunctionToolCallOutput:
      properties:
        call_id:
          type: string
          title: Call Id
        output:
          type: string
          title: Output
        type:
          type: string
          const: function_call_output
          title: Type
          default: function_call_output
        id:
          title: Id
          type: string
        status:
          title: Status
          type: string
      type: object
      required:
      - call_id
      - output
      title: OpenAIResponseInputFunctionToolCallOutput
      description: This represents the output of a function call that gets passed back to the model.
    OpenAIResponseInputMessageContentFile:
      properties:
        type:
          type: string
          const: input_file
          title: Type
          default: input_file
        file_data:
          title: File Data
          type: string
        file_id:
          title: File Id
          type: string
        file_url:
          title: File Url
          type: string
        filename:
          title: Filename
          type: string
      type: object
      title: OpenAIResponseInputMessageContentFile
      description: File content for input messages in OpenAI response format.
    OpenAIResponseInputMessageContentImage:
      properties:
        detail:
          anyOf:
          - type: string
            const: low
          - type: string
            const: high
          - type: string
            const: auto
          title: Detail
          default: auto
        type:
          type: string
          const: input_image
          title: Type
          default: input_image
        file_id:
          title: File Id
          type: string
        image_url:
          title: Image Url
          type: string
      type: object
      title: OpenAIResponseInputMessageContentImage
      description: Image content for input messages in OpenAI response format.
    OpenAIResponseInputMessageContentText:
      properties:
        text:
          type: string
          title: Text
        type:
          type: string
          const: input_text
          title: Type
          default: input_text
      type: object
      required:
      - text
      title: OpenAIResponseInputMessageContentText
      description: Text content for input messages in OpenAI response format.
    OpenAIResponseInputToolFileSearch:
      properties:
        type:
          type: string
          const: file_search
          title: Type
          default: file_search
        vector_store_ids:
          items:
            type: string
          type: array
          title: Vector Store Ids
        filters:
          title: Filters
          additionalProperties: true
          type: object
        max_num_results:
          title: Max Num Results
          default: 10
          type: integer
          maximum: 50.0
          minimum: 1.0
        ranking_options:
          $ref: '#/components/schemas/SearchRankingOptions'
      type: object
      required:
      - vector_store_ids
      title: OpenAIResponseInputToolFileSearch
      description: File search tool configuration for OpenAI response inputs.
    OpenAIResponseInputToolFunction:
      properties:
        type:
          type: string
          const: function
          title: Type
          default: function
        name:
          type: string
          title: Name
        description:
          title: Description
          type: string
        parameters:
          title: Parameters
          additionalProperties: true
          type: object
        strict:
          title: Strict
          type: boolean
      type: object
      required:
      - name
      - parameters
      title: OpenAIResponseInputToolFunction
      description: Function tool configuration for OpenAI response inputs.
    OpenAIResponseInputToolMCP:
      properties:
        type:
          type: string
          const: mcp
          title: Type
          default: mcp
        server_label:
          type: string
          title: Server Label
        server_url:
          type: string
          title: Server Url
        headers:
          title: Headers
          additionalProperties: true
          type: object
        require_approval:
          anyOf:
          - type: string
            const: always
          - type: string
            const: never
          - $ref: '#/components/schemas/ApprovalFilter'
          title: Require Approval
          default: never
        allowed_tools:
          anyOf:
          - items:
              type: string
            type: array
          - $ref: '#/components/schemas/AllowedToolsFilter'
          title: Allowed Tools
      type: object
      required:
      - server_label
      - server_url
      title: OpenAIResponseInputToolMCP
      description: Model Context Protocol (MCP) tool configuration for OpenAI response inputs.
    OpenAIResponseInputToolWebSearch:
      properties:
        type:
          anyOf:
          - type: string
            const: web_search
          - type: string
            const: web_search_preview
          - type: string
            const: web_search_preview_2025_03_11
          title: Type
          default: web_search
        search_context_size:
          title: Search Context Size
          default: medium
          type: string
          pattern: ^low|medium|high$
      type: object
      title: OpenAIResponseInputToolWebSearch
      description: Web search tool configuration for OpenAI response inputs.
    OpenAIResponseMCPApprovalRequest:
      properties:
        arguments:
          type: string
          title: Arguments
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        server_label:
          type: string
          title: Server Label
        type:
          type: string
          const: mcp_approval_request
          title: Type
          default: mcp_approval_request
      type: object
      required:
      - arguments
      - id
      - name
      - server_label
      title: OpenAIResponseMCPApprovalRequest
      description: A request for human approval of a tool invocation.
    OpenAIResponseMCPApprovalResponse:
      properties:
        approval_request_id:
          type: string
          title: Approval Request Id
        approve:
          type: boolean
          title: Approve
        type:
          type: string
          const: mcp_approval_response
          title: Type
          default: mcp_approval_response
        id:
          title: Id
          type: string
        reason:
          title: Reason
          type: string
      type: object
      required:
      - approval_request_id
      - approve
      title: OpenAIResponseMCPApprovalResponse
      description: A response to an MCP approval request.
    OpenAIResponseMessage-Input:
      properties:
        content:
          anyOf:
          - type: string
          - items:
              oneOf:
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentText'
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentImage'
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentFile'
              discriminator:
                propertyName: type
                mapping:
                  input_file: '#/components/schemas/OpenAIResponseInputMessageContentFile'
                  input_image: '#/components/schemas/OpenAIResponseInputMessageContentImage'
                  input_text: '#/components/schemas/OpenAIResponseInputMessageContentText'
            type: array
          - items:
              oneOf:
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageContentOutputText'
              - $ref: '#/components/schemas/OpenAIResponseContentPartRefusal'
              discriminator:
                propertyName: type
                mapping:
                  output_text: '#/components/schemas/OpenAIResponseOutputMessageContentOutputText'
                  refusal: '#/components/schemas/OpenAIResponseContentPartRefusal'
            type: array
          title: Content
        role:
          anyOf:
          - type: string
            const: system
          - type: string
            const: developer
          - type: string
            const: user
          - type: string
            const: assistant
          title: Role
        type:
          type: string
          const: message
          title: Type
          default: message
        id:
          title: Id
          type: string
        status:
          title: Status
          type: string
      type: object
      required:
      - content
      - role
      title: OpenAIResponseMessage
      description: "Corresponds to the various Message types in the Responses API.\nThey are all under one type because the Responses API gives them all\nthe same \"type\" value, and there is no way to tell them apart in certain\nscenarios."
    OpenAIResponseMessage-Output:
      properties:
        content:
          anyOf:
          - type: string
          - items:
              oneOf:
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentText'
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentImage'
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentFile'
              discriminator:
                propertyName: type
                mapping:
                  input_file: '#/components/schemas/OpenAIResponseInputMessageContentFile'
                  input_image: '#/components/schemas/OpenAIResponseInputMessageContentImage'
                  input_text: '#/components/schemas/OpenAIResponseInputMessageContentText'
            type: array
          - items:
              oneOf:
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageContentOutputText'
              - $ref: '#/components/schemas/OpenAIResponseContentPartRefusal'
              discriminator:
                propertyName: type
                mapping:
                  output_text: '#/components/schemas/OpenAIResponseOutputMessageContentOutputText'
                  refusal: '#/components/schemas/OpenAIResponseContentPartRefusal'
            type: array
          title: Content
        role:
          anyOf:
          - type: string
            const: system
          - type: string
            const: developer
          - type: string
            const: user
          - type: string
            const: assistant
          title: Role
        type:
          type: string
          const: message
          title: Type
          default: message
        id:
          title: Id
          type: string
        status:
          title: Status
          type: string
      type: object
      required:
      - content
      - role
      title: OpenAIResponseMessage
      description: "Corresponds to the various Message types in the Responses API.\nThey are all under one type because the Responses API gives them all\nthe same \"type\" value, and there is no way to tell them apart in certain\nscenarios."
    OpenAIResponseObject:
      properties:
        created_at:
          type: integer
          title: Created At
        error:
          $ref: '#/components/schemas/OpenAIResponseError'
        id:
          type: string
          title: Id
        model:
          type: string
          title: Model
        object:
          type: string
          const: response
          title: Object
          default: response
        output:
          items:
            oneOf:
            - $ref: '#/components/schemas/OpenAIResponseMessage-Output'
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
            - $ref: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
            discriminator:
              propertyName: type
              mapping:
                file_search_call: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
                function_call: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
                mcp_approval_request: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
                mcp_call: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
                mcp_list_tools: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
                message: '#/components/schemas/OpenAIResponseMessage-Output'
                web_search_call: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
          type: array
          title: Output
        parallel_tool_calls:
          type: boolean
          title: Parallel Tool Calls
          default: false
        previous_response_id:
          title: Previous Response Id
          type: string
        prompt:
          $ref: '#/components/schemas/OpenAIResponsePrompt'
        status:
          type: string
          title: Status
        temperature:
          title: Temperature
          type: number
        text:
          $ref: '#/components/schemas/OpenAIResponseText'
          default:
            format:
              type: text
        top_p:
          title: Top P
          type: number
        tools:
          title: Tools
          items:
            oneOf:
            - $ref: '#/components/schemas/OpenAIResponseInputToolWebSearch'
            - $ref: '#/components/schemas/OpenAIResponseInputToolFileSearch'
            - $ref: '#/components/schemas/OpenAIResponseInputToolFunction'
            - $ref: '#/components/schemas/OpenAIResponseToolMCP'
            discriminator:
              propertyName: type
              mapping:
                file_search: '#/components/schemas/OpenAIResponseInputToolFileSearch'
                function: '#/components/schemas/OpenAIResponseInputToolFunction'
                mcp: '#/components/schemas/OpenAIResponseToolMCP'
                web_search: '#/components/schemas/OpenAIResponseInputToolWebSearch'
                web_search_preview: '#/components/schemas/OpenAIResponseInputToolWebSearch'
                web_search_preview_2025_03_11: '#/components/schemas/OpenAIResponseInputToolWebSearch'
          type: array
        truncation:
          title: Truncation
          type: string
        usage:
          $ref: '#/components/schemas/OpenAIResponseUsage'
        instructions:
          title: Instructions
          type: string
      type: object
      required:
      - created_at
      - id
      - model
      - output
      - status
      title: OpenAIResponseObject
      description: Complete OpenAI response object containing generation results and metadata.
    OpenAIResponseOutputMessageContentOutputText:
      properties:
        text:
          type: string
          title: Text
        type:
          type: string
          const: output_text
          title: Type
          default: output_text
        annotations:
          items:
            oneOf:
            - $ref: '#/components/schemas/OpenAIResponseAnnotationFileCitation'
            - $ref: '#/components/schemas/OpenAIResponseAnnotationCitation'
            - $ref: '#/components/schemas/OpenAIResponseAnnotationContainerFileCitation'
            - $ref: '#/components/schemas/OpenAIResponseAnnotationFilePath'
            discriminator:
              propertyName: type
              mapping:
                container_file_citation: '#/components/schemas/OpenAIResponseAnnotationContainerFileCitation'
                file_citation: '#/components/schemas/OpenAIResponseAnnotationFileCitation'
                file_path: '#/components/schemas/OpenAIResponseAnnotationFilePath'
                url_citation: '#/components/schemas/OpenAIResponseAnnotationCitation'
          type: array
          title: Annotations
      type: object
      required:
      - text
      title: OpenAIResponseOutputMessageContentOutputText
    OpenAIResponseOutputMessageFileSearchToolCall:
      properties:
        id:
          type: string
          title: Id
        queries:
          items:
            type: string
          type: array
          title: Queries
        status:
          type: string
          title: Status
        type:
          type: string
          const: file_search_call
          title: Type
          default: file_search_call
        results:
          title: Results
          items:
            $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCallResults'
          type: array
      type: object
      required:
      - id
      - queries
      - status
      title: OpenAIResponseOutputMessageFileSearchToolCall
      description: File search tool call output message for OpenAI responses.
    OpenAIResponseOutputMessageFileSearchToolCallResults:
      properties:
        attributes:
          additionalProperties: true
          type: object
          title: Attributes
        file_id:
          type: string
          title: File Id
        filename:
          type: string
          title: Filename
        score:
          type: number
          title: Score
        text:
          type: string
          title: Text
      type: object
      required:
      - attributes
      - file_id
      - filename
      - score
      - text
      title: OpenAIResponseOutputMessageFileSearchToolCallResults
      description: Search results returned by the file search operation.
    OpenAIResponseOutputMessageFunctionToolCall:
      properties:
        call_id:
          type: string
          title: Call Id
        name:
          type: string
          title: Name
        arguments:
          type: string
          title: Arguments
        type:
          type: string
          const: function_call
          title: Type
          default: function_call
        id:
          title: Id
          type: string
        status:
          title: Status
          type: string
      type: object
      required:
      - call_id
      - name
      - arguments
      title: OpenAIResponseOutputMessageFunctionToolCall
      description: Function tool call output message for OpenAI responses.
    OpenAIResponseOutputMessageMCPCall:
      properties:
        id:
          type: string
          title: Id
        type:
          type: string
          const: mcp_call
          title: Type
          default: mcp_call
        arguments:
          type: string
          title: Arguments
        name:
          type: string
          title: Name
        server_label:
          type: string
          title: Server Label
        error:
          title: Error
          type: string
        output:
          title: Output
          type: string
      type: object
      required:
      - id
      - arguments
      - name
      - server_label
      title: OpenAIResponseOutputMessageMCPCall
      description: Model Context Protocol (MCP) call output message for OpenAI responses.
    OpenAIResponseOutputMessageMCPListTools:
      properties:
        id:
          type: string
          title: Id
        type:
          type: string
          const: mcp_list_tools
          title: Type
          default: mcp_list_tools
        server_label:
          type: string
          title: Server Label
        tools:
          items:
            $ref: '#/components/schemas/MCPListToolsTool'
          type: array
          title: Tools
      type: object
      required:
      - id
      - server_label
      - tools
      title: OpenAIResponseOutputMessageMCPListTools
      description: MCP list tools output message containing available tools from an MCP server.
    OpenAIResponseOutputMessageWebSearchToolCall:
      properties:
        id:
          type: string
          title: Id
        status:
          type: string
          title: Status
        type:
          type: string
          const: web_search_call
          title: Type
          default: web_search_call
      type: object
      required:
      - id
      - status
      title: OpenAIResponseOutputMessageWebSearchToolCall
      description: Web search tool call output message for OpenAI responses.
    OpenAIResponsePrompt:
      properties:
        id:
          type: string
          title: Id
        variables:
          title: Variables
          additionalProperties:
            oneOf:
            - $ref: '#/components/schemas/OpenAIResponseInputMessageContentText'
            - $ref: '#/components/schemas/OpenAIResponseInputMessageContentImage'
            - $ref: '#/components/schemas/OpenAIResponseInputMessageContentFile'
            discriminator:
              propertyName: type
              mapping:
                input_file: '#/components/schemas/OpenAIResponseInputMessageContentFile'
                input_image: '#/components/schemas/OpenAIResponseInputMessageContentImage'
                input_text: '#/components/schemas/OpenAIResponseInputMessageContentText'
          type: object
        version:
          title: Version
          type: string
      type: object
      required:
      - id
      title: OpenAIResponsePrompt
      description: OpenAI compatible Prompt object that is used in OpenAI responses.
    OpenAIResponseText:
      properties:
        format:
          $ref: '#/components/schemas/OpenAIResponseTextFormat'
      type: object
      title: OpenAIResponseText
      description: Text response configuration for OpenAI responses.
    OpenAIResponseTextFormat:
      properties:
        type:
          anyOf:
          - type: string
            const: text
          - type: string
            const: json_schema
          - type: string
            const: json_object
          title: Type
        name:
          title: Name
          type: string
        schema:
          title: Schema
          additionalProperties: true
          type: object
        description:
          title: Description
          type: string
        strict:
          title: Strict
          type: boolean
      type: object
      title: OpenAIResponseTextFormat
      description: Configuration for Responses API text format.
    OpenAIResponseToolMCP:
      properties:
        type:
          type: string
          const: mcp
          title: Type
          default: mcp
        server_label:
          type: string
          title: Server Label
        allowed_tools:
          anyOf:
          - items:
              type: string
            type: array
          - $ref: '#/components/schemas/AllowedToolsFilter'
          title: Allowed Tools
      type: object
      required:
      - server_label
      title: OpenAIResponseToolMCP
      description: Model Context Protocol (MCP) tool configuration for OpenAI response object.
    OpenAIResponseUsage:
      properties:
        input_tokens:
          type: integer
          title: Input Tokens
        output_tokens:
          type: integer
          title: Output Tokens
        total_tokens:
          type: integer
          title: Total Tokens
        input_tokens_details:
          $ref: '#/components/schemas/OpenAIResponseUsageInputTokensDetails'
        output_tokens_details:
          $ref: '#/components/schemas/OpenAIResponseUsageOutputTokensDetails'
      type: object
      required:
      - input_tokens
      - output_tokens
      - total_tokens
      title: OpenAIResponseUsage
      description: Usage information for OpenAI response.
    OpenAIResponseUsageInputTokensDetails:
      properties:
        cached_tokens:
          title: Cached Tokens
          type: integer
      type: object
      title: OpenAIResponseUsageInputTokensDetails
      description: Token details for input tokens in OpenAI response usage.
    OpenAIResponseUsageOutputTokensDetails:
      properties:
        reasoning_tokens:
          title: Reasoning Tokens
          type: integer
      type: object
      title: OpenAIResponseUsageOutputTokensDetails
      description: Token details for output tokens in OpenAI response usage.
    OpenAISystemMessageParam:
      properties:
        role:
          type: string
          const: system
          title: Role
          default: system
        content:
          anyOf:
          - type: string
          - items:
              $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
            type: array
          title: Content
        name:
          title: Name
          type: string
      type: object
      required:
      - content
      title: OpenAISystemMessageParam
      description: A system message providing instructions or context to the model.
    OpenAITokenLogProb:
      properties:
        token:
          type: string
          title: Token
        bytes:
          title: Bytes
          items:
            type: integer
          type: array
        logprob:
          type: number
          title: Logprob
        top_logprobs:
          items:
            $ref: '#/components/schemas/OpenAITopLogProb'
          type: array
          title: Top Logprobs
      type: object
      required:
      - token
      - logprob
      - top_logprobs
      title: OpenAITokenLogProb
      description: The log probability for a token from an OpenAI-compatible chat completion response.
    OpenAIToolMessageParam:
      properties:
        role:
          type: string
          const: tool
          title: Role
          default: tool
        tool_call_id:
          type: string
          title: Tool Call Id
        content:
          anyOf:
          - type: string
          - items:
              $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
            type: array
          title: Content
      type: object
      required:
      - tool_call_id
      - content
      title: OpenAIToolMessageParam
      description: A message representing the result of a tool invocation in an OpenAI-compatible chat completion request.
    OpenAITopLogProb:
      properties:
        token:
          type: string
          title: Token
        bytes:
          title: Bytes
          items:
            type: integer
          type: array
        logprob:
          type: number
          title: Logprob
      type: object
      required:
      - token
      - logprob
      title: OpenAITopLogProb
      description: The top log probability for a token from an OpenAI-compatible chat completion response.
    OpenAIUserMessageParam-Input:
      properties:
        role:
          type: string
          const: user
          title: Role
          default: user
        content:
          anyOf:
          - type: string
          - items:
              oneOf:
              - $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
              - $ref: '#/components/schemas/OpenAIChatCompletionContentPartImageParam'
              - $ref: '#/components/schemas/OpenAIFile'
              discriminator:
                propertyName: type
                mapping:
                  file: '#/components/schemas/OpenAIFile'
                  image_url: '#/components/schemas/OpenAIChatCompletionContentPartImageParam'
                  text: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
            type: array
          title: Content
        name:
          title: Name
          type: string
      type: object
      required:
      - content
      title: OpenAIUserMessageParam
      description: A message from the user in an OpenAI-compatible chat completion request.
    OpenAIUserMessageParam-Output:
      properties:
        role:
          type: string
          const: user
          title: Role
          default: user
        content:
          anyOf:
          - type: string
          - items:
              oneOf:
              - $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
              - $ref: '#/components/schemas/OpenAIChatCompletionContentPartImageParam'
              - $ref: '#/components/schemas/OpenAIFile'
              discriminator:
                propertyName: type
                mapping:
                  file: '#/components/schemas/OpenAIFile'
                  image_url: '#/components/schemas/OpenAIChatCompletionContentPartImageParam'
                  text: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
            type: array
          title: Content
        name:
          title: Name
          type: string
      type: object
      required:
      - content
      title: OpenAIUserMessageParam
      description: A message from the user in an OpenAI-compatible chat completion request.
    OptimizerConfig:
      properties:
        optimizer_type:
          $ref: '#/components/schemas/OptimizerType'
        lr:
          type: number
          title: Lr
        weight_decay:
          type: number
          title: Weight Decay
        num_warmup_steps:
          type: integer
          title: Num Warmup Steps
      type: object
      required:
      - optimizer_type
      - lr
      - weight_decay
      - num_warmup_steps
      title: OptimizerConfig
      description: Configuration parameters for the optimization algorithm.
    OptimizerType:
      type: string
      enum:
      - adam
      - adamw
      - sgd
      title: OptimizerType
      description: Available optimizer algorithms for training.
    Order:
      type: string
      enum:
      - asc
      - desc
      title: Order
      description: Sort order for paginated responses.
    OutputTokensDetails:
      properties:
        reasoning_tokens:
          type: integer
          title: Reasoning Tokens
      additionalProperties: true
      type: object
      required:
      - reasoning_tokens
      title: OutputTokensDetails
    PostTrainingJob:
      properties:
        job_uuid:
          type: string
          title: Job Uuid
      type: object
      required:
      - job_uuid
      title: PostTrainingJob
    Prompt:
      properties:
        prompt:
          title: Prompt
          description: The system prompt with variable placeholders
          type: string
        version:
          type: integer
          minimum: 1.0
          title: Version
          description: Version (integer starting at 1, incremented on save)
        prompt_id:
          type: string
          title: Prompt Id
          description: Unique identifier in format 'pmpt_<48-digit-hash>'
        variables:
          items:
            type: string
          type: array
          title: Variables
          description: List of variable names that can be used in the prompt template
        is_default:
          type: boolean
          title: Is Default
          description: Boolean indicating whether this version is the default version
          default: false
      type: object
      required:
      - version
      - prompt_id
      title: Prompt
      description: A prompt resource representing a stored OpenAI Compatible prompt template in Llama Stack.
    ProviderInfo:
      properties:
        api:
          type: string
          title: Api
        provider_id:
          type: string
          title: Provider Id
        provider_type:
          type: string
          title: Provider Type
        config:
          additionalProperties: true
          type: object
          title: Config
        health:
          additionalProperties: true
          type: object
          title: Health
      type: object
      required:
      - api
      - provider_id
      - provider_type
      - config
      - health
      title: ProviderInfo
      description: Information about a registered provider including its configuration and health status.
    QueryChunksResponse:
      properties:
        chunks:
          items:
            $ref: '#/components/schemas/Chunk-Output'
          type: array
          title: Chunks
        scores:
          items:
            type: number
          type: array
          title: Scores
      type: object
      required:
      - chunks
      - scores
      title: QueryChunksResponse
      description: Response from querying chunks in a vector database.
    RAGQueryConfig:
      properties:
        query_generator_config:
          oneOf:
          - $ref: '#/components/schemas/DefaultRAGQueryGeneratorConfig'
          - $ref: '#/components/schemas/LLMRAGQueryGeneratorConfig'
          title: Query Generator Config
          default:
            type: default
            separator: ' '
          discriminator:
            propertyName: type
            mapping:
              default: '#/components/schemas/DefaultRAGQueryGeneratorConfig'
              llm: '#/components/schemas/LLMRAGQueryGeneratorConfig'
        max_tokens_in_context:
          type: integer
          title: Max Tokens In Context
          default: 4096
        max_chunks:
          type: integer
          title: Max Chunks
          default: 5
        chunk_template:
          type: string
          title: Chunk Template
          default: "Result {index}\nContent: {chunk.content}\nMetadata: {metadata}\n"
        mode:
          default: vector
          $ref: '#/components/schemas/RAGSearchMode'
        ranker:
          title: Ranker
          oneOf:
          - $ref: '#/components/schemas/RRFRanker'
          - $ref: '#/components/schemas/WeightedRanker'
          discriminator:
            propertyName: type
            mapping:
              rrf: '#/components/schemas/RRFRanker'
              weighted: '#/components/schemas/WeightedRanker'
      type: object
      title: RAGQueryConfig
      description: Configuration for the RAG query generation.
    RAGQueryResult:
      properties:
        content:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Output'
            - $ref: '#/components/schemas/TextContentItem'
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Output'
                text: '#/components/schemas/TextContentItem'
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Output'
              - $ref: '#/components/schemas/TextContentItem'
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Output'
                  text: '#/components/schemas/TextContentItem'
            type: array
          title: Content
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
      type: object
      title: RAGQueryResult
      description: Result of a RAG query containing retrieved content and metadata.
    RAGSearchMode:
      type: string
      enum:
      - vector
      - keyword
      - hybrid
      title: RAGSearchMode
      description: "Search modes for RAG query retrieval:\n- VECTOR: Uses vector similarity search for semantic matching\n- KEYWORD: Uses keyword-based search for exact matching\n- HYBRID: Combines both vector and keyword search for better results"
    RRFRanker:
      properties:
        type:
          type: string
          const: rrf
          title: Type
          default: rrf
        impact_factor:
          type: number
          title: Impact Factor
          default: 60.0
          minimum: 0.0
      type: object
      title: RRFRanker
      description: Reciprocal Rank Fusion (RRF) ranker configuration.
    RegexParserScoringFnParams:
      properties:
        type:
          type: string
          const: regex_parser
          title: Type
          default: regex_parser
        parsing_regexes:
          items:
            type: string
          type: array
          title: Parsing Regexes
          description: Regex to extract the answer from generated response
        aggregation_functions:
          items:
            $ref: '#/components/schemas/AggregationFunctionType'
          type: array
          title: Aggregation Functions
          description: Aggregation functions to apply to the scores of each row
      type: object
      title: RegexParserScoringFnParams
      description: Parameters for regex parser scoring function configuration.
    RerankData:
      properties:
        index:
          type: integer
          title: Index
        relevance_score:
          type: number
          title: Relevance Score
      type: object
      required:
      - index
      - relevance_score
      title: RerankData
      description: A single rerank result from a reranking response.
    RerankResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/RerankData'
          type: array
          title: Data
      type: object
      required:
      - data
      title: RerankResponse
      description: Response from a reranking request.
    RouteInfo:
      properties:
        route:
          type: string
          title: Route
        method:
          type: string
          title: Method
        provider_types:
          items:
            type: string
          type: array
          title: Provider Types
      type: object
      required:
      - route
      - method
      - provider_types
      title: RouteInfo
      description: Information about an API route including its path, method, and implementing providers.
    RowsDataSource:
      properties:
        type:
          type: string
          const: rows
          title: Type
          default: rows
        rows:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Rows
      type: object
      required:
      - rows
      title: RowsDataSource
      description: A dataset stored in rows.
    RunShieldResponse:
      properties:
        violation:
          $ref: '#/components/schemas/SafetyViolation'
      type: object
      title: RunShieldResponse
      description: Response from running a safety shield.
    SafetyViolation:
      properties:
        violation_level:
          $ref: '#/components/schemas/ViolationLevel'
        user_message:
          title: User Message
          type: string
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
      type: object
      required:
      - violation_level
      title: SafetyViolation
      description: Details of a safety violation detected by content moderation.
    SamplingParams:
      properties:
        strategy:
          oneOf:
          - $ref: '#/components/schemas/GreedySamplingStrategy'
          - $ref: '#/components/schemas/TopPSamplingStrategy'
          - $ref: '#/components/schemas/TopKSamplingStrategy'
          title: Strategy
          discriminator:
            propertyName: type
            mapping:
              greedy: '#/components/schemas/GreedySamplingStrategy'
              top_k: '#/components/schemas/TopKSamplingStrategy'
              top_p: '#/components/schemas/TopPSamplingStrategy'
        max_tokens:
          title: Max Tokens
          type: integer
        repetition_penalty:
          title: Repetition Penalty
          default: 1.0
          type: number
        stop:
          title: Stop
          items:
            type: string
          type: array
      type: object
      title: SamplingParams
      description: Sampling parameters.
    ScoreBatchResponse:
      properties:
        dataset_id:
          title: Dataset Id
          type: string
        results:
          additionalProperties:
            $ref: '#/components/schemas/ScoringResult'
          type: object
          title: Results
      type: object
      required:
      - results
      title: ScoreBatchResponse
      description: Response from batch scoring operations on datasets.
    ScoreResponse:
      properties:
        results:
          additionalProperties:
            $ref: '#/components/schemas/ScoringResult'
          type: object
          title: Results
      type: object
      required:
      - results
      title: ScoreResponse
      description: The response from scoring.
    ScoringFn-Output:
      properties:
        identifier:
          type: string
          title: Identifier
          description: Unique identifier for this resource in llama stack
        provider_resource_id:
          title: Provider Resource Id
          description: Unique identifier for this resource in the provider
          type: string
        provider_id:
          type: string
          title: Provider Id
          description: ID of the provider that owns this resource
        type:
          type: string
          const: scoring_function
          title: Type
          default: scoring_function
        description:
          title: Description
          type: string
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
          description: Any additional metadata for this definition
        return_type:
          oneOf:
          - $ref: '#/components/schemas/StringType'
          - $ref: '#/components/schemas/NumberType'
          - $ref: '#/components/schemas/BooleanType'
          - $ref: '#/components/schemas/ArrayType'
          - $ref: '#/components/schemas/ObjectType'
          - $ref: '#/components/schemas/JsonType'
          - $ref: '#/components/schemas/UnionType'
          - $ref: '#/components/schemas/ChatCompletionInputType'
          - $ref: '#/components/schemas/CompletionInputType'
          - $ref: '#/components/schemas/AgentTurnInputType'
          title: Return Type
          description: The return type of the deterministic function
          discriminator:
            propertyName: type
            mapping:
              agent_turn_input: '#/components/schemas/AgentTurnInputType'
              array: '#/components/schemas/ArrayType'
              boolean: '#/components/schemas/BooleanType'
              chat_completion_input: '#/components/schemas/ChatCompletionInputType'
              completion_input: '#/components/schemas/CompletionInputType'
              json: '#/components/schemas/JsonType'
              number: '#/components/schemas/NumberType'
              object: '#/components/schemas/ObjectType'
              string: '#/components/schemas/StringType'
              union: '#/components/schemas/UnionType'
        params:
          title: Params
          description: The parameters for the scoring function for benchmark eval, these can be overridden for app eval
          oneOf:
          - $ref: '#/components/schemas/LLMAsJudgeScoringFnParams'
          - $ref: '#/components/schemas/RegexParserScoringFnParams'
          - $ref: '#/components/schemas/BasicScoringFnParams'
          discriminator:
            propertyName: type
            mapping:
              basic: '#/components/schemas/BasicScoringFnParams'
              llm_as_judge: '#/components/schemas/LLMAsJudgeScoringFnParams'
              regex_parser: '#/components/schemas/RegexParserScoringFnParams'
      type: object
      required:
      - identifier
      - provider_id
      - return_type
      title: ScoringFn
      description: A scoring function resource for evaluating model outputs.
    ScoringResult:
      properties:
        score_rows:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Score Rows
        aggregated_results:
          additionalProperties: true
          type: object
          title: Aggregated Results
      type: object
      required:
      - score_rows
      - aggregated_results
      title: ScoringResult
      description: A scoring result for a single row.
    SearchRankingOptions:
      properties:
        ranker:
          title: Ranker
          type: string
        score_threshold:
          title: Score Threshold
          default: 0.0
          type: number
      type: object
      title: SearchRankingOptions
      description: Options for ranking and filtering search results.
    Shield:
      properties:
        identifier:
          type: string
          title: Identifier
          description: Unique identifier for this resource in llama stack
        provider_resource_id:
          title: Provider Resource Id
          description: Unique identifier for this resource in the provider
          type: string
        provider_id:
          type: string
          title: Provider Id
          description: ID of the provider that owns this resource
        type:
          type: string
          const: shield
          title: Type
          default: shield
        params:
          title: Params
          additionalProperties: true
          type: object
      type: object
      required:
      - identifier
      - provider_id
      title: Shield
      description: A safety shield resource that can be used to check content.
    ShieldCallStep-Output:
      properties:
        turn_id:
          type: string
          title: Turn Id
        step_id:
          type: string
          title: Step Id
        started_at:
          title: Started At
          type: string
          format: date-time
        completed_at:
          title: Completed At
          type: string
          format: date-time
        step_type:
          type: string
          const: shield_call
          title: Step Type
          default: shield_call
        violation:
          $ref: '#/components/schemas/SafetyViolation'
      type: object
      required:
      - turn_id
      - step_id
      - violation
      title: ShieldCallStep
      description: A shield call step in an agent turn.
    StopReason:
      type: string
      enum:
      - end_of_turn
      - end_of_message
      - out_of_tokens
      title: StopReason
    StringType:
      properties:
        type:
          type: string
          const: string
          title: Type
          default: string
      type: object
      title: StringType
      description: Parameter type for string values.
    SystemMessage:
      properties:
        role:
          type: string
          const: system
          title: Role
          default: system
        content:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Input'
            - $ref: '#/components/schemas/TextContentItem'
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Input'
                text: '#/components/schemas/TextContentItem'
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Input'
              - $ref: '#/components/schemas/TextContentItem'
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Input'
                  text: '#/components/schemas/TextContentItem'
            type: array
          title: Content
      type: object
      required:
      - content
      title: SystemMessage
      description: A system message providing instructions or context to the model.
    SystemMessageBehavior:
      type: string
      enum:
      - append
      - replace
      title: SystemMessageBehavior
      description: Config for how to override the default system prompt.
    TextContentItem:
      properties:
        type:
          type: string
          const: text
          title: Type
          default: text
        text:
          type: string
          title: Text
      type: object
      required:
      - text
      title: TextContentItem
      description: A text content item
    ToolCall:
      properties:
        call_id:
          type: string
          title: Call Id
        tool_name:
          anyOf:
          - $ref: '#/components/schemas/BuiltinTool'
          - type: string
          title: Tool Name
        arguments:
          type: string
          title: Arguments
      type: object
      required:
      - call_id
      - tool_name
      - arguments
      title: ToolCall
    ToolChoice:
      type: string
      enum:
      - auto
      - required
      - none
      title: ToolChoice
      description: Whether tool use is required or automatic. This is a hint to the model which may not be followed. It depends on the Instruction Following capabilities of the model.
    ToolConfig:
      properties:
        tool_choice:
          anyOf:
          - $ref: '#/components/schemas/ToolChoice'
          - type: string
          title: Tool Choice
          default: auto
        tool_prompt_format:
          $ref: '#/components/schemas/ToolPromptFormat'
        system_message_behavior:
          default: append
          $ref: '#/components/schemas/SystemMessageBehavior'
      type: object
      title: ToolConfig
      description: Configuration for tool use.
    ToolDef:
      properties:
        toolgroup_id:
          title: Toolgroup Id
          type: string
        name:
          type: string
          title: Name
        description:
          title: Description
          type: string
        input_schema:
          title: Input Schema
          additionalProperties: true
          type: object
        output_schema:
          title: Output Schema
          additionalProperties: true
          type: object
        metadata:
          title: Metadata
          additionalProperties: true
          type: object
      type: object
      required:
      - name
      title: ToolDef
      description: Tool definition used in runtime contexts.
    ToolExecutionStep-Output:
      properties:
        turn_id:
          type: string
          title: Turn Id
        step_id:
          type: string
          title: Step Id
        started_at:
          title: Started At
          type: string
          format: date-time
        completed_at:
          title: Completed At
          type: string
          format: date-time
        step_type:
          type: string
          const: tool_execution
          title: Step Type
          default: tool_execution
        tool_calls:
          items:
            $ref: '#/components/schemas/ToolCall'
          type: array
          title: Tool Calls
        tool_responses:
          items:
            $ref: '#/components/schemas/ToolResponse-Output'
          type: array
          title: Tool Responses
      type: object
      required:
      - turn_id
      - step_id
      - tool_calls
      - tool_responses
      title: ToolExecutionStep
      description: A tool execution step in an agent turn.
    ToolGroup:
      properties:
        identifier:
          type: string
          title: Identifier
          description: Unique identifier for this resource in llama stack
        provider_resource_id:
          title: Provider Resource Id
          description: Unique identifier for this resource in the provider
          type: string
        provider_id:
          type: string
          title: Provider Id
          description: ID of the provider that owns this resource
        type:
          type: string
          const: tool_group
          title: Type
          default: tool_group
        mcp_endpoint:
          $ref: '#/components/schemas/URL'
        args:
          title: Args
          additionalProperties: true
          type: object
      type: object
      required:
      - identifier
      - provider_id
      title: ToolGroup
      description: A group of related tools managed together.
    ToolInvocationResult:
      properties:
        content:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Output'
            - $ref: '#/components/schemas/TextContentItem'
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Output'
                text: '#/components/schemas/TextContentItem'
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Output'
              - $ref: '#/components/schemas/TextContentItem'
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Output'
                  text: '#/components/schemas/TextContentItem'
            type: array
          title: Content
        error_message:
          title: Error Message
          type: string
        error_code:
          title: Error Code
          type: integer
        metadata:
          title: Metadata
          additionalProperties: true
          type: object
      type: object
      title: ToolInvocationResult
      description: Result of a tool invocation.
    ToolPromptFormat:
      type: string
      enum:
      - json
      - function_tag
      - python_list
      title: ToolPromptFormat
      description: Prompt format for calling custom / zero shot tools.
    ToolResponse-Input:
      properties:
        call_id:
          type: string
          title: Call Id
        tool_name:
          anyOf:
          - $ref: '#/components/schemas/BuiltinTool'
          - type: string
          title: Tool Name
        content:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Input'
            - $ref: '#/components/schemas/TextContentItem'
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Input'
                text: '#/components/schemas/TextContentItem'
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Input'
              - $ref: '#/components/schemas/TextContentItem'
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Input'
                  text: '#/components/schemas/TextContentItem'
            type: array
          title: Content
        metadata:
          title: Metadata
          additionalProperties: true
          type: object
      type: object
      required:
      - call_id
      - tool_name
      - content
      title: ToolResponse
      description: Response from a tool invocation.
    ToolResponse-Output:
      properties:
        call_id:
          type: string
          title: Call Id
        tool_name:
          anyOf:
          - $ref: '#/components/schemas/BuiltinTool'
          - type: string
          title: Tool Name
        content:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Output'
            - $ref: '#/components/schemas/TextContentItem'
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Output'
                text: '#/components/schemas/TextContentItem'
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Output'
              - $ref: '#/components/schemas/TextContentItem'
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Output'
                  text: '#/components/schemas/TextContentItem'
            type: array
          title: Content
        metadata:
          title: Metadata
          additionalProperties: true
          type: object
      type: object
      required:
      - call_id
      - tool_name
      - content
      title: ToolResponse
      description: Response from a tool invocation.
    ToolResponseMessage-Output:
      properties:
        role:
          type: string
          const: tool
          title: Role
          default: tool
        call_id:
          type: string
          title: Call Id
        content:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Output'
            - $ref: '#/components/schemas/TextContentItem'
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Output'
                text: '#/components/schemas/TextContentItem'
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Output'
              - $ref: '#/components/schemas/TextContentItem'
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Output'
                  text: '#/components/schemas/TextContentItem'
            type: array
          title: Content
      type: object
      required:
      - call_id
      - content
      title: ToolResponseMessage
      description: A message representing the result of a tool invocation.
    TopKSamplingStrategy:
      properties:
        type:
          type: string
          const: top_k
          title: Type
          default: top_k
        top_k:
          type: integer
          minimum: 1.0
          title: Top K
      type: object
      required:
      - top_k
      title: TopKSamplingStrategy
      description: Top-k sampling strategy that restricts sampling to the k most likely tokens.
    TopPSamplingStrategy:
      properties:
        type:
          type: string
          const: top_p
          title: Type
          default: top_p
        temperature:
          title: Temperature
          type: number
          minimum: 0.0
        top_p:
          title: Top P
          default: 0.95
          type: number
      type: object
      required:
      - temperature
      title: TopPSamplingStrategy
      description: Top-p (nucleus) sampling strategy that samples from the smallest set of tokens with cumulative probability >= p.
    TrainingConfig:
      properties:
        n_epochs:
          type: integer
          title: N Epochs
        max_steps_per_epoch:
          type: integer
          title: Max Steps Per Epoch
          default: 1
        gradient_accumulation_steps:
          type: integer
          title: Gradient Accumulation Steps
          default: 1
        max_validation_steps:
          title: Max Validation Steps
          default: 1
          type: integer
        data_config:
          $ref: '#/components/schemas/DataConfig'
        optimizer_config:
          $ref: '#/components/schemas/OptimizerConfig'
        efficiency_config:
          $ref: '#/components/schemas/EfficiencyConfig'
        dtype:
          title: Dtype
          default: bf16
          type: string
      type: object
      required:
      - n_epochs
      title: TrainingConfig
      description: Comprehensive configuration for the training process.
    Turn:
      properties:
        turn_id:
          type: string
          title: Turn Id
        session_id:
          type: string
          title: Session Id
        input_messages:
          items:
            anyOf:
            - $ref: '#/components/schemas/UserMessage-Output'
            - $ref: '#/components/schemas/ToolResponseMessage-Output'
          type: array
          title: Input Messages
        steps:
          items:
            oneOf:
            - $ref: '#/components/schemas/InferenceStep-Output'
            - $ref: '#/components/schemas/ToolExecutionStep-Output'
            - $ref: '#/components/schemas/ShieldCallStep-Output'
            - $ref: '#/components/schemas/MemoryRetrievalStep-Output'
            discriminator:
              propertyName: step_type
              mapping:
                inference: '#/components/schemas/InferenceStep-Output'
                memory_retrieval: '#/components/schemas/MemoryRetrievalStep-Output'
                shield_call: '#/components/schemas/ShieldCallStep-Output'
                tool_execution: '#/components/schemas/ToolExecutionStep-Output'
          type: array
          title: Steps
        output_message:
          $ref: '#/components/schemas/CompletionMessage-Output'
        output_attachments:
          title: Output Attachments
          items:
            $ref: '#/components/schemas/Attachment-Output'
          type: array
        started_at:
          type: string
          format: date-time
          title: Started At
        completed_at:
          title: Completed At
          type: string
          format: date-time
      type: object
      required:
      - turn_id
      - session_id
      - input_messages
      - steps
      - output_message
      - started_at
      title: Turn
      description: A single turn in an interaction with an Agentic System.
    URIDataSource:
      properties:
        type:
          type: string
          const: uri
          title: Type
          default: uri
        uri:
          type: string
          title: Uri
      type: object
      required:
      - uri
      title: URIDataSource
      description: A dataset that can be obtained from a URI.
    URL:
      properties:
        uri:
          type: string
          title: Uri
      type: object
      required:
      - uri
      title: URL
      description: A URL reference to external content.
    UnionType:
      properties:
        type:
          type: string
          const: union
          title: Type
          default: union
      type: object
      title: UnionType
      description: Parameter type for union values.
    UserMessage-Input:
      properties:
        role:
          type: string
          const: user
          title: Role
          default: user
        content:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Input'
            - $ref: '#/components/schemas/TextContentItem'
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Input'
                text: '#/components/schemas/TextContentItem'
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Input'
              - $ref: '#/components/schemas/TextContentItem'
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Input'
                  text: '#/components/schemas/TextContentItem'
            type: array
          title: Content
        context:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Input'
            - $ref: '#/components/schemas/TextContentItem'
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Input'
                text: '#/components/schemas/TextContentItem'
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Input'
              - $ref: '#/components/schemas/TextContentItem'
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Input'
                  text: '#/components/schemas/TextContentItem'
            type: array
          title: Context
      type: object
      required:
      - content
      title: UserMessage
      description: A message from the user in a chat conversation.
    UserMessage-Output:
      properties:
        role:
          type: string
          const: user
          title: Role
          default: user
        content:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Output'
            - $ref: '#/components/schemas/TextContentItem'
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Output'
                text: '#/components/schemas/TextContentItem'
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Output'
              - $ref: '#/components/schemas/TextContentItem'
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Output'
                  text: '#/components/schemas/TextContentItem'
            type: array
          title: Content
        context:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Output'
            - $ref: '#/components/schemas/TextContentItem'
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Output'
                text: '#/components/schemas/TextContentItem'
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Output'
              - $ref: '#/components/schemas/TextContentItem'
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Output'
                  text: '#/components/schemas/TextContentItem'
            type: array
          title: Context
      type: object
      required:
      - content
      title: UserMessage
      description: A message from the user in a chat conversation.
    VectorStoreChunkingStrategyAuto:
      properties:
        type:
          type: string
          const: auto
          title: Type
          default: auto
      type: object
      title: VectorStoreChunkingStrategyAuto
      description: Automatic chunking strategy for vector store files.
    VectorStoreChunkingStrategyStatic:
      properties:
        type:
          type: string
          const: static
          title: Type
          default: static
        static:
          $ref: '#/components/schemas/VectorStoreChunkingStrategyStaticConfig'
      type: object
      required:
      - static
      title: VectorStoreChunkingStrategyStatic
      description: Static chunking strategy with configurable parameters.
    VectorStoreChunkingStrategyStaticConfig:
      properties:
        chunk_overlap_tokens:
          type: integer
          title: Chunk Overlap Tokens
          default: 400
        max_chunk_size_tokens:
          type: integer
          maximum: 4096.0
          minimum: 100.0
          title: Max Chunk Size Tokens
          default: 800
      type: object
      title: VectorStoreChunkingStrategyStaticConfig
      description: Configuration for static chunking strategy.
    VectorStoreContent:
      properties:
        type:
          type: string
          const: text
          title: Type
        text:
          type: string
          title: Text
      type: object
      required:
      - type
      - text
      title: VectorStoreContent
      description: Content item from a vector store file or search result.
    VectorStoreFileBatchObject:
      properties:
        id:
          type: string
          title: Id
        object:
          type: string
          title: Object
          default: vector_store.file_batch
        created_at:
          type: integer
          title: Created At
        vector_store_id:
          type: string
          title: Vector Store Id
        status:
          anyOf:
          - type: string
            const: completed
          - type: string
            const: in_progress
          - type: string
            const: cancelled
          - type: string
            const: failed
          title: Status
        file_counts:
          $ref: '#/components/schemas/VectorStoreFileCounts'
      type: object
      required:
      - id
      - created_at
      - vector_store_id
      - status
      - file_counts
      title: VectorStoreFileBatchObject
      description: OpenAI Vector Store File Batch object.
    VectorStoreFileCounts:
      properties:
        completed:
          type: integer
          title: Completed
        cancelled:
          type: integer
          title: Cancelled
        failed:
          type: integer
          title: Failed
        in_progress:
          type: integer
          title: In Progress
        total:
          type: integer
          title: Total
      type: object
      required:
      - completed
      - cancelled
      - failed
      - in_progress
      - total
      title: VectorStoreFileCounts
      description: File processing status counts for a vector store.
    VectorStoreFileLastError:
      properties:
        code:
          anyOf:
          - type: string
            const: server_error
          - type: string
            const: rate_limit_exceeded
          title: Code
        message:
          type: string
          title: Message
      type: object
      required:
      - code
      - message
      title: VectorStoreFileLastError
      description: Error information for failed vector store file processing.
    VectorStoreFileObject:
      properties:
        id:
          type: string
          title: Id
        object:
          type: string
          title: Object
          default: vector_store.file
        attributes:
          additionalProperties: true
          type: object
          title: Attributes
        chunking_strategy:
          oneOf:
          - $ref: '#/components/schemas/VectorStoreChunkingStrategyAuto'
          - $ref: '#/components/schemas/VectorStoreChunkingStrategyStatic'
          title: Chunking Strategy
          discriminator:
            propertyName: type
            mapping:
              auto: '#/components/schemas/VectorStoreChunkingStrategyAuto'
              static: '#/components/schemas/VectorStoreChunkingStrategyStatic'
        created_at:
          type: integer
          title: Created At
        last_error:
          $ref: '#/components/schemas/VectorStoreFileLastError'
        status:
          anyOf:
          - type: string
            const: completed
          - type: string
            const: in_progress
          - type: string
            const: cancelled
          - type: string
            const: failed
          title: Status
        usage_bytes:
          type: integer
          title: Usage Bytes
          default: 0
        vector_store_id:
          type: string
          title: Vector Store Id
      type: object
      required:
      - id
      - chunking_strategy
      - created_at
      - status
      - vector_store_id
      title: VectorStoreFileObject
      description: OpenAI Vector Store File object.
    VectorStoreObject:
      properties:
        id:
          type: string
          title: Id
        object:
          type: string
          title: Object
          default: vector_store
        created_at:
          type: integer
          title: Created At
        name:
          title: Name
          type: string
        usage_bytes:
          type: integer
          title: Usage Bytes
          default: 0
        file_counts:
          $ref: '#/components/schemas/VectorStoreFileCounts'
        status:
          type: string
          title: Status
          default: completed
        expires_after:
          title: Expires After
          additionalProperties: true
          type: object
        expires_at:
          title: Expires At
          type: integer
        last_active_at:
          title: Last Active At
          type: integer
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
      type: object
      required:
      - id
      - created_at
      - file_counts
      title: VectorStoreObject
      description: OpenAI Vector Store object.
    VectorStoreSearchResponse:
      properties:
        file_id:
          type: string
          title: File Id
        filename:
          type: string
          title: Filename
        score:
          type: number
          title: Score
        attributes:
          title: Attributes
          additionalProperties:
            anyOf:
            - type: string
            - type: number
            - type: boolean
          type: object
        content:
          items:
            $ref: '#/components/schemas/VectorStoreContent'
          type: array
          title: Content
      type: object
      required:
      - file_id
      - filename
      - score
      - content
      title: VectorStoreSearchResponse
      description: Response from searching a vector store.
    VectorStoreSearchResponsePage:
      properties:
        object:
          type: string
          title: Object
          default: vector_store.search_results.page
        search_query:
          type: string
          title: Search Query
        data:
          items:
            $ref: '#/components/schemas/VectorStoreSearchResponse'
          type: array
          title: Data
        has_more:
          type: boolean
          title: Has More
          default: false
        next_page:
          title: Next Page
          type: string
      type: object
      required:
      - search_query
      - data
      title: VectorStoreSearchResponsePage
      description: Paginated response from searching a vector store.
    VersionInfo:
      properties:
        version:
          type: string
          title: Version
      type: object
      required:
      - version
      title: VersionInfo
      description: Version information for the service.
    ViolationLevel:
      type: string
      enum:
      - info
      - warn
      - error
      title: ViolationLevel
      description: Severity level of a safety violation.
    WeightedRanker:
      properties:
        type:
          type: string
          const: weighted
          title: Type
          default: weighted
        alpha:
          type: number
          maximum: 1.0
          minimum: 0.0
          title: Alpha
          description: Weight factor between 0 and 1. 0 means only keyword scores, 1 means only vector scores.
          default: 0.5
      type: object
      title: WeightedRanker
      description: Weighted ranker configuration that combines vector and keyword scores.
    _URLOrData:
      properties:
        url:
          $ref: '#/components/schemas/URL'
        data:
          contentEncoding: base64
          title: Data
          type: string
      type: object
      title: _URLOrData
      description: A URL or a base64 encoded string
    __main_____agents_agent_id_session_Request:
      properties:
        agent_id:
          type: string
          title: Agent Id
        session_name:
          type: string
          title: Session Name
      type: object
      required:
      - agent_id
      - session_name
      title: _agents_agent_id_session_Request
    __main_____agents_agent_id_session_session_id_turn_Request:
      properties:
        agent_id:
          type: string
          title: Agent Id
        session_id:
          type: string
          title: Session Id
        messages:
          $ref: '#/components/schemas/UserMessage-Input'
        stream:
          type: boolean
          title: Stream
          default: false
        documents:
          $ref: '#/components/schemas/Document'
        toolgroups:
          anyOf:
          - type: string
          - $ref: '#/components/schemas/AgentToolGroupWithArgs'
          title: Toolgroups
        tool_config:
          $ref: '#/components/schemas/ToolConfig'
      type: object
      required:
      - agent_id
      - session_id
      - messages
      - documents
      - toolgroups
      - tool_config
      title: _agents_agent_id_session_session_id_turn_Request
    __main_____agents_agent_id_session_session_id_turn_turn_id_resume_Request:
      properties:
        agent_id:
          type: string
          title: Agent Id
        session_id:
          type: string
          title: Session Id
        turn_id:
          type: string
          title: Turn Id
        tool_responses:
          $ref: '#/components/schemas/ToolResponse-Input'
        stream:
          type: boolean
          title: Stream
          default: false
      type: object
      required:
      - agent_id
      - session_id
      - turn_id
      - tool_responses
      title: _agents_agent_id_session_session_id_turn_turn_id_resume_Request
    __main_____datasets_Request:
      properties:
        purpose:
          $ref: '#/components/schemas/DatasetPurpose'
        metadata:
          type: string
          title: Metadata
        dataset_id:
          type: string
          title: Dataset Id
      type: object
      required:
      - purpose
      - metadata
      - dataset_id
      title: _datasets_Request
    _batches_Request:
      properties:
        input_file_id:
          type: string
          title: Input File Id
        endpoint:
          type: string
          title: Endpoint
        completion_window:
          type: string
          title: Completion Window
        metadata:
          type: string
          title: Metadata
        idempotency_key:
          type: string
          title: Idempotency Key
      type: object
      required:
      - input_file_id
      - endpoint
      - completion_window
      - metadata
      - idempotency_key
      title: _batches_Request
    _batches_batch_id_cancel_Request:
      properties:
        batch_id:
          type: string
          title: Batch Id
      type: object
      required:
      - batch_id
      title: _batches_batch_id_cancel_Request
    _conversations_Request:
      properties:
        items:
          oneOf:
          - $ref: '#/components/schemas/OpenAIResponseMessage-Input'
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
          - $ref: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
          - $ref: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
          - $ref: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
          title: Items
          discriminator:
            propertyName: type
            mapping:
              file_search_call: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
              function_call: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
              function_call_output: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
              mcp_approval_request: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
              mcp_approval_response: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
              mcp_call: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
              mcp_list_tools: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
              message: '#/components/schemas/OpenAIResponseMessage-Input'
              web_search_call: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
        metadata:
          type: string
          title: Metadata
      type: object
      required:
      - items
      - metadata
      title: _conversations_Request
    _conversations_conversation_id_Request:
      properties:
        conversation_id:
          type: string
          title: Conversation Id
        metadata:
          type: string
          title: Metadata
      type: object
      required:
      - conversation_id
      - metadata
      title: _conversations_conversation_id_Request
    _conversations_conversation_id_items_Request:
      properties:
        conversation_id:
          type: string
          title: Conversation Id
        items:
          anyOf:
          - $ref: '#/components/schemas/OpenAIResponseMessage-Input'
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
          - $ref: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
          - $ref: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
          - $ref: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
          title: Items
      type: object
      required:
      - conversation_id
      - items
      title: _conversations_conversation_id_items_Request
    _inference_rerank_Request:
      properties:
        model:
          type: string
          title: Model
        query:
          type: string
          title: Query
        items:
          type: string
          title: Items
        max_num_results:
          type: integer
          title: Max Num Results
      type: object
      required:
      - model
      - query
      - items
      - max_num_results
      title: _inference_rerank_Request
    _models_Request:
      properties:
        model_id:
          type: string
          title: Model Id
        provider_model_id:
          type: string
          title: Provider Model Id
        provider_id:
          type: string
          title: Provider Id
        metadata:
          type: string
          title: Metadata
        model_type:
          $ref: '#/components/schemas/ModelType'
      type: object
      required:
      - model_id
      - provider_model_id
      - provider_id
      - metadata
      - model_type
      title: _models_Request
    _moderations_Request:
      properties:
        input:
          type: string
          title: Input
        model:
          type: string
          title: Model
      type: object
      required:
      - input
      - model
      title: _moderations_Request
    _prompts_Request:
      properties:
        prompt:
          type: string
          title: Prompt
        variables:
          type: string
          title: Variables
      type: object
      required:
      - prompt
      - variables
      title: _prompts_Request
    _prompts_prompt_id_Request:
      properties:
        prompt_id:
          type: string
          title: Prompt Id
        prompt:
          type: string
          title: Prompt
        version:
          type: integer
          title: Version
        variables:
          type: string
          title: Variables
        set_as_default:
          type: boolean
          title: Set As Default
          default: true
      type: object
      required:
      - prompt_id
      - prompt
      - version
      - variables
      title: _prompts_prompt_id_Request
    _prompts_prompt_id_set_default_version_Request:
      properties:
        prompt_id:
          type: string
          title: Prompt Id
        version:
          type: integer
          title: Version
      type: object
      required:
      - prompt_id
      - version
      title: _prompts_prompt_id_set_default_version_Request
    _responses_Request:
      properties:
        input:
          type: string
          title: Input
        model:
          type: string
          title: Model
        prompt:
          $ref: '#/components/schemas/OpenAIResponsePrompt'
        instructions:
          type: string
          title: Instructions
        previous_response_id:
          type: string
          title: Previous Response Id
        conversation:
          type: string
          title: Conversation
        store:
          type: boolean
          title: Store
          default: true
        stream:
          type: boolean
          title: Stream
          default: false
        temperature:
          type: number
          title: Temperature
        text:
          $ref: '#/components/schemas/OpenAIResponseText'
        tools:
          oneOf:
          - $ref: '#/components/schemas/OpenAIResponseInputToolWebSearch'
          - $ref: '#/components/schemas/OpenAIResponseInputToolFileSearch'
          - $ref: '#/components/schemas/OpenAIResponseInputToolFunction'
          - $ref: '#/components/schemas/OpenAIResponseInputToolMCP'
          title: Tools
          discriminator:
            propertyName: type
            mapping:
              file_search: '#/components/schemas/OpenAIResponseInputToolFileSearch'
              function: '#/components/schemas/OpenAIResponseInputToolFunction'
              mcp: '#/components/schemas/OpenAIResponseInputToolMCP'
              web_search: '#/components/schemas/OpenAIResponseInputToolWebSearch'
              web_search_preview: '#/components/schemas/OpenAIResponseInputToolWebSearch'
              web_search_preview_2025_03_11: '#/components/schemas/OpenAIResponseInputToolWebSearch'
        include:
          type: string
          title: Include
        max_infer_iters:
          type: integer
          title: Max Infer Iters
          default: 10
      type: object
      required:
      - input
      - model
      - prompt
      - instructions
      - previous_response_id
      - conversation
      - temperature
      - text
      - tools
      - include
      title: _responses_Request
    _scoring_score_Request:
      properties:
        input_rows:
          type: string
          title: Input Rows
        scoring_functions:
          type: string
          title: Scoring Functions
      type: object
      required:
      - input_rows
      - scoring_functions
      title: _scoring_score_Request
    _scoring_score_batch_Request:
      properties:
        dataset_id:
          type: string
          title: Dataset Id
        scoring_functions:
          type: string
          title: Scoring Functions
        save_results_dataset:
          type: boolean
          title: Save Results Dataset
          default: false
      type: object
      required:
      - dataset_id
      - scoring_functions
      title: _scoring_score_batch_Request
    _shields_Request:
      properties:
        shield_id:
          type: string
          title: Shield Id
        provider_shield_id:
          type: string
          title: Provider Shield Id
        provider_id:
          type: string
          title: Provider Id
        params:
          type: string
          title: Params
      type: object
      required:
      - shield_id
      - provider_shield_id
      - provider_id
      - params
      title: _shields_Request
    _tool_runtime_invoke_Request:
      properties:
        tool_name:
          type: string
          title: Tool Name
        kwargs:
          type: string
          title: Kwargs
      type: object
      required:
      - tool_name
      - kwargs
      title: _tool_runtime_invoke_Request
    _tool_runtime_rag_tool_query_Request:
      properties:
        content:
          type: string
          title: Content
        vector_store_ids:
          type: string
          title: Vector Store Ids
        query_config:
          $ref: '#/components/schemas/RAGQueryConfig'
      type: object
      required:
      - content
      - vector_store_ids
      - query_config
      title: _tool_runtime_rag_tool_query_Request
    _vector_io_query_Request:
      properties:
        vector_store_id:
          type: string
          title: Vector Store Id
        query:
          type: string
          title: Query
        params:
          type: string
          title: Params
      type: object
      required:
      - vector_store_id
      - query
      - params
      title: _vector_io_query_Request
    _vector_stores_vector_store_id_Request:
      properties:
        vector_store_id:
          type: string
          title: Vector Store Id
        name:
          type: string
          title: Name
        expires_after:
          type: string
          title: Expires After
        metadata:
          type: string
          title: Metadata
      type: object
      required:
      - vector_store_id
      - name
      - expires_after
      - metadata
      title: _vector_stores_vector_store_id_Request
    _vector_stores_vector_store_id_file_batches_batch_id_cancel_Request:
      properties:
        batch_id:
          type: string
          title: Batch Id
        vector_store_id:
          type: string
          title: Vector Store Id
      type: object
      required:
      - batch_id
      - vector_store_id
      title: _vector_stores_vector_store_id_file_batches_batch_id_cancel_Request
    _vector_stores_vector_store_id_files_Request:
      properties:
        vector_store_id:
          type: string
          title: Vector Store Id
        file_id:
          type: string
          title: File Id
        attributes:
          type: string
          title: Attributes
        chunking_strategy:
          anyOf:
          - $ref: '#/components/schemas/VectorStoreChunkingStrategyAuto'
          - $ref: '#/components/schemas/VectorStoreChunkingStrategyStatic'
          title: Chunking Strategy
      type: object
      required:
      - vector_store_id
      - file_id
      - attributes
      - chunking_strategy
      title: _vector_stores_vector_store_id_files_Request
    _vector_stores_vector_store_id_files_file_id_Request:
      properties:
        vector_store_id:
          type: string
          title: Vector Store Id
        file_id:
          type: string
          title: File Id
        attributes:
          type: string
          title: Attributes
      type: object
      required:
      - vector_store_id
      - file_id
      - attributes
      title: _vector_stores_vector_store_id_files_file_id_Request
    _vector_stores_vector_store_id_search_Request:
      properties:
        vector_store_id:
          type: string
          title: Vector Store Id
        query:
          type: string
          title: Query
        filters:
          type: string
          title: Filters
        max_num_results:
          type: integer
          title: Max Num Results
          default: 10
        ranking_options:
          $ref: '#/components/schemas/SearchRankingOptions'
        rewrite_query:
          type: boolean
          title: Rewrite Query
          default: false
        search_mode:
          type: string
          title: Search Mode
          default: vector
      type: object
      required:
      - vector_store_id
      - query
      - filters
      - ranking_options
      title: _vector_stores_vector_store_id_search_Request
    Error:
      description: Error response from the API. Roughly follows RFC 7807.
      properties:
        status:
          title: Status
          type: integer
        title:
          title: Title
          type: string
        detail:
          title: Detail
          type: string
        instance:
          title: Instance
          type: string
          nullable: true
      required:
      - status
      - title
      - detail
      title: Error
      type: object
    Agent:
      description: An agent instance with configuration and metadata.
      properties:
        agent_id:
          title: Agent Id
          type: string
        agent_config:
          $ref: '#/components/schemas/AgentConfig'
        created_at:
          format: date-time
          title: Created At
          type: string
      required:
      - agent_id
      - agent_config
      - created_at
      title: Agent
      type: object
    AgentStepResponse:
      description: Response containing details of a specific agent step.
      properties:
        step:
          discriminator:
            mapping:
              inference: '#/$defs/InferenceStep'
              memory_retrieval: '#/$defs/MemoryRetrievalStep'
              shield_call: '#/$defs/ShieldCallStep'
              tool_execution: '#/$defs/ToolExecutionStep'
            propertyName: step_type
          oneOf:
          - $ref: '#/components/schemas/InferenceStep'
          - $ref: '#/components/schemas/ToolExecutionStep'
          - $ref: '#/components/schemas/ShieldCallStep'
          - $ref: '#/components/schemas/MemoryRetrievalStep'
          title: Step
      required:
      - step
      title: AgentStepResponse
      type: object
    CompletionMessage:
      description: A message containing the model's (assistant) response in a chat conversation.
      properties:
        role:
          const: assistant
          default: assistant
          title: Role
          type: string
        content:
          anyOf:
          - type: string
          - discriminator:
              mapping:
                image: '#/$defs/ImageContentItem'
                text: '#/$defs/TextContentItem'
              propertyName: type
            oneOf:
            - $ref: '#/components/schemas/ImageContentItem'
            - $ref: '#/components/schemas/TextContentItem'
          - items:
              discriminator:
                mapping:
                  image: '#/$defs/ImageContentItem'
                  text: '#/$defs/TextContentItem'
                propertyName: type
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem'
              - $ref: '#/components/schemas/TextContentItem'
            type: array
          title: Content
        stop_reason:
          $ref: '#/components/schemas/StopReason'
        tool_calls:
          title: Tool Calls
          items:
            $ref: '#/components/schemas/ToolCall'
          type: array
      required:
      - content
      - stop_reason
      title: CompletionMessage
      type: object
    InferenceStep:
      description: An inference step in an agent turn.
      properties:
        turn_id:
          title: Turn Id
          type: string
        step_id:
          title: Step Id
          type: string
        started_at:
          title: Started At
          format: date-time
          type: string
          nullable: true
        completed_at:
          title: Completed At
          format: date-time
          type: string
          nullable: true
        step_type:
          const: inference
          default: inference
          title: Step Type
          type: string
        model_response:
          $ref: '#/components/schemas/CompletionMessage'
      required:
      - turn_id
      - step_id
      - model_response
      title: InferenceStep
      type: object
    ListOpenAIResponseInputItem:
      description: List container for OpenAI response input items.
      properties:
        data:
          items:
            anyOf:
            - discriminator:
                mapping:
                  file_search_call: '#/$defs/OpenAIResponseOutputMessageFileSearchToolCall'
                  function_call: '#/$defs/OpenAIResponseOutputMessageFunctionToolCall'
                  mcp_approval_request: '#/$defs/OpenAIResponseMCPApprovalRequest'
                  mcp_call: '#/$defs/OpenAIResponseOutputMessageMCPCall'
                  mcp_list_tools: '#/$defs/OpenAIResponseOutputMessageMCPListTools'
                  message: '#/$defs/OpenAIResponseMessage'
                  web_search_call: '#/$defs/OpenAIResponseOutputMessageWebSearchToolCall'
                propertyName: type
              oneOf:
              - $ref: '#/components/schemas/OpenAIResponseMessage'
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
              - $ref: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
            - $ref: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
            - $ref: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
            - $ref: '#/components/schemas/OpenAIResponseMessage'
          title: Data
          type: array
        object:
          const: list
          default: list
          title: Object
          type: string
      required:
      - data
      title: ListOpenAIResponseInputItem
      type: object
    ListOpenAIResponseObject:
      description: Paginated list of OpenAI response objects with navigation metadata.
      properties:
        data:
          items:
            $ref: '#/components/schemas/OpenAIResponseObjectWithInput'
          title: Data
          type: array
        has_more:
          title: Has More
          type: boolean
        first_id:
          title: First Id
          type: string
        last_id:
          title: Last Id
          type: string
        object:
          const: list
          default: list
          title: Object
          type: string
      required:
      - data
      - has_more
      - first_id
      - last_id
      title: ListOpenAIResponseObject
      type: object
    MemoryRetrievalStep:
      description: A memory retrieval step in an agent turn.
      properties:
        turn_id:
          title: Turn Id
          type: string
        step_id:
          title: Step Id
          type: string
        started_at:
          title: Started At
          format: date-time
          type: string
          nullable: true
        completed_at:
          title: Completed At
          format: date-time
          type: string
          nullable: true
        step_type:
          const: memory_retrieval
          default: memory_retrieval
          title: Step Type
          type: string
        vector_store_ids:
          title: Vector Store Ids
          type: string
        inserted_context:
          anyOf:
          - type: string
          - discriminator:
              mapping:
                image: '#/$defs/ImageContentItem'
                text: '#/$defs/TextContentItem'
              propertyName: type
            oneOf:
            - $ref: '#/components/schemas/ImageContentItem'
            - $ref: '#/components/schemas/TextContentItem'
          - items:
              discriminator:
                mapping:
                  image: '#/$defs/ImageContentItem'
                  text: '#/$defs/TextContentItem'
                propertyName: type
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem'
              - $ref: '#/components/schemas/TextContentItem'
            type: array
          title: Inserted Context
      required:
      - turn_id
      - step_id
      - vector_store_ids
      - inserted_context
      title: MemoryRetrievalStep
      type: object
    OpenAIDeleteResponseObject:
      description: Response object confirming deletion of an OpenAI response.
      properties:
        id:
          title: Id
          type: string
        object:
          const: response
          default: response
          title: Object
          type: string
        deleted:
          default: true
          title: Deleted
          type: boolean
      required:
      - id
      title: OpenAIDeleteResponseObject
      type: object
    PaginatedResponse:
      description: A generic paginated response that follows a simple format.
      properties:
        data:
          items:
            additionalProperties: true
            type: object
          title: Data
          type: array
        has_more:
          title: Has More
          type: boolean
        url:
          title: Url
          type: string
          nullable: true
      required:
      - data
      - has_more
      title: PaginatedResponse
      type: object
    Session:
      description: A single session of an interaction with an Agentic System.
      properties:
        session_id:
          title: Session Id
          type: string
        session_name:
          title: Session Name
          type: string
        turns:
          items:
            $ref: '#/components/schemas/Turn'
          title: Turns
          type: array
        started_at:
          format: date-time
          title: Started At
          type: string
      required:
      - session_id
      - session_name
      - turns
      - started_at
      title: Session
      type: object
    ShieldCallStep:
      description: A shield call step in an agent turn.
      properties:
        turn_id:
          title: Turn Id
          type: string
        step_id:
          title: Step Id
          type: string
        started_at:
          title: Started At
          format: date-time
          type: string
          nullable: true
        completed_at:
          title: Completed At
          format: date-time
          type: string
          nullable: true
        step_type:
          const: shield_call
          default: shield_call
          title: Step Type
          type: string
        violation:
          $ref: '#/components/schemas/SafetyViolation'
      required:
      - turn_id
      - step_id
      - violation
      title: ShieldCallStep
      type: object
    ToolExecutionStep:
      description: A tool execution step in an agent turn.
      properties:
        turn_id:
          title: Turn Id
          type: string
        step_id:
          title: Step Id
          type: string
        started_at:
          title: Started At
          format: date-time
          type: string
          nullable: true
        completed_at:
          title: Completed At
          format: date-time
          type: string
          nullable: true
        step_type:
          const: tool_execution
          default: tool_execution
          title: Step Type
          type: string
        tool_calls:
          items:
            $ref: '#/components/schemas/ToolCall'
          title: Tool Calls
          type: array
        tool_responses:
          items:
            $ref: '#/components/schemas/ToolResponse'
          title: Tool Responses
          type: array
      required:
      - turn_id
      - step_id
      - tool_calls
      - tool_responses
      title: ToolExecutionStep
      type: object
    ToolResponse:
      description: Response from a tool invocation.
      properties:
        call_id:
          title: Call Id
          type: string
        tool_name:
          anyOf:
          - $ref: '#/components/schemas/BuiltinTool'
          - type: string
          title: Tool Name
        content:
          anyOf:
          - type: string
          - discriminator:
              mapping:
                image: '#/$defs/ImageContentItem'
                text: '#/$defs/TextContentItem'
              propertyName: type
            oneOf:
            - $ref: '#/components/schemas/ImageContentItem'
            - $ref: '#/components/schemas/TextContentItem'
          - items:
              discriminator:
                mapping:
                  image: '#/$defs/ImageContentItem'
                  text: '#/$defs/TextContentItem'
                propertyName: type
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem'
              - $ref: '#/components/schemas/TextContentItem'
            type: array
          title: Content
        metadata:
          title: Metadata
          additionalProperties: true
          type: object
          nullable: true
      required:
      - call_id
      - tool_name
      - content
      title: ToolResponse
      type: object
    ListBatchesResponse:
      description: Response containing a list of batch objects.
      properties:
        object:
          const: list
          default: list
          title: Object
          type: string
        data:
          description: List of batch objects
          items:
            $ref: '#/components/schemas/Batch'
          title: Data
          type: array
        first_id:
          description: ID of the first batch in the list
          title: First Id
          type: string
          nullable: true
        last_id:
          description: ID of the last batch in the list
          title: Last Id
          type: string
          nullable: true
        has_more:
          default: false
          description: Whether there are more batches available
          title: Has More
          type: boolean
      required:
      - data
      title: ListBatchesResponse
      type: object
    ConversationDeletedResource:
      description: Response for deleted conversation.
      properties:
        id:
          description: The deleted conversation identifier
          title: Id
          type: string
        object:
          default: conversation.deleted
          description: Object type
          title: Object
          type: string
        deleted:
          default: true
          description: Whether the object was deleted
          title: Deleted
          type: boolean
      required:
      - id
      title: ConversationDeletedResource
      type: object
    ConversationItemDeletedResource:
      description: Response for deleted conversation item.
      properties:
        id:
          description: The deleted item identifier
          title: Id
          type: string
        object:
          default: conversation.item.deleted
          description: Object type
          title: Object
          type: string
        deleted:
          default: true
          description: Whether the object was deleted
          title: Deleted
          type: boolean
      required:
      - id
      title: ConversationItemDeletedResource
      type: object
    ListOpenAIFileResponse:
      description: Response for listing files in OpenAI Files API.
      properties:
        data:
          items:
            $ref: '#/components/schemas/OpenAIFileObject'
          title: Data
          type: array
        has_more:
          title: Has More
          type: boolean
        first_id:
          title: First Id
          type: string
        last_id:
          title: Last Id
          type: string
        object:
          const: list
          default: list
          title: Object
          type: string
      required:
      - data
      - has_more
      - first_id
      - last_id
      title: ListOpenAIFileResponse
      type: object
    OpenAIFileDeleteResponse:
      description: Response for deleting a file in OpenAI Files API.
      properties:
        id:
          title: Id
          type: string
        object:
          const: file
          default: file
          title: Object
          type: string
        deleted:
          title: Deleted
          type: boolean
      required:
      - id
      - deleted
      title: OpenAIFileDeleteResponse
      type: object
    ListOpenAIChatCompletionResponse:
      description: Response from listing OpenAI-compatible chat completions.
      properties:
        data:
          items:
            $ref: '#/$defs/RouteInfo'
          title: Data
          type: array
      required:
        - data
      title: ListRoutesResponse
      description: >-
        Response containing a list of all available API routes.
    OpenAIModel:
      type: object
      properties:
        id:
          type: string
        object:
          type: string
          const: model
          default: model
        created:
          type: integer
        owned_by:
          type: string
        custom_metadata:
          type: object
          additionalProperties:
            oneOf:
              - type: 'null'
              - type: boolean
              - type: number
              - type: string
              - type: array
              - type: object
      additionalProperties: false
      required:
        - id
        - object
        - created
        - owned_by
      title: OpenAIModel
      description: A model from OpenAI.
    OpenAIListModelsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/OpenAIModel'
      additionalProperties: false
      required:
        - data
      title: OpenAIListModelsResponse
    ModelType:
      type: string
      enum:
        - llm
        - embedding
        - rerank
      title: ModelType
      description: >-
        Enumeration of supported model types in Llama Stack.
    RegisterModelRequest:
      type: object
      properties:
        model_id:
          type: string
          description: The identifier of the model to register.
        provider_model_id:
          type: string
          description: >-
            The identifier of the model in the provider.
        provider_id:
          type: string
          description: The identifier of the provider.
        metadata:
          type: object
          additionalProperties:
            oneOf:
              - type: 'null'
              - type: boolean
              - type: number
              - type: string
              - type: array
              - type: object
          description: Any additional metadata for this model.
        model_type:
          $ref: '#/components/schemas/ModelType'
          description: The type of model to register.
      additionalProperties: false
      required:
        - model_id
      title: RegisterModelRequest
    Model:
      type: object
      properties:
        identifier:
          type: string
          description: >-
            Unique identifier for this resource in llama stack
        provider_resource_id:
          type: string
          description: >-
            Unique identifier for this resource in the provider
        provider_id:
          type: string
          description: >-
            ID of the provider that owns this resource
        type:
          type: string
          enum:
            - model
            - shield
            - vector_store
            - dataset
            - scoring_function
            - benchmark
            - tool
            - tool_group
            - prompt
          const: model
          default: model
          description: >-
            The resource type, always 'model' for model resources
        metadata:
          type: object
          additionalProperties:
            oneOf:
              - type: 'null'
              - type: boolean
              - type: number
              - type: string
              - type: array
              - type: object
          description: Any additional metadata for this model
        model_type:
          $ref: '#/components/schemas/ModelType'
          default: llm
          description: >-
            The type of model (LLM or embedding model)
      additionalProperties: false
      required:
        - identifier
        - provider_id
        - type
        - metadata
        - model_type
      title: Model
      description: >-
        A model resource representing an AI model registered in Llama Stack.
    RunModerationRequest:
      type: object
    ModerationObject:
      $defs:
        ModerationObjectResults:
          description: >-
            A moderation object.

            :param flagged: Whether any of the below categories are flagged.

            :param categories: A list of the categories, and whether they are flagged
            or not.

            :param category_applied_input_types: A list of the categories along with
            the input type(s) that the score applies to.

            :param category_scores: A list of the categories along with their scores
            as predicted by model.
          properties:
            flagged:
              title: Flagged
              type: boolean
            categories:
              anyOf:
                - additionalProperties:
                    type: boolean
                  type: object
                - type: 'null'
              title: Categories
            category_applied_input_types:
              anyOf:
                - additionalProperties:
                    items:
                      type: string
                    type: array
                  type: object
                - type: 'null'
              title: Category Applied Input Types
            category_scores:
              anyOf:
                - additionalProperties:
                    type: number
                  type: object
                - type: 'null'
              title: Category Scores
            user_message:
              anyOf:
                - type: string
                - type: 'null'
              title: User Message
            metadata:
              additionalProperties: true
              title: Metadata
              type: object
          required:
            - flagged
          title: ModerationObjectResults
          type: object
      description: >-
        A moderation object.

        :param id: The unique identifier for the moderation request.

        :param model: The model used to generate the moderation results.

        :param results: A list of moderation objects
      properties:
        id:
          title: Id
          type: string
        model:
          title: Model
          type: string
        results:
          items:
            $ref: '#/$defs/ModerationObjectResults'
          title: Results
          type: array
      required:
        - id
        - model
        - results
      title: ModerationObject
      type: object
    ListPromptsResponse:
      $defs:
        Prompt:
          description: >-
            A prompt resource representing a stored OpenAI Compatible prompt template
            in Llama Stack.


            :param prompt: The system prompt text with variable placeholders. Variables
            are only supported when using the Responses API.

            :param version: Version (integer starting at 1, incremented on save)

            :param prompt_id: Unique identifier formatted as 'pmpt_<48-digit-hash>'

            :param variables: List of prompt variable names that can be used in the
            prompt template

            :param is_default: Boolean indicating whether this version is the default
            version for this prompt
          properties:
            prompt:
              anyOf:
                - type: string
                - type: 'null'
              description: >-
                The system prompt with variable placeholders
              title: Prompt
            version:
              description: >-
                Version (integer starting at 1, incremented on save)
              minimum: 1
              title: Version
              type: integer
            prompt_id:
              description: >-
                Unique identifier in format 'pmpt_<48-digit-hash>'
              title: Prompt Id
              type: string
            variables:
              description: >-
                List of variable names that can be used in the prompt template
              items:
                type: string
              title: Variables
              type: array
            is_default:
              default: false
              description: >-
                Boolean indicating whether this version is the default version
              title: Is Default
              type: boolean
          required:
            - version
            - prompt_id
          title: Prompt
          type: object
      description: Response model to list prompts.
      properties:
        data:
          items:
            $ref: '#/$defs/Prompt'
          title: Data
          type: array
      required:
        - data
      title: ListPromptsResponse
      type: object
    CreatePromptRequest:
      type: object
    Prompt:
      description: >-
        A prompt resource representing a stored OpenAI Compatible prompt template
        in Llama Stack.


        :param prompt: The system prompt text with variable placeholders. Variables
        are only supported when using the Responses API.

        :param version: Version (integer starting at 1, incremented on save)

        :param prompt_id: Unique identifier formatted as 'pmpt_<48-digit-hash>'

        :param variables: List of prompt variable names that can be used in the prompt
        template

        :param is_default: Boolean indicating whether this version is the default
        version for this prompt
      properties:
        prompt:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            The system prompt with variable placeholders
          title: Prompt
        version:
          description: >-
            Version (integer starting at 1, incremented on save)
          minimum: 1
          title: Version
          type: integer
        prompt_id:
          description: >-
            Unique identifier in format 'pmpt_<48-digit-hash>'
          title: Prompt Id
          type: string
        variables:
          description: >-
            List of variable names that can be used in the prompt template
          items:
            type: string
          title: Variables
          type: array
        is_default:
          default: false
          description: >-
            Boolean indicating whether this version is the default version
          title: Is Default
          type: boolean
      required:
        - version
        - prompt_id
      title: Prompt
      type: object
    UpdatePromptRequest:
      type: object
    SetDefaultVersionRequest:
      type: object
    ListProvidersResponse:
      $defs:
        ProviderInfo:
          description: >-
            Information about a registered provider including its configuration and
            health status.


            :param api: The API name this provider implements

            :param provider_id: Unique identifier for the provider

            :param provider_type: The type of provider implementation

            :param config: Configuration parameters for the provider

            :param health: Current health status of the provider
          properties:
            api:
              title: Api
              type: string
            provider_id:
              title: Provider Id
              type: string
            provider_type:
              title: Provider Type
              type: string
            config:
              additionalProperties: true
              title: Config
              type: object
            health:
              additionalProperties: true
              title: Health
              type: object
          required:
            - api
            - provider_id
            - provider_type
            - config
            - health
          title: ProviderInfo
          type: object
      description: >-
        Response containing a list of all available providers.


        :param data: List of provider information objects
      properties:
        data:
          items:
            $ref: '#/$defs/ProviderInfo'
          title: Data
          type: array
      required:
        - data
      title: ListProvidersResponse
      type: object
    ProviderInfo:
      description: >-
        Information about a registered provider including its configuration and health
        status.


        :param api: The API name this provider implements

        :param provider_id: Unique identifier for the provider

        :param provider_type: The type of provider implementation

        :param config: Configuration parameters for the provider

        :param health: Current health status of the provider
      properties:
        api:
          title: Api
          type: string
        provider_id:
          title: Provider Id
          type: string
        provider_type:
          title: Provider Type
          type: string
        config:
          additionalProperties: true
          title: Config
          type: object
        health:
          additionalProperties: true
          title: Health
          type: object
      required:
        - api
        - provider_id
        - provider_type
        - config
        - health
      title: ProviderInfo
      type: object
    ListOpenAIResponseObject:
      $defs:
        AllowedToolsFilter:
          description: >-
            Filter configuration for restricting which MCP tools can be used.


            :param tool_names: (Optional) List of specific tool names that are allowed
          properties:
            tool_names:
              anyOf:
                - items:
                    type: string
                  type: array
                - type: 'null'
              title: Tool Names
          title: AllowedToolsFilter
          type: object
        MCPListToolsTool:
          description: >-
            Tool definition returned by MCP list tools operation.


            :param input_schema: JSON schema defining the tool's input parameters

            :param name: Name of the tool

            :param description: (Optional) Description of what the tool does
          properties:
            input_schema:
              additionalProperties: true
              title: Input Schema
              type: object
            name:
              title: Name
              type: string
            description:
              anyOf:
                - type: string
                - type: 'null'
              title: Description
          required:
            - input_schema
            - name
          title: MCPListToolsTool
          type: object
        OpenAIResponseAnnotationCitation:
          description: >-
            URL citation annotation for referencing external web resources.


            :param type: Annotation type identifier, always "url_citation"

            :param end_index: End position of the citation span in the content

            :param start_index: Start position of the citation span in the content

            :param title: Title of the referenced web resource

            :param url: URL of the referenced web resource
          properties:
            type:
              const: url_citation
              default: url_citation
              title: Type
              type: string
            end_index:
              title: End Index
              type: integer
            start_index:
              title: Start Index
              type: integer
            title:
              title: Title
              type: string
            url:
              title: Url
              type: string
          required:
            - end_index
            - start_index
            - title
            - url
          title: OpenAIResponseAnnotationCitation
          type: object
        "OpenAIResponseAnnotationContainerFileCitation":
          properties:
            type:
              const: container_file_citation
              default: container_file_citation
              title: Type
              type: string
            container_id:
              title: Container Id
              type: string
            end_index:
              title: End Index
              type: integer
            file_id:
              title: File Id
              type: string
            filename:
              title: Filename
              type: string
            start_index:
              title: Start Index
              type: integer
          required:
            - container_id
            - end_index
            - file_id
            - filename
            - start_index
          title: >-
            OpenAIResponseAnnotationContainerFileCitation
          type: object
        OpenAIResponseAnnotationFileCitation:
          description: >-
            File citation annotation for referencing specific files in response content.


            :param type: Annotation type identifier, always "file_citation"

            :param file_id: Unique identifier of the referenced file

            :param filename: Name of the referenced file

            :param index: Position index of the citation within the content
          properties:
            type:
              const: file_citation
              default: file_citation
              title: Type
              type: string
            file_id:
              title: File Id
              type: string
            filename:
              title: Filename
              type: string
            index:
              title: Index
              type: integer
          required:
            - file_id
            - filename
            - index
          title: OpenAIResponseAnnotationFileCitation
          type: object
        OpenAIResponseAnnotationFilePath:
          properties:
            type:
              const: file_path
              default: file_path
              title: Type
              type: string
            file_id:
              title: File Id
              type: string
            index:
              title: Index
              type: integer
          required:
            - file_id
            - index
          title: OpenAIResponseAnnotationFilePath
          type: object
        OpenAIResponseContentPartRefusal:
          description: >-
            Refusal content within a streamed response part.


            :param type: Content part type identifier, always "refusal"

            :param refusal: Refusal text supplied by the model
          properties:
            type:
              const: refusal
              default: refusal
              title: Type
              type: string
            refusal:
              title: Refusal
              type: string
          required:
            - refusal
          title: OpenAIResponseContentPartRefusal
          type: object
        OpenAIResponseError:
          description: >-
            Error details for failed OpenAI response requests.


            :param code: Error code identifying the type of failure

            :param message: Human-readable error message describing the failure
          properties:
            code:
              title: Code
              type: string
            message:
              title: Message
              type: string
          required:
            - code
            - message
          title: OpenAIResponseError
          type: object
        "OpenAIResponseInputFunctionToolCallOutput":
          description: >-
            This represents the output of a function call that gets passed back to
            the model.
          properties:
            call_id:
              title: Call Id
              type: string
            output:
              title: Output
              type: string
            type:
              const: function_call_output
              default: function_call_output
              title: Type
              type: string
            id:
              anyOf:
                - type: string
                - type: 'null'
              title: Id
            status:
              anyOf:
                - type: string
                - type: 'null'
              title: Status
          required:
            - call_id
            - output
          title: >-
            OpenAIResponseInputFunctionToolCallOutput
          type: object
        OpenAIResponseInputMessageContentImage:
          description: >-
            Image content for input messages in OpenAI response format.


            :param detail: Level of detail for image processing, can be "low", "high",
            or "auto"

            :param type: Content type identifier, always "input_image"

            :param image_url: (Optional) URL of the image content
          properties:
            detail:
              anyOf:
                - const: low
                  type: string
                - const: high
                  type: string
                - const: auto
                  type: string
              default: auto
              title: Detail
            type:
              const: input_image
              default: input_image
              title: Type
              type: string
            image_url:
              anyOf:
                - type: string
                - type: 'null'
              title: Image Url
          title: OpenAIResponseInputMessageContentImage
          type: object
        OpenAIResponseInputMessageContentText:
          description: >-
            Text content for input messages in OpenAI response format.


            :param text: The text content of the input message

            :param type: Content type identifier, always "input_text"
          properties:
            text:
              title: Text
              type: string
            type:
              const: input_text
              default: input_text
              title: Type
              type: string
          required:
            - text
          title: OpenAIResponseInputMessageContentText
          type: object
        OpenAIResponseInputToolFileSearch:
          description: >-
            File search tool configuration for OpenAI response inputs.


            :param type: Tool type identifier, always "file_search"

            :param vector_store_ids: List of vector store identifiers to search within

            :param filters: (Optional) Additional filters to apply to the search

            :param max_num_results: (Optional) Maximum number of search results to
            return (1-50)

            :param ranking_options: (Optional) Options for ranking and scoring search
            results
          properties:
            type:
              const: file_search
              default: file_search
              title: Type
              type: string
            vector_store_ids:
              items:
                type: string
              title: Vector Store Ids
              type: array
            filters:
              anyOf:
                - additionalProperties: true
                  type: object
                - type: 'null'
              title: Filters
            max_num_results:
              anyOf:
                - maximum: 50
                  minimum: 1
                  type: integer
                - type: 'null'
              default: 10
              title: Max Num Results
            ranking_options:
              anyOf:
                - $ref: '#/$defs/SearchRankingOptions'
                - type: 'null'
          required:
            - vector_store_ids
          title: OpenAIResponseInputToolFileSearch
          type: object
        OpenAIResponseInputToolFunction:
          description: >-
            Function tool configuration for OpenAI response inputs.


            :param type: Tool type identifier, always "function"

            :param name: Name of the function that can be called

            :param description: (Optional) Description of what the function does

            :param parameters: (Optional) JSON schema defining the function's parameters

            :param strict: (Optional) Whether to enforce strict parameter validation
          properties:
            type:
              const: function
              default: function
              title: Type
              type: string
            name:
              title: Name
              type: string
            description:
              anyOf:
                - type: string
                - type: 'null'
              title: Description
            parameters:
              anyOf:
                - additionalProperties: true
                  type: object
                - type: 'null'
              title: Parameters
            strict:
              anyOf:
                - type: boolean
                - type: 'null'
              title: Strict
          required:
            - name
            - parameters
          title: OpenAIResponseInputToolFunction
          type: object
        OpenAIResponseInputToolWebSearch:
          description: >-
            Web search tool configuration for OpenAI response inputs.


            :param type: Web search tool type variant to use

            :param search_context_size: (Optional) Size of search context, must be
            "low", "medium", or "high"
          properties:
            type:
              anyOf:
                - const: web_search
                  type: string
                - const: web_search_preview
                  type: string
                - const: web_search_preview_2025_03_11
                  type: string
              default: web_search
              title: Type
            search_context_size:
              anyOf:
                - pattern: ^low|medium|high$
                  type: string
                - type: 'null'
              default: medium
              title: Search Context Size
          title: OpenAIResponseInputToolWebSearch
          type: object
        OpenAIResponseMCPApprovalRequest:
          description: >-
            A request for human approval of a tool invocation.
          properties:
            arguments:
              title: Arguments
              type: string
            id:
              title: Id
              type: string
            name:
              title: Name
              type: string
            server_label:
              title: Server Label
              type: string
            type:
              const: mcp_approval_request
              default: mcp_approval_request
              title: Type
              type: string
          required:
            - arguments
            - id
            - name
            - server_label
          title: OpenAIResponseMCPApprovalRequest
          type: object
        OpenAIResponseMCPApprovalResponse:
          description: A response to an MCP approval request.
          properties:
            approval_request_id:
              title: Approval Request Id
              type: string
            approve:
              title: Approve
              type: boolean
            type:
              const: mcp_approval_response
              default: mcp_approval_response
              title: Type
              type: string
            id:
              anyOf:
                - type: string
                - type: 'null'
              title: Id
            reason:
              anyOf:
                - type: string
                - type: 'null'
              title: Reason
          required:
            - approval_request_id
            - approve
          title: OpenAIResponseMCPApprovalResponse
          type: object
        OpenAIResponseMessage:
          description: >-
            Corresponds to the various Message types in the Responses API.

            They are all under one type because the Responses API gives them all

            the same "type" value, and there is no way to tell them apart in certain

            scenarios.
          properties:
            content:
              anyOf:
                - type: string
                - items:
                    discriminator:
                      mapping:
                        input_image: >-
                          #/$defs/OpenAIResponseInputMessageContentImage
                        input_text: >-
                          #/$defs/OpenAIResponseInputMessageContentText
                      propertyName: type
                    oneOf:
                      - $ref: >-
                          #/$defs/OpenAIResponseInputMessageContentText
                      - $ref: >-
                          #/$defs/OpenAIResponseInputMessageContentImage
                  type: array
                - items:
                    discriminator:
                      mapping:
                        output_text: >-
                          #/$defs/OpenAIResponseOutputMessageContentOutputText
                        refusal: '#/$defs/OpenAIResponseContentPartRefusal'
                      propertyName: type
                    oneOf:
                      - $ref: >-
                          #/$defs/OpenAIResponseOutputMessageContentOutputText
                      - $ref: '#/$defs/OpenAIResponseContentPartRefusal'
                  type: array
              title: Content
            role:
              anyOf:
                - const: system
                  type: string
                - const: developer
                  type: string
                - const: user
                  type: string
                - const: assistant
                  type: string
              title: Role
            type:
              const: message
              default: message
              title: Type
              type: string
            id:
              anyOf:
                - type: string
                - type: 'null'
              title: Id
            status:
              anyOf:
                - type: string
                - type: 'null'
              title: Status
          required:
            - content
            - role
          title: OpenAIResponseMessage
          type: object
        OpenAIResponseObjectWithInput:
          description: >-
            OpenAI response object extended with input context information.


            :param input: List of input items that led to this response
          properties:
            created_at:
              title: Created At
              type: integer
            error:
              anyOf:
                - $ref: '#/$defs/OpenAIResponseError'
                - type: 'null'
            id:
              title: Id
              type: string
            model:
              title: Model
              type: string
            object:
              const: response
              default: response
              title: Object
              type: string
            output:
              items:
                discriminator:
                  mapping:
                    file_search_call: >-
                      #/$defs/OpenAIResponseOutputMessageFileSearchToolCall
                    function_call: >-
                      #/$defs/OpenAIResponseOutputMessageFunctionToolCall
                    mcp_approval_request: '#/$defs/OpenAIResponseMCPApprovalRequest'
                    mcp_call: >-
                      #/$defs/OpenAIResponseOutputMessageMCPCall
                    mcp_list_tools: >-
                      #/$defs/OpenAIResponseOutputMessageMCPListTools
                    message: '#/$defs/OpenAIResponseMessage'
                    web_search_call: >-
                      #/$defs/OpenAIResponseOutputMessageWebSearchToolCall
                  propertyName: type
                oneOf:
                  - $ref: '#/$defs/OpenAIResponseMessage'
                  - $ref: >-
                      #/$defs/OpenAIResponseOutputMessageWebSearchToolCall
                  - $ref: >-
                      #/$defs/OpenAIResponseOutputMessageFileSearchToolCall
                  - $ref: >-
                      #/$defs/OpenAIResponseOutputMessageFunctionToolCall
                  - $ref: >-
                      #/$defs/OpenAIResponseOutputMessageMCPCall
                  - $ref: >-
                      #/$defs/OpenAIResponseOutputMessageMCPListTools
                  - $ref: '#/$defs/OpenAIResponseMCPApprovalRequest'
              title: Output
              type: array
            parallel_tool_calls:
              default: false
              title: Parallel Tool Calls
              type: boolean
            previous_response_id:
              anyOf:
                - type: string
                - type: 'null'
              title: Previous Response Id
            status:
              title: Status
              type: string
            temperature:
              anyOf:
                - type: number
                - type: 'null'
              title: Temperature
            text:
              $ref: '#/$defs/OpenAIResponseText'
              default:
                format:
                  type: text
            top_p:
              anyOf:
                - type: number
                - type: 'null'
              title: Top P
            tools:
              anyOf:
                - items:
                    discriminator:
                      mapping:
                        file_search: >-
                          #/$defs/OpenAIResponseInputToolFileSearch
                        function: '#/$defs/OpenAIResponseInputToolFunction'
                        mcp: '#/$defs/OpenAIResponseToolMCP'
                        web_search: '#/$defs/OpenAIResponseInputToolWebSearch'
                        web_search_preview: '#/$defs/OpenAIResponseInputToolWebSearch'
                        web_search_preview_2025_03_11: '#/$defs/OpenAIResponseInputToolWebSearch'
                      propertyName: type
                    oneOf:
                      - $ref: '#/$defs/OpenAIResponseInputToolWebSearch'
                      - $ref: >-
                          #/$defs/OpenAIResponseInputToolFileSearch
                      - $ref: '#/$defs/OpenAIResponseInputToolFunction'
                      - $ref: '#/$defs/OpenAIResponseToolMCP'
                  type: array
                - type: 'null'
              title: Tools
            truncation:
              anyOf:
                - type: string
                - type: 'null'
              title: Truncation
            usage:
              anyOf:
                - $ref: '#/$defs/OpenAIResponseUsage'
                - type: 'null'
            instructions:
              anyOf:
                - type: string
                - type: 'null'
              title: Instructions
            input:
              items:
                anyOf:
                  - discriminator:
                      mapping:
                        file_search_call: >-
                          #/$defs/OpenAIResponseOutputMessageFileSearchToolCall
                        function_call: >-
                          #/$defs/OpenAIResponseOutputMessageFunctionToolCall
                        mcp_approval_request: '#/$defs/OpenAIResponseMCPApprovalRequest'
                        mcp_call: >-
                          #/$defs/OpenAIResponseOutputMessageMCPCall
                        mcp_list_tools: >-
                          #/$defs/OpenAIResponseOutputMessageMCPListTools
                        message: '#/$defs/OpenAIResponseMessage'
                        web_search_call: >-
                          #/$defs/OpenAIResponseOutputMessageWebSearchToolCall
                      propertyName: type
                    oneOf:
                      - $ref: '#/$defs/OpenAIResponseMessage'
                      - $ref: >-
                          #/$defs/OpenAIResponseOutputMessageWebSearchToolCall
                      - $ref: >-
                          #/$defs/OpenAIResponseOutputMessageFileSearchToolCall
                      - $ref: >-
                          #/$defs/OpenAIResponseOutputMessageFunctionToolCall
                      - $ref: >-
                          #/$defs/OpenAIResponseOutputMessageMCPCall
                      - $ref: >-
                          #/$defs/OpenAIResponseOutputMessageMCPListTools
                      - $ref: '#/$defs/OpenAIResponseMCPApprovalRequest'
                  - $ref: >-
                      #/$defs/OpenAIResponseInputFunctionToolCallOutput
                  - $ref: >-
                      #/$defs/OpenAIResponseMCPApprovalResponse
                  - $ref: '#/$defs/OpenAIResponseMessage'
              title: Input
              type: array
          required:
            - created_at
            - id
            - model
            - output
            - status
            - input
          title: OpenAIResponseObjectWithInput
          type: object
        "OpenAIResponseOutputMessageContentOutputText":
          properties:
            text:
              title: Text
              type: string
            type:
              const: output_text
              default: output_text
              title: Type
              type: string
            annotations:
              items:
                discriminator:
                  mapping:
                    container_file_citation: >-
                      #/$defs/OpenAIResponseAnnotationContainerFileCitation
                    file_citation: >-
                      #/$defs/OpenAIResponseAnnotationFileCitation
                    file_path: '#/$defs/OpenAIResponseAnnotationFilePath'
                    url_citation: '#/$defs/OpenAIResponseAnnotationCitation'
                  propertyName: type
                oneOf:
                  - $ref: >-
                      #/$defs/OpenAIResponseAnnotationFileCitation
                  - $ref: '#/$defs/OpenAIResponseAnnotationCitation'
                  - $ref: >-
                      #/$defs/OpenAIResponseAnnotationContainerFileCitation
                  - $ref: '#/$defs/OpenAIResponseAnnotationFilePath'
              title: Annotations
              type: array
          required:
            - text
          title: >-
            OpenAIResponseOutputMessageContentOutputText
          type: object
        "OpenAIResponseOutputMessageFileSearchToolCall":
          description: >-
            File search tool call output message for OpenAI responses.


            :param id: Unique identifier for this tool call

            :param queries: List of search queries executed

            :param status: Current status of the file search operation

            :param type: Tool call type identifier, always "file_search_call"

            :param results: (Optional) Search results returned by the file search
            operation
          properties:
            id:
              title: Id
              type: string
            queries:
              items:
                type: string
              title: Queries
              type: array
            status:
              title: Status
              type: string
            type:
              const: file_search_call
              default: file_search_call
              title: Type
              type: string
            results:
              anyOf:
                - items:
                    $ref: >-
                      #/$defs/OpenAIResponseOutputMessageFileSearchToolCallResults
                  type: array
                - type: 'null'
              title: Results
          required:
            - id
            - queries
            - status
          title: >-
            OpenAIResponseOutputMessageFileSearchToolCall
          type: object
        "OpenAIResponseOutputMessageFileSearchToolCallResults":
          description: >-
            Search results returned by the file search operation.


            :param attributes: (Optional) Key-value attributes associated with the
            file

            :param file_id: Unique identifier of the file containing the result

            :param filename: Name of the file containing the result

            :param score: Relevance score for this search result (between 0 and 1)

            :param text: Text content of the search result
          properties:
            attributes:
              additionalProperties: true
              title: Attributes
              type: object
            file_id:
              title: File Id
              type: string
            filename:
              title: Filename
              type: string
            score:
              title: Score
              type: number
            text:
              title: Text
              type: string
          required:
            - attributes
            - file_id
            - filename
            - score
            - text
          title: >-
            OpenAIResponseOutputMessageFileSearchToolCallResults
          type: object
        "OpenAIResponseOutputMessageFunctionToolCall":
          description: >-
            Function tool call output message for OpenAI responses.


            :param call_id: Unique identifier for the function call

            :param name: Name of the function being called

            :param arguments: JSON string containing the function arguments

            :param type: Tool call type identifier, always "function_call"

            :param id: (Optional) Additional identifier for the tool call

            :param status: (Optional) Current status of the function call execution
          properties:
            call_id:
              title: Call Id
              type: string
            name:
              title: Name
              type: string
            arguments:
              title: Arguments
              type: string
            type:
              const: function_call
              default: function_call
              title: Type
              type: string
            id:
              anyOf:
                - type: string
                - type: 'null'
              title: Id
            status:
              anyOf:
                - type: string
                - type: 'null'
              title: Status
          required:
            - call_id
            - name
            - arguments
          title: >-
            OpenAIResponseOutputMessageFunctionToolCall
          type: object
        OpenAIResponseOutputMessageMCPCall:
          description: >-
            Model Context Protocol (MCP) call output message for OpenAI responses.


            :param id: Unique identifier for this MCP call

            :param type: Tool call type identifier, always "mcp_call"

            :param arguments: JSON string containing the MCP call arguments

            :param name: Name of the MCP method being called

            :param server_label: Label identifying the MCP server handling the call

            :param error: (Optional) Error message if the MCP call failed

            :param output: (Optional) Output result from the successful MCP call
          properties:
            id:
              title: Id
              type: string
            type:
              const: mcp_call
              default: mcp_call
              title: Type
              type: string
            arguments:
              title: Arguments
              type: string
            name:
              title: Name
              type: string
            server_label:
              title: Server Label
              type: string
            error:
              anyOf:
                - type: string
                - type: 'null'
              title: Error
            output:
              anyOf:
                - type: string
                - type: 'null'
              title: Output
          required:
            - id
            - arguments
            - name
            - server_label
          title: OpenAIResponseOutputMessageMCPCall
          type: object
        OpenAIResponseOutputMessageMCPListTools:
          description: >-
            MCP list tools output message containing available tools from an MCP server.


            :param id: Unique identifier for this MCP list tools operation

            :param type: Tool call type identifier, always "mcp_list_tools"

            :param server_label: Label identifying the MCP server providing the tools

            :param tools: List of available tools provided by the MCP server
          properties:
            id:
              title: Id
              type: string
            type:
              const: mcp_list_tools
              default: mcp_list_tools
              title: Type
              type: string
            server_label:
              title: Server Label
              type: string
            tools:
              items:
                $ref: '#/$defs/MCPListToolsTool'
              title: Tools
              type: array
          required:
            - id
            - server_label
            - tools
          title: OpenAIResponseOutputMessageMCPListTools
          type: object
        "OpenAIResponseOutputMessageWebSearchToolCall":
          description: >-
            Web search tool call output message for OpenAI responses.


            :param id: Unique identifier for this tool call

            :param status: Current status of the web search operation

            :param type: Tool call type identifier, always "web_search_call"
          properties:
            id:
              title: Id
              type: string
            status:
              title: Status
              type: string
            type:
              const: web_search_call
              default: web_search_call
              title: Type
              type: string
          required:
            - id
            - status
          title: >-
            OpenAIResponseOutputMessageWebSearchToolCall
          type: object
        OpenAIResponseText:
          description: >-
            Text response configuration for OpenAI responses.


            :param format: (Optional) Text format configuration specifying output
            format requirements
          properties:
            format:
              anyOf:
                - $ref: '#/$defs/OpenAIResponseTextFormat'
                - type: 'null'
          title: OpenAIResponseText
          type: object
        OpenAIResponseTextFormat:
          description: >-
            Configuration for Responses API text format.


            :param type: Must be "text", "json_schema", or "json_object" to identify
            the format type

            :param name: The name of the response format. Only used for json_schema.

            :param schema: The JSON schema the response should conform to. In a Python
            SDK, this is often a `pydantic` model. Only used for json_schema.

            :param description: (Optional) A description of the response format. Only
            used for json_schema.

            :param strict: (Optional) Whether to strictly enforce the JSON schema.
            If true, the response must match the schema exactly. Only used for json_schema.
          properties:
            type:
              anyOf:
                - const: text
                  type: string
                - const: json_schema
                  type: string
                - const: json_object
                  type: string
              title: Type
            name:
              anyOf:
                - type: string
                - type: 'null'
              title: Name
            schema:
              anyOf:
                - additionalProperties: true
                  type: object
                - type: 'null'
              title: Schema
            description:
              anyOf:
                - type: string
                - type: 'null'
              title: Description
            strict:
              anyOf:
                - type: boolean
                - type: 'null'
              title: Strict
          title: OpenAIResponseTextFormat
          type: object
        OpenAIResponseToolMCP:
          description: >-
            Model Context Protocol (MCP) tool configuration for OpenAI response object.


            :param type: Tool type identifier, always "mcp"

            :param server_label: Label to identify this MCP server

            :param allowed_tools: (Optional) Restriction on which tools can be used
            from this server
          properties:
            type:
              const: mcp
              default: mcp
              title: Type
              type: string
            server_label:
              title: Server Label
              type: string
            allowed_tools:
              anyOf:
                - items:
                    type: string
                  type: array
                - $ref: '#/$defs/AllowedToolsFilter'
                - type: 'null'
              title: Allowed Tools
          required:
            - server_label
          title: OpenAIResponseToolMCP
          type: object
        OpenAIResponseUsage:
          description: >-
            Usage information for OpenAI response.


            :param input_tokens: Number of tokens in the input

            :param output_tokens: Number of tokens in the output

            :param total_tokens: Total tokens used (input + output)

            :param input_tokens_details: Detailed breakdown of input token usage

            :param output_tokens_details: Detailed breakdown of output token usage
          properties:
            input_tokens:
              title: Input Tokens
              type: integer
            output_tokens:
              title: Output Tokens
              type: integer
            total_tokens:
              title: Total Tokens
              type: integer
            input_tokens_details:
              anyOf:
                - $ref: >-
                    #/$defs/OpenAIResponseUsageInputTokensDetails
                - type: 'null'
            output_tokens_details:
              anyOf:
                - $ref: >-
                    #/$defs/OpenAIResponseUsageOutputTokensDetails
                - type: 'null'
          required:
            - input_tokens
            - output_tokens
            - total_tokens
          title: OpenAIResponseUsage
          type: object
        OpenAIResponseUsageInputTokensDetails:
          description: >-
            Token details for input tokens in OpenAI response usage.


            :param cached_tokens: Number of tokens retrieved from cache
          properties:
            cached_tokens:
              anyOf:
                - type: integer
                - type: 'null'
              title: Cached Tokens
          title: OpenAIResponseUsageInputTokensDetails
          type: object
        OpenAIResponseUsageOutputTokensDetails:
          description: >-
            Token details for output tokens in OpenAI response usage.


            :param reasoning_tokens: Number of tokens used for reasoning (o1/o3 models)
          properties:
            reasoning_tokens:
              anyOf:
                - type: integer
                - type: 'null'
              title: Reasoning Tokens
          title: OpenAIResponseUsageOutputTokensDetails
          type: object
        SearchRankingOptions:
          description: >-
            Options for ranking and filtering search results.


            :param ranker: (Optional) Name of the ranking algorithm to use

            :param score_threshold: (Optional) Minimum relevance score threshold for
            results
          properties:
            ranker:
              anyOf:
                - type: string
                - type: 'null'
              title: Ranker
            score_threshold:
              anyOf:
                - type: number
                - type: 'null'
              default: 0.0
              title: Score Threshold
          title: SearchRankingOptions
          type: object
      description: >-
        Paginated list of OpenAI response objects with navigation metadata.


        :param data: List of response objects with their input context

        :param has_more: Whether there are more results available beyond this page

        :param first_id: Identifier of the first item in this page

        :param last_id: Identifier of the last item in this page

        :param object: Object type identifier, always "list"
      properties:
        data:
          items:
            $ref: '#/$defs/OpenAIResponseObjectWithInput'
          title: Data
          type: array
        has_more:
          title: Has More
          type: boolean
        first_id:
          title: First Id
          type: string
        last_id:
          title: Last Id
          type: string
        object:
          const: list
          default: list
          title: Object
          type: string
      required:
      - data
      - has_more
      - first_id
      - last_id
      title: ListOpenAIChatCompletionResponse
      type: object
    OpenAIAssistantMessageParam:
      description: A message containing the model's (assistant) response in an OpenAI-compatible chat completion request.
      properties:
        role:
          const: assistant
          default: assistant
          title: Role
          type: string
        content:
          anyOf:
          - type: string
          - items:
              $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
            type: array
          title: Content
          nullable: true
        name:
          title: Name
          type: string
          nullable: true
        tool_calls:
          title: Tool Calls
          items:
            $ref: '#/components/schemas/OpenAIChatCompletionToolCall'
          type: array
          nullable: true
      title: OpenAIAssistantMessageParam
      type: object
    OpenAIChoice:
      description: A choice from an OpenAI-compatible chat completion response.
      properties:
        message:
          discriminator:
            mapping:
              assistant: '#/$defs/OpenAIAssistantMessageParam'
              developer: '#/$defs/OpenAIDeveloperMessageParam'
              system: '#/$defs/OpenAISystemMessageParam'
              tool: '#/$defs/OpenAIToolMessageParam'
              user: '#/$defs/OpenAIUserMessageParam'
            propertyName: role
          oneOf:
          - $ref: '#/components/schemas/OpenAIUserMessageParam'
          - $ref: '#/components/schemas/OpenAISystemMessageParam'
          - $ref: '#/components/schemas/OpenAIAssistantMessageParam'
          - $ref: '#/components/schemas/OpenAIToolMessageParam'
          - $ref: '#/components/schemas/OpenAIDeveloperMessageParam'
          title: Message
        finish_reason:
          title: Finish Reason
          type: string
        index:
          title: Index
          type: integer
        logprobs:
          $ref: '#/components/schemas/OpenAIChoiceLogprobs'
          nullable: true
      required:
      - message
      - finish_reason
      - index
      title: OpenAIChoice
      type: object
    OpenAIChoiceLogprobs:
      description: The log probabilities for the tokens in the message from an OpenAI-compatible chat completion response.
      properties:
        content:
          title: Content
          items:
            $ref: '#/components/schemas/OpenAITokenLogProb'
          type: array
          nullable: true
        refusal:
          title: Refusal
          items:
            $ref: '#/components/schemas/OpenAITokenLogProb'
          type: array
          nullable: true
      title: OpenAIChoiceLogprobs
      type: object
    OpenAICompletionWithInputMessages:
      properties:
        id:
          title: Id
          type: string
        choices:
          items:
            $ref: '#/components/schemas/OpenAIChoice'
          title: Choices
          type: array
        object:
          const: chat.completion
          default: chat.completion
          title: Object
          type: string
        created:
          title: Created
          type: integer
        model:
          title: Model
          type: string
        usage:
          $ref: '#/components/schemas/OpenAIChatCompletionUsage'
          nullable: true
        input_messages:
          items:
            discriminator:
              mapping:
                assistant: '#/$defs/OpenAIAssistantMessageParam'
                developer: '#/$defs/OpenAIDeveloperMessageParam'
                system: '#/$defs/OpenAISystemMessageParam'
                tool: '#/$defs/OpenAIToolMessageParam'
                user: '#/$defs/OpenAIUserMessageParam'
              propertyName: role
            oneOf:
            - $ref: '#/components/schemas/OpenAIUserMessageParam'
            - $ref: '#/components/schemas/OpenAISystemMessageParam'
            - $ref: '#/components/schemas/OpenAIAssistantMessageParam'
            - $ref: '#/components/schemas/OpenAIToolMessageParam'
            - $ref: '#/components/schemas/OpenAIDeveloperMessageParam'
          title: Input Messages
          type: array
      required:
      - id
      - choices
      - created
      - model
      - input_messages
      title: OpenAICompletionWithInputMessages
      type: object
    OpenAIUserMessageParam:
      description: A message from the user in an OpenAI-compatible chat completion request.
      properties:
        role:
          const: user
          default: user
          title: Role
          type: string
        content:
          anyOf:
          - type: string
          - items:
              discriminator:
                mapping:
                  file: '#/$defs/OpenAIFile'
                  image_url: '#/$defs/OpenAIChatCompletionContentPartImageParam'
                  text: '#/$defs/OpenAIChatCompletionContentPartTextParam'
                propertyName: type
              oneOf:
              - $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
              - $ref: '#/components/schemas/OpenAIChatCompletionContentPartImageParam'
              - $ref: '#/components/schemas/OpenAIFile'
            type: array
          title: Content
        name:
          title: Name
          type: string
          nullable: true
      required:
      - content
      title: OpenAIUserMessageParam
      type: object
    Checkpoint:
      description: Checkpoint created during training runs.
      properties:
        identifier:
          title: Identifier
          type: string
        created_at:
          format: date-time
          title: Created At
          type: string
        epoch:
          title: Epoch
          type: integer
        post_training_job_id:
          title: Post Training Job Id
          type: string
        path:
          title: Path
          type: string
        training_metrics:
          $ref: '#/components/schemas/PostTrainingMetric'
          nullable: true
      required:
      - identifier
      - created_at
      - epoch
      - post_training_job_id
      - path
      title: Checkpoint
      type: object
    PostTrainingJobArtifactsResponse:
      description: Artifacts of a finetuning job.
      properties:
        job_uuid:
          title: Job Uuid
          type: string
        checkpoints:
          items:
            $ref: '#/components/schemas/Checkpoint'
          title: Checkpoints
          type: array
      required:
      - job_uuid
      title: PostTrainingJobArtifactsResponse
      type: object
    PostTrainingJobStatusResponse:
      description: Status of a finetuning job.
      properties:
        job_uuid:
          title: Job Uuid
          type: string
        status:
          $ref: '#/components/schemas/JobStatus'
        scheduled_at:
          title: Scheduled At
          format: date-time
          type: string
          nullable: true
        started_at:
          title: Started At
          format: date-time
          type: string
          nullable: true
        completed_at:
          title: Completed At
          format: date-time
          type: string
          nullable: true
        resources_allocated:
          title: Resources Allocated
          additionalProperties: true
          type: object
          nullable: true
        checkpoints:
          items:
            $ref: '#/components/schemas/Checkpoint'
          title: Checkpoints
          type: array
      required:
      - job_uuid
      - status
      title: PostTrainingJobStatusResponse
      type: object
    ScoringFn:
      description: A scoring function resource for evaluating model outputs.
      properties:
        identifier:
          description: Unique identifier for this resource in llama stack
          title: Identifier
          type: string
        provider_resource_id:
          description: Unique identifier for this resource in the provider
          title: Provider Resource Id
          type: string
          nullable: true
        provider_id:
          description: ID of the provider that owns this resource
          title: Provider Id
          type: string
        type:
          const: scoring_function
          default: scoring_function
          title: Type
          type: string
        description:
          title: Description
          type: string
          nullable: true
        metadata:
          additionalProperties: true
          description: Any additional metadata for this definition
          title: Metadata
          type: object
        return_type:
          description: The return type of the deterministic function
          discriminator:
            mapping:
              agent_turn_input: '#/$defs/AgentTurnInputType'
              array: '#/$defs/ArrayType'
              boolean: '#/$defs/BooleanType'
              chat_completion_input: '#/$defs/ChatCompletionInputType'
              completion_input: '#/$defs/CompletionInputType'
              json: '#/$defs/JsonType'
              number: '#/$defs/NumberType'
              object: '#/$defs/ObjectType'
              string: '#/$defs/StringType'
              union: '#/$defs/UnionType'
            propertyName: type
          oneOf:
          - $ref: '#/components/schemas/StringType'
          - $ref: '#/components/schemas/NumberType'
          - $ref: '#/components/schemas/BooleanType'
          - $ref: '#/components/schemas/ArrayType'
          - $ref: '#/components/schemas/ObjectType'
          - $ref: '#/components/schemas/JsonType'
          - $ref: '#/components/schemas/UnionType'
          - $ref: '#/components/schemas/ChatCompletionInputType'
          - $ref: '#/components/schemas/CompletionInputType'
          - $ref: '#/components/schemas/AgentTurnInputType'
          title: Return Type
        params:
          description: The parameters for the scoring function for benchmark eval, these can be overridden for app eval
          title: Params
          discriminator:
            mapping:
              basic: '#/$defs/BasicScoringFnParams'
              llm_as_judge: '#/$defs/LLMAsJudgeScoringFnParams'
              regex_parser: '#/$defs/RegexParserScoringFnParams'
            propertyName: type
          oneOf:
          - $ref: '#/components/schemas/LLMAsJudgeScoringFnParams'
          - $ref: '#/components/schemas/RegexParserScoringFnParams'
          - $ref: '#/components/schemas/BasicScoringFnParams'
          nullable: true
      required:
      - identifier
      - provider_id
      - return_type
      title: ScoringFn
      type: object
    ScoreRequest:
      type: object
    ScoreResponse:
      $defs:
        ScoringResult:
          description: >-
            A scoring result for a single row.


            :param score_rows: The scoring result for each row. Each row is a map
            of column name to value.

            :param aggregated_results: Map of metric name to aggregated value
          properties:
            score_rows:
              items:
                additionalProperties: true
                type: object
              title: Score Rows
              type: array
            aggregated_results:
              additionalProperties: true
              title: Aggregated Results
              type: object
          required:
            - score_rows
            - aggregated_results
          title: ScoringResult
          type: object
      description: >-
        The response from scoring.


        :param results: A map of scoring function name to ScoringResult.
      properties:
        results:
          additionalProperties:
            $ref: '#/$defs/ScoringResult'
          title: Results
          type: object
      required:
        - results
      title: ScoreResponse
      type: object
    ScoreBatchRequest:
      type: object
    ScoreBatchResponse:
      $defs:
        ScoringResult:
          description: >-
            A scoring result for a single row.


            :param score_rows: The scoring result for each row. Each row is a map
            of column name to value.

            :param aggregated_results: Map of metric name to aggregated value
          properties:
            score_rows:
              items:
                additionalProperties: true
                type: object
              title: Score Rows
              type: array
            aggregated_results:
              additionalProperties: true
              title: Aggregated Results
              type: object
          required:
            - score_rows
            - aggregated_results
          title: ScoringResult
          type: object
      description: >-
        Response from batch scoring operations on datasets.


        :param dataset_id: (Optional) The identifier of the dataset that was scored

        :param results: A map of scoring function name to ScoringResult
      properties:
        dataset_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Dataset Id
        results:
          additionalProperties:
            $ref: '#/$defs/ScoringResult'
          title: Results
          type: object
      required:
        - results
      title: ScoreBatchResponse
      type: object
    ListShieldsResponse:
      $defs:
        Shield:
          description: >-
            A safety shield resource that can be used to check content.


            :param params: (Optional) Configuration parameters for the shield

            :param type: The resource type, always shield
          properties:
            identifier:
              description: >-
                Unique identifier for this resource in llama stack
              title: Identifier
              type: string
            provider_resource_id:
              anyOf:
                - type: string
                - type: 'null'
              description: >-
                Unique identifier for this resource in the provider
              title: Provider Resource Id
            provider_id:
              description: >-
                ID of the provider that owns this resource
              title: Provider Id
              type: string
            type:
              const: shield
              default: shield
              title: Type
              type: string
            params:
              anyOf:
                - additionalProperties: true
                  type: object
                - type: 'null'
              title: Params
          required:
            - identifier
            - provider_id
          title: Shield
          type: object
      properties:
        data:
          items:
            $ref: '#/$defs/Shield'
          title: Data
          type: array
      required:
        - data
      title: ListShieldsResponse
      type: object
    RegisterShieldRequest:
      type: object
      properties:
        shield_id:
          type: string
          description: >-
            The identifier of the shield to register.
        provider_shield_id:
          type: string
          description: >-
            The identifier of the shield in the provider.
        provider_id:
          type: string
          description: The identifier of the provider.
        params:
          type: object
          additionalProperties:
            oneOf:
              - type: 'null'
              - type: boolean
              - type: number
              - type: string
              - type: array
              - type: object
          description: The parameters of the shield.
      additionalProperties: false
      required:
        - shield_id
      title: RegisterShieldRequest
    InvokeToolRequest:
      type: object
      properties:
        tool_name:
          type: string
          description: The name of the tool to invoke.
        kwargs:
          type: object
          additionalProperties:
            oneOf:
              - type: 'null'
              - type: boolean
              - type: number
              - type: string
              - type: array
              - type: object
          description: >-
            A dictionary of arguments to pass to the tool.
      additionalProperties: false
      required:
        - tool_name
        - kwargs
      title: InvokeToolRequest
    ImageContentItem:
      type: object
      properties:
        type:
          type: string
          const: image
          default: image
          description: >-
            Discriminator type of the content item. Always "image"
        image:
          type: object
          properties:
            url:
              $ref: '#/components/schemas/URL'
              description: >-
                A URL of the image or data URL in the format of data:image/{type};base64,{data}.
                Note that URL could have length limits.
            data:
              type: string
              contentEncoding: base64
              description: base64 encoded image data as string
          additionalProperties: false
          description: >-
            Image as a base64 encoded string or an URL
      additionalProperties: false
      required:
        - type
        - image
      title: ImageContentItem
      description: A image content item
    InterleavedContent:
      oneOf:
        - type: string
        - $ref: '#/components/schemas/InterleavedContentItem'
        - type: array
          items:
            $ref: '#/components/schemas/InterleavedContentItem'
    InterleavedContentItem:
      oneOf:
        - $ref: '#/components/schemas/ImageContentItem'
        - $ref: '#/components/schemas/TextContentItem'
      discriminator:
        propertyName: type
        mapping:
          image: '#/components/schemas/ImageContentItem'
          text: '#/components/schemas/TextContentItem'
    TextContentItem:
      type: object
      properties:
        type:
          type: string
          const: text
          default: text
          description: >-
            Discriminator type of the content item. Always "text"
        text:
          type: string
          description: Text content
      additionalProperties: false
      required:
        - type
        - text
      title: TextContentItem
      description: A text content item
    ToolInvocationResult:
      type: object
      properties:
        content:
          $ref: '#/components/schemas/InterleavedContent'
          description: >-
            (Optional) The output content from the tool execution
        error_message:
          type: string
          description: >-
            (Optional) Error message if the tool execution failed
        error_code:
          type: integer
          description: >-
            (Optional) Numeric error code if the tool execution failed
        metadata:
          type: object
          additionalProperties:
            oneOf:
              - type: 'null'
              - type: boolean
              - type: number
              - type: string
              - type: array
              - type: object
          description: >-
            (Optional) Additional metadata about the tool execution
      additionalProperties: false
      title: ToolInvocationResult
      description: Result of a tool invocation.
    URL:
      type: object
      properties:
        uri:
          type: string
          description: The URL string pointing to the resource
      additionalProperties: false
      required:
        - uri
      title: URL
      description: A URL reference to external content.
    ToolDef:
      type: object
      properties:
        toolgroup_id:
          type: string
          description: >-
            (Optional) ID of the tool group this tool belongs to
        name:
          type: string
          description: Name of the tool
        description:
          type: string
          description: >-
            (Optional) Human-readable description of what the tool does
        input_schema:
          type: object
          additionalProperties:
            oneOf:
              - type: 'null'
              - type: boolean
              - type: number
              - type: string
              - type: array
              - type: object
          description: >-
            (Optional) JSON Schema for tool inputs (MCP inputSchema)
        output_schema:
          type: object
          additionalProperties:
            oneOf:
              - type: 'null'
              - type: boolean
              - type: number
              - type: string
              - type: array
              - type: object
          description: >-
            (Optional) JSON Schema for tool outputs (MCP outputSchema)
        metadata:
          type: object
          additionalProperties:
            oneOf:
              - type: 'null'
              - type: boolean
              - type: number
              - type: string
              - type: array
              - type: object
          description: >-
            (Optional) Additional metadata about the tool
      additionalProperties: false
      required:
        - name
      title: ToolDef
      description: >-
        Tool definition used in runtime contexts.
    ListToolDefsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/ToolDef'
          description: List of tool definitions
      additionalProperties: false
      required:
        - data
      title: ListToolDefsResponse
      description: >-
        Response containing a list of tool definitions.
    RAGDocument:
      type: object
      properties:
        document_id:
          type: string
          description: The unique identifier for the document.
        content:
          oneOf:
            - type: string
            - $ref: '#/components/schemas/InterleavedContentItem'
            - type: array
              items:
                $ref: '#/components/schemas/InterleavedContentItem'
            - $ref: '#/components/schemas/URL'
          description: The content of the document.
        mime_type:
          type: string
          description: The MIME type of the document.
        metadata:
          type: object
          additionalProperties:
            oneOf:
              - type: 'null'
              - type: boolean
              - type: number
              - type: string
              - type: array
              - type: object
          description: Additional metadata for the document.
      additionalProperties: false
      required:
        - document_id
        - content
        - metadata
      title: RAGDocument
      description: >-
        A document to be used for document ingestion in the RAG Tool.
    InsertRequest:
      type: object
      properties:
        documents:
          type: array
          items:
            $ref: '#/components/schemas/RAGDocument'
          description: >-
            List of documents to index in the RAG system
        vector_store_id:
          type: string
          description: >-
            ID of the vector database to store the document embeddings
        chunk_size_in_tokens:
          type: integer
          description: >-
            (Optional) Size in tokens for document chunking during indexing
      additionalProperties: false
      required:
        - documents
        - vector_store_id
        - chunk_size_in_tokens
      title: InsertRequest
    DefaultRAGQueryGeneratorConfig:
      type: object
      properties:
        type:
          type: string
          const: default
          default: default
          description: >-
            Type of query generator, always 'default'
        separator:
          type: string
          default: ' '
          description: >-
            String separator used to join query terms
      additionalProperties: false
      required:
        - type
        - separator
      title: DefaultRAGQueryGeneratorConfig
      description: >-
        Configuration for the default RAG query generator.
    LLMRAGQueryGeneratorConfig:
      type: object
      properties:
        type:
          type: string
          const: llm
          default: llm
          description: Type of query generator, always 'llm'
        model:
          type: string
          description: >-
            Name of the language model to use for query generation
        template:
          type: string
          description: >-
            Template string for formatting the query generation prompt
      additionalProperties: false
      required:
        - type
        - model
        - template
      title: LLMRAGQueryGeneratorConfig
      description: >-
        Configuration for the LLM-based RAG query generator.
    RAGQueryConfig:
      type: object
      properties:
        query_generator_config:
          oneOf:
            - $ref: '#/components/schemas/DefaultRAGQueryGeneratorConfig'
            - $ref: '#/components/schemas/LLMRAGQueryGeneratorConfig'
          discriminator:
            propertyName: type
            mapping:
              default: '#/components/schemas/DefaultRAGQueryGeneratorConfig'
              llm: '#/components/schemas/LLMRAGQueryGeneratorConfig'
          description: Configuration for the query generator.
        max_tokens_in_context:
          type: integer
          default: 4096
          description: Maximum number of tokens in the context.
        max_chunks:
          type: integer
          default: 5
          description: Maximum number of chunks to retrieve.
        chunk_template:
          type: string
          default: >
            Result {index}


        :param params: (Optional) Configuration parameters for the shield

        :param type: The resource type, always shield
      properties:
        identifier:
          description: >-
            Unique identifier for this resource in llama stack
          title: Identifier
          type: string
        provider_resource_id:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Unique identifier for this resource in the provider
          title: Provider Resource Id
        provider_id:
          description: >-
            ID of the provider that owns this resource
          title: Provider Id
          type: string
        type:
          const: shield
          default: shield
          title: Type
          type: string
        params:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Params
      required:
        - identifier
        - provider_id
      title: Shield
      type: object
    SyntheticDataGenerateRequest:
      type: object
    SyntheticDataGenerationResponse:
      description: >-
        Response from the synthetic data generation. Batch of (prompt, response, score)
        tuples that pass the threshold.


        :param synthetic_data: List of generated synthetic data samples that passed
        the filtering criteria

        :param statistics: (Optional) Statistical information about the generation
        process and filtering results
      properties:
        synthetic_data:
          items:
            additionalProperties: true
            type: object
          title: Synthetic Data
          type: array
        statistics:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Statistics
      required:
        - synthetic_data
      title: SyntheticDataGenerationResponse
      type: object
    InvokeToolRequest:
      type: object
    ToolInvocationResult:
      $defs:
        ImageContentItem:
          description: >-
            A image content item


            :param type: Discriminator type of the content item. Always "image"

            :param image: Image as a base64 encoded string or an URL
          properties:
            type:
              const: image
              default: image
              title: Type
              type: string
            image:
              $ref: '#/$defs/_URLOrData'
          required:
            - image
          title: ImageContentItem
          type: object
        TextContentItem:
          description: >-
            A text content item


            :param type: Discriminator type of the content item. Always "text"

            :param text: Text content
          properties:
            type:
              const: text
              default: text
              title: Type
              type: string
            text:
              title: Text
              type: string
          required:
            - text
          title: TextContentItem
          type: object
        URL:
          description: >-
            A URL reference to external content.


            :param uri: The URL string pointing to the resource
          properties:
            uri:
              title: Uri
              type: string
          required:
            - uri
          title: URL
          type: object
        _URLOrData:
          description: >-
            A URL or a base64 encoded string


            :param url: A URL of the image or data URL in the format of data:image/{type};base64,{data}.
            Note that URL could have length limits.

            :param data: base64 encoded image data as string
          properties:
            url:
              anyOf:
                - $ref: '#/$defs/URL'
                - type: 'null'
            data:
              anyOf:
                - type: string
                - type: 'null'
              contentEncoding: base64
              title: Data
          title: _URLOrData
          type: object
      description: >-
        Result of a tool invocation.


        :param content: (Optional) The output content from the tool execution

        :param error_message: (Optional) Error message if the tool execution failed

        :param error_code: (Optional) Numeric error code if the tool execution failed

        :param metadata: (Optional) Additional metadata about the tool execution
      properties:
        content:
          anyOf:
            - type: string
            - discriminator:
                mapping:
                  image: '#/$defs/ImageContentItem'
                  text: '#/$defs/TextContentItem'
                propertyName: type
              oneOf:
                - $ref: '#/$defs/ImageContentItem'
                - $ref: '#/$defs/TextContentItem'
            - items:
                discriminator:
                  mapping:
                    image: '#/$defs/ImageContentItem'
                    text: '#/$defs/TextContentItem'
                  propertyName: type
                oneOf:
                  - $ref: '#/$defs/ImageContentItem'
                  - $ref: '#/$defs/TextContentItem'
              type: array
            - type: 'null'
          title: Content
        error_message:
          anyOf:
            - type: string
            - type: 'null'
          title: Error Message
        error_code:
          anyOf:
            - type: integer
            - type: 'null'
          title: Error Code
        metadata:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Metadata
      title: ToolInvocationResult
      type: object
    URL:
      description: >-
        A URL reference to external content.


        :param uri: The URL string pointing to the resource
      properties:
        uri:
          title: Uri
          type: string
      required:
        - uri
      title: URL
      type: object
    ListToolDefsResponse:
      description: Response containing a list of tool definitions.
      properties:
        data:
          items:
            $ref: '#/components/schemas/ToolDef'
          title: Data
          type: array
      required:
      - data
      title: ListToolDefsResponse
      type: object
    VectorStoreDeleteResponse:
      description: Response from deleting a vector store.
      properties:
        id:
          title: Id
          type: string
        object:
          default: vector_store.deleted
          title: Object
          type: string
        deleted:
          default: true
          title: Deleted
          type: boolean
      required:
      - id
      title: VectorStoreDeleteResponse
      type: object
    VectorStoreFileContentsResponse:
      description: Response from retrieving the contents of a vector store file.
      properties:
        file_id:
          title: File Id
          type: string
        filename:
          title: Filename
          type: string
        attributes:
          additionalProperties: true
          title: Attributes
          type: object
        content:
          items:
            $ref: '#/components/schemas/VectorStoreContent'
          title: Content
          type: array
      required:
      - file_id
      - filename
      - attributes
      - content
      title: VectorStoreFileContentsResponse
      type: object
    VectorStoreFileDeleteResponse:
      description: Response from deleting a vector store file.
      properties:
        id:
          title: Id
          type: string
        object:
          default: vector_store.file.deleted
          title: Object
          type: string
        deleted:
          default: true
          title: Deleted
          type: boolean
      required:
      - id
      title: VectorStoreFileDeleteResponse
      type: object
    VectorStoreFilesListInBatchResponse:
      description: Response from listing files in a vector store file batch.
      properties:
        object:
          default: list
          title: Object
          type: string
        data:
          items:
            $ref: '#/components/schemas/VectorStoreFileObject'
          title: Data
          type: array
        first_id:
          title: First Id
          type: string
          nullable: true
        last_id:
          title: Last Id
          type: string
          nullable: true
        has_more:
          default: false
          title: Has More
          type: boolean
      required:
      - data
      title: VectorStoreFilesListInBatchResponse
      type: object
    VectorStoreListFilesResponse:
      description: Response from listing files in a vector store.
      properties:
        object:
          default: list
          title: Object
          type: string
        data:
          items:
            $ref: '#/components/schemas/VectorStoreFileObject'
          title: Data
          type: array
        first_id:
          title: First Id
          type: string
          nullable: true
        last_id:
          title: Last Id
          type: string
          nullable: true
        has_more:
          default: false
          title: Has More
          type: boolean
      required:
      - data
      title: VectorStoreListFilesResponse
      type: object
    VectorStoreListResponse:
      description: Response from listing vector stores.
      properties:
        object:
          default: list
          title: Object
          type: string
        data:
          items:
            $ref: '#/components/schemas/VectorStoreObject'
          title: Data
          type: array
        first_id:
          title: First Id
          type: string
          nullable: true
        last_id:
          title: Last Id
          type: string
          nullable: true
        has_more:
          default: false
          title: Has More
          type: boolean
      required:
      - data
      title: VectorStoreListResponse
      type: object
    OpenAIResponseMessage:
      description: "Corresponds to the various Message types in the Responses API.\nThey are all under one type because the Responses API gives them all\nthe same \"type\" value, and there is no way to tell them apart in certain\nscenarios."
      properties:
        content:
          anyOf:
          - type: string
          - items:
              discriminator:
                mapping:
                  input_file: '#/$defs/OpenAIResponseInputMessageContentFile'
                  input_image: '#/$defs/OpenAIResponseInputMessageContentImage'
                  input_text: '#/$defs/OpenAIResponseInputMessageContentText'
                propertyName: type
              oneOf:
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentText'
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentImage'
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentFile'
            type: array
          - items:
              discriminator:
                mapping:
                  output_text: '#/$defs/OpenAIResponseOutputMessageContentOutputText'
                  refusal: '#/$defs/OpenAIResponseContentPartRefusal'
                propertyName: type
              oneOf:
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageContentOutputText'
              - $ref: '#/components/schemas/OpenAIResponseContentPartRefusal'
            type: array
          title: Content
        role:
          anyOf:
          - const: system
            type: string
          - const: developer
            type: string
          - const: user
            type: string
          - const: assistant
            type: string
          title: Role
        type:
          const: message
          default: message
          title: Type
          type: string
        id:
          title: Id
          type: string
          nullable: true
        status:
          title: Status
          type: string
          nullable: true
      required:
      - content
      - role
      title: OpenAIResponseMessage
      type: object
    OpenAIResponseObjectWithInput:
      description: OpenAI response object extended with input context information.
      properties:
        created_at:
          title: Created At
          type: integer
        error:
          $ref: '#/components/schemas/OpenAIResponseError'
          nullable: true
        id:
          title: Id
          type: string
        model:
          title: Model
          type: string
      required:
        - session_id
      title: AgentSessionCreateResponse
      description: >-
        Response returned when creating a new agent session.
    CompletionMessage:
      type: object
      properties:
        role:
          type: string
          const: assistant
          default: assistant
          description: >-
            Must be "assistant" to identify this as the model's response
        content:
          $ref: '#/components/schemas/InterleavedContent'
          description: The content of the model's response
        stop_reason:
          type: string
          enum:
            - end_of_turn
            - end_of_message
            - out_of_tokens
          description: >-
            Reason why the model stopped generating. Options are: - `StopReason.end_of_turn`:
            The model finished generating the entire response. - `StopReason.end_of_message`:
            The model finished generating but generated a partial response -- usually,
            a tool call. The user may call the tool and continue the conversation
            with the tool's response. - `StopReason.out_of_tokens`: The model ran
            out of token budget.
        tool_calls:
          type: array
          items:
            $ref: '#/components/schemas/ToolCall'
          description: >-
            List of tool calls. Each tool call is a ToolCall object.
      additionalProperties: false
      required:
        - role
        - content
        - stop_reason
      title: CompletionMessage
      description: >-
        A message containing the model's (assistant) response in a chat conversation.
    InferenceStep:
      type: object
    Session:
      $defs:
        Attachment:
          description: >-
            An attachment to an agent turn.


            :param content: The content of the attachment.

            :param mime_type: The MIME type of the attachment.
          properties:
            content:
              anyOf:
                - type: string
                - discriminator:
                    mapping:
                      image: '#/$defs/ImageContentItem'
                      text: '#/$defs/TextContentItem'
                    propertyName: type
                  oneOf:
                    - $ref: '#/$defs/ImageContentItem'
                    - $ref: '#/$defs/TextContentItem'
                - items:
                    discriminator:
                      mapping:
                        image: '#/$defs/ImageContentItem'
                        text: '#/$defs/TextContentItem'
                      propertyName: type
                    oneOf:
                      - $ref: '#/$defs/ImageContentItem'
                      - $ref: '#/$defs/TextContentItem'
                  type: array
                - $ref: '#/$defs/URL'
              title: Content
            mime_type:
              title: Mime Type
              type: string
          required:
            - content
            - mime_type
          title: Attachment
          type: object
        BuiltinTool:
          enum:
            - brave_search
            - wolfram_alpha
            - photogen
            - code_interpreter
          title: BuiltinTool
          type: string
        CompletionMessage:
          description: >-
            A message containing the model's (assistant) response in a chat conversation.


            :param role: Must be "assistant" to identify this as the model's response

            :param content: The content of the model's response

            :param stop_reason: Reason why the model stopped generating. Options are:
                - `StopReason.end_of_turn`: The model finished generating the entire
            response.
                - `StopReason.end_of_message`: The model finished generating but generated
            a partial response -- usually, a tool call. The user may call the tool
            and continue the conversation with the tool's response.
                - `StopReason.out_of_tokens`: The model ran out of token budget.
            :param tool_calls: List of tool calls. Each tool call is a ToolCall object.
          properties:
            role:
              const: assistant
              default: assistant
              title: Role
              type: string
            content:
              anyOf:
                - type: string
                - discriminator:
                    mapping:
                      image: '#/$defs/ImageContentItem'
                      text: '#/$defs/TextContentItem'
                    propertyName: type
                  oneOf:
                    - $ref: '#/$defs/ImageContentItem'
                    - $ref: '#/$defs/TextContentItem'
                - items:
                    discriminator:
                      mapping:
                        image: '#/$defs/ImageContentItem'
                        text: '#/$defs/TextContentItem'
                      propertyName: type
                    oneOf:
                      - $ref: '#/$defs/ImageContentItem'
                      - $ref: '#/$defs/TextContentItem'
                  type: array
              title: Content
            stop_reason:
              $ref: '#/$defs/StopReason'
            tool_calls:
              anyOf:
                - items:
                    $ref: '#/$defs/ToolCall'
                  type: array
                - type: 'null'
              title: Tool Calls
          required:
            - content
            - stop_reason
          title: CompletionMessage
          type: object
        ImageContentItem:
          description: >-
            A image content item


            :param type: Discriminator type of the content item. Always "image"

            :param image: Image as a base64 encoded string or an URL
          properties:
            type:
              const: image
              default: image
              title: Type
              type: string
            image:
              $ref: '#/$defs/_URLOrData'
          required:
            - image
          title: ImageContentItem
          type: object
        InferenceStep:
          description: >-
            An inference step in an agent turn.


            :param model_response: The response from the LLM.
          properties:
            turn_id:
              title: Turn Id
              type: string
            step_id:
              title: Step Id
              type: string
            started_at:
              anyOf:
                - format: date-time
                  type: string
                - type: 'null'
              title: Started At
            completed_at:
              anyOf:
                - format: date-time
                  type: string
                - type: 'null'
              title: Completed At
            step_type:
              const: inference
              default: inference
              title: Step Type
              type: string
            model_response:
              $ref: '#/$defs/CompletionMessage'
          required:
            - turn_id
            - step_id
            - model_response
          title: InferenceStep
          type: object
        MemoryRetrievalStep:
          description: >-
            A memory retrieval step in an agent turn.


            :param vector_store_ids: The IDs of the vector databases to retrieve context
            from.

            :param inserted_context: The context retrieved from the vector databases.
          properties:
            turn_id:
              title: Turn Id
              type: string
            step_id:
              title: Step Id
              type: string
            started_at:
              anyOf:
                - format: date-time
                  type: string
                - type: 'null'
              title: Started At
            completed_at:
              anyOf:
                - format: date-time
                  type: string
                - type: 'null'
              title: Completed At
            step_type:
              const: memory_retrieval
              default: memory_retrieval
              title: Step Type
              type: string
            vector_store_ids:
              title: Vector Store Ids
              type: string
            inserted_context:
              anyOf:
                - type: string
                - discriminator:
                    mapping:
                      image: '#/$defs/ImageContentItem'
                      text: '#/$defs/TextContentItem'
                    propertyName: type
                  oneOf:
                    - $ref: '#/$defs/ImageContentItem'
                    - $ref: '#/$defs/TextContentItem'
                - items:
                    discriminator:
                      mapping:
                        image: '#/$defs/ImageContentItem'
                        text: '#/$defs/TextContentItem'
                      propertyName: type
                    oneOf:
                      - $ref: '#/$defs/ImageContentItem'
                      - $ref: '#/$defs/TextContentItem'
                  type: array
              title: Inserted Context
          required:
            - turn_id
            - step_id
            - vector_store_ids
            - inserted_context
          title: MemoryRetrievalStep
          type: object
        SafetyViolation:
          description: >-
            Details of a safety violation detected by content moderation.


            :param violation_level: Severity level of the violation

            :param user_message: (Optional) Message to convey to the user about the
            violation

            :param metadata: Additional metadata including specific violation codes
            for debugging and telemetry
          properties:
            violation_level:
              $ref: '#/$defs/ViolationLevel'
            user_message:
              anyOf:
                - type: string
                - type: 'null'
              title: User Message
            metadata:
              additionalProperties: true
              title: Metadata
              type: object
          required:
            - violation_level
          title: SafetyViolation
          type: object
        ShieldCallStep:
          description: >-
            A shield call step in an agent turn.


            :param violation: The violation from the shield call.
          properties:
            turn_id:
              title: Turn Id
              type: string
            step_id:
              title: Step Id
              type: string
            started_at:
              anyOf:
                - format: date-time
                  type: string
                - type: 'null'
              title: Started At
            completed_at:
              anyOf:
                - format: date-time
                  type: string
                - type: 'null'
              title: Completed At
            step_type:
              const: shield_call
              default: shield_call
              title: Step Type
              type: string
            violation:
              anyOf:
                - $ref: '#/$defs/SafetyViolation'
                - type: 'null'
          required:
            - turn_id
            - step_id
            - violation
          title: ShieldCallStep
          type: object
        StopReason:
          enum:
            - end_of_turn
            - end_of_message
            - out_of_tokens
          title: StopReason
          type: string
        TextContentItem:
          description: >-
            A text content item


            :param type: Discriminator type of the content item. Always "text"

            :param text: Text content
          properties:
            type:
              const: text
              default: text
              title: Type
              type: string
            text:
              title: Text
              type: string
          required:
            - text
          title: TextContentItem
          type: object
        ToolCall:
          properties:
            call_id:
              title: Call Id
              type: string
            tool_name:
              anyOf:
                - $ref: '#/$defs/BuiltinTool'
                - type: string
              title: Tool Name
            arguments:
              title: Arguments
              type: string
          required:
            - call_id
            - tool_name
            - arguments
          title: ToolCall
          type: object
        ToolExecutionStep:
          description: >-
            A tool execution step in an agent turn.


            :param tool_calls: The tool calls to execute.

            :param tool_responses: The tool responses from the tool calls.
          properties:
            turn_id:
              title: Turn Id
              type: string
            step_id:
              title: Step Id
              type: string
            started_at:
              anyOf:
                - format: date-time
                  type: string
                - type: 'null'
              title: Started At
            completed_at:
              anyOf:
                - format: date-time
                  type: string
                - type: 'null'
              title: Completed At
            step_type:
              const: tool_execution
              default: tool_execution
              title: Step Type
              type: string
            tool_calls:
              items:
                $ref: '#/$defs/ToolCall'
              title: Tool Calls
              type: array
            tool_responses:
              items:
                $ref: '#/$defs/ToolResponse'
              title: Tool Responses
              type: array
          required:
            - turn_id
            - step_id
            - tool_calls
            - tool_responses
          title: ToolExecutionStep
          type: object
        ToolResponse:
          description: >-
            Response from a tool invocation.


            :param call_id: Unique identifier for the tool call this response is for

            :param tool_name: Name of the tool that was invoked

            :param content: The response content from the tool

            :param metadata: (Optional) Additional metadata about the tool response
          properties:
            call_id:
              title: Call Id
              type: string
            tool_name:
              anyOf:
                - $ref: '#/$defs/BuiltinTool'
                - type: string
              title: Tool Name
            content:
              anyOf:
                - type: string
                - discriminator:
                    mapping:
                      image: '#/$defs/ImageContentItem'
                      text: '#/$defs/TextContentItem'
                    propertyName: type
                  oneOf:
                    - $ref: '#/$defs/ImageContentItem'
                    - $ref: '#/$defs/TextContentItem'
                - items:
                    discriminator:
                      mapping:
                        image: '#/$defs/ImageContentItem'
                        text: '#/$defs/TextContentItem'
                      propertyName: type
                    oneOf:
                      - $ref: '#/$defs/ImageContentItem'
                      - $ref: '#/$defs/TextContentItem'
                  type: array
              title: Content
            metadata:
              anyOf:
                - additionalProperties: true
                  type: object
                - type: 'null'
              title: Metadata
          required:
            - call_id
            - tool_name
            - content
          title: ToolResponse
          type: object
        ToolResponseMessage:
          description: >-
            A message representing the result of a tool invocation.


            :param role: Must be "tool" to identify this as a tool response

            :param call_id: Unique identifier for the tool call this response is for

            :param content: The response content from the tool
          properties:
            role:
              const: tool
              default: tool
              title: Role
              type: string
            call_id:
              title: Call Id
              type: string
            content:
              anyOf:
                - type: string
                - discriminator:
                    mapping:
                      image: '#/$defs/ImageContentItem'
                      text: '#/$defs/TextContentItem'
                    propertyName: type
                  oneOf:
                    - $ref: '#/$defs/ImageContentItem'
                    - $ref: '#/$defs/TextContentItem'
                - items:
                    discriminator:
                      mapping:
                        image: '#/$defs/ImageContentItem'
                        text: '#/$defs/TextContentItem'
                      propertyName: type
                    oneOf:
                      - $ref: '#/$defs/ImageContentItem'
                      - $ref: '#/$defs/TextContentItem'
                  type: array
              title: Content
          required:
            - call_id
            - content
          title: ToolResponseMessage
          type: object
        Turn:
          description: >-
            A single turn in an interaction with an Agentic System.


            :param turn_id: Unique identifier for the turn within a session

            :param session_id: Unique identifier for the conversation session

            :param input_messages: List of messages that initiated this turn

            :param steps: Ordered list of processing steps executed during this turn

            :param output_message: The model's generated response containing content
            and metadata

            :param output_attachments: (Optional) Files or media attached to the agent's
            response

            :param started_at: Timestamp when the turn began

            :param completed_at: (Optional) Timestamp when the turn finished, if completed
          properties:
            turn_id:
              title: Turn Id
              type: string
            session_id:
              title: Session Id
              type: string
            input_messages:
              items:
                anyOf:
                  - $ref: '#/$defs/UserMessage'
                  - $ref: '#/$defs/ToolResponseMessage'
              title: Input Messages
              type: array
            steps:
              items:
                discriminator:
                  mapping:
                    inference: '#/$defs/InferenceStep'
                    memory_retrieval: '#/$defs/MemoryRetrievalStep'
                    shield_call: '#/$defs/ShieldCallStep'
                    tool_execution: '#/$defs/ToolExecutionStep'
                  propertyName: step_type
                oneOf:
                  - $ref: '#/$defs/InferenceStep'
                  - $ref: '#/$defs/ToolExecutionStep'
                  - $ref: '#/$defs/ShieldCallStep'
                  - $ref: '#/$defs/MemoryRetrievalStep'
              title: Steps
              type: array
            output_message:
              $ref: '#/$defs/CompletionMessage'
            output_attachments:
              anyOf:
                - items:
                    $ref: '#/$defs/Attachment'
                  type: array
                - type: 'null'
              title: Output Attachments
            started_at:
              format: date-time
              title: Started At
              type: string
            completed_at:
              anyOf:
                - format: date-time
                  type: string
                - type: 'null'
              title: Completed At
          required:
            - turn_id
            - session_id
            - input_messages
            - steps
            - output_message
            - started_at
          title: Turn
          type: object
        URL:
          description: >-
            A URL reference to external content.


            :param uri: The URL string pointing to the resource
          properties:
            uri:
              title: Uri
              type: string
          required:
            - uri
          title: URL
          type: object
        UserMessage:
          description: >-
            A message from the user in a chat conversation.


            :param role: Must be "user" to identify this as a user message

            :param content: The content of the message, which can include text and
            other media

            :param context: (Optional) This field is used internally by Llama Stack
            to pass RAG context. This field may be removed in the API in the future.
          properties:
            role:
              const: user
              default: user
              title: Role
              type: string
            content:
              anyOf:
                - type: string
                - discriminator:
                    mapping:
                      image: '#/$defs/ImageContentItem'
                      text: '#/$defs/TextContentItem'
                    propertyName: type
                  oneOf:
                    - $ref: '#/$defs/ImageContentItem'
                    - $ref: '#/$defs/TextContentItem'
                - items:
                    discriminator:
                      mapping:
                        image: '#/$defs/ImageContentItem'
                        text: '#/$defs/TextContentItem'
                      propertyName: type
                    oneOf:
                      - $ref: '#/$defs/ImageContentItem'
                      - $ref: '#/$defs/TextContentItem'
                  type: array
              title: Content
            context:
              anyOf:
                - type: string
                - discriminator:
                    mapping:
                      image: '#/$defs/ImageContentItem'
                      text: '#/$defs/TextContentItem'
                    propertyName: type
                  oneOf:
                    - $ref: '#/$defs/ImageContentItem'
                    - $ref: '#/$defs/TextContentItem'
                - items:
                    discriminator:
                      mapping:
                        image: '#/$defs/ImageContentItem'
                        text: '#/$defs/TextContentItem'
                      propertyName: type
                    oneOf:
                      - $ref: '#/$defs/ImageContentItem'
                      - $ref: '#/$defs/TextContentItem'
                  type: array
                - type: 'null'
              title: Context
          required:
            - content
          title: UserMessage
          type: object
        ViolationLevel:
          description: >-
            Severity level of a safety violation.


            :cvar INFO: Informational level violation that does not require action

            :cvar WARN: Warning level violation that suggests caution but allows continuation

            :cvar ERROR: Error level violation that requires blocking or intervention
          enum:
            - info
            - warn
            - error
          title: ViolationLevel
          type: string
        _URLOrData:
          description: >-
            A URL or a base64 encoded string


            :param url: A URL of the image or data URL in the format of data:image/{type};base64,{data}.
            Note that URL could have length limits.

            :param data: base64 encoded image data as string
          properties:
            url:
              anyOf:
                - $ref: '#/$defs/URL'
                - type: 'null'
            data:
              anyOf:
                - type: string
                - type: 'null'
              contentEncoding: base64
              title: Data
          title: _URLOrData
          type: object
      description: >-
        A single session of an interaction with an Agentic System.


        :param session_id: Unique identifier for the conversation session

        :param session_name: Human-readable name for the session

        :param turns: List of all turns that have occurred in this session

        :param started_at: Timestamp when the session was created
      properties:
        session_id:
          title: Session Id
          type: string
        session_name:
          title: Session Name
          type: string
        turns:
          items:
            $ref: '#/$defs/Turn'
          title: Turns
          type: array
        started_at:
          format: date-time
          title: Started At
          type: string
      required:
        - session_id
        - session_name
        - turns
        - started_at
      title: Session
      type: object
      properties:
        turn_id:
          type: string
          description: The ID of the turn.
        step_id:
          type: string
          description: The ID of the step.
        started_at:
          type: string
          format: date-time
          description: The time the step started.
        completed_at:
          type: string
          format: date-time
          description: The time the step completed.
        step_type:
          type: string
          enum:
            - inference
            - tool_execution
            - shield_call
            - memory_retrieval
          title: StepType
          description: Type of the step in an agent turn.
          const: shield_call
          default: shield_call
        violation:
          $ref: '#/components/schemas/SafetyViolation'
          description: The violation from the shield call.
      additionalProperties: false
      required:
        - turn_id
        - step_id
        - step_type
      title: ShieldCallStep
      description: A shield call step in an agent turn.
    ToolCall:
      type: object
      properties:
        call_id:
          type: string
        tool_name:
          oneOf:
            - type: string
              enum:
                - brave_search
                - wolfram_alpha
                - photogen
                - code_interpreter
              title: BuiltinTool
            - type: string
        arguments:
          type: string
      additionalProperties: false
      required:
        - call_id
        - tool_name
        - arguments
      title: ToolCall
    ToolExecutionStep:
      type: object
      properties:
        turn_id:
          type: string
          description: The ID of the turn.
        step_id:
          type: string
          description: The ID of the step.
        started_at:
          type: string
          format: date-time
          description: The time the step started.
        completed_at:
          type: string
          format: date-time
          description: The time the step completed.
        step_type:
          type: string
          enum:
            - inference
            - tool_execution
            - shield_call
            - memory_retrieval
          title: StepType
          description: Type of the step in an agent turn.
          const: tool_execution
          default: tool_execution
        tool_calls:
          type: array
          items:
            $ref: '#/components/schemas/ToolCall'
          description: The tool calls to execute.
        tool_responses:
          type: array
          items:
            $ref: '#/components/schemas/ToolResponse'
          description: The tool responses from the tool calls.
      additionalProperties: false
      required:
        - turn_id
        - step_id
        - step_type
        - tool_calls
        - tool_responses
      title: ToolExecutionStep
      description: A tool execution step in an agent turn.
    ToolResponse:
      type: object
      properties:
        call_id:
          type: string
          description: >-
            Unique identifier for the tool call this response is for
        tool_name:
          oneOf:
            - type: string
              enum:
                - brave_search
                - wolfram_alpha
                - photogen
                - code_interpreter
              title: BuiltinTool
            - type: string
          description: Name of the tool that was invoked
        content:
          $ref: '#/components/schemas/InterleavedContent'
          description: The response content from the tool
        metadata:
          type: object
          additionalProperties:
            oneOf:
              - type: 'null'
              - type: boolean
              - type: number
              - type: string
              - type: array
              - type: object
          description: >-
            (Optional) Additional metadata about the tool response
      additionalProperties: false
      required:
        - call_id
        - tool_name
        - content
      title: ToolResponse
      description: Response from a tool invocation.
    ToolResponseMessage:
      type: object
      properties:
        role:
          type: string
          const: tool
          default: tool
          description: >-
            Must be "tool" to identify this as a tool response
        call_id:
          type: string
          description: >-
            Unique identifier for the tool call this response is for
        content:
          $ref: '#/components/schemas/InterleavedContent'
          description: The response content from the tool
      additionalProperties: false
      required:
        - role
        - call_id
        - content
      title: ToolResponseMessage
      description: >-
        A message representing the result of a tool invocation.
    Turn:
      $defs:
        Attachment:
          description: >-
            An attachment to an agent turn.


            :param content: The content of the attachment.

            :param mime_type: The MIME type of the attachment.
          properties:
            content:
              anyOf:
                - type: string
                - discriminator:
                    mapping:
                      image: '#/$defs/ImageContentItem'
                      text: '#/$defs/TextContentItem'
                    propertyName: type
                  oneOf:
                    - $ref: '#/$defs/ImageContentItem'
                    - $ref: '#/$defs/TextContentItem'
                - items:
                    discriminator:
                      mapping:
                        image: '#/$defs/ImageContentItem'
                        text: '#/$defs/TextContentItem'
                      propertyName: type
                    oneOf:
                      - $ref: '#/$defs/ImageContentItem'
                      - $ref: '#/$defs/TextContentItem'
                  type: array
                - $ref: '#/$defs/URL'
              title: Content
            mime_type:
              title: Mime Type
              type: string
          required:
            - content
            - mime_type
          title: Attachment
          type: object
        BuiltinTool:
          enum:
            - brave_search
            - wolfram_alpha
            - photogen
            - code_interpreter
          title: BuiltinTool
          type: string
        CompletionMessage:
          description: >-
            A message containing the model's (assistant) response in a chat conversation.


            :param role: Must be "assistant" to identify this as the model's response

            :param content: The content of the model's response

            :param stop_reason: Reason why the model stopped generating. Options are:
                - `StopReason.end_of_turn`: The model finished generating the entire
            response.
                - `StopReason.end_of_message`: The model finished generating but generated
            a partial response -- usually, a tool call. The user may call the tool
            and continue the conversation with the tool's response.
                - `StopReason.out_of_tokens`: The model ran out of token budget.
            :param tool_calls: List of tool calls. Each tool call is a ToolCall object.
          properties:
            role:
              const: assistant
              default: assistant
              title: Role
              type: string
            content:
              anyOf:
                - type: string
                - discriminator:
                    mapping:
                      image: '#/$defs/ImageContentItem'
                      text: '#/$defs/TextContentItem'
                    propertyName: type
                  oneOf:
                    - $ref: '#/$defs/ImageContentItem'
                    - $ref: '#/$defs/TextContentItem'
                - items:
                    discriminator:
                      mapping:
                        image: '#/$defs/ImageContentItem'
                        text: '#/$defs/TextContentItem'
                      propertyName: type
                    oneOf:
                      - $ref: '#/$defs/ImageContentItem'
                      - $ref: '#/$defs/TextContentItem'
                  type: array
              title: Content
            stop_reason:
              $ref: '#/$defs/StopReason'
            tool_calls:
              anyOf:
                - items:
                    $ref: '#/$defs/ToolCall'
                  type: array
                - type: 'null'
              title: Tool Calls
          required:
            - content
            - stop_reason
          title: CompletionMessage
          type: object
        ImageContentItem:
          description: >-
            A image content item


            :param type: Discriminator type of the content item. Always "image"

            :param image: Image as a base64 encoded string or an URL
          properties:
            type:
              const: image
              default: image
              title: Type
              type: string
            image:
              $ref: '#/$defs/_URLOrData'
          required:
            - image
          title: ImageContentItem
          type: object
        InferenceStep:
          description: >-
            An inference step in an agent turn.


            :param model_response: The response from the LLM.
          properties:
            turn_id:
              title: Turn Id
              type: string
            step_id:
              title: Step Id
              type: string
            started_at:
              anyOf:
                - format: date-time
                  type: string
                - type: 'null'
              title: Started At
            completed_at:
              anyOf:
                - format: date-time
                  type: string
                - type: 'null'
              title: Completed At
            step_type:
              const: inference
              default: inference
              title: Step Type
              type: string
            model_response:
              $ref: '#/$defs/CompletionMessage'
          required:
            - turn_id
            - step_id
            - model_response
          title: InferenceStep
          type: object
        MemoryRetrievalStep:
          description: >-
            A memory retrieval step in an agent turn.


            :param vector_store_ids: The IDs of the vector databases to retrieve context
            from.

            :param inserted_context: The context retrieved from the vector databases.
          properties:
            turn_id:
              title: Turn Id
              type: string
            step_id:
              title: Step Id
              type: string
            started_at:
              anyOf:
                - format: date-time
                  type: string
                - type: 'null'
              title: Started At
            completed_at:
              anyOf:
                - format: date-time
                  type: string
                - type: 'null'
              title: Completed At
            step_type:
              const: memory_retrieval
              default: memory_retrieval
              title: Step Type
              type: string
            vector_store_ids:
              title: Vector Store Ids
              type: string
            inserted_context:
              anyOf:
                - type: string
                - discriminator:
                    mapping:
                      image: '#/$defs/ImageContentItem'
                      text: '#/$defs/TextContentItem'
                    propertyName: type
                  oneOf:
                    - $ref: '#/$defs/ImageContentItem'
                    - $ref: '#/$defs/TextContentItem'
                - items:
                    discriminator:
                      mapping:
                        image: '#/$defs/ImageContentItem'
                        text: '#/$defs/TextContentItem'
                      propertyName: type
                    oneOf:
                      - $ref: '#/$defs/ImageContentItem'
                      - $ref: '#/$defs/TextContentItem'
                  type: array
              title: Inserted Context
          required:
            - turn_id
            - step_id
            - vector_store_ids
            - inserted_context
          title: MemoryRetrievalStep
          type: object
        SafetyViolation:
          description: >-
            Details of a safety violation detected by content moderation.


            :param violation_level: Severity level of the violation

            :param user_message: (Optional) Message to convey to the user about the
            violation

            :param metadata: Additional metadata including specific violation codes
            for debugging and telemetry
          properties:
            violation_level:
              $ref: '#/$defs/ViolationLevel'
            user_message:
              anyOf:
                - type: string
                - type: 'null'
              title: User Message
            metadata:
              additionalProperties: true
              title: Metadata
              type: object
          required:
            - violation_level
          title: SafetyViolation
          type: object
        ShieldCallStep:
          description: >-
            A shield call step in an agent turn.


            :param violation: The violation from the shield call.
          properties:
            turn_id:
              title: Turn Id
              type: string
            step_id:
              title: Step Id
              type: string
            started_at:
              anyOf:
                - format: date-time
                  type: string
                - type: 'null'
              title: Started At
            completed_at:
              anyOf:
                - format: date-time
                  type: string
                - type: 'null'
              title: Completed At
            step_type:
              const: shield_call
              default: shield_call
              title: Step Type
              type: string
            violation:
              anyOf:
                - $ref: '#/$defs/SafetyViolation'
                - type: 'null'
          required:
            - turn_id
            - step_id
            - violation
          title: ShieldCallStep
          type: object
        StopReason:
          enum:
            - end_of_turn
            - end_of_message
            - out_of_tokens
          title: StopReason
          type: string
        TextContentItem:
          description: >-
            A text content item


            :param type: Discriminator type of the content item. Always "text"

            :param text: Text content
          properties:
            type:
              const: text
              default: text
              title: Type
              type: string
            text:
              title: Text
              type: string
          required:
            - text
          title: TextContentItem
          type: object
        ToolCall:
          properties:
            call_id:
              title: Call Id
              type: string
            tool_name:
              anyOf:
                - $ref: '#/$defs/BuiltinTool'
                - type: string
              title: Tool Name
            arguments:
              title: Arguments
              type: string
          required:
            - call_id
            - tool_name
            - arguments
          title: ToolCall
          type: object
        ToolExecutionStep:
          description: >-
            A tool execution step in an agent turn.


            :param tool_calls: The tool calls to execute.

            :param tool_responses: The tool responses from the tool calls.
          properties:
            turn_id:
              title: Turn Id
              type: string
            step_id:
              title: Step Id
              type: string
            started_at:
              anyOf:
                - format: date-time
                  type: string
                - type: 'null'
              title: Started At
            completed_at:
              anyOf:
                - format: date-time
                  type: string
                - type: 'null'
              title: Completed At
            step_type:
              const: tool_execution
              default: tool_execution
              title: Step Type
              type: string
            tool_calls:
              items:
                $ref: '#/$defs/ToolCall'
              title: Tool Calls
              type: array
            tool_responses:
              items:
                $ref: '#/$defs/ToolResponse'
              title: Tool Responses
              type: array
          required:
            - turn_id
            - step_id
            - tool_calls
            - tool_responses
          title: ToolExecutionStep
          type: object
        ToolResponse:
          description: >-
            Response from a tool invocation.


            :param call_id: Unique identifier for the tool call this response is for

            :param tool_name: Name of the tool that was invoked

            :param content: The response content from the tool

            :param metadata: (Optional) Additional metadata about the tool response
          properties:
            call_id:
              title: Call Id
              type: string
            tool_name:
              anyOf:
                - $ref: '#/$defs/BuiltinTool'
                - type: string
              title: Tool Name
            content:
              anyOf:
                - type: string
                - discriminator:
                    mapping:
                      image: '#/$defs/ImageContentItem'
                      text: '#/$defs/TextContentItem'
                    propertyName: type
                  oneOf:
                    - $ref: '#/$defs/ImageContentItem'
                    - $ref: '#/$defs/TextContentItem'
                - items:
                    discriminator:
                      mapping:
                        image: '#/$defs/ImageContentItem'
                        text: '#/$defs/TextContentItem'
                      propertyName: type
                    oneOf:
                      - $ref: '#/$defs/ImageContentItem'
                      - $ref: '#/$defs/TextContentItem'
                  type: array
              title: Content
            metadata:
              anyOf:
                - additionalProperties: true
                  type: object
                - type: 'null'
              title: Metadata
          required:
            - call_id
            - tool_name
            - content
          title: ToolResponse
          type: object
        ToolResponseMessage:
          description: >-
            A message representing the result of a tool invocation.


            :param role: Must be "tool" to identify this as a tool response

            :param call_id: Unique identifier for the tool call this response is for

            :param content: The response content from the tool
          properties:
            role:
              const: tool
              default: tool
              title: Role
              type: string
            call_id:
              title: Call Id
              type: string
            content:
              anyOf:
                - type: string
                - discriminator:
                    mapping:
                      image: '#/$defs/ImageContentItem'
                      text: '#/$defs/TextContentItem'
                    propertyName: type
                  oneOf:
                    - $ref: '#/$defs/ImageContentItem'
                    - $ref: '#/$defs/TextContentItem'
                - items:
                    discriminator:
                      mapping:
                        image: '#/$defs/ImageContentItem'
                        text: '#/$defs/TextContentItem'
                      propertyName: type
                    oneOf:
                      - $ref: '#/$defs/ImageContentItem'
                      - $ref: '#/$defs/TextContentItem'
                  type: array
              title: Content
          required:
            - call_id
            - content
          title: ToolResponseMessage
          type: object
        URL:
          description: >-
            A URL reference to external content.


            :param uri: The URL string pointing to the resource
          properties:
            uri:
              title: Uri
              type: string
          required:
            - uri
          title: URL
          type: object
        UserMessage:
          description: >-
            A message from the user in a chat conversation.


            :param role: Must be "user" to identify this as a user message

            :param content: The content of the message, which can include text and
            other media

            :param context: (Optional) This field is used internally by Llama Stack
            to pass RAG context. This field may be removed in the API in the future.
          properties:
            role:
              const: user
              default: user
              title: Role
              type: string
            content:
              anyOf:
                - type: string
                - discriminator:
                    mapping:
                      image: '#/$defs/ImageContentItem'
                      text: '#/$defs/TextContentItem'
                    propertyName: type
                  oneOf:
                    - $ref: '#/$defs/ImageContentItem'
                    - $ref: '#/$defs/TextContentItem'
                - items:
                    discriminator:
                      mapping:
                        image: '#/$defs/ImageContentItem'
                        text: '#/$defs/TextContentItem'
                      propertyName: type
                    oneOf:
                      - $ref: '#/$defs/ImageContentItem'
                      - $ref: '#/$defs/TextContentItem'
                  type: array
              title: Content
            context:
              anyOf:
                - type: string
                - discriminator:
                    mapping:
                      image: '#/$defs/ImageContentItem'
                      text: '#/$defs/TextContentItem'
                    propertyName: type
                  oneOf:
                    - $ref: '#/$defs/ImageContentItem'
                    - $ref: '#/$defs/TextContentItem'
                - items:
                    discriminator:
                      mapping:
                        image: '#/$defs/ImageContentItem'
                        text: '#/$defs/TextContentItem'
                      propertyName: type
                    oneOf:
                      - $ref: '#/$defs/ImageContentItem'
                      - $ref: '#/$defs/TextContentItem'
                  type: array
                - type: 'null'
              title: Context
          required:
            - content
          title: UserMessage
          type: object
        ViolationLevel:
          description: >-
            Severity level of a safety violation.


            :cvar INFO: Informational level violation that does not require action

            :cvar WARN: Warning level violation that suggests caution but allows continuation

            :cvar ERROR: Error level violation that requires blocking or intervention
          enum:
            - info
            - warn
            - error
          title: ViolationLevel
          type: string
        _URLOrData:
          description: >-
            A URL or a base64 encoded string


            :param url: A URL of the image or data URL in the format of data:image/{type};base64,{data}.
            Note that URL could have length limits.

            :param data: base64 encoded image data as string
          properties:
            url:
              anyOf:
                - $ref: '#/$defs/URL'
                - type: 'null'
            data:
              anyOf:
                - type: string
                - type: 'null'
              contentEncoding: base64
              title: Data
          title: _URLOrData
          type: object
      description: >-
        A single turn in an interaction with an Agentic System.


        :param turn_id: Unique identifier for the turn within a session

        :param session_id: Unique identifier for the conversation session

        :param input_messages: List of messages that initiated this turn

        :param steps: Ordered list of processing steps executed during this turn

        :param output_message: The model's generated response containing content and
        metadata

        :param output_attachments: (Optional) Files or media attached to the agent's
        response

        :param started_at: Timestamp when the turn began

        :param completed_at: (Optional) Timestamp when the turn finished, if completed
      properties:
        turn_id:
          title: Turn Id
          type: string
        session_id:
          title: Session Id
          type: string
        input_messages:
          items:
            anyOf:
              - $ref: '#/$defs/UserMessage'
              - $ref: '#/$defs/ToolResponseMessage'
          title: Input Messages
          type: array
        steps:
          items:
            discriminator:
              mapping:
                file_search_call: '#/$defs/OpenAIResponseOutputMessageFileSearchToolCall'
                function_call: '#/$defs/OpenAIResponseOutputMessageFunctionToolCall'
                mcp_approval_request: '#/$defs/OpenAIResponseMCPApprovalRequest'
                mcp_call: '#/$defs/OpenAIResponseOutputMessageMCPCall'
                mcp_list_tools: '#/$defs/OpenAIResponseOutputMessageMCPListTools'
                message: '#/$defs/OpenAIResponseMessage'
                web_search_call: '#/$defs/OpenAIResponseOutputMessageWebSearchToolCall'
              propertyName: type
            oneOf:
            - $ref: '#/components/schemas/OpenAIResponseMessage'
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
            - $ref: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
          title: Output
          type: array
        parallel_tool_calls:
          default: false
          title: Parallel Tool Calls
          type: boolean
        previous_response_id:
          title: Previous Response Id
          type: string
        completed_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Completed At
      required:
        - turn_id
        - session_id
        - input_messages
        - steps
        - output_message
        - started_at
      title: Turn
      description: >-
        A single turn in an interaction with an Agentic System.
    UserMessage:
      type: object
      properties:
        role:
          type: string
          const: user
          default: user
          description: >-
            Must be "user" to identify this as a user message
        content:
          $ref: '#/components/schemas/InterleavedContent'
          description: >-
            The content of the message, which can include text and other media
        context:
          $ref: '#/components/schemas/InterleavedContent'
          description: >-
            (Optional) This field is used internally by Llama Stack to pass RAG context.
            This field may be removed in the API in the future.
      additionalProperties: false
      required:
        - role
        - content
      title: UserMessage
      description: >-
        A message from the user in a chat conversation.
    CreateAgentTurnRequest:
      type: object
    ResumeAgentTurnRequest:
      type: object
    AgentStepResponse:
      $defs:
        BuiltinTool:
          enum:
            - brave_search
            - wolfram_alpha
            - photogen
            - code_interpreter
          title: BuiltinTool
          type: string
        temperature:
          title: Temperature
          type: number
          nullable: true
        text:
          $ref: '#/components/schemas/OpenAIResponseText'
          default:
            format:
              type: text
        top_p:
          title: Top P
          type: number
          nullable: true
        tools:
          title: Tools
          items:
            discriminator:
              mapping:
                file_search: '#/$defs/OpenAIResponseInputToolFileSearch'
                function: '#/$defs/OpenAIResponseInputToolFunction'
                mcp: '#/$defs/OpenAIResponseToolMCP'
                web_search: '#/$defs/OpenAIResponseInputToolWebSearch'
                web_search_preview: '#/$defs/OpenAIResponseInputToolWebSearch'
                web_search_preview_2025_03_11: '#/$defs/OpenAIResponseInputToolWebSearch'
              propertyName: type
            oneOf:
            - $ref: '#/components/schemas/OpenAIResponseInputToolWebSearch'
            - $ref: '#/components/schemas/OpenAIResponseInputToolFileSearch'
            - $ref: '#/components/schemas/OpenAIResponseInputToolFunction'
            - $ref: '#/components/schemas/OpenAIResponseToolMCP'
          type: array
          nullable: true
        truncation:
          title: Truncation
          type: string
          nullable: true
        usage:
          $ref: '#/components/schemas/OpenAIResponseUsage'
          nullable: true
        instructions:
          title: Instructions
          type: string
          nullable: true
        input:
          items:
            anyOf:
            - discriminator:
                mapping:
                  file_search_call: '#/$defs/OpenAIResponseOutputMessageFileSearchToolCall'
                  function_call: '#/$defs/OpenAIResponseOutputMessageFunctionToolCall'
                  mcp_approval_request: '#/$defs/OpenAIResponseMCPApprovalRequest'
                  mcp_call: '#/$defs/OpenAIResponseOutputMessageMCPCall'
                  mcp_list_tools: '#/$defs/OpenAIResponseOutputMessageMCPListTools'
                  message: '#/$defs/OpenAIResponseMessage'
                  web_search_call: '#/$defs/OpenAIResponseOutputMessageWebSearchToolCall'
                propertyName: type
              oneOf:
              - $ref: '#/components/schemas/OpenAIResponseMessage'
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
              - $ref: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
            - $ref: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
            - $ref: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
            - $ref: '#/components/schemas/OpenAIResponseMessage'
          title: Input
          type: array
      required:
      - created_at
      - id
      - model
      - output
      - status
      - input
      title: OpenAIResponseObjectWithInput
      type: object
    ImageContentItem:
      description: A image content item
      properties:
        type:
          const: image
          default: image
          title: Type
          type: string
        image:
          $ref: '#/components/schemas/_URLOrData'
      required:
      - image
      title: ImageContentItem
      type: object
      properties:
        type:
          type: string
          const: agent
          default: agent
        config:
          $ref: '#/components/schemas/AgentConfig'
          description: >-
            The configuration for the agent candidate.
      additionalProperties: false
      required:
        - type
        - config
      title: AgentCandidate
      description: An agent candidate for evaluation.
    BenchmarkConfig:
      type: object
      properties:
        eval_candidate:
          oneOf:
            - $ref: '#/components/schemas/ModelCandidate'
            - $ref: '#/components/schemas/AgentCandidate'
          discriminator:
            propertyName: type
            mapping:
              model: '#/components/schemas/ModelCandidate'
              agent: '#/components/schemas/AgentCandidate'
          description: The candidate to evaluate.
        scoring_params:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/ScoringFnParams'
          description: >-
            Map between scoring function id and parameters for each scoring function
            you want to run
        num_examples:
          type: integer
          description: >-
            (Optional) The number of examples to evaluate. If not provided, all examples
            in the dataset will be evaluated
      additionalProperties: false
      required:
        - eval_candidate
        - scoring_params
      title: BenchmarkConfig
      description: >-
        A benchmark configuration for evaluation.
    ModelCandidate:
      type: object
      properties:
        type:
          type: string
          const: model
          default: model
        model:
          type: string
          description: The model ID to evaluate.
        sampling_params:
          $ref: '#/components/schemas/SamplingParams'
          description: The sampling parameters for the model.
        system_message:
          $ref: '#/components/schemas/SystemMessage'
          description: >-
            (Optional) The system message providing instructions or context to the
            model.
      additionalProperties: false
      required:
        - type
        - model
        - sampling_params
      title: ModelCandidate
      description: A model candidate for evaluation.
    SystemMessage:
      type: object
      properties:
        role:
          type: string
          const: system
          default: system
          description: >-
            Must be "system" to identify this as a system message
        content:
          $ref: '#/components/schemas/InterleavedContent'
          description: >-
            The content of the "system prompt". If multiple system messages are provided,
            they are concatenated. The underlying Llama Stack code may also add other
            system messages (for example, for formatting tool definitions).
      additionalProperties: false
      required:
        - role
        - content
      title: SystemMessage
      description: >-
        A system message providing instructions or context to the model.
    EvaluateRowsRequest:
      type: object
    EvaluateResponse:
      $defs:
        ScoringResult:
          description: >-
            A scoring result for a single row.


            :param score_rows: The scoring result for each row. Each row is a map
            of column name to value.

            :param aggregated_results: Map of metric name to aggregated value
          properties:
            score_rows:
              items:
                additionalProperties: true
                type: object
              title: Score Rows
              type: array
            aggregated_results:
              additionalProperties: true
              title: Aggregated Results
              type: object
          required:
            - score_rows
            - aggregated_results
          title: ScoringResult
          type: object
      description: >-
        The response from an evaluation.


        :param generations: The generations from the evaluation.

        :param scores: The scores from the evaluation.
      properties:
        epoch:
          title: Epoch
          type: integer
        train_loss:
          title: Train Loss
          type: number
        validation_loss:
          title: Validation Loss
          type: number
        perplexity:
          title: Perplexity
          type: number
      required:
      - epoch
      - train_loss
      - validation_loss
      - perplexity
      title: PostTrainingMetric
      type: object
    _safety_run_shield_Request:
      properties:
        shield_id:
          title: Shield Id
          type: string
        messages:
          anyOf:
          - $ref: '#/components/schemas/OpenAIUserMessageParam'
          - $ref: '#/components/schemas/OpenAISystemMessageParam'
          - $ref: '#/components/schemas/OpenAIAssistantMessageParam'
          - $ref: '#/components/schemas/OpenAIToolMessageParam'
          - $ref: '#/components/schemas/OpenAIDeveloperMessageParam'
          title: Messages
        params:
          title: Params
          type: string
      required:
      - shield_id
      - messages
      - params
      title: _safety_run_shield_Request
      type: object
  responses:
    BadRequest400:
      description: The request was invalid or malformed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            status: 400
            title: Bad Request
            detail: The request was invalid or malformed
    TooManyRequests429:
      description: The client has sent too many requests in a given amount of time
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            status: 429
            title: Too Many Requests
            detail: You have exceeded the rate limit. Please try again later.
    InternalServerError500:
      description: The server encountered an unexpected error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            status: 500
            title: Internal Server Error
            detail: An unexpected error occurred. Our team has been notified.
    DefaultError:
      description: An unexpected error occurred
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            status: 0
            title: Error
            detail: An unexpected error occurred
security:
  - Default: []
tags:
  - name: Agents
    description: >-
      APIs for creating and interacting with agentic systems.
    x-displayName: Agents
  - name: Batches
    description: >-
      The API is designed to allow use of openai client libraries for seamless integration.


      This API provides the following extensions:
       - idempotent batch creation

      Note: This API is currently under active development and may undergo changes.
    x-displayName: >-
      The Batches API enables efficient processing of multiple requests in a single
      operation, particularly useful for processing large datasets, batch evaluation
      workflows, and cost-effective inference at scale.
  - name: Benchmarks
    description: ''
  - name: Conversations
    description: >-
      Protocol for conversation management operations.
    x-displayName: Conversations
  - name: DatasetIO
    description: ''
  - name: Datasets
    description: ''
  - name: Eval
    description: >-
      Llama Stack Evaluation API for running evaluations on model and agent candidates.
    x-displayName: Evaluations
  - name: Files
    description: >-
      This API is used to upload documents that can be used with other Llama Stack
      APIs.
    x-displayName: Files
  - name: Inference
    description: >-
      Llama Stack Inference API for generating completions, chat completions, and
      embeddings.

          This API provides the raw interface to the underlying models. Three kinds
      of models are supported:
          - LLM models: these models generate "raw" and "chat" (conversational) completions.
          - Embedding models: these models generate embeddings to be used for semantic
      search.
          - Rerank models: these models reorder the documents based on their relevance
      to a query.
    x-displayName: Inference
  - name: Inspect
    description: >-
      APIs for inspecting the Llama Stack service, including health status, available
      API routes with methods and implementing providers.
    x-displayName: Inspect
  - name: Models
    description: ''
  - name: PostTraining (Coming Soon)
    description: ''
  - name: Prompts
    description: >-
      Protocol for prompt management operations.
    x-displayName: Prompts
  - name: Providers
    description: >-
      Providers API for inspecting, listing, and modifying providers and their configurations.
    x-displayName: Providers
  - name: Safety
    description: OpenAI-compatible Moderations API.
    x-displayName: Safety
  - name: Scoring
    description: ''
  - name: ScoringFunctions
    description: ''
  - name: Shields
    description: ''
  - name: ToolGroups
    description: ''
  - name: ToolRuntime
    description: ''
  - name: VectorIO
    description: ''
x-tagGroups:
  - name: Operations
    tags:
      - Agents
      - Batches
      - Benchmarks
      - Conversations
      - DatasetIO
      - Datasets
      - Eval
      - Files
      - Inference
      - Inspect
      - Models
      - PostTraining (Coming Soon)
      - Prompts
      - Providers
      - Safety
      - Scoring
      - ScoringFunctions
      - Shields
      - ToolGroups
      - ToolRuntime
      - VectorIO