List Chats
List context agent chats for the user's organization.
Default: the caller's own non-empty chats for the sidebar, newest first, without the transcript (message_count stands in for it; the detail route serves it). proposals=true: the paginated proposal inbox. Admins/modelers-with-unrestricted-access see every proposal in the org (any author); other users see only their own. The transcript is stripped (the inbox only renders summary fields) and the result is filtered by proposal_filter (open/merged/rejected/all), then by who started each row (initiators), its kind and the days its date falls on in the viewer's timezone, then windowed by offset/limit. Drafting proposals are kept even with no messages yet so the link resolves during the async window.
Returns: proposals=true: {"chats": [...], "total": int, "limit": int, "offset": int, "initiators": [{"id", "label", "count"}], "data_gap_count": int} otherwise: {"chats": [...]}
Request
- Base URL: https://app.getdot.ai (the document declares no server; this is the origin it was published from)
- URL: https://app.getdot.ai/api/context-agent/chats
- Auth: one of:
- API key in header X-API-KEY
- API key in cookie Authorization
- OAuth 2 (password, token URL /api/auth/token)
Query parameters
Comma-separated initiator ids; 'dot' is a routine review
First day shown (YYYY-MM-DD)
Last day shown (YYYY-MM-DD)
Viewer's IANA timezone for the days
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.