H2O.ai Documents API

The Documents API from H2O.ai — 20 operation(s) for documents.

OpenAPI Specification

h2o-ai-documents-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: h2oGPTe REST Documents API
  description: "\n# Overview \n\nUsers can easily interact with the h2oGPTe API through its REST API, allowing HTTP requests from any programming language.\n\n## Authorization: Getting an API key\n\nSign up/in at Enterprise h2oGPTe and generate one of the following two types of API keys: \n\n- **Global API key**: If a Collection is not specified when creating a new API Key, that key is considered to be a global API Key. Use global API Keys to grant full user impersonation and system-wide access to all of your work. Anyone with access to one of your global API Keys can create, delete, or interact with any of your past, current, and future Collections, Documents, Chats, and settings.\n\n- **Collection-specific API key**: Use Collection-specific API Keys to grant external access to only Chat with a specified Collection and make related API calls to it. Collection-specific API keys do not allow other API calls, such as creation, deletion, or access to other Collections or Chats.\n \nAccess Enterprise h2oGPTe through your [H2O Generative AI](https://genai.h2o.ai/appstore) app store account, available with a freemium tier.\n\n## Authorization: Using an API key \n\nAll h2oGPTe REST API requests must include an API Key in the \"Authorization\" HTTP header, formatted as follows:\n\n```\nAuthorization: Bearer sk-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\n```\n\n```sh\ncurl -X 'POST' \\\n  'https://h2ogpte.genai.h2o.ai/api/v1/collections' \\\n  -H 'accept: application/json' \\\n  -H 'Content-Type: application/json' \\\n  -H 'Authorization: Bearer sk-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \\\n  -d '{\n    \"name\": \"The name of my Collection\",\n    \"description\": \"The description of my Collection\",\n    \"embedding_model\": \"BAAI/bge-large-en-v1.5\"\n  }'\n```\n    \n## Interactive h2oGPTe API testing\n\nThis page only showcases the h2oGPTe REST API; you can test it directly in the [Swagger UI](https://h2ogpte.genai.h2o.ai/swagger-ui/). Ensure that you are logged into your Enterprise h2oGPTe account.\n"
  version: v1.0.0
