v14

latestOpenAPI 3.1.02026-08-03122113375.9 KB
conversations

List conversations

Retrieve conversations for the authenticated user, including each conversation's latest message.

Use this endpoint for inbox views and messaging sidebars.

Query behavior:

  • Supports pagination and sorting by creation or update timestamp.
get/conversations

Query parameters

pageinteger

Page number, defaults to 1

Page number, defaults to 1

sizeinteger

Results per page, defaults to 20

Results per page, defaults to 20

sort'createdAt' | 'updatedAt'

Field to sort by

Field to sort by

direction'asc' | 'desc'

Sort direction

Sort direction

Response

List of conversations

idstring required

Unique identifier for the conversation

lockedboolean required

Whether the conversation is locked

createdAtstring nullable

Timestamp when the conversation was created

updatedAtstring nullable

Timestamp when the conversation was last updated