Skip to navigation
Modular DS Public APITasksUploads

Upload a file

View as MarkdownOpen in Claude

Uploads one file to attach to a task, and returns the id to send in the files of “Create tasks on websites” or “Update a task”. A file that no task takes is removed automatically after one day, and there is no request to read an upload back.

Uploading needs its own permission, held by the same roles that can create tasks: your role must be allowed to upload files, otherwise the request answers 404. The request is limited to 20 per minute per token on top of the general limit.

Body

  • file (file, required): sent as multipart/form-data, at most 6 MB, with one of the extensions gif, jpeg, jpg, png, webp, tif or tiff.

Errors

  • 422: file is missing, larger than 6 MB or has a disallowed extension.
  • 429: the 20-per-minute limit was reached.

Authentication

AuthorizationBearer

Personal access token created in the Modular DS dashboard; read-only tokens can only call GET endpoints.

Request

This endpoint expects a multipart form containing an optional file.
filefileOptional

Required. At most 6 MB. Allowed extensions: gif, jpeg, jpg, png, webp, tif, tiff.

Response

201 Created
dataobjectOptional
jsonapiobjectOptional