GET
https://api.dumate.cn/api/v1/sessions
本接口用于查询会话（Session）列表，支持按会话状态过滤和游标分页。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
URL 参数
cursor
stringinteger
分页游标。
首次请求不传；后续请求传入上一页响应返回的 nextCursor。
可选
limit
integer
每页返回数量。默认值和上限以服务端实际限制为准。
可选
status
string
按会话（Session）状态过滤，示例为 idle。
可选
请求结构
GET /api/v1/sessions?limit=20&status=idle HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json示例代码
请求示例
curl --location --request GET "https://api.dumate.cn/api/v1/sessions" \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_API_KEY>'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
data
array
会话（Session）列表。
可选
显示子属性
隐藏子属性
items
object {8}
显示子属性
隐藏子属性
id
string
会话（Session）标识。
可选
status
string
会话（Session）状态，示例为 idle。
可选
agent
object {2}
会话（Session）绑定的智能体（Agent）版本信息。
可选
显示子属性
隐藏子属性
id
string
智能体（Agent）标识。
可选
version
integer
智能体（Agent）版本号。
可选
skills
array
会话（Session）使用的技能（Skill）列表。
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
skillID
string
技能（Skill）标识。
可选
releaseID
string
技能（Skill）发布版本标识。
可选
type
string
技能（Skill）类型。
可选值：custom（自定义）、official（官方预置）。
可选
mcpServers
array
会话（Session）配置的 MCP 服务列表。
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
type
string
MCP 服务接入类型。
可选
name
string
MCP 服务名称。
可选
url
string
MCP 服务地址。
可选
metadata
object {1}
业务侧自定义元数据。
可选
显示子属性
隐藏子属性
externalTaskId
string
外部任务标识。
可选
createdAt
string
创建时间，ISO 8601 格式，带时区偏移。
可选
updatedAt
string
最近更新时间，ISO 8601 格式，带时区偏移。
可选
nextCursor
stringintegernull
下一页游标；无下一页时为 null。
查询下一页时将该值作为请求参数 cursor 传入。
可选
hasMore
boolean
是否还有下一页。true：有下一页。false：已是最后一页。
可选
响应示例
{
"data": [
{
"id": "ses_demo_a18d0f",
"status": "idle",
"agent": {
"id": "agt_demo_7f3a2c",
"version": 2
},
"skills": [
{
"skillID": "skillhub_id",
"releaseID": "<skillReleaseId>"
}
],
"mcpServers": [
{
"type": "url",
"name": "ticket",
"url": "<MCP_SERVER_URL>"
}
],
"metadata": {
"externalTaskId": "task_demo_1001"
},
"createdAt": "2026-07-28T10:00:00+08:00",
"updatedAt": "2026-07-28T10:00:00+08:00"
}
],
"nextCursor": 2,
"hasMore": true
}