Session & Event

List Events

List all events for a session

GET

/api/v1/agentstudio/sessions/{session_id}/events

cURL

curl --request GET \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/sessions/{session_id}/events' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "data": [
    {
      "object": "message",
      "id": "msg_001",
      "created_at": "2025-10-24T08:15:30.500Z",
      "sequence_number": null,
      "status": "completed",
      "role": "assistant",
      "type": "message",
      "content": [
        {
          "type": "text",
          "text": "开始分析"
        }
      ],
      "metadata": {}
    }
  ],
  "next_page": null,
  "request_id": "req_xxx"
}

Authorizations

string

header

required

DashScope API Key

Path Parameters

string

required

Query Parameters

enum<string>[]

按事件类型过滤，可重复传入。如 ?types=message&types=tool_approval_request。断线/刷新后恢复审批卡片时，用 types=tool_approval_request 补拉当前批次的审批请求，再按 (batch_id, call_id) 关联。用 types=error 补拉运行期错误（如 pending_tool_approval_unresolved、invalid_tool_approval），错误详情位于 Message 顶层的 error 对象（error.code / error.message），不在 content[].data 中

enum<string>

default"asc"

排序方向：asc（升序）| desc（降序）

Available options:asc,desc

string

按时间窗口过滤（大于），ISO 8601；四个比较运算符可组合

string

按时间窗口过滤（大于等于），ISO 8601

string

按时间窗口过滤（小于），ISO 8601

string

按时间窗口过滤（小于等于），ISO 8601

integer

default20

每页数量，最大 100

string

首次不传，后续传上一次响应的 next_page

Response

200-application/json

(普通事件 · object | error 事件 · object)[]

事件 Message 对象数组，按 order 排序

message / tool_call / tool_call_output / tool_approval_request / tool_approval_response / function_call / function_call_output / mcp_call / mcp_call_output / session_status 事件

普通事件
error 事件

Show child attributes

string

恒为 message

string

事件 ID，前缀 msg_ 或 out_

string

事件时间戳，ISO 8601

number | null

流式分块序号；历史接口返回已完成事件，通常为 null

string

恒为 completed

enum<string>

Available options:user,assistant,tool

enum<string>

事件类型，取值同 SSE 服务端推送事件（不含 error，error 见独立分支）

Available options:message,tool_call,tool_call_output,tool_approval_request,tool_approval_response,function_call,function_call_output,mcp_call,mcp_call_output,session_status

object[]

ContentBlock 数组，结构同发送侧

boolean

仅工具输出事件（tool_call_output / mcp_call_output）出现，写在 Message 顶层（不在 content[].data 内）：true 表示该次工具执行失败或被中断/拒绝；此时 data 仍为 ToolCallOutput / McpCallOutput，至少含 call_id 与 output

object

事件附加信息（如 thread_id、call_id 等）

string | null

下一页游标；无更多数据时不返回或为 null

string

本次请求的唯一标识

cURL

curl --request GET \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/sessions/{session_id}/events' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "data": [
    {
      "object": "message",
      "id": "msg_001",
      "created_at": "2025-10-24T08:15:30.500Z",
      "sequence_number": null,
      "status": "completed",
      "role": "assistant",
      "type": "message",
      "content": [
        {
          "type": "text",
          "text": "开始分析"
        }
      ],
      "metadata": {}
    }
  ],
  "next_page": null,
  "request_id": "req_xxx"
}