POST /api/v1/{context_id}/facts/batch

Bulk conversation ingest. Persists each message as a turn and routes extraction through reconcile_extraction.

Request

The document declares no server URL.
Auth
HTTP bearer
TypeScript
https://skmtc.dev/surrealdb/apis/spectron/docs/api/v1/:context_id/facts/batch/post.ts
A function with typed inputs. Its response is checked against the schema.

context_idstring required

Spectron context id

extract'per_message' | 'whole_conversation'

Bulk extraction strategy for /facts/batch.

infer'full' | 'triples' | 'preview' | 'none'

Inference mode for the /facts write API.

Decides which extraction path runs and which provenance kind the reconciler tags the writes with (see the per-variant docs below).

labelsLabel[]

Descriptive labels for the persisted rows (accepted + recorded; row application deferred).

session_idstring nullable

sessionIdstring required

turnIdsstring[] required

Aug 24, 20269f1598713067 Revision changes
- info
  added the new optional request property //
- info
  added the non-success response with the status
- info
  added the required property // to the response with the status
Jun 16, 20266ad06b1fefc4 Revision changes
- warning
  removed the request property
- info
  added the new optional request property