Skip to main content
POST
新增 Session File Resource

Authorizations

Authorization
string
header
required

标准的 HTTP Bearer 认证方式,在 API Keys 页面获取密钥。

Headers

zai-version
enum<string>
default:2026-05-26
required

Managed Agents API 协议版本,固定为 2026-05-26。

Available options:
2026-05-26
Example:

"2026-05-26"

zai-beta
string
default:managed-agents-2026-05-26
required

必须包含 managed-agents-2026-05-26;可与其他 beta 标识用逗号分隔。

Example:

"managed-agents-2026-05-26"

Path Parameters

sessionId
string
required

sessionId 资源标识。

Query Parameters

beta
string

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

Body

application/json
type
enum<string>
required

固定为 file。

Available options:
file
file_id
string
required

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

Minimum string length: 1
mount_path
string | null

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

Response

请求成功。

id
string
required
type
enum<string>
required
Available options:
file
file_id
string
required
mount_path
string
required
created_at
string<date-time>
required

创建时间。

updated_at
string<date-time>
required

更新时间。