Skip to main content
GET
List or search past conversations.
Scope: chat:conversations:read. See API Tokens.

Authorizations

Authorization
string
header
required

CloudThinker token: a personal access token ct_pat_… (fine-grained scopes, created in Settings) or an OAuth access token ct_oat_… (1 hour, from the OAuth flow). Send Authorization: Bearer <token>. Scopes have the form module:resource:read|write; write includes read.

Path Parameters

workspace_id
string<uuid>
required

Workspace to act in. Every call names it.

Query Parameters

query
string

Text to find in titles, messages, tool names, inputs and outputs.

Required string length: 1 - 200
match
enum<string>
default:literal

How query matches.

Available options:
literal,
regex,
fuzzy
since
string<date-time>

Only conversations at or after this time.

until
string<date-time>

Only conversations before this time.

type
string[]

Only these types, for example chat or rca.

limit
integer
default:20

Items per page.

Required range: 1 <= x <= 100
cursor
string

next_cursor from the previous page.

Maximum string length: 512

Response

OK

Conversations, newest first; with query, the matching ones.

items
Conversation · object[]
required
next_cursor
string | null
required

Pass back as cursor for the next page. Null on the last page.