Notion/retrieveFileUpload

Online calls unavailable · details below

NotionNotion collaborative workspace API

GET/v1/file_uploads/{file_upload_id}

Retrieve a file upload

Returns a file upload record and its status by ID.

Manage pages, blocks, data sources/databases, comments, file uploads, views, users, and search through the official versioned Notion API, with OAuth and async tasks. The complete boundary is the 49 endpoints in the official OpenAPI snapshot; workspace data is private user content, so Pontx does not proxy, cache, or aggregate it and callers use the local SDK/CLI directly.

Request

operationId: retrieveFileUpload
Server: https://api.notion.com
Authentication: bearerAuth, basicAuth

Request parameters

`file_upload_id`

pathidRequestrequired

`Notion-Version`

headerstringrequired

API version date for the request; the current latest version is 2026-03-11.

2026-03-11

Responses

`200`

fileUploadObjectResponseapplication/json

Request succeeded.

Properties: complete_urlcontent_lengthcontent_typecreated_bycreated_timeexpiry_timefile_import_resultfilenameidin_trashlast_edited_timenumber_of_partsobjectstatusupload_url

`400`

error_api_400application/json

Request parameters are invalid.

`401`

error_api_401application/json

Unauthenticated or the token is invalid.

`403`

error_api_403application/json

Access to the resource is forbidden.

`404`

error_api_404application/json

The requested resource was not found.

`406`

error_api_406application/json

The request cannot be represented as requested.

`409`

error_api_409application/json

The request conflicts with the current state of the resource.

`429`

error_api_429application/json

Rate limited; retry after Retry-After.

`500`

error_api_500application/json

Upstream internal error.

`503`

error_api_503application/json

Upstream service temporarily unavailable.

`504`

error_api_504application/json

Upstream gateway timeout.

`529`

error_api_529application/json

Upstream overloaded; retry like a 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"
}