---
title: "List Chats"
method: GET
path: "/api/context-agent/chats"
tags: ["context-agent"]
---

# List Chats

`GET /api/context-agent/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`)

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": [...]}

## Query parameters

- `proposals` boolean
- `proposal_filter` string
- `limit` integer
- `offset` integer
- `initiators` string, nullable: Comma-separated initiator ids; 'dot' is a routine review
- `kind` 'proposal' | 'problem' | 'review', nullable
- `start_date` string, nullable: First day shown (YYYY-MM-DD)
- `end_date` string, nullable: Last day shown (YYYY-MM-DD)
- `tz` string, nullable: Viewer's IANA timezone for the days

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/getdot/apis/dot-api-2.md) · [All operations](https://skmtc.dev/getdot/apis/dot-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/getdot/apis/dot-api-2/revisions/d26fe7163a7f?raw)