Sign in

v1

latestOpenAPI 3.1.0BUSL-1.12026-07-1756132288.0 KB

Upload a new Layer 0 knowledge document (multipart/form-data)

post/api/v1/{context_id}/documents

Path parameters

context_idstring required

Spectron context id

Response

Upload accepted

contentHashstring required
deduplicatedboolean required
idstring required
status'queued' | 'extracting' | 'chunking' | 'embedding' | 'keywording' | 'extracting_nodes' | 'ready' | 'failed' required

Lifecycle state of a [Document] in the ingestion pipeline.

Matches the SurrealQL ASSERT $value IN [...] on document.status in V1__schema.surql. The Keywording state is reserved for Phase C; in Phase A the pipeline transitions straight from Embedding to Ready.