---
title: "Batch Ingest"
method: POST
path: "/ingestion/batch"
tags: ["Ingestion Pipeline"]
---

# Batch Ingest

`POST /ingestion/batch`

## Request

- Base URL: `https://api.getmetacognition.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getmetacognition.com/ingestion/batch`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/metacognition/apis/tex-api/docs/ingestion/batch/post.ts> (a function with typed inputs; its response is checked against the schema)

Batch ingest multiple documents (1–600) in a single request.

Each document is submitted to the ingestion pipeline independently.
Returns a batch_id and a list of job_ids for polling.

## Request body

- BatchIngestRequest: Batch document ingestion request.
  - `documents` BatchDocumentItem[], required: Documents to ingest
    - `data` string, required: Document text content
    - `format` string: Content format: text, markdown, html
    - `metadata` object, nullable: Document metadata
  - `options` object, nullable: Ingestion options

## Response `200`

Successful Response

- BatchIngestResponse: Response from batch ingestion.
  - `batch_id` string, required: Batch tracking ID
  - `jobs` object[]: Per-document job info
  - `total` integer: Total documents submitted

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/metacognition/apis/tex-api.md) - [All operations](https://skmtc.dev/metacognition/apis/tex-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metacognition/apis/tex-api/revisions/3bef47e50f2e?raw)