Upload a file to Todoist.

This endpoint accepts file uploads via two methods:

1. Multipart form-data (recommended):

   • Send the file as a form field with the actual file content
   • Optionally include project_id as another form field
   • The filename will be extracted from the Content-Disposition header

2. Raw binary stream:

   • Send the file content directly in the request body
   • Set Content-Type header to the file's MIME type
   • Set X-File-Name header with the desired filename
   • Optionally include project_id as a query parameter

The optional project_id parameter can be used to apply workspace-specific upload limits when uploading to a workspace project.

{
  "file_name": "document.pdf",
  "project_id": "6XGgm6PHrGgMpCFX"
}

{
  "file_url": "https://files.todoist.com/abc123/by/1234567/as/file.pdf",
  "file_name": "document.pdf",
  "file_size": 12345,
  "file_type": "application/pdf",
  "resource_type": "file",
  "image_width": 1200,
  "image_height": 800,
  "upload_state": "completed"
}