Skip to main content
GET
List chats

Authorizations

Authorization
string
header
required

An Admin API key, starting with cas_admin_.

Query Parameters

from
string<date-time>
required

Inclusive start of the range, by creation time, as an ISO 8601 timestamp.

to
string<date-time>
required

Exclusive end of the range as an ISO 8601 timestamp. The range can span at most 31 days.

limit
integer
default:100

Maximum number of records to return.

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

The nextCursor from the previous page.

agentIds
string[]

Only include these Agents, using the IDs from the agent breakdown or /chats. Built-in models combine their thinking levels. Pass several as a comma-separated list.

Maximum array length: 20
excludeAgentIds
string[]

Leave out these Agents. Pass several as a comma-separated list.

Maximum array length: 20
modelIds
string[]

Only include Agents that use these models, such as claude-opus-5-5, including the built-in model's own Agent. Agents count as the model they use today, so changing an Agent's model moves its past usage too. Thinking levels are combined. Pass several as a comma-separated list.

Maximum array length: 20
excludeModelIds
string[]

Leave out Agents that use these models. Pass several as a comma-separated list.

Maximum array length: 20
userId
string

Only list chats started by this user.

source
enum<string>

Only list chats from this source, such as slack or web.

Available options:
web,
slack,
teams,
googleChat,
embedded,
email,
api

Response

Successful response

nextCursor
string | null
required

Pass as cursor to get the next page. Null on the last page.

chats
object[]
required