The Asana API is a RESTful interface, providing programmatic access to much of the data in the system. It provides predictable URLs for accessing resources, and uses built-in HTTP features to receive commands and return responses. This makes it easy to communicate from a wide variety of environments: apps, command-line utilities, gadgets, and even the browser URL bar itself.

The API accepts JSON or form-encoded content in requests and returns JSON content in all of its responses, including errors. Only UTF-8 character encoding is supported for both requests and responses.

How documentation is structured

Documentation on this site is divided into two major sections:

  • Guides: Contextual information, guides, and tutorials regarding API usage
    • Guides for API include how to work with opt fields (input/output options), pagination, handling errors, rate limits, working with custom fields, storing external data, working with rich text, SCIM, Audit log events, and deprecations
  • API reference: A comprehensive reference for objects, schemas, and endpoints available in the API
    You may navigate between both sections at any time using the navigation bar above.