---
title: "列出线程事件"
method: GET
path: "/agent/managed/v1/sessions/{sessionId}/threads/{threadId}/events"
tags: ["Thread"]
---

# 列出线程事件

`GET /agent/managed/v1/sessions/{sessionId}/threads/{threadId}/events`

## Request

- Base URL: `https://agent-api.bigmodel.cn/api`
- URL: `https://agent-api.bigmodel.cn/api/agent/managed/v1/sessions/{sessionId}/threads/{threadId}/events`
- Auth: HTTP bearer

分页列出指定线程的完整事件历史，按创建时间升序返回。

<Accordion title="使用说明">

线程完整历史，data/next_page，按 created_at 升序。

</Accordion>

## Path parameters

- `sessionId` string, required
- `threadId` string, required

## Query parameters

- `limit` integer
- `page` string

## Headers

- `zai-version` '2026-05-26', required
- `zai-beta` string, required

## Response `200`

成功

- ManagedEventsPage
  - `data` ManagedPersistedEvent[], required
    - `id` string, required
    - `type` 'agent.custom_tool_use' | 'agent.mcp_tool_result' | 'agent.mcp_tool_use' | 'agent.message' | 'agent.thinking' | 'agent.thread_context_compacted' | 'agent.thread_message_received' | 'agent.thread_message_sent' | 'agent.tool_result' | 'agent.tool_use' | 'session.deleted' | 'session.error' | 'session.status_idle' | 'session.status_rescheduled' | 'session.status_running' | 'session.status_terminated' | 'session.thread_created' | 'session.thread_status_idle' | 'session.thread_status_rescheduled' | 'session.thread_status_running' | 'session.thread_status_terminated' | 'session.updated' | 'session.usage' | 'span.model_request_end' | 'span.model_request_start' | 'span.outcome_evaluation_end' | 'span.outcome_evaluation_ongoing' | 'span.outcome_evaluation_start' | 'system.message' | 'user.custom_tool_result' | 'user.define_outcome' | 'user.interrupt' | 'user.message' | 'user.tool_confirmation' | 'user.tool_result', required
    - `processed_at` string, date-time, nullable: 事件被平台处理时写入，不保证唯一。排队中的 user.message / user.interrupt 在历史接口中可能省略或为 null；公共 SSE 会在平台接手后携带 processed_at 推送。
    - `session_thread_id` string: Session 面子线程 cross-post 的来源归属；Thread ID，不是第三类资源。
    - `from_session_thread_id` string
    - `from_agent_name` string
    - `to_session_thread_id` string
    - `to_agent_name` string
    - `stop_details` null, nullable
    - `workflow_run_id` string, nullable
    - `content` object[]: 消息/Thinking 内容或工具结果块。Search 使用 search_result，Fetch 使用 document；agent.thinking 的 content 仅新协议下输出。
    - `usage` object
      - `input_tokens` integer, required
      - `output_tokens` integer, required
      - `cache_read_input_tokens` integer, required
      - `server_tool_use` object
        - `web_search_requests` integer, required
        - `web_fetch_requests` 0, required
  - `next_page` string, nullable, required

## Other responses

- `default`: 错误

## Changes

- **2026-11-03** `7fd61aa7f811`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/changes/agent/managed/v1/sessions/:sessionId/threads/:threadId/events/get.md)

---

[API](https://skmtc.dev/bigmodel/apis/zhipu-ai-api.md) - [All operations](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/revisions/f2be7c0fcbb9?raw)