Ingest trace runs
Ingests a batch of workflow/flow/node trace runs, as produced by the Dynamiq Python SDK's `TracingCallbackHandler` / `DynamiqTracingClient`. The collector validates `id`, `name`, `type`, `trace_id`, `source_id`, `start_time`, `end_time`, and `status`; the remaining fields are stored as-is. SDK-emitted fields not listed in the schema (such as `session_id` and `tags`) are accepted and ignored by the collector.
Authorization
accessKey Organization or project Access Key created in the Dynamiq console. Used for deployed-app (Runs API), AI Gateway, traces collector, and management API requests. Send as Authorization: Bearer <access-key>.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/v1/traces" \ -H "Content-Type: application/json" \ -d '{ "runs": [ { "id": "11d4a6e8-9c2b-4f3a-8e1d-2f6071829301", "name": "Workflow", "type": "workflow", "trace_id": "6e7f8091-a2b3-4c5d-8e6f-708192a3b4c5", "source_id": "4f6e1c2a-7b8d-4e9f-a1b2-c3d4e5f60718", "session_id": "3d3e8a1f-09a6-4f64-9d68-1d2f3a4b5c6d", "start_time": "2026-06-10T09:15:21Z", "end_time": "2026-06-10T09:15:34Z", "status": "succeeded", "input": { "ticket_subject": "Charged twice for June invoice" }, "output": { "category": "billing" }, "metadata": { "workflow": { "id": "2b3c4d5e-6f70-4182-93a4-b5c6d7e8f901", "version": "3" } }, "executions": [], "tags": [ "support-triage", "production" ] } ] }'{
"message": "ok"
}{
"error": {
"code": "bad_request",
"message": "Bad Request",
"details": {
"input": "cannot be blank"
}
}
}{
"error": {
"code": "unauthorized",
"message": "Unauthorized"
}
}