所有端点需要 Bearer Token（或 API Key）认证。

创建线程

POST /v1/threads

请求体

字段	类型	必填	说明
`title`	`string`	否	线程标题
`is_private`	`bool`	否	是否私有，默认 `false`

响应

{
  "id": "...",
  "org_id": "...",
  "created_by_user_id": "...",
  "title": "我的第一个对话",
  "project_id": null,
  "created_at": "2024-01-01T00:00:00Z",
  "active_run_id": null,
  "is_private": false
}

列出线程

GET /v1/threads

查询参数

参数	类型	说明
`limit`	`int`	每页数量
`before`	`string`	cursor，用于翻页
`project_id`	`string`	按项目过滤

搜索线程

GET /v1/threads/search

查询参数

参数	类型	说明
`q`	`string`	搜索关键词
`limit`	`int`	每页数量

已收藏线程

GET /v1/threads/starred

获取线程详情

GET /v1/threads/{thread_id}

更新线程

PATCH /v1/threads/{thread_id}

请求体

字段	类型	说明
`title`	`string \| null`	标题（`null` 清空）
`project_id`	`string \| null`	关联项目

删除线程

DELETE /v1/threads/{thread_id}

收藏 / 取消收藏线程

POST   /v1/threads/{thread_id}/star
DELETE /v1/threads/{thread_id}/star

线程 (Threads)

创建线程

列出线程

搜索线程

已收藏线程

获取线程详情

更新线程

删除线程

收藏 / 取消收藏线程

On this page