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

# Create chunks for a datasource



## OpenAPI

````yaml post /v2/knowledge/{knowledge_id}/datasources/{datasource_id}/chunks
openapi: 3.1.0
info:
  title: orq.ai API
  version: '2.0'
  description: orq.ai API documentation
servers:
  - url: https://api.orq.ai
security:
  - ApiKey: []
tags:
  - description: List models available through the AI Router.
    name: Models
  - name: Guardrail Rules
  - name: Policies
  - name: Routing Rules
  - name: API keys
    description: >-
      API keys authenticate programmatic access to the workspace. The unified
      key model exposes opaque tokens, per-domain access grants, and budget /
      rate-limit constraints (see ADR 0001 and ADR 0002).
  - name: Budgets
    description: >-
      Budgets govern spend, token usage, and request rate across six scopes:
      workspace, project, identity, api-key, provider, and model. A budget is
      hierarchical and defense-in-depth — every applicable budget is a hard
      gate, and the most restrictive one wins per dimension (see ADR 0007).
  - name: Documentation
    description: >-
      Search the orq.ai documentation. Proxies the workspace's query to the
      hosted docs search index.
  - name: Files
    description: File upload and retrieval operations.
  - name: Identities
    description: >-
      Identities represent end users from your system for usage and engagement
      tracking.
  - name: Projects
    description: Projects organize resources within a workspace
  - name: Skills
    description: >-
      Skills are modular instructions you can use to codify processes and
      conventions
  - name: Responses
  - description: >-
      Run agents on a cadence — cron, interval, or one-off. Minimum firing
      interval is 1 hour.
    name: Agent Schedules
  - name: Embeddings
  - name: Reporting
    description: >-
      GenAI reporting API over canonical analytics rollups. Accepts a metric
      name, time range, grain, group-by, and filters; returns a typed time
      series and optional totals.
externalDocs:
  url: https://docs.orq.ai
  description: orq.ai Documentation
paths:
  /v2/knowledge/{knowledge_id}/datasources/{datasource_id}/chunks:
    post:
      tags:
        - Knowledge Bases
      summary: Create chunks for a datasource
      operationId: CreateChunk
      parameters:
        - schema:
            type: string
            description: Unique identifier of the knowledge
          required: true
          description: Unique identifier of the knowledge
          name: knowledge_id
          in: path
        - schema:
            type: string
            description: Unique identifier of the datasource
          required: true
          description: Unique identifier of the datasource
          name: datasource_id
          in: path
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                properties:
                  text:
                    type: string
                    minLength: 1
                    description: The text content of the chunk
                  embedding:
                    type: array
                    items:
                      type: number
                    description: >-
                      The embedding vector of the chunk. If not provided the
                      chunk will be embedded with the knowledge base embeddings
                      model.
                  metadata:
                    type: object
                    additionalProperties:
                      anyOf:
                        - type: string
                        - type: number
                        - type: boolean
                    description: Metadata of the chunk
                required:
                  - text
              minItems: 1
              maxItems: 100
              description: Array of chunks to create. Maximum of 100 chunks per request.
      responses:
        '200':
          description: Chunk successfully created
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    _id:
                      type: string
                      description: The unique identifier of the chunk
                    text:
                      type: string
                      description: The text content of the chunk
                    metadata:
                      type: object
                      additionalProperties:
                        anyOf:
                          - type: string
                          - type: number
                          - type: boolean
                      default: {}
                      description: >-
                        Metadata of the chunk. Can include `page_number` or any
                        other key-value pairs
                    enabled:
                      type: boolean
                      description: Whether the chunk is enabled
                    status:
                      type: string
                      enum:
                        - pending
                        - processing
                        - completed
                        - failed
                        - queued
                      description: The status of the chunk
                    created:
                      type: string
                      description: The date and time the chunk was created
                    updated:
                      type: string
                      description: The date and time the chunk was updated
                    created_by_id:
                      type:
                        - string
                        - 'null'
                      description: The unique identifier of the user who created the chunk
                    update_by_id:
                      type:
                        - string
                        - 'null'
                      description: The unique identifier of the user who updated the chunk
                  required:
                    - _id
                    - text
                    - enabled
                    - status
                    - created
                    - updated
                description: Array of created chunks
        '500':
          description: Failed to create chunk
components:
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      bearerFormat: JWT

````