---
title: "List user's conversations"
method: GET
path: "/v1/users/{user_id}/conversations"
tags: ["Conversations"]
---

# List user's conversations

`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

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

## Path parameters

- `user_id` string, uuid, required

## Query parameters

- `integration_ids` string[]
- `synced_only` boolean
- `limit` string
- `cursor` string

## Response `200`

Default Response

- object
  - `success` true, required
  - `data` object[], required
    - `id` string, required
    - `integration_id` string, required
    - `title` string, required
    - `type` string, required
    - `provider` string, required
    - `import_messages` boolean, required
  - `pagination` union, required
    - object
      - `limit` number, required
      - `has_more` true, required
      - `next_cursor` string, required
    - object
      - `limit` number, required
      - `has_more` false, required

## Other responses

- `400`: Default Response
- `500`: Default Response

---

[API](https://skmtc.dev/attrove/apis/attrove-api.md) · [All operations](https://skmtc.dev/attrove/apis/attrove-api/llms.txt) · [OpenAPI document](https://skmtc.dev/attrove/apis/attrove-api/revisions/fcdc818b45cb?raw)