Get a trace with runs
Returns a single trace together with its full run tree. The trace carries started_at/ended_at while each run carries start_time/end_time — this mirrors the server responses and is intentional.
Authorization
personalAccessToken Personal Access Token of a Dynamiq user — the only credential accepted by the management API (api.*). Prefix dyn_pat_ (legacy uak_ tokens still authenticate). Send as Authorization: Bearer <token>.
In: header
Path Parameters
Trace UUID.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/tracing/traces/497f6eca-6276-4993-bfeb-53cbbbba6f08"{
"data": {
"id": "6e7f8091-a2b3-4c5d-8e6f-708192a3b4c5",
"source_id": "4f6e1c2a-7b8d-4e9f-a1b2-c3d4e5f60718",
"started_at": "2026-06-10T09:15:21Z",
"ended_at": "2026-06-10T09:15:34Z",
"status": "succeeded",
"input": {
"ticket_subject": "Charged twice for June invoice"
},
"output": {
"category": "billing"
},
"usage": {
"prompt_tokens": 1843,
"completion_tokens": 212
},
"runs": [
{
"id": "11d4a6e8-9c2b-4f3a-8e1d-2f6071829301",
"name": "Workflow",
"type": "workflow",
"trace_id": "6e7f8091-a2b3-4c5d-8e6f-708192a3b4c5",
"start_time": "2026-06-10T09:15:21Z",
"end_time": "2026-06-10T09:15:34Z",
"status": "succeeded"
}
]
}
}{
"error": {
"code": "unauthorized",
"message": "Unauthorized"
}
}{
"error": {
"code": "not_found",
"message": "Not Found"
}
}List service traces
Lists execution traces of a deployed service, most recent first (ordered by `started_at` descending).
Download a trace
Returns a single trace as a downloadable JSON file (`Content-Disposition: attachment; filename="<trace_id>.json"`). Set `include_runs=true` to embed the trace's run tree in the exported object.