857 B
857 B
Using the Chunk API
Endpoint: POST /vex/evidence/chunks
- Content-Type:
application/x-ndjson - See schema:
docs/modules/excititor/schemas/vex-chunk-api.yaml
Response: 202 Accepted
{ "chunk_digest": "sha256:…", "queue_id": "uuid" }
Operational notes
- Deterministic hashing: server recomputes
chunk_digestfrom canonical JSON; mismatches return 400. - Limits: default 500 items, max 2000 (aligned with Program.cs guard).
- Telemetry: metrics under
StellaOps.Excititor.Chunks(see chunk-telemetry.md). - Headers: correlation/trace headers echoed (
X-Stella-TraceId,X-Stella-CorrelationId).
Example curl
curl -X POST https://excitor.local/vex/evidence/chunks \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/x-ndjson" \
--data-binary @docs/modules/excititor/samples/chunk-sample.ndjson