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: https://developers.asana.com/docs
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
or 
for feedback on each page
As a side note, our OpenAPI Specifications have also been moved to the new openapi repository.
Feedback
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!