Ingestion API
POST /api/ingest validates normalized JSON traces, stores the raw payload, queues an ingest job, and returns immediately.
The generated reference page for this flow is Queue trace ingestion.
Authentication
POST /api/ingest accepts either:
- a bearer token from the CLI
- a signed-in browser session
Contributor Terms
The account must have accepted the current Sell Traces Contributor Terms before it can upload. Until then the endpoint stores nothing and returns403 with
error: "terms_required" and an acceptUrl for the dashboard acceptance page.
The selltraces CLI prints that URL, opens it in an interactive terminal, and
exits non-zero; run the upload again after accepting.
JSON trace upload
Queued response
202.