Retrieve run trace
Returns the OTel trace subtree for the requested run — the run’s span as rootSpan, its ancestor chain, and its descendant spans. For child or nested runs in a large trace, this is scoped to that run rather than the trace-wide root.
trace.rootSpan is that run’s span — not necessarily the trace-wide root — with its descendant spans nested under children.
For a child or nested run inside a large trace, this endpoint scopes the tree to that run so you still get a useful subtree even when the full trace has more spans than the platform can return in one response.Authorizations
Use your project-specific Secret API key. Will start with tr_dev_, tr_prod, tr_stg, etc.
You can find your Secret API key in the API Keys section of your Trigger.dev project dashboard.
Our TypeScript SDK will default to using the value of the TRIGGER_SECRET_KEY environment variable if it is set. If you are using the SDK in a different environment, you can set the key using the configure function.
Path Parameters
The ID of an run, starts with run_. The run ID will be returned when you trigger a run on a task.
Response
Successful request

