Overview
This is the interface for interacting with the Asana platform. This reference is generated from ourOpenAPI Specification, and contains a comprehensive reference for objects, schemas, and endpoints available in the API.
For contextual information, guides, and tutorials regarding API usage, visit ourguides.
To view the API reference forapp components, clickhere.
📘
Quick start
To begin making requests against the REST API, see thequick start guide.
Usage
The Asana API is aRESTful interface with predictable resource-oriented URLs, acceptsJSON orform-encoded requests, returns JSON, and uses standardHTTP features (verbs,response codes, etc.)
API endpoints are relative to the followingbase URL:
https://app.asana.com/api/1.0Some requests returncompact representations of objects in order to conserve resources and complete the request more efficiently. Seeinput/output options to customize your responses.
Navigation
- Objects (i.e., resources in the API) are ordered alphabetically in the sidebar of this API reference
- Object schemas can be found by selecting the object in the sidebar (e.g.,Attachments)
- Select an endpoint (e.g.,get a task) to see code samples, example requests, and responses
API explorer
Each API endpoint features a built-in, in-contextAPI explorer through which you can make requests (and see responses). For notes on enumerated values (i.e., on request properties), seethis documentation.