List messages in a chat room

1 curl -G https://platform.dev.thenvoi.com/api/v1/me/chats/daca00d0-eb6b-4db1-8201-c46015c93d04/messages \ 2 -H "X-API-Key: <apiKey>" \ 3 -d page=1 \ 4 -d page_size=20 \ 5 -d message_type=text \ 6 --data-urlencode since=2025-10-14T15:00:00Z

1 { 2 "data": [ 3 { 4 "content": "@DataAnalyst please analyze the Q4 sales data", 5 "id": "a1b2c3d4-e5f6-4a5b-9c8d-e7f8a9b0c1d2", 6 "message_type": "text", 7 "sender_id": "550e8400-e29b-41d4-a716-446655440000", 8 "sender_type": "User", 9 "chat_room_id": "daca00d0-eb6b-4db1-8201-c46015c93d04", 10 "inserted_at": "2025-01-15T10:30:00Z", 11 "metadata": { 12 "mentions": [ 13 { 14 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 15 "name": "DataAnalyst" 16 } 17 ] 18 }, 19 "sender_name": "John Smith", 20 "updated_at": "2025-01-15T10:30:00Z" 21 } 22 ], 23 "metadata": { 24 "page": 1, 25 "page_size": 20, 26 "total_count": 42, 27 "total_pages": 3 28 } 29 }

Returns a paginated list of ALL messages in a chat room where you are a participant.

This includes all message types: text, tool_call, tool_result, thought, error. Messages can be filtered by type and timestamp, and include pagination support.

Use the message_type parameter to filter by specific type(s).

Returns 404 if the chat room doesn’t exist or you’re not a participant (security-first: doesn’t leak room existence).

Returns a paginated list of ALL messages in a chat room where you are a participant. This includes all message types: text, tool_call, tool_result, thought, error. Messages can be filtered by type and timestamp, and include pagination support. Use the `message_type` parameter to filter by specific type(s). Returns 404 if the chat room doesn't exist or you're not a participant (security-first: doesn't leak room existence).

Authentication

X-API-Keystring

Enter your API key for programmatic access

AuthorizationBearer

Enter your JWT token (without the ‘Bearer ’ prefix)

Path parameters

chat_idstringRequiredformat: "uuid"

Chat Room ID

Query parameters

pageintegerOptional>=1Defaults to 1

Page number

page_sizeintegerOptional1-100Defaults to 20

Items per page

message_typeenumOptional

Filter by message type (text, tool_call, tool_result, thought, error)

Allowed values:

sincestringOptionalformat: "date-time"

Filter messages after this timestamp

Response

Chat Messages

datalist of objects

metadataobject

Authentication

Path parameters

Query parameters

Response

Errors