Skip to main content
Completes a multi-part file upload after all parts have been successfully sent. This finalizes the upload and makes the file available for use in Notion.

Method

Parameters

string
required
Identifier for a Notion file upload object, obtained from the id of the Create File Upload response.

Response

Returns the final FileUpload object with updated status.
string
"uploaded" if successful, or "failed" if an error occurred during processing.
object
Contains:
  • total: Total number of parts that were expected
  • sent: Number of parts successfully received (should equal total)
object
Result of importing the file:
string
"success" or "error"
string
ISO 8601 timestamp when the file was imported.
object
Empty object present when type is "success".
object
Error details when type is "error":
  • type: Error category ("validation_error", "internal_system_error", "download_error", "upload_error")
  • code: Short error code
  • message: Human-readable error description
  • parameter: Related parameter name, if applicable
  • status_code: HTTP status code, if applicable

Example

Complete multi-part upload

After sending all parts of a large file:

Error handling

Check for errors after completion:

Verify all parts sent

Before calling complete:

Notes

  • Only required for multi-part uploads (mode: "multi_part")
  • Not needed for single-part uploads - they complete automatically after sending
  • Must be called after all parts have been sent via send
  • The upload will fail if the number of parts sent doesn’t match number_of_parts from create
  • Check file_import_result to verify the file was successfully imported