Dynamiq
Apps

Get an app trace

Returns a single execution trace of an app.

GET
/v1/apps/{app_id}/traces/{trace_id}

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

app_id*string

App UUID.

trace_id*string

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/apps/497f6eca-6276-4993-bfeb-53cbbbba6f08/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
    }
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized"
  }
}
{
  "error": {
    "code": "not_found",
    "message": "Not Found"
  }
}

Download app traces

Streams an app's execution traces as a downloadable JSON file (`Content-Disposition: attachment; filename="<app_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.

List app trace runs

Lists the individual runs — workflow, flow, and node executions — that make up a trace, ordered by `start_time` descending by default.