> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roark.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# roark conversation list

> List conversations

Calls and chats in the project as one list, most recent start first. A conversation is listed once it is recorded: a call when it connects, a chat when it ends. Listing calls needs `call:read`, chats `chat:read`, and both kinds both.

```bash Synopsis theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark conversation list [options]
```

> [!NOTE]
>
> Calls `GET /v1/conversation`

## Options

**--modality** `string`

Only `voice`, or only `chat`. Both by default. One of `voice`, `chat`, `call`

**--started-from** `string`

Only conversations that started at or after this time.

**--started-to** `string`

Only conversations that started at or before this time.

**--limit** `integer`

How many to return (default 20, max 100).

**--after** `string`

The `nextCursor` of the previous page.

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark conversation list
```

Every command also takes the [global options](https://docs.roark.ai/cli-reference/overview.md#global-options) and sets one
of the [exit codes](https://docs.roark.ai/cli-reference/overview.md#exit-codes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.