Skip to main content
GET
List Runs

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,
running,
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,
assistant_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.

assistant_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