BIbigmodel
Managed Agents - File

获取 File

Changed on

获取指定 File 的元数据，不返回文件二进制内容。无读取权限时与文件不存在时均返回 404。

get/agent/managed/v1/files/{fileId}

Request

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

Path parameters

fileIdstring required

fileId 资源标识。

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。

Response

请求成功。

type'file' required
idstring required

File ID。

size_bytesinteger required
created_atstring date-time required

创建时间。

filenamestring required
mime_typestring required
downloadableboolean required

上传文件为 false，不可再下载；写入 /mnt/session/outputs 后编目的会话产物为 true。

expires_at'null' nullable

新协议固定为 null，不设自动过期时间；旧协议省略此字段。

Example response

{
  "type": "file",
  "id": "file_01911111-1111-7111-8111-222222222222",
  "size_bytes": 1024,
  "created_at": "2026-10-15T08:00:00.000Z",
  "filename": "report.txt",
  "mime_type": "text/plain",
  "downloadable": true,
  "expires_at": null,
  "scope": {
    "type": "session",
    "id": "sess_01911111-1111-7111-8111-111111111111"
  }
}

Changes