BIbigmodel
Managed Agents - Session

新增 Session File Resource

Changed on

向未归档的 Session 新增一个 File Resource。file_id 必须属于该 Agent 所有者，mount_path 必须有效且不能与现有挂载路径重叠。

post/agent/managed/v1/sessions/{sessionId}/resources

Request

  • Base URL
    https://agent-api.bigmodel.cn/api
  • Auth
    HTTP bearer

Path parameters

sessionIdstring required

sessionId 资源标识。

Query parameters

betastring

SDK 兼容参数；Session Resource 路由只识别该参数名，不校验取值。

Headers

zai-version'2026-05-26' required
Example:2026-05-26

Managed Agents API 入口要求的基础协议标识，当前只接受 2026-05-26；响应兼容形态由 zai-beta 选择。两个头均需携带。

zai-betastring required
Example:managed-agents-2026-09-22

声明 Managed Agents Beta 协议并选择响应字段与兼容行为。新接入使用 managed-agents-2026-09-22；旧客户端仍可使用 managed-agents-2026-05-26。必须同时携带 zai-version: 2026-05-26。字段差异见 /cn/managed-agents/protocol-versions。

Request body

type'file' required

固定为 file。

file_idstring required

已存在且归当前资源所有者所有的 File ID。

mount_pathstring nullable

沙箱内挂载路径；省略或传 null 时默认为 /mnt/session/uploads/{file_id}。路径会归一化到 /mnt/session/uploads 下，不能逃逸该目录，UTF-8 总长度不超过 1024 字节。

Response

请求成功。

idstring required
type'file' required
file_idstring required
mount_pathstring required
created_atstring date-time required

创建时间。

updated_atstring date-time required

更新时间。

Changes