Ingests content into a knowledge base: it gathers documents (from a registered source or inline), REDACTS each body, chunks it, embeds the chunks via the wired embedder OUTSIDE the store transaction (the network/ egress call must never hold the single SQLite writer — the deploy discipline), and persists documents + chunks in one transaction.
POST
/v1/m/knowledge/kbs/{id}/ingest
const url = 'https://example.com/v1/m/knowledge/kbs/example/ingest';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"documents":[{"acl":["example"],"body":"example","classification":"example","content_type":"example","source_doc_id":"example","source_kind":"inline","source_mode":"example","space_ref":"example","title":"example"}],"source":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/v1/m/knowledge/kbs/example/ingest \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "documents": [ { "acl": [ "example" ], "body": "example", "classification": "example", "content_type": "example", "source_doc_id": "example", "source_kind": "inline", "source_mode": "example", "space_ref": "example", "title": "example" } ], "source": "example" }'Ingests content into a knowledge base: it gathers documents (from a registered source or inline), REDACTS each body, chunks it, embeds the chunks via the wired embedder OUTSIDE the store transaction (the network/ egress call must never hold the single SQLite writer — the deploy discipline), and persists documents + chunks in one transaction.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” id
required
string
Path parameter id.
Header Parameters
Section titled “Header Parameters ” X-Olivares-Tenant
string format: uuid
Target tenant id; required when the principal can act in more than one tenant.
Request Body required
Section titled “Request Body required ” Media type application/json
Any of:
object
documents
Array<object>
object
acl
Array<string>
body
string
classification
Accepted as supplied; empty inherits the knowledge-base classification.
string
content_type
string
source_doc_id
required
string
source_kind
string
source_mode
Unknown or empty values are normalized to direct for inline documents.
string
space_ref
string
title
string
source
required
string
object
documents
required
source
string
Responses
Section titled “ Responses ”OK
Media type application/json
object
Example generated
{}Bad request
Media type application/json
object
Example generated
{}Unauthenticated
Media type application/json
object
Example generated
{}Forbidden
Media type application/json
object
Example generated
{}Not found
Media type application/json
object
Example generated
{}Conflict / setup required
Media type application/json
object
Example generated
{}Rate limited
Media type application/json
object
Example generated
{}