openapi: 3.1.0
info:
  title: Trieve REST Chunk API
  version: '1'
  description: 'Trieve REST API for search, recommendations, RAG, and analytics. Endpoints

    derived from https://docs.trieve.ai/api-reference and the Redoc spec at

    https://api.trieve.ai/redoc.

    '
  contact:
    name: Trieve (Devflow, Inc.)
    url: https://docs.trieve.ai/api-reference
servers:
- url: https://api.trieve.ai
  description: Trieve Cloud (production)
- url: http://localhost:8090
  description: Self-hosted (local dev)
security:
- ApiKeyAuth: []
tags:
- name: Chunk
paths:
  /api/chunk:
    post:
      tags:
      - Chunk
      summary: Create or upsert chunk(s)
      description: 'Creates new chunks. A chunk with the same tracking_id as an existing chunk

        will cause the request to fail. Bulk uploads are capped at 120 chunks

        per request.

        '
      parameters:
      - in: header
        name: TR-Dataset
        required: true
        schema:
          type: string
        description: Dataset UUID or tracking_id targeted by the request.
      responses:
        '200':
          description: Chunk(s) created
        '400':
          description: Deserialization error
        '413':
          description: Too many chunks (exceeds 120)
        '426':
          description: Upgrade required
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'Trieve API key. User or API key must have admin or owner role on the

        targeted dataset''s organization.

        '