upload_attachment
Upload a reference file (image, PDF, or short video) to a task for the assigned worker to access after claiming. Files are stored privately with a time-limited download link.
Instructions
Upload a reference file (image, PDF, or short video) to a task so the assigned worker can access it after claiming. Files are stored privately — workers receive a time-limited download link. Max 5 attachments per task. Task must be open or claimed. Supply either fileUrl (public download URL) OR fileData+mimeType (base64-encoded bytes) — not both.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| taskId | Yes | The task ID to attach the file to | |
| filename | Yes | Display name for the attachment (e.g. "storefront_reference.jpg") | |
| fileUrl | No | A publicly accessible URL to the file (JPEG/PNG/WebP ≤8 MB, PDF ≤25 MB, MP4/WebM/MOV ≤30 MB). The server will download and re-upload it. Use this OR fileData, not both. | |
| fileData | No | Base64-encoded file contents. Use instead of fileUrl for files that cannot be given a public URL (e.g. generated files, private data). Must be accompanied by mimeType. | |
| mimeType | No | MIME type of the file when using fileData (e.g. "image/jpeg", "application/pdf", "video/mp4"). Required when fileData is provided; ignored when fileUrl is used. |