Conversations

List user's conversations

Returns conversations (Slack channels, email threads, etc.) for filtering RAG queries.

Use cases:

  • Display channel picker UI for filtering RAG queries
  • Let users select which channels to query from

Optional filters:

  • integration_ids: Filter to specific integrations (opaque IDs like int_xxx)
  • synced_only: If true, only return conversations where syncing is enabled

Pagination (cursor-only):

  • limit: Maximum number of conversations per page (default: 50, max: 100)
  • cursor: Opaque token from pagination.next_cursor of a prior response. Pass it back unchanged to fetch the next page. Omit on the first page.

The response pagination object contains limit, has_more, and (when has_more=true) next_cursor. There is no offset and no total_count — partners walk pages forward via cursor and use has_more to detect the last page.

Response: Array of conversation objects with opaque IDs

get/v1/users/{user_id}/conversations

Request

  • Base URL: http://0.0.0.0:3000
  • URL: http://0.0.0.0:3000/v1/users/{user_id}/conversations
  • Auth: none declared

Path parameters

user_idstring uuid required

Query parameters

integration_idsstring[]

Filter to specific integrations (int_xxx format)

synced_onlyboolean

Only return conversations where syncing is enabled

limitstring

Number of items to return (1-100, default 50)

cursorstring

Opaque pagination cursor returned as pagination.next_cursor from a prior response. Pass it back unchanged to fetch the next page. Cursors are sort-key bound — a cursor from one endpoint cannot be reused on another.

Response

Default Response

successtrue required

Changes

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