v52

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

List agent conversation threads

List the caller's agent conversations grouped by thread (most recently active first). Restore a thread's messages via the run events endpoints.

Required roles: All, App

get/agent/threads

Query parameters

limitinteger
offsetinteger
principal_idstring

Filter by principal. If omitted, only threads with no principal (principal_id is null) are returned. Mutually exclusive with all_principals=true (400 if both are set).

all_principalsboolean

If true, return threads across all principals in the tenant. Mutually exclusive with principal_id (400 if both are set).

Response

Agent thread list