Skip to main content
GET
List threads for an agent

Authorizations

Authorization
string
header
required

Use JWT token for authentication

Path Parameters

agentId
string<uuid>
required

UUID of the agent whose threads should be listed

Query Parameters

status
enum<string>

Filter threads by status Current status of the thread

Available options:
RUNNING,
PAUSED,
COMPLETED,
FAILED,
AWAITING_APPROVAL
limit
integer<int32>
default:20

Maximum number of threads to return (pagination)

Required range: 1 <= x <= 100
offset
integer<int32>
default:0

Number of threads to skip (pagination offset)

Required range: x >= 0
tenantId
string

Filter threads by tenant ID

subtenantId
string

Filter threads by subtenant ID (end user/entity inside a tenant)

Response

List of threads for the specified agent

id
string<uuid>
required

Unique identifier for the thread

agentId
string<uuid>
required

Unique identifier for the associated agent

status
enum<string>
required

Current status of the thread

Available options:
RUNNING,
PAUSED,
COMPLETED,
FAILED,
AWAITING_APPROVAL
createdAt
string<date-time>
required

Timestamp when the thread was created

messages
object[]
required

Messages exchanged in the thread

updatedAt
string<date-time>

Timestamp when the thread was last updated

metadata
object

Custom metadata associated with the thread

cost
number<float>

Total cost accumulated by this thread