Notion/listFileUploads

Online calls unavailable · details below

NotionNotion collaborative workspace API

GET/v1/file_uploads

List file uploads

Paginates over a connection's file upload records by status.

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: listFileUploads
Server: https://api.notion.com
Authentication: bearerAuth, basicAuth

Request parameters

`status`

querystring

HTTP status code.

pending

`start_cursor`

querystring

Pagination start cursor (opaque).

example content

`page_size`

queryinteger

Number of results per page.

`Notion-Version`

headerstringrequired

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

2026-03-11

Responses

`200`

objectapplication/json

Request succeeded.

Properties: file_uploadhas_morenext_cursorobjectrequest_statusresultstype

`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.

{
  "file_upload": {},
  "has_more": true,
  "object": "list",
  "request_status": {
    "incomplete_reason": "query_result_limit_reached",
    "type": "complete"
  },
  "results": {
    "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"
  },
  "type": "file_upload"
}