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 expectedsent: Number of parts successfully received (should equaltotal)
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 codemessage: Human-readable error descriptionparameter: Related parameter name, if applicablestatus_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_partsfrom create - Check
file_import_resultto verify the file was successfully imported
Related
- Create file upload - Initialize upload
- Send file upload - Upload file parts
- List file uploads - Track upload status