Skip to main content
GET
/
threads
/
{thread_id}
/
runs
List Runs
curl --request GET \
  --url https://api.b-bot.space/api/v2/threads/{thread_id}/runs \
  --header 'bbot-api-key: <api-key>'
[
  {
    "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "channel_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "status": "pending",
    "metadata": {},
    "kwargs": {},
    "multitask_strategy": "reject"
  }
]

Authorizations

​
bbot-api-key
string
header
required

API key for authentication

Path Parameters

​
thread_id
string<uuid>
required

The ID of the thread.

Query Parameters

​
limit
integer
default:10
​
offset
integer
default:0
​
status
enum<string>
Available options:
pending,
error,
success,
timeout,
interrupted
​
select
enum<string>[]

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

Available options:
run_id,
thread_id,
channel_id,
created_at,
updated_at,
status,
metadata,
kwargs,
multitask_strategy

Response

Success

​
run_id
string<uuid>
required

The ID of the run.

​
thread_id
string<uuid>
required

The ID of the thread.

​
channel_id
string<uuid>
required

The assistant that was used for this run.

​
created_at
string<date-time>
required

The time the run was created.

​
updated_at
string<date-time>
required

The last time the run was updated.

​
status
enum<string>
required

The status of the run. One of 'pending', 'running', 'error', 'success', 'timeout', 'interrupted'.

Available options:
pending,
running,
error,
success,
timeout,
interrupted
​
metadata
Metadata · object
required

The run metadata.

​
kwargs
Kwargs · object
required
​
multitask_strategy
enum<string>
required

Strategy to handle concurrent runs on the same thread.

Available options:
reject,
rollback,
interrupt,
enqueue