# List conversations

**GET** `/conversations`

Returns conversations accessible to the authenticated user. Use this before polling
message history or assigning work to a teammate.

Authentication: bearerAuth
Required scopes: `conversation:list`
Allowed roles: `owner`, `admin`, `agent`
Authorization: List conversations in the caller's conversation scope.

## Parameters

- `pageSize` (query integer, optional)
- `pageToken` (query string, optional)
- `interacted` (query boolean, optional)
- `search` (query string, optional) - Case-insensitive substring search across the conversation name and external identifier.
- `conversationIds` (query array<string>, optional) - Return explicit conversations by ID, preserving normal authorization scope.
- `status` (query array<enum>, optional)
- `ownerType` (query array<enum>, optional)
- `sort` (query enum, optional)
- `orderDirection` (query enum, optional)

## Responses

- `200`: List of conversations
- `default`: Error