Skip to main content
POST
Ingest a document

Authorizations

Authorization
string
header
required

Workspace API key. Create one via the dashboard or POST /v1/auth/keys.

Body

text
string

Raw text to ingest.

url
string

URL to fetch and ingest.

file_base64
string

Base64-encoded file bytes.

filename
string

Display filename or title.

content_type
string

MIME type for file_base64.

knowledge_base_id
string<uuid>

Target knowledge base.

source
string

Provenance label; defaults to api.

Maximum string length: 120

Response

Document ingested.

id
string
knowledge_base_id
string | null
filename
string | null
source
string | null
source_url
string | null
status
string
bytes
integer | null
created_at
string
updated_at
string