Skip to main content
POST
/
threads
/
search
Search Threads
curl --request POST \
  --url https://api.b-bot.space/v2/threads/search \
  --header 'Content-Type: application/json' \
  --data '{
  "ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "metadata": {},
  "values": {},
  "status": "idle",
  "limit": 10,
  "offset": 0,
  "sort_by": "thread_id",
  "sort_order": "asc",
  "select": [
    "thread_id"
  ]
}'
[
  {
    "thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "metadata": {},
    "config": {},
    "status": "idle",
    "values": {},
    "interrupts": {}
  }
]

Body

application/json

Payload for listing threads.

​
ids
string<uuid>[]

List of thread IDs to include. Others are excluded.

​
metadata
object

Thread metadata to filter on.

​
values
object

State values to filter on.

​
status
enum<string>

Thread status to filter on.

Available options:
idle,
busy,
interrupted,
error
​
limit
integer
default:10

Maximum number to return.

Required range: 1 <= x <= 1000
​
offset
integer
default:0

Offset to start from.

Required range: x >= 0
​
sort_by
enum<string>

Sort by field.

Available options:
thread_id,
status,
created_at,
updated_at
​
sort_order
enum<string>

Sort order.

Available options:
asc,
desc
​
select
enum<string>[]

Specify which fields to return. If not provided, all fields are returned.

Response

Success

​
thread_id
string<uuid>
required

The ID of the thread.

​
created_at
string<date-time>
required

The time the thread was created.

​
updated_at
string<date-time>
required

The last time the thread was updated.

​
metadata
object
required

The thread metadata.

​
status
enum<string>
required

The status of the thread.

Available options:
idle,
busy,
interrupted,
error
​
config
object

The thread config.

​
values
object

The current state of the thread.

​
interrupts
object

The current interrupts of the thread.

⌘I