NOnotion
File uploads

List file uploads

get/v1/file_uploads

Request

  • Base URL
    https://api.notion.com/admin
  • URL
    https://api.notion.com/admin/v1/file_uploads
  • Auth
    HTTP bearer

Query parameters

status'pending' | 'uploaded' | 'expired' | 'failed'

If supplied, the endpoint will return file uploads with the specified status.

start_cursorstring

If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.

page_sizeinteger

The number of items from the full list desired in the response. Maximum: 100

Headers

Notion-Version'2026-03-11' required

The API version to use for this request. The latest version is 2026-03-11.

Response

object'list' required

Always list

next_cursorstring uuid required
has_moreboolean required
type'file_upload' required

Always file_upload

file_uploadEmptyObject required

Changes

No recorded changes to this operation across all 1 revision of this API.