API: chat

Status: GA Access: token required API contract: 0.3.0 · capability 2026-09-03.1 View as Markdown Open in Claude Open in ChatGPT

`GET /api/v1/chat/messages`

List Messages

Open as a page →

Work-chat archive — the conversational context behind a task or defect.

Read-only. is_full=false on a row means the message text is TRUNCATED (the log and the message store could not be joined) — never quote such a row as verbatim.

Auth: Authorization: Bearer <token> required

Parameter	In	Required	Type	Description
`chat`	query	no	`string \| null`	chat alias: `work` (the team work chat, default) or `agents`; or a raw chat_id
`author`	query	no	`string \| null`	substring of the author’s display name
`since_days`	query	no	`integer \| null`	only messages from the last N days
`q`	query	no	`string \| null`	substring to search for in the message text
`limit`	query	no	`integer`
`offset`	query	no	`integer`

Responses:

Code	Meaning	Body
`200`	Successful Response	`ChatMessageListResponse`
`401`	Missing or invalid authentication credentials	`ErrorResponse`
`422`	Validation Error	`HTTPValidationError`