traces

List Related Traces

Trace thumbnails related to trace_id.

get/v2/trace/{trace_id}/related

Path parameters

trace_idstring uuid required

Query parameters

kind'job' | 'task' | 'recent' | 'discover' required

job (same job_id), task (every version of the same task), recent (caller's own traces, requires auth), or discover (most-recent visible traces overall).

limitinteger
scope_to_jobboolean

Only meaningful with kind=task: further restrict to the source trace's job. Used by the info-card sibling-run squares.

Only meaningful with kind=task: further restrict to the source trace's job. Used by the info-card sibling-run squares.

statusstring nullable

Comma-separated status whitelist applied to Trace.status — e.g. completed to exclude live/cancelled rows.

Comma-separated status whitelist applied to Trace.status — e.g. completed to exclude live/cancelled rows.

order'asc' | 'desc'

Sort by created_at.

Response

Successful Response

idstring uuid required
job_idstring uuid required
job_namestring nullable
statusstring required
rewardnumber nullable
stop_reason'done' | 'max_steps' | 'length' | 'timeout' | 'malformed_tool_call'
is_validboolean
errorstring nullable
created_atstring date-time required
start_timestring date-time nullable
end_timestring date-time nullable
viewsinteger
task_version_idstring uuid nullable
task_slugstring nullable
task_version_numberinteger nullable
task_promptstring nullable
thumbnail_urlstring nullable
inference_llm_model_idstring uuid nullable
metadataobject
evaluation_resultobject nullable
user_namestring nullable
user_avatar_urlstring nullable

Changes

No recorded changes to this endpoint across all 1 revision of this API.