Skip to main content
GET
Search your chat threads

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

q
string
required

The text to find.

Required string length: 1 - 200
limit
integer
default:20

Maximum number of threads to return.

Required range: 1 <= x <= 50

Response

Successful Response

id
string
required

Thread ID.

status
enum<string>
required

Active or archived.

Available options:
regular,
archived
created_at
string<date-time>
required

When the thread was created.

updated_at
string<date-time>
required

Last activity in the thread.

created_by
string
required

Who started the thread.

can_post
boolean
required

Whether you can send messages in it.

can_manage
boolean
required

Whether you can rename, archive or delete it.

can_share
boolean
required

Whether you can create share links for it.

title
string | null

Display title; null until the first message.

workspace_id
string | null

The workspace the thread belongs to; null for a personal thread.

instructions
string | null

Standing instructions for the assistant, as Markdown. Added to the base prompt, never replacing it, and added to rather than replacing any the workspace sets. Cannot change which tools exist or which need approval.

defaults
ChatContextDefaults · object

What the assistant reaches for first in this thread.

subject
ChatSubject · object | null

The item this thread is about, if it is bound to one.

snippet
string | null

The text around the match, on one line; null when only the title matched.