跳转到主要内容
GET /api/v1/cloud/files/{file_id} 获取单个 File 对象。deleted 状态的文件不会通过该接口返回。

​
请求头

头部必选说明
Authorization是Bearer <PAT>

​
路径参数

参数类型必选说明
file_idstring是File ID，前缀为 file_

​
示例请求

curl -X GET "https://api.qoder.com/api/v1/cloud/files/file_019e3bb8c1387743bf4ef115aae5acb1" \
  -H "Authorization: Bearer $QODER_PAT"

​
示例响应

HTTP 200 OK 
{
  "id": "file_019e3bb8c1387743bf4ef115aae5acb1",
  "type": "file",
  "filename": "qoder-test-upload.txt",
  "mime_type": "text/plain",
  "size_bytes": 110,
  "downloadable": true,
  "scope": {
    "id": "sess_019e3bb8e6c47d18",
    "type": "session"
  },
  "metadata": {
    "project": "demo"
  },
  "created_at": "2026-05-18T15:33:44Z"
}

​
响应字段

字段类型说明
idstringFile ID，前缀为 file_
typestring固定为 "file"
filenamestring存储后的文件名
size_bytesinteger文件大小，单位 byte
mime_typestring上传时提供或根据文件名检测出的 MIME type
downloadableboolean是否可通过 /content 端点下载
scopeobject | null文件关联到其他资源时的 scope，例如 { "id": "sess_...", "type": "session" }
metadataobject上传时传入的自定义元数据对象；省略时为 {}
created_atstringUTC 创建时间，RFC 3339 格式

​
错误码

HTTPtype触发条件
401authentication_error缺少或无效的认证令牌
404not_found_error指定 ID 的文件不存在，或文件处于 deleted 状态
完整错误信封说明详见 错误参考。

​
相关

附加与下载文件

上传文件为 Agent 提供上下文，并下载 Agent 产出的文件。