Upload an attachment

POST

/tasks/{task_gid}/attachments

Upload an attachment.

This method uploads an attachment to a task and returns the compact
record for the created attachment object. It is not possible to attach
files from third party services such as Dropbox, Box & Google Drive via
the API. You must download the file content first and then upload it as
any other attachment.

The 100MB size limit on attachments in Asana is enforced on this endpoint.

This endpoint expects a multipart/form-data encoded request containing
the full contents of the file to be uploaded.

Requests made should follow the HTTP/1.1 specification that line
terminators are of the form CRLF or \r\n outlined
here
in order for the server to reliably and properly handle the request.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://app.asana.com/api/1.0/tasks//attachments'

Response Example

200 - Example 1

{
    "data": {
        "gid": "12345",
        "resource_type": "task",
        "name": "Screenshot.png",
        "resource_subtype": null,
        "created_at": "2012-02-22T02:06:58.147Z",
        "download_url": "https://s3.amazonaws.com/assets/123/Screenshot.png",
        "host": "dropbox",
        "parent": {
            "gid": "12345",
            "resource_type": "task",
            "name": "Bug Task"
        },
        "view_url": "https://www.dropbox.com/s/123/Screenshot.png"
    }
}

Request

Path Params

Body Params multipart/form-data

Responses

🟢200Successfully uploaded the attachment to the task.

application/json

Body

🟠400400

🟠401401

🟠403403

🟠404404

🔴500500

Modified at 2022-09-13 02:00:31

Get attachments for a task

Submit parallel requests