Ingest documents (text, files, or mixed)

Unified document ingestion endpoint.

Accepts a multipart form with:

manifest (required): JSON array describing each item
files (optional): one or more file uploads, referenced by file_index in the manifest

Manifest format (JSON array):

[
  {"type": "file", "file_index": 0, "title": "Report"},
  {"type": "text", "title": "FAQ", "content": "What is..."},
  {"type": "file", "file_index": 1, "title": "Old Report", "document_id": "uuid"}
]

POST

knowledge-base

knowledge-bases

{kb_id}

ingest

Ingest documents (text, files, or mixed)

curl --request POST \
  --url https://api-sandbox.featherhq.com/v1/knowledge-base/knowledge-bases/{kb_id}/ingest \
  --header 'x-api-key: <api-key>'

{
  "ingestion_job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "items": [
    {
      "manifest_index": 123,
      "document_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "duplicate_of_document_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "duplicate_of_version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "duplicate_of_document_title": "<string>"
    }
  ]
}

Authorizations

x-api-key

string

header

required

Path Parameters

kb_id

string<uuid>

required

Response

Successful Response

Response from the unified ingest endpoint.

ingestion_job_id is the parent IngestionJob for bulk submissions, or the single-doc job for a 1-item manifest. items mirrors the manifest order so callers can render per-item outcomes without a second call.

ingestion_job_id

string<uuid>

required

items

IngestResultItem · object[]

required

Show child attributes

List ingestion jobs for a knowledge base

⌘I

Ingest documents (text, files, or mixed)

curl --request POST \
  --url https://api-sandbox.featherhq.com/v1/knowledge-base/knowledge-bases/{kb_id}/ingest \
  --header 'x-api-key: <api-key>'

{
  "ingestion_job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "items": [
    {
      "manifest_index": 123,
      "document_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "duplicate_of_document_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "duplicate_of_version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "duplicate_of_document_title": "<string>"
    }
  ]
}