servers:
- url: https://h2ogpte.genai.h2o.ai/api/v1
security:
- bearerAuth: []
tags:
- name: Documents
paths:
  /documents:
    get:
      operationId: list_documents
      summary: List documents.
      description: List documents for a given user. If sort_column is not specified, the output is sorted by by last update time in descending order.
      tags:
      - Documents
      parameters:
      - name: offset
        in: query
        description: How many documents to skip before returning.
        required: false
        schema:
          type: integer
          default: 0
      - name: limit
        in: query
        description: How many documents to return.
        required: false
        schema:
          type: integer
          default: 100
      - name: sort_column
        in: query
        description: Sort column.
        required: false
        schema:
          type: string
          enum:
          - name
          - username
          - type
          - size
          - page_count
          - connector
          - uri
          - original_type
          - original_mtime
          - status
          - updated_at
          default: updated_at
      - name: ascending
        in: query
        description: When true, returns sorted by sort_column in ascending order.
        required: false
        schema:
          type: boolean
          default: false
      - name: with_summaries
        in: query
        description: When true, returns also summary and summary_parameter with other common attributes of the document.
        required: false
        schema:
          type: boolean
          default: false
      - name: metadata_filter
        in: query
        description: String containing metadata json dict to filter collections by metadata.
        required: false
        schema:
          type: string
      - name: username
        in: query
        description: Filter documents by the username of the uploader (exact match).
        required: false
        schema:
          type: string
      - name: status
        in: query
        description: 'Filter documents by ingestion status (exact match). Values: unknown, scheduled, queued, running, completed, failed, canceled, agent_only.'
        required: false
        schema:
          type: string
      - name: source
        in: query
        description: Filter documents by connector source (case-insensitive match, e.g. SharePoint, url, upload, Agent).
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Document'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        default:
          $ref: '#/components/responses/Unexpected'
  /documents/count:
    get:
      operationId: get_document_count
      summary: Counts a number of documents.
      description: Counts a number of documents the user has access to. If owned parameter is enabled, it counts only the documents owned by the user.
      tags:
      - Documents
      parameters:
      - name: owned
        in: query
        description: If true, it counts only the documents owned by the user.
        required: false
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Count'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        default:
          $ref: '#/components/responses/Unexpected'
  /documents/{document_id}:
    get:
      tags:
      - Documents
      summary: Finds a document by id.
      description: Returns a single document by its unique identifier.
      operationId: get_document
      parameters:
      - name: document_id
        in: path
        description: Id of document to return
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Document'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        default:
          $ref: '#/components/responses/Unexpected'
    delete:
      tags:
      - Documents
      summary: Deletes a document.
      description: Deletes a document with a given unique identifier.
      operationId: delete_document
      parameters:
      - name: document_id
        in: path
        description: Id of document to delete
        required: true
        schema:
          type: string
      - name: timeout
        in: query
        description: Timeout in seconds
        schema:
          type: number
          format: double
          default: 300
      responses:
        '204':
          description: Successful operation
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        default:
          $ref: '#/components/responses/Unexpected'
    patch:
      tags:
      - Documents
      summary: Updates attributes of an existing document.
      description: Updates attributes of an existing document, particularly name and uri.
      operationId: update_document
      parameters:
      - name: document_id
        in: path
        description: Id of document to to be updated
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DocumentUpdateRequest'
        required: true
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Document'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        default:
          $ref: '#/components/responses/Unexpected'
  /documents/{document_id}/chunks:
    get:
      tags:
      - Documents
      summary: Returns all chunks for a specific document.
      description: Returns all chunks for a specific document.
      operationId: list_document_chunks
      parameters:
      - name: document_id
        in: path
        description: Id of the document.
        required: true
        schema:
          type: string
      - name: collection_id
        in: query
        description: Id of the collection the document belongs to.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ChunkSearchResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        default:
          $ref: '#/components/responses/Unexpected'
  /documents/process_job:
    post:
      tags:
      - Documents
      summary: Creates job to process document.
      description: 'Processes a document to either create a global or piecewise summary/extraction/transformation of a document.

        '
      operationId: create_process_document_job
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProcessDocumentJobRequest'
      responses:
        '201':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobDetails'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        default:
          $ref: '#/components/responses/Unexpected'
  /documents/delete_job:
    post:
      tags:
      - Documents
      summary: Creates job to delete documents.
      description: Creates job to delete documents with a given unique identifier.
      operationId: create_delete_document_job
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteDocumentsJobRequest'
      responses:
        '201':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobDetails'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        default:
          $ref: '#/components/responses/Unexpected'
  /documents/{document_id}/collections:
    get:
      tags:
      - Documents
      summary: Lists collections for containing a given document.
      description: Lists collections for containing a given document.
      operationId: list_collections_for_document
      parameters:
      - name: document_id
        in: path
        description: Id of the document.
        required: true
        schema:
          type: string
      - name: offset
        in: query
        description: How many collections to skip before returning.
        required: false
        schema:
          type: integer
          default: 0
      - name: limit
        in: query
        description: How many collections to return.
        required: false
        schema:
          type: integer
          default: 100
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Collection'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        default:
          $ref: '#/components/responses/Unexpected'
  /documents/{document_id}/tags:
    post:
      tags:
      - Documents
      summary: Assigns a tag to the document.
      description: Assigns a tag to the document.
      operationId: create_tag_on_document
      parameters:
      - name: document_id
        in: path
        description: Id of the document to to be associated with a tag
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TagCreateRequest'
        required: true
      responses:
        '201':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Tag'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        default:
          $ref: '#/components/responses/Unexpected'
  /documents/{document_id}/tags/{tag_name}:
    delete:
      tags:
      - Documents
      summary: Removes a tag from a document.
      description: Removes a tag from a document.
      operationId: delete_tag_from_document
      parameters:
      - name: document_id
        in: path
        description: Id of the document to remove the tag from
        required: true
        schema:
          type: string
      - name: tag_name
        in: path
        description: Name of the tag to be removed.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                required:
                - tag_id
                properties:
                  tag_id:
                    type: string
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        default:
          $ref: '#/components/responses/Unexpected'
  /documents/{document_id}/chats:
    get:
      operationId: list_chat_sessions_for_document
      summary: List chat sessions for a given document.
      description: List chat sessions for a given document.
      tags:
      - Documents
      parameters:
      - name: document_id
        in: path
        description: Id of the document to filter by.
        required: true
        schema:
          type: string
      - name: offset
        in: query
        description: How many chat sessions to skip before returning.
        required: false
        schema:
          type: integer
          default: 0
      - name: limit
        in: query
        description: How many chat sessions to return.
        required: false
        schema:
          type: integer
          default: 100
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ChatSession'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        default:
          $ref: '#/components/responses/Unexpected'
  /documents/{document_id}/chats/count:
    get:
      operationId: get_chat_session_count_for_document
      summary: Counts a number of chat sessions with the document.
      description: Counts a number of chat sessions with the document.
      tags:
      - Documents
      parameters:
      - name: document_id
        in: path
        description: Id of the document to filter by.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Count'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        default:
          $ref: '#/components/responses/Unexpected'
  /documents/{document_id}/summaries:
    get:
      operationId: list_document_summaries
      summary: Fetches recent document summaries/extractions/transformations
      description: Fetches recent document summaries/extractions/transformations
      tags:
      - Documents
      parameters:
      - name: document_id
        in: path
        description: Id of the document to filter by.
        required: true
        schema:
          type: string
      - name: offset
        in: query
        description: How many summaries to skip before returning.
        required: false
        schema:
          type: integer
          default: 0
      - name: limit
        in: query
        description: How many summaries to return.
        required: false
        schema:
          type: integer
          default: 100
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/DocumentSummary'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        default:
          $ref: '#/components/responses/Unexpected'
  /documents/summaries/{summary_ids}:
    delete:
      operationId: delete_document_summaries
      summary: Deletes document summaries.
      description: Deletes document summaries.
      tags:
      - Documents
      parameters:
      - name: summary_ids
        in: path
        description: List of string ids of a document summary to delete from the system.
        required: true
        schema:
          type: array
          items:
            type: string
      responses:
        '204':
          description: Successful operation
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        default:
          $ref: '#/components/responses/Unexpected'
  /documents/{document_id}/metadata:
    get:
      operationId: get_document_metadata
      summary: Fetches document metadata.
      description: Returns details of document metadata
      tags:
      - Documents
      parameters:
      - name: document_id
        in: path
        description: Id of the document associated with the metadata
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Metadata'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        default:
          $ref: '#/components/responses/Unexpected'
    put:
      operationId: update_document_metadata
      summary: Updates document metadata.
      description: Recreates entire metadata of the document.
      tags:
      - Documents
      parameters:
      - name: document_id
        in: path
        description: Id of the document
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Metadata'
      responses:
        '204':
          description: Successful operation
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        default:
          $ref: '#/components/responses/Unexpected'
  /documents/{document_id}/user_source_file:
    get:
      operationId: get_document_user_source_file
      summary: Fetches document user source file.
      description: Returns document user source file.
      tags:
      - Documents
      parameters:
      - name: document_id
        in: path
        description: Id of the document
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful operation with data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dictionary'
        '204':
          description: Successful operation with no result
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        default:
          $ref: '#/components/responses/Unexpected'
  /documents/{document_id}/page_ocr_model:
    get:
      operationId: get_document_page_ocr_model
      summary: Fetches document page ocr model.
      description: Returns document page ocr model.
      tags:
      - Documents
      parameters:
      - name: document_id
        in: path
        description: Id of the document
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful operation with data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dictionary'
        '204':
          description: Successful operation with no result
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        default:
          $ref: '#/components/responses/Unexpected'
  /documents/{document_id}/page_layout:
    get:
      operationId: get_document_page_layout
      summary: Fetches document page layout.
      description: Returns document page layout.
      tags:
      - Documents
      parameters:
      - name: document_id
        in: path
        description: Id of the document
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful operation with data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dictionary'
        '204':
          description: Successful operation with no result
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        default:
          $ref: '#/components/responses/Unexpected'
  /documents/{document_id}/internal_metadata:
    get:
      operationId: get_document_internal_metadata
      summary: Fetches document internal metadata.
      description: Returns document internal metadata.
      tags:
      - Documents
      parameters:
      - name: document_id
        in: path
        description: Id of the document
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful operation with data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dictionary'
        '204':
          description: Successful operation with no result
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        default:
          $ref: '#/components/responses/Unexpected'
  /documents/{document_id}/guardrails_settings:
    get:
      operationId: get_document_guardrails_settings
      summary: Fetches document guardrails settings.
      description: Returns document guardrails settings.
      tags:
      - Documents
      parameters:
      - name: document_id
        in: path
        description: Id of the document
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful operation with data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GuardrailsSettings'
        '204':
          description: Successful operation with no result
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        default:
          $ref: '#/components/responses/Unexpected'
  /document_summaries/{summary_id}:
    get:
      operationId: get_document_summary
      summary: Fetches document summary.
      description: Fetches document summary.
      tags:
      - Documents
      parameters:
      - name: summary_id
        in: path
        description: Id of the document summary
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocumentSummary'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        default:
          $ref: '#/components/responses/Unexpected'
