Sign in
Attachments

Get an attachment

<b>Required scope: </b><code>attachments:read</code>

Get the full record for a single attachment.

get/attachments/{attachment_gid}

Request

  • Base URL: https://app.asana.com/api/1.0
  • URL: https://app.asana.com/api/1.0/attachments/{attachment_gid}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.asana.com/-/oauth_authorize, token URL https://app.asana.com/-/oauth_token, scopes: attachments:read)

Query parameters

opt_fieldsstring[]

This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. Properties can include nested fields. To learn more, see the input/output options guide.

Response

Successfully retrieved the record for a single attachment.

Example response

{
  "data": {
    "gid": "12345",
    "resource_type": "attachment",
    "name": "Screenshot.png",
    "resource_subtype": "dropbox",
    "created_at": "2012-02-22T02:06:58.147Z",
    "download_url": "https://s3.amazonaws.com/assets/1234/Screenshot.png",
    "permanent_url": "https://app.asana.com/app/asana/-/get_asset?asset_id=1234567890",
    "host": "dropbox",
    "parent": {
      "gid": "12345",
      "resource_type": "task",
      "name": "Bug Task",
      "resource_subtype": "default_task",
      "created_by": {
        "gid": "1111",
        "resource_type": "user"
      }
    },
    "size": 12345,
    "view_url": "https://www.dropbox.com/s/123/Screenshot.png"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.