Sign in
humanApiMessages

List messages in a chat room

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, task. Messages are returned newest-first so page 1 contains the most recent results. Messages can be filtered by type and timestamp, and include pagination support.

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

Pagination

Use cursor + limit for cursor-based pagination (recommended). The response metadata includes next_cursor and has_more.

Note: since and cursor cannot be combined. Use one or the other.

page and page_size are deprecated and will be removed in API 2.0.0 (2026-10-01).

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

get/api/v1/me/chats/{chat_id}/messages

Path parameters

chat_idstring uuid required

Chat Room ID

Query parameters

cursorstring

Cursor for keyset pagination (from previous response next_cursor)

limitinteger

Items per page for cursor pagination (default: 20, max: 100)

pageinteger

Page number (deprecated — use cursor)

page_sizeinteger

Items per page (deprecated — use limit)

message_type'text' | 'tool_call' | 'tool_result' | 'thought' | 'error' | 'task' | 'attention' | 'system' | 'participant'

Filter by message type

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

sincestring date-time

Filter messages after this timestamp (cannot be combined with cursor)

Headers

X-API-Keystring required

Enter your API key for programmatic access

Response

Chat Messages

MessagesListMyChatMessagesResponse200 required— unresolved $ref

Changes

Changed in 2 of the 5 revisions of this API.54

  • 3cff423845a22See the full diff
    • ○

      added the new enum value participant to the query request parameter message_type

      request-parameter-enum-value-added

    • ○

      added the new enum value system to the query request parameter message_type

      request-parameter-enum-value-added

  • d4b03725c5d752See the full diff
    • ●

      for the query request parameter limit, the max was set to 100.00

      request-parameter-max-set

    • ●

      for the query request parameter page_size, the max was set to 100.00

      request-parameter-max-set

    • ●

      for the query request parameter limit, the min was set to 1.00

      request-parameter-min-set

    • ●

      for the query request parameter page, the min was set to 1.00

      request-parameter-min-set

    • ●

      for the query request parameter page_size, the min was set to 1.00

      request-parameter-min-set

    • ○

      query request parameter page was deprecated

      request-parameter-deprecated

    • ○

      query request parameter page_size was deprecated

      request-parameter-deprecated