v1

latestOpenAPI 3.1.1MIT License2026-07-122354100.9 KB
Ingest Jobs

Create an ingest job

Create an ingest job for the authenticated organization. You can control how documents are parsed and chunked using the optional config object (for example, chunk size, overlap, language, and advanced OCR/LLM options).

post/v1/namespace/{namespaceId}/ingest-jobs

Path parameters

namespaceIdstring required

The id of the namespace (prefixed with ns_)

Example:ns_123

The id of the namespace (prefixed with ns_)

Headers

x-tenant-idstring

Optional tenant id to use for the request. If not provided, the namespace will be used directly. Must be alphanumeric and up to 64 characters.

Optional tenant id to use for the request. If not provided, the namespace will be used directly. Must be alphanumeric and up to 64 characters.

Request body

namestring nullable

The name of the ingest job.

externalIdstring nullable

A unique external ID of the ingest job. You can use this to identify the ingest job in your system.

Response

The created ingest job

successtrue required