This is the interface for interacting with the Asana platform. This reference is generated from our OpenAPI 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 our guides.

To view the API reference for app components, click here.


Quick start

To begin making requests against the REST API, see the quick start guide.


  • Objects are ordered alphabetically in the sidebar
  • 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-context API explorer through which you can make requests (and see responses). For notes on enumerated values (i.e., on request properties), see this article.

Base URL

API endpoints are relative to the following base URL:


Additional resources