The Asana Attachments API allows developers to interact with and manage file attachments within the Asana project management platform. This API enables users to upload, download, and delete attachments associated with tasks, projects, and conversations. With the Asana Attachments API, developers can seamlessly integrate file sharing capabilities into their own applications, allowing for easier collaboration and file management within the Asana platform.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/asana-attachments-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Asana Allocations Attachments API
description: The Asana Allocations API allows users to manage and allocate resources within their Asana project management system. An allocation object represents how much of a resource (e.g. person, team) is dedicated to a specific work object (e.g. project, portfolio) over a specific period of time. The effort value can be a percentage or number of hours.
version: '1.0'
termsOfService: https://asana.com/terms
contact:
name: Asana Support
url: https://asana.com/support
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0
servers:
- url: https://app.asana.com/api/1.0
description: Main endpoint.
security:
- personalAccessToken: []
- oauth2: []
tags:
- name: Attachments
description: An attachment object represents any file attached to a task in Asana.
paths:
/attachments/{attachment_gid}:
parameters:
- $ref: '#/components/parameters/attachment_path_gid'
- $ref: '#/components/parameters/pretty'
get:
summary: Asana Get an attachment
description: Returns the full record for a single attachment.
operationId: getAttachment
tags:
- Attachments
parameters:
- name: attachment_gid
in: path
required: true
description: Globally unique identifier for the attachment.
schema:
type: string
example: '12345'
- name: opt_fields
in: query
required: false
schema:
type: array
items:
type: string
style: form
explode: false
responses:
'200':
description: Successfully retrieved the record for a single attachment.
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/AttachmentResponse'
'400':
description: Bad request.
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not found.
'500':
description: Internal server error.
delete:
summary: Asana Delete an attachment
description: Deletes a specific, existing attachment.
operationId: deleteAttachment
tags:
- Attachments
parameters:
- name: attachment_gid
in: path
required: true
description: Globally unique identifier for the attachment.
schema:
type: string
example: '12345'
responses:
'200':
description: Successfully deleted the specified attachment.
content:
application/json:
schema:
type: object
properties:
data:
type: object
'400':
description: Bad request.
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not found.
'500':
description: Internal server error.
/attachments:
parameters:
- $ref: '#/components/parameters/pretty'
get:
summary: Asana Get attachments from an object
description: Returns the compact records for all attachments on the object.
operationId: getAttachmentsForObject
tags:
- Attachments
parameters:
- name: parent
in: query
required: true
description: Globally unique identifier for object to fetch attachments from.
schema:
type: string
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 100
- name: offset
in: query
required: false
schema:
type: string
responses:
'200':
description: Successfully retrieved the compact records for all attachments.
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/AttachmentCompact'
'400':
description: Bad request.
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not found.
'500':
description: Internal server error.
post:
summary: Asana Upload an attachment
description: Upload an attachment. The file content must be sent as a multipart form data request.
operationId: createAttachmentForObject
tags:
- Attachments
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
file:
type: string
format: binary
description: The file to upload.
parent:
type: string
description: Globally unique identifier for the task to add the attachment to.
resource_subtype:
type: string
description: The type of the attachment.
enum:
- asana
- dropbox
- gdrive
- onedrive
- box
- vimeo
- external
name:
type: string
description: The name of the external resource being attached.
url:
type: string
format: uri
description: The URL of the external resource being attached.
required:
- parent
- resource_subtype
responses:
'200':
description: Successfully uploaded the attachment.
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/AttachmentResponse'
'400':
description: Bad request.
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not found.
'500':
description: Internal server error.
components:
schemas:
AttachmentCompact:
type: object
properties:
gid:
type: string
readOnly: true
example: '12345'
resource_type:
type: string
readOnly: true
example: attachment
name:
type: string
description: The name of the file.
example: Screenshot.png
resource_subtype:
type: string
description: The service hosting the attachment.
example: dropbox
AttachmentResponse:
type: object
properties:
gid:
type: string
readOnly: true
example: '12345'
resource_type:
type: string
readOnly: true
example: attachment
name:
type: string
example: Screenshot.png
resource_subtype:
type: string
example: dropbox
created_at:
type: string
format: date-time
readOnly: true
example: '2012-02-22T02:06:58.147Z'
download_url:
type: string
format: uri
nullable: true
readOnly: true
host:
type: string
readOnly: true
example: dropbox
parent:
type: object
properties:
gid:
type: string
resource_type:
type: string
name:
type: string
permanent_url:
type: string
format: uri
readOnly: true
size:
type: integer
readOnly: true
description: The size of the attachment in bytes.
view_url:
type: string
format: uri
nullable: true
readOnly: true
connected_to_app:
type: boolean
readOnly: true
parameters:
pretty:
name: opt_pretty
in: query
description: 'Provides “pretty” output.
Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.'
required: false
allowEmptyValue: true
schema:
type: boolean
style: form
example: true
attachment_path_gid:
name: attachment_gid
in: path
description: Globally unique identifier for the attachment.
required: true
schema:
type: string
example: '12345'
x-env-variable: attachment
securitySchemes:
personalAccessToken:
type: http
description: A personal access token for the Asana API.
scheme: bearer
oauth2:
type: oauth2
description: OAuth 2.0 authorization code flow.
flows:
authorizationCode:
authorizationUrl: https://app.asana.com/-/oauth_authorize
tokenUrl: https://app.asana.com/-/oauth_token
scopes:
default: Provides access to all endpoints documented in the API reference.