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
client.fileUploads.complete({
file_upload_id: "file_upload_id"
})
Parameters
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.
"uploaded" if successful, or "failed" if an error occurred during processing.
Contains:
total: Total number of parts that were expectedsent: Number of parts successfully received (should equal total)
Result of importing the file:file_import_result.imported_time
ISO 8601 timestamp when the file was imported.
file_import_result.success
Empty object present when type is "success".
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:
import fs from "fs"
const CHUNK_SIZE = 20 * 1024 * 1024 // 20MB
const fileBuffer = fs.readFileSync("./large-video.mp4")
const totalParts = Math.ceil(fileBuffer.length / CHUNK_SIZE)
// Step 1: Create the upload
const fileUpload = await client.fileUploads.create({
mode: "multi_part",
filename: "large-video.mp4",
content_type: "video/mp4",
number_of_parts: totalParts
})
// Step 2: Send all parts
for (let i = 0; i < totalParts; i++) {
const start = i * CHUNK_SIZE
const end = Math.min(start + CHUNK_SIZE, fileBuffer.length)
const chunk = fileBuffer.slice(start, end)
await client.fileUploads.send({
file_upload_id: fileUpload.id,
file: { data: chunk },
part_number: String(i + 1)
})
}
// Step 3: Complete the upload
const completed = await client.fileUploads.complete({
file_upload_id: fileUpload.id
})
if (completed.status === "uploaded") {
console.log("Upload successful!")
console.log(completed.file_import_result)
} else {
console.error("Upload failed:", completed.file_import_result?.error)
}
Error handling
Check for errors after completion:
const result = await client.fileUploads.complete({
file_upload_id: fileUpload.id
})
if (result.file_import_result?.type === "error") {
const error = result.file_import_result.error
console.error(`Upload error (${error.type}): ${error.message}`)
if (error.type === "validation_error") {
console.error(`Parameter: ${error.parameter}`)
}
} else if (result.file_import_result?.type === "success") {
console.log("File imported at:", result.file_import_result.imported_time)
}
Verify all parts sent
Before calling complete:
// After sending all parts, verify count
const uploadStatus = await client.fileUploads.retrieve({
file_upload_id: fileUpload.id
})
if (uploadStatus.number_of_parts?.sent === uploadStatus.number_of_parts?.total) {
// All parts sent, safe to complete
const result = await client.fileUploads.complete({
file_upload_id: fileUpload.id
})
console.log("Upload completed:", result.status)
} else {
console.error(
`Missing parts: ${uploadStatus.number_of_parts?.sent} / ${uploadStatus.number_of_parts?.total}`
)
}
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
