NOnotion
File uploads

Upload a file

post/v1/file_uploads/{file_upload_id}/send

Request

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

Path parameters

file_upload_idstring required

Headers

Notion-Version'2026-03-11' required

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

Request body multipart/form-data

fileobject required

The raw binary file contents to upload.

part_numberstring

When uploading files greater than 20MB in parts, this is the current part number. Must be an integer between 1 and 1,000.

Response

object'file_upload' required

Always file_upload

idstring uuid required
created_timestring date-time required
last_edited_timestring date-time required
in_trashboolean required
expiry_timestring date-time nullable required
status'pending' | 'uploaded' | 'expired' | 'failed' required

One of: pending, uploaded, expired, failed

filenamestring nullable required
content_typestring nullable required
content_lengthinteger nullable required
upload_urlstring
complete_urlstring

Changes

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