Skip to main content
GET
List agent conversation threads

Authorizations

x-api-key
string
header
required

API key for authentication

Query Parameters

limit
integer
default:50
Required range: 1 <= x <= 200
offset
integer
default:0
Required range: x >= 0
principal_id
string

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_principals
boolean
default:false

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

Response

Agent thread list

threads
object[]
required