List Chats
GET/v1/chats
List the N most recent chats for the authenticated user.
path, when provided, is used as an affinity hint: chats whose location
table records a matching path are bubbled to the top of the list, but the
result is never filtered down to only path-matches. This guarantees the
selector is never empty when chats exist — the original strict-filter
behaviour silently dropped every chat after a redirect or query-string
drift between writer and reader.
Cursor-paginated. The wire query parameter is exclusiveStartKey (what the cURL tab and the parameter table show); the TypeScript SDK takes it as the exclusiveStartKey option and the Python SDK as the exclusive_start_key keyword — one parameter, spelled per language. Pass the previous page's nextKey and stop when it comes back null — or let iterAll() / iter_all() drive the cursor for you (see the SDKs page, "Pagination").
Request
Responses
- 200
- 404
- 422
Successful Response
Not found
Validation Error