Skip to main content
POST
Ingest Knowledge
Use this API to submit reference material (guidelines, standards, policy docs) to your Memory knowledge base. Ingestion is asynchronous: the call returns immediately with a sourceId, and conversion, rule extraction, and embedding run in the background. Poll Get Ingest Status until the status is terminal. Supported file types: PDF, CSV, Excel (.xlsx), and plain text.

Endpoint

POST https://api.velt.dev/v2/memory/knowledge/ingest

Headers

x-velt-api-key
string
required
Your API key.
x-velt-auth-token
string
required

Body

Params

The request is a discriminated union on source: send source: "inline" with a base64 file (decoded size up to 5 MB), or source: "fileRef" with a gs:// URI from Get Upload URL (up to 30 MB).
data
object
required

Example Requests

Inline (file up to 5 MB)

By reference (file up to 30 MB)

Response

Ingestion runs in the background. Poll Get Ingest Status with the returned sourceId until the status is completed or failed.

Success Response

Failure Response