v3

latestOpenAPI 3.1.02026-07-31495191.1 MB
File uploads

List file uploads

get/v1/file_uploads

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