Sign in
chat
chat

Get Conversations

Get conversations for a user with pagination support.

Returns an envelope {conversations, next_cursor, has_more} when a cursor is supplied; for backwards compatibility, returns a bare list when only offset is used (existing clients pre-cursor support).

get/chat/conversations/{user_id}

Path parameters

user_idstring required

Query parameters

limitinteger

Number of conversations to return

Number of conversations to return

offsetinteger

Number of conversations to skip (legacy — prefer cursor)

Number of conversations to skip (legacy — prefer cursor)

cursorstring nullable

Opaque cursor returned as next_cursor from a previous page. Format: '<iso_timestamp>|<conversation_id>'. When supplied, the server returns conversations strictly before this point, ordered by last-activity desc. Beats offset for users with thousands of conversations — no row re-scan.

Opaque cursor returned as next_cursor from a previous page. Format: '<iso_timestamp>|<conversation_id>'. When supplied, the server returns conversations strictly before this point, ordered by last-activity desc. Beats offset for users with thousands of conversations — no row re-scan.

Headers

authorizationstring nullable

Response

Successful Response

{"stackTrail":"paths:/chat/conversations/{user_id}:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

No recorded changes to this endpoint across all 1 revision of this API.