GET /api/v1/chat/messages

Статус: GA Доступ: по токену контракт API: 0.3.0 · capability 2026-09-03.1 Открыть как Markdown Открыть в Claude Открыть в ChatGPT

List Messages

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.

Авторизация: нужен Authorization: Bearer <token>

Запрос

curl -sS -X GET "https://entherium.duckdns.org:8443/api/v1/chat/messages" \
  -H "Authorization: Bearer <token>"

Ответ `200`

В контракте нет примера для этого ответа; схема: ChatMessageListResponse. Поля — в интерактивном обозревателе.

Возвращает

ChatMessageListResponse — Successful Response

Поле	Тип	Описание
`items`	`массив ChatMessageRead`
`limit`	`integer` (opt.)
`offset`	`integer` (opt.)
`total`	`integer`

Параметры

Параметр	Где	Обязателен	Тип	По умолчанию	Ограничения	Описание
`chat`	query	нет	`string \| null`	—	—	chat alias: `work` (the team work chat, default) or `agents`; or a raw chat_id
`author`	query	нет	`string \| null`	—	—	substring of the author’s display name
`since_days`	query	нет	`integer \| null`	—	min 1; max 365	only messages from the last N days
`q`	query	нет	`string \| null`	—	—	substring to search for in the message text
`limit`	query	нет	`integer`	`100`	min 1; max 500
`offset`	query	нет	`integer`	`0`	min 0

Ошибки

Код	Смысл	Тело
`401`	Missing or invalid authentication credentials	`ErrorResponse`
`422`	Validation Error	`HTTPValidationError`

Тело любой ошибки — {detail, code?, request_id, doc_url}: request_id — что цитировать, doc_url ведёт в Справочник ошибок.