Test Results for File Upload Endpoints (2026-03-11)

These endpoints were added to the OpenAPI spec (scripts/notion-openapi.json) with zero source code changes. The existing auto-generation pipeline handles multipart/form-data with format:binary out of the box.

Test 1: Create a file upload session (create-a-file-upload)

• Called POST /v1/file_uploads with filename='notion-upload-test.txt', content_type='text/plain', mode='single_part'
• Result: SUCCESS - Got file_upload id=320e72cf-fcec-8179-a0b4-00b24ee206da, status='pending'

Test 2: Send file content (send-file-upload-content)

• Called POST /v1/file_uploads/{id}/send with a local file path (/tmp/notion-upload-test.txt)
• Result: SUCCESS - status changed to 'uploaded', content_length=47 bytes

Test 3: Retrieve a file upload (retrieve-a-file-upload)

• Called GET /v1/file_uploads/{id} with the uploaded file's id
• Result: SUCCESS - Returned file_upload object with status='uploaded', filename='notion-upload-test.txt', content_length=47

Test 4: List file uploads (list-file-uploads)

• Called GET /v1/file_uploads with page_size=3
• Result: SUCCESS - Returned list with 1 file upload matching the one we created

Test 5: complete-a-file-upload was not tested (only needed for multi_part mode)

Summary: 4/4 tested endpoints passed. All 5 file upload endpoints are available as MCP tools with zero source code changes - only the OpenAPI spec (scripts/notion-openapi.json) was modified.

Test 6: Embed uploaded image in page (image block with file_upload)

Test 7: Embed uploaded text file in page (file block with file_upload)

attachment:ca4f070f-9323-46b4-9e5d-81d47003029a:notion-upload-test.txt