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

# 列出会话

> 列出通过 OpenAI 兼容 v1 API 创建的非渠道会话。

Source: https://docs.manyfold.ai/zh/api-reference/conversations/

```http
GET /api/v1/conversations
```

认证: Bearer API token，scope 为 chat.completions 或 api.full。
配额: 只读接口，不计入每月 API request 配额。

## 参数

| 参数 | 必填 | 说明 |
| --- | --- | --- |
| `model` | 可选 | 按 agent id 过滤。绑定到单个 agent 的 token 只能读取该 agent。 |
| `limit` | 可选 | 1-100 条结果，默认 20。 |
| `after` | 可选 | 使用上一页的 first_id 或 last_id 做 cursor pagination。 |
| `order` | 可选 | 默认 desc；使用 asc 获取最旧优先。 |

## 请求

```bash
curl "https://api.manyfold.ai/api/v1/conversations?limit=20" \
  -H "Authorization: Bearer $MF_API_TOKEN"
```

## 响应

- 返回 OpenAI 风格 list envelope，包含 object、data、first_id、last_id、has_more。
- 每个 item 包含 id、model、title、created_at、updated_at。