---
title: "Ingest Bulk"
method: POST
path: "/v1/ingest/manual/bulk"
tags: ["manual-ingest"]
---

# Ingest Bulk

`POST /v1/ingest/manual/bulk`

Ingest multiple documents at once.

Useful for batch importing documents or transcripts.
Maximum 50 documents per request.

## Request body

- BulkIngestRequest — Request to ingest multiple documents at once.
  - `workspace_id` string, uuid, required
  - `vault_id` string, uuid, nullable
  - `documents` ManualIngestRequest[], required
    - `workspace_id` string, uuid, required — Target workspace
    - `vault_id` string, uuid, nullable — Optional vault to associate with
    - `content` string, required — The text content to ingest
    - `title` string, required — Document title
    - `document_type` 'transcript' | 'notes' | 'document' | 'article' | 'email' | 'chat' — Types of manually ingested documents.
    - `author_name` string, nullable — Author name
    - `author_email` string, nullable — Author email
    - `source_url` string, nullable — Original source URL if applicable
    - `created_at` string, date-time, nullable — Original creation date
    - `tags` string[] — Tags for categorization
    - `metadata` object — Additional metadata

## Response `200`

Successful Response

- BulkIngestResponse — Response for bulk ingestion.
  - `total` integer, required
  - `created` integer, required
  - `updated` integer, required
  - `unchanged` integer, required
  - `errors` object[]
  - `document_ids` string[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ontora/apis/ontora-api.md) · [All operations](https://skmtc.dev/ontora/apis/ontora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ontora/ontora-api/revisions/7f57037fd94b/schema)