v6

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01231846.9 KB
Threads

Search Threads

Search for threads.

This endpoint also functions as the endpoint to list all threads.

post/threads/search

Request body

metadataobject

Thread metadata to filter on.

valuesobject

State values to filter on.

status'idle' | 'busy' | 'interrupted' | 'error'

Thread status to filter on.

limitinteger

Maximum number to return.

offsetinteger

Offset to start from.

Response

Success

thread_idstring uuid required

The ID of the thread.

created_atstring date-time required

The time the thread was created.

updated_atstring date-time required

The last time the thread was updated.

metadataobject required

The thread metadata.

status'idle' | 'busy' | 'interrupted' | 'error' required

The status of the thread.

valuesobject

The current state of the thread.