> ## Documentation Index > Fetch the complete documentation index at: https://docs.bigmodel.cn/llms.txt > Use this file to discover all available pages before exploring further. # 归档 Session > 归档指定 API Session，并将其终止后保留历史数据。运行中的 Session 不能归档，已归档 Session 再次归档会返回冲突；归档后不可再追加事件或修改资源。点击 **Try it** 按钮可快速试用。 ## OpenAPI ````yaml /openapi/openapi-managed-agents.json post /agent/managed/v1/sessions/{sessionId}/archive openapi: 3.0.1 info: title: 智谱 AI Managed Agents API version: 1.0.0 description: Agent、Environment、Session、File、Memory、Vault、Skill、Deployment 接口。 contact: name: Z.AI 开发者 url: https://chat.z.ai/legal-agreement/privacy-policy email: user_feedback@z.ai servers: - url: https://open.bigmodel.cn/api/ description: 开放平台服务 security: - bearerAuth: [] tags: - name: Managed Agents - Agent description: Agent 与版本管理。 x-group: Agent - name: Managed Agents - Environment description: 声明式执行环境管理。 x-group: Environment - name: Managed Agents - Session description: Session、Resource 与事件流。 x-group: Session - name: Managed Agents - File description: Managed Files 上传、读取与删除。 x-group: File - name: Managed Agents - Memory description: Memory Store、Memory 与版本管理。 x-group: Memory - name: Managed Agents - Vault description: Vault 与 Credential 管理。 x-group: Vault - name: Managed Agents - Skill description: 自定义 Skill 与版本管理。 x-group: Skill - name: Managed Agents - Deployment description: 定时或手动 Deployment 与运行记录。 x-group: Deployment paths: /agent/managed/v1/sessions/{sessionId}/archive: servers: - url: https://agent-api.bigmodel.cn/api description: 智谱 Managed Agents 服务 post: tags: - Managed Agents - Session summary: 归档 Session description: >- 归档指定 API Session，并将其终止后保留历史数据。运行中的 Session 不能归档，已归档 Session 再次归档会返回冲突；归档后不可再追加事件或修改资源。点击 **Try it** 按钮可快速试用。 operationId: managedPostSessionsBySessionIdArchive parameters: - $ref: '#/components/parameters/ManagedZaiVersion' - $ref: '#/components/parameters/ManagedZaiBeta' - name: sessionId in: path required: true description: sessionId 资源标识。 schema: type: string responses: '200': description: 请求成功。 content: application/json: schema: $ref: '#/components/schemas/ManagedSession' default: description: 请求失败。 content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsErrorResponse' components: parameters: ManagedZaiVersion: name: zai-version in: header required: true description: Managed Agents API 协议版本，固定为 2026-05-26。 schema: type: string enum: - '2026-05-26' default: '2026-05-26' example: '2026-05-26' ManagedZaiBeta: name: zai-beta in: header required: true description: 必须包含 managed-agents-2026-05-26；可与其他 beta 标识用逗号分隔。 schema: type: string default: managed-agents-2026-05-26 example: managed-agents-2026-05-26 schemas: ManagedSession: type: object properties: id: type: string description: Session ID。 example: sess_01J... type: type: string enum: - session agent: $ref: '#/components/schemas/ManagedSessionAgentResponse' environment_id: type: string status: type: string enum: - idle - running - rescheduling - terminated title: type: string nullable: true description: Session 标题。 metadata: $ref: '#/components/schemas/ManagedMetadata' resources: type: array items: $ref: '#/components/schemas/ManagedSessionResourceResponse' vault_ids: type: array items: type: string outcome_evaluations: type: array items: type: object additionalProperties: true stats: type: object properties: active_seconds: type: number duration_seconds: type: number required: - active_seconds - duration_seconds usage: type: object properties: input_tokens: type: integer output_tokens: type: integer cache_read_input_tokens: type: integer required: - input_tokens - output_tokens - cache_read_input_tokens budget: type: object nullable: true enum: - null description: 当前不支持会话级消费上限，固定为 null。 created_at: type: string format: date-time description: 创建时间。 updated_at: type: string format: date-time description: 更新时间。 archived_at: type: string nullable: true description: 归档时间。 required: - id - type - agent - environment_id - status - title - metadata - resources - outcome_evaluations - stats - usage - vault_ids - created_at - updated_at - archived_at additionalProperties: false ManagedAgentsErrorResponse: type: object properties: type: type: string enum: - error error: type: object properties: type: type: string enum: - invalid_request_error - authentication_error - permission_error - not_found_error - request_too_large - rate_limit_error - api_error - timeout_error - overloaded_error message: type: string details: type: object additionalProperties: true required: - type - message additionalProperties: false request_id: type: string example: req_01J... required: - type - error - request_id additionalProperties: false ManagedSessionAgentResponse: type: object properties: id: type: string type: type: string enum: - agent name: type: string model: $ref: '#/components/schemas/ManagedModelResponse' system: type: string nullable: true description: 解析后的系统提示词。 description: type: string nullable: true description: Agent 描述。 tools: type: array items: $ref: '#/components/schemas/ManagedAgentToolsetResponse' skills: type: array items: $ref: '#/components/schemas/ManagedSkillReference' mcp_servers: type: array items: $ref: '#/components/schemas/ManagedMcpServer' multiagent: type: object nullable: true enum: - null description: 当前暂未支持，默认为 null。 version: type: integer minimum: 0 required: - id - type - name - model - system - description - tools - skills - mcp_servers - version additionalProperties: false ManagedMetadata: type: object additionalProperties: type: string description: 客户端自定义元数据；省略时默认为空对象。最多 16 个键，键名长度不超过 64 字符，值必须是长度不超过 512 字符的字符串。 maxProperties: 16 ManagedSessionResourceResponse: oneOf: - title: memory_store allOf: - $ref: '#/components/schemas/ManagedMemoryStoreResourceResponse' - title: file allOf: - $ref: '#/components/schemas/ManagedFileResourceResponse' ManagedModelResponse: type: object properties: id: type: string example: glm-5.3 effort: type: string enum: - low - high - max example: max speed: type: string enum: - standard example: standard required: - id - speed additionalProperties: false ManagedAgentToolsetResponse: oneOf: - title: agent_toolset_20260601 type: object properties: type: type: string enum: - agent_toolset_20260601 default_config: $ref: '#/components/schemas/ManagedToolDefaultConfigResponse' configs: type: array items: $ref: '#/components/schemas/ManagedBuiltinToolConfigResponse' required: - type - default_config - configs additionalProperties: false - title: mcp_toolset type: object properties: type: type: string enum: - mcp_toolset mcp_server_name: type: string default_config: $ref: '#/components/schemas/ManagedToolDefaultConfigResponse' configs: type: array items: $ref: '#/components/schemas/ManagedMcpToolConfigResponse' required: - type - mcp_server_name - default_config - configs additionalProperties: false - title: custom type: object properties: type: type: string enum: - custom name: type: string description: type: string input_schema: $ref: '#/components/schemas/ManagedCustomToolInputSchema' required: - type - name - description - input_schema additionalProperties: false ManagedSkillReference: type: object properties: type: type: string enum: - custom - zai description: custom 表示当前所有者创建的 Skill；zai 表示平台内置 Skill。 skill_id: type: string minLength: 1 description: Skill ID；必须存在且当前身份可访问。 version: type: string minLength: 1 description: 必须显式固定的 Skill 版本。 required: - type - skill_id - version additionalProperties: false ManagedMcpServer: type: object description: >- 远程 MCP Server。name 在同一配置内必须唯一，并且必须与 tools 中恰好一个 mcp_toolset.mcp_server_name 相同。 properties: type: type: string enum: - url description: 当前只支持 url。 name: type: string minLength: 1 maxLength: 255 description: Server 名称，长度 1–255；同一 mcp_servers 数组内不得重复。 url: type: string format: uri pattern: ^https:// maxLength: 2048 description: 公开 HTTPS Streamable HTTP URL；不得包含凭据、fragment、空 query 或旧式 SSE 路径。 required: - type - name - url additionalProperties: false example: type: url name: knowledge-base url: https://mcp.example.com/mcp ManagedMemoryStoreResourceResponse: type: object properties: type: type: string enum: - memory_store memory_store_id: type: string name: type: string description: type: string nullable: true access: type: string enum: - read_only - read_write instructions: type: string nullable: true mount_path: type: string required: - type - memory_store_id - name - description - access - instructions - mount_path additionalProperties: false ManagedFileResourceResponse: type: object properties: id: type: string type: type: string enum: - file file_id: type: string mount_path: type: string created_at: type: string format: date-time description: 创建时间。 updated_at: type: string format: date-time description: 更新时间。 required: - id - type - file_id - mount_path - created_at - updated_at additionalProperties: false ManagedToolDefaultConfigResponse: type: object properties: enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedPermissionPolicy' required: - enabled - permission_policy additionalProperties: false ManagedBuiltinToolConfigResponse: type: object properties: name: type: string enum: - read - write - edit - bash - grep - find - ls enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedPermissionPolicy' required: - name - enabled - permission_policy additionalProperties: false ManagedMcpToolConfigResponse: type: object properties: name: type: string enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedPermissionPolicy' required: - name - enabled - permission_policy additionalProperties: false ManagedCustomToolInputSchema: type: object properties: type: type: string enum: - object description: 固定为 object。 properties: type: object additionalProperties: true description: 工具输入字段的 JSON Schema；省略时表示未声明属性。 required: type: array items: type: string description: 必填输入字段名；省略时无必填字段。 required: - type additionalProperties: true ManagedPermissionPolicy: type: object properties: type: type: string enum: - always_allow - always_ask description: 工具调用权限策略。always_allow 表示无需确认；always_ask 表示每次调用前请求确认。 required: - type additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer description: >- 标准的 HTTP Bearer 认证方式，在 [API Keys](https://bigmodel.cn/usercenter/proj-mgmt/apikeys) 页面获取密钥。 ````