GET /api/v1/chat/messages

Note

Generated from the OpenAPI contract — do not edit by hand. Interactive explorer with full schemas: https://entherium.duckdns.org:8443/reference; frozen spec for this build: openapi.json. Group: chat.

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.

Auth: Authorization: Bearer <token> required

Request

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

Response 200

The contract carries no example for this response; schema: ChatMessageListResponse. Field-level shape: interactive explorer.

Returns

ChatMessageListResponse — Successful Response

Field	Type	Description
items	array of ChatMessageRead
limit	integer (opt.)
offset	integer (opt.)
total	integer

Parameters

Parameter	In	Required	Type	Default	Constraints	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	—	min 1; max 365	only messages from the last N days
q	query	no	string | null	—	—	substring to search for in the message text
limit	query	no	integer	100	min 1; max 500
offset	query	no	integer	0	min 0

Errors

Code	Meaning	Body
401	Missing or invalid authentication credentials	ErrorResponse
422	Validation Error	HTTPValidationError

Every error body is {detail, code?, request_id, doc_url} — request_id is the value to quote, doc_url points at the Errors reference.