Dynamiq
Tracing

Download project traces

Streams a project's execution traces as a downloadable JSON file (Content-Disposition: attachment; filename="<project_id>-traces.json"). The body is a JSON array of trace objects — each with id, started_at, ended_at, status, input, output, and usage — ordered by started_at descending. When include_runs is true, each trace also carries a runs array. Optional time-range filters on started_at use the started_at:gt|gte|lt|lte=<RFC3339> form; gt/gte and lt/lte are mutually exclusive.

GET
/v1/projects/{project_id}/traces/download

Authorization

personalAccessToken
AuthorizationBearer <token>

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

project_id*string

Project UUID.

Query Parameters

limit?integer

Maximum number of traces to include (1–1000). Defaults to the 10000 most recent traces when omitted.

include_runs?boolean

Include each trace's run tree in the exported objects.

started_at:gt?string

Only traces started strictly after this RFC 3339 timestamp.

started_at:gte?string

Only traces started at or after this RFC 3339 timestamp.

started_at:lt?string

Only traces started strictly before this RFC 3339 timestamp.

started_at:lte?string

Only traces started at or before this RFC 3339 timestamp.

Response Body

application/octet-stream

application/json

application/json

application/json

curl -X GET "https://example.com/v1/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/traces/download"
"string"
{
  "error": {
    "code": "bad_request",
    "message": "Bad Request",
    "details": {
      "input": "cannot be blank"
    }
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized"
  }
}
{
  "error": {
    "code": "not_found",
    "message": "Not Found"
  }
}