v52

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-0393116227.2 KB
agent

Get an agent thread's run tree

Get the runs of a thread as a tree (via parent_run_id). Use it to detect branches (sibling runs from edit/regenerate) and pick a run to restore (restore via the run events endpoints).

Required roles: All, App

get/agent/threads/{thread_id}

Path parameters

thread_idstring required

Query parameters

principal_idstring

Scope by principal. If omitted, only a thread with no principal (principal_id is null) is returned; a thread whose principal differs yields 404.

Response

Agent thread run tree

thread_idstring required