stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 3 Releases Wiki Activity
Files
main
git.stella-ops.org/docs/modules/excititor/operations/chunk-api-user-guide.md
master 044cf0923c docs consolidation
2026-01-07 10:23:21 +02:00

857 B
Raw Permalink Blame History

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_digest from 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