v1

latestOpenAPI 3.1.0BUSL-1.12026-07-1756132288.0 KB

Gets a Layer 0 knowledge document by id

get/api/v1/{context_id}/documents/{id}

Path parameters

context_idstring required

Spectron context id

idstring required

Document id fragment

Response

Document

contentHashstring required
createdAtstring date-time required
errorstring nullable
idstring required
mimeTypestring required
processingCompletedAtstring date-time nullable
processingStartedAtstring date-time nullable
sizeBytesinteger required
sourcestring 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.

titlestring required
updatedAtstring date-time required
versioninteger required