v6

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

Threads

Create Thread

Create a thread.

post/threads

thread_idstring uuid

The ID of the thread. If not provided, a random UUID will be generated.

assistant_idstring uuid

The assistant to bind to the thread.

metadataobject

Metadata to add to thread.

if_exists'raise' | 'do_nothing'

How to handle duplicate creation. Must be either 'raise' (raise error if duplicate), or 'do_nothing' (return existing thread).

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.

All 23 operations