v54

Swagger 2.0AGPL-3.0raw.githubusercontent.com2026-08-03397565628.8 KB

Chats

List chats

Experimental: this endpoint is subject to change.

get/api/experimental/chats

Query parameters

qstring

Search query. Supports title:<substring> (case-insensitive, quote multi-word values), archived:bool, has_unread:bool, pr_status:<draft\|open\|merged\|closed> as repeated or comma-separated values, source:<created_by_me\|shared_with_me>, diff_url:<url> (quote values containing colons), pr:<number> (exact PR number match), repo:<owner/repo> (case-insensitive substring match against git remote origin or URL), pr_title:<text> (case-insensitive PR title substring), search:<text> (full-text search across chat titles, PR titles, PR numbers, and message bodies; quote multi-word values; cannot be combined with title, pr_title, or pr). Bare terms are not supported; use title:<value> or search:<value>.

labelstring

Filter by label as key:value. Repeat for multiple (AND logic).

Response

agent_idstring uuid

archivedboolean

build_idstring uuid

client_type'ui' | 'api'

created_atstring date-time

has_unreadboolean

HasUnread is true when assistant messages exist beyond the owner's read cursor, which updates on stream connect and disconnect.

idstring uuid

labelsobject

last_model_config_idstring uuid

last_reasoning_effortstring

last_turn_summarystring

mcp_server_idsstring[]

organization_idstring uuid

owner_idstring uuid

owner_namestring

owner_usernamestring

parent_chat_idstring uuid

pin_orderinteger

plan_mode'plan'

root_chat_idstring uuid

sharedboolean

Shared is true when this chat's root chat has explicit user or group ACL entries.

status'waiting' | 'running' | 'error' | 'requires_action' | 'interrupting'

summarystring

Summary is the persisted whole-chat summary, generated in the background. It is nil until the first summary has been produced.

titlestring

updated_atstring date-time

warningsstring[]

workspace_idstring uuid