Introducing our new developer documentation!

Hi developers,

As we promised earlier this month, our team has been making some major updates to our developer documentation. Today, we are excited to share that our new docs have launched!

You can access the new developer documentation here:

New features

  • An improved docs structure with distinct sections for:
    • Guides: Contextual information, guides, and tutorials regarding API usage
    • API references: A comprehensive reference for objects, schemas, and endpoints available in the API
  • A top-level navbar with quick access to the App Directory, Forum, and the Developer Console
  • Separate pages for each article in documentation (rather than all documentation on a single, long page)
  • An in-context, easy-to-use API explorer built into the API reference – just add your personal access token and begin making API calls right away!
  • Schema information listed directly on the object reference itself (e.g. Users)
  • An updated Search experience
  • A :+1: or :-1: for feedback on each page

As a side note, our OpenAPI Specifications have also been moved to the new openapi repository.


As we continue to improve the developer experience, we’d love to hear your feedback! Feel free to leave us a note using this form.

Thank you all for building with Asana!

Andrew Wong, Developer Advocate

P.S. If you don’t see the changes yet when visiting the documentation site, they may still be propagating with today’s DNS rollout. Please check back shortly!


Can we still use the beta link or is it deprecated?

@Bastien_Siebman the beta link will redirect with to the main site. However, we saw that it was erroring out, so we’re working on a fix. For now, please user the Overview site. Thanks!