components:
  schemas:
    DocumentUpdateRequest:
      type: object
      properties:
        name:
          type: string
        uri:
          type: string
    JobDetailsStatus:
      required:
      - id
      - status
      type: object
      properties:
        id:
          type: string
        status:
          type: string
    Collection:
      required:
      - id
      - name
      - description
      - embedding_model
      - document_count
      - document_size
      - created_at
      - updated_at
      - user_count
      - is_public
      - username
      - sessions_count
      - status
      type: object
      properties:
        id:
          description: A unique identifier of the collection
          type: string
          example: 123e4567-e89b-12d3-a456-426655440000
        name:
          description: Name of the collection
          type: string
          example: My sci-fi library
        description:
          description: Description of the collection
          type: string
          example: Collection of my favourite sci-fi books
        embedding_model:
          type: string
          example: BAAI/bge-large-en-v1.5
        document_count:
          description: A number of documents in the collection
          type: integer
        document_size:
          description: Total size in bytes of all documents in the collection
          type: integer
        created_at:
          description: Time when the collection was created
          type: string
          format: date-time
        updated_at:
          description: Last time when the collection was modified
          type: string
          format: date-time
        user_count:
          description: A number of users having access to the collection
          type: integer
        is_public:
          description: Is publicly accessible
          type: boolean
        username:
          description: Name of the user owning the collection
          type: string
        sessions_count:
          description: A number of chat sessions with the collection
          type: integer
        status:
          description: Status of the collection
          type: string
        prompt_template_id:
          description: A unique identifier of a prompt template associated with the collection.
          type: string
          example: 4e400991-c459-455f-995c-dc6f55ffdb90
        thumbnail:
          description: A file name of a thumbnail image.
          type: string
        size_limit:
          description: Maximum size of data that could be contained in the collection.
          type: integer
        expiry_date:
          description: An expiry date
          type: string
          format: date-time
        inactivity_interval:
          description: The inactivity interval as an integer number of days.
          type: integer
        rag_type:
          description: "RAG type options:\n  * `auto` - Automatically select the best rag_type.\n  * `llm_only` LLM Only - Answer the query without any supporting document contexts.\n  Requires 1 LLM call.\n  * `rag` RAG (Retrieval Augmented Generation) - Use supporting document contexts\n  to answer the query. Requires 1 LLM call.\n  * `hyde1` LLM Only + RAG composite - HyDE RAG (Hypothetical Document Embedding).\n  Use 'LLM Only' response to find relevant contexts from a collection for generating\n  a response. Requires 2 LLM calls.\n  * `hyde2` HyDE + RAG composite - Use the 'HyDE RAG' response to find relevant\n  contexts from a collection for generating a response. Requires 3 LLM calls.\n  * `rag+` Summary RAG - Like RAG, but uses more context and recursive\n  summarization to overcome LLM context limits. Keeps all retrieved chunks, puts\n  them in order, adds neighboring chunks, then uses the summary API to get the\n  answer. Can require several LLM calls.\n  * `all_data` All Data RAG - Like Summary RAG, but includes all document\n  chunks. Uses recursive summarization to overcome LLM context limits.\n  Can require several LLM calls.\n"
          type: string
          enum:
          - auto
          - llm_only
          - rag
          - hyde1
          - hyde2
          - rag+
          - all_data
        metadata_dict:
          $ref: '#/components/schemas/Metadata'
        workspace:
          description: The workspace associated with the collection.
          type: string
        has_default_guardrails:
          description: Whether this collection was created with default guardrails enabled.
          type: boolean
        vex_encryption:
          description: 'The per-collection vector encryption choice that was set at creation: `enabled`, `disabled`, or null when the collection follows the server default. Read-only — cannot be changed after creation.

            '
          type:
          - string
          - 'null'
          enum:
          - enabled
          - disabled
    DocumentSummary:
      type: object
      required:
      - id
      - document_id
      - content
      - error
      - kwargs
      - created_at
      properties:
        id:
          description: A unique identifier of the document summary
          type: string
        document_id:
          description: A unique identifier of the document
          type: string
        content:
          type: string
        error:
          type: string
        kwargs:
          type: string
        created_at:
          type: string
          format: datetime
        usage_stats:
          type: string
    Dictionary:
      type: object
      additionalProperties: true
    ChunkSearchResult:
      allOf:
      - $ref: '#/components/schemas/Chunk'
      - type: object
        required:
        - topic
        - score
        properties:
          topic:
            type: string
          score:
            type: number
            format: double
    Metadata:
      type: object
      additionalProperties: true
    ChatCompletionRequestLLMArgs:
      type: object
      description: "A map of arguments sent to LLM with query.\n  * `temperature` **(type=double, default=0.0)** - A value used to modulate the next token probabilities.\n    0 is the most deterministic and 1 is most creative.\n  * `top_k` **(type=integer, default=1)** - A number of highest probability vocabulary tokens to keep for top-k-filtering.\n  * `top_p` **(type=double, default=0.0)** - If set to a value < 1, only the smallest set of most probable\n    tokens with probabilities that add up to top_p or high

# --- truncated at 32 KB (56 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/h2o-ai/refs/heads/main/openapi/h2o-ai-documents-api-openapi.yml