Notion/retrieveFileUpload

暂不支持在线调用 · 原因见下方

NotionNotion 协作工作区 API

GET/v1/file_uploads/{file_upload_id}

查询文件上传

按 ID 返回文件上传记录及其状态。

通过官方版本化 Notion API 管理页面、块、数据源/数据库、评论、文件上传、视图、用户与搜索，并支持 OAuth 与异步任务。完整边界为官方 OpenAPI 快照中的 49 个 Endpoint；工作区数据为私有用户内容，Pontx 不代理、缓存或聚合，调用方使用本地 SDK/CLI 直连。

请求

operationId: retrieveFileUpload
服务器: https://api.notion.com
认证: bearerAuth, basicAuth

请求参数

`file_upload_id`

pathidRequest必填

`Notion-Version`

headerstring必填

请求使用的 API 版本日期；当前最新版本为 2026-03-11。

2026-03-11

响应

`200`

fileUploadObjectResponseapplication/json

请求成功。

字段: complete_urlcontent_lengthcontent_typecreated_bycreated_timeexpiry_timefile_import_resultfilenameidin_trashlast_edited_timenumber_of_partsobjectstatusupload_url

`400`

error_api_400application/json

请求参数无效。

`401`

error_api_401application/json

未认证或令牌无效。

`403`

error_api_403application/json

无权限访问该资源。

`404`

error_api_404application/json

未找到指定资源。

`406`

error_api_406application/json

请求无法按要求表示。

`409`

error_api_409application/json

请求与资源当前状态冲突。

`429`

error_api_429application/json

请求频率超限，请遵循 Retry-After 后重试。

`500`

error_api_500application/json

上游服务内部错误。

`503`

error_api_503application/json

上游服务暂时不可用。

`504`

error_api_504application/json

上游网关超时。

`529`

error_api_529application/json

上游服务过载，请按 429 相同方式重试。

{
  "complete_url": "https://example.com",
  "content_length": 1,
  "content_type": "example content",
  "created_by": {
    "id": "0ab51e95-9373-4d42-97f8-1b5b0a5c0b52",
    "type": "person"
  },
  "created_time": "2026-03-11T00:00:00.000Z",
  "expiry_time": "2026-03-11T00:00:00.000Z",
  "filename": "example content"
}