Skip to main content

Land Staged Upload

POST 
/traces/land

Land a staged export by reference (202). The worker frames it — no bytes cross this handler.

An Idempotency-Key retry returns the run the first call created, with Idempotency-Replayed: true — the run's own state cannot signal reuse, since a replayed run may still be pending while a fresh one may already have completed.

Returns 403 if the caller does not belong to the named workspace, and 400 if project_id names no project in a workspace the caller belongs to. Returns 404 if the staged upload cannot be found, or if dataset_id names no dataset in the landing workspace/project. Returns 422 if the Idempotency-Key header is malformed, a supplied dataset_id does not accept trace spans, a supplied project_id is not a trace project, or retention_days is not one of the supported values. Returns 409 if another ingest for the same idempotency key is already in progress.

Request​

Responses​

Successful Response