Skip to main content
GET
Get Trace

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

trace_id
string
required

Query Parameters

fields
string | null

Comma-separated field groups to include: 'core' (tree/timing/status, always included), 'usage' (tokens/cost), 'io' (per-span input/output), 'metadata' (per-span metadata). Aliases: 'skeleton' (core,usage), 'full' (everything). Unknown groups return 400.

project_id
string | null

Target project for the request. Required when authenticating with a user session token (a user credential is only meaningful scoped to a project); for an API key it is optional and, if given, must match the key's project.

Response

Successful Response

Full trace payload plus a backend-built link to its UI detail view.

git_ref
string | null
required
git_repo
string | null
required
input
string | null
required
metadata
string | null
required
name
string
required
output
string | null
required
project_id
string
required
session_id
string | null
required
spans
SpanResponse · object[]
required
trace_id
string
required
trace_start_time
string<date-time>
required
trace_url
string
required
user_id
string | null
required