Programmatic access to all data in your asana system
Last verified: November 12, 2026
100% uptime: the documentation responded in 5 of 5 checks over the last 30 days. Median response time: 404 ms.
From Asana's OpenAPI specification (version 1.0), spec updated March 6, 2023, via APIs.guru.
This is the interface for interacting with the Asana Platform. Our API reference is generated from our [OpenAPI spec] (https://raw.githubusercontent.com/Asana/developer-docs/master/defs/asana oas.yaml).
Buy me a coffee
https://app.asana.com/api/1.0| Method | Path | What it does |
|---|---|---|
| GET | /attachments | Get attachments from an object |
| POST | /attachments | Upload an attachment |
| GET | /attachments/{attachment_gid} | Get an attachment |
| DELETE | /attachments/{attachment_gid} | Delete an attachment |
| POST | /batch | Submit parallel requests |
| POST | /custom_fields | Create a custom field |
| GET | /custom_fields/{custom_field_gid} | Get a custom field |
| PUT | /custom_fields/{custom_field_gid} | Update a custom field |
| DELETE | /custom_fields/{custom_field_gid} | Delete a custom field |
| POST | /custom_fields/{custom_field_gid}/enum_options | Create an enum option |
| POST | /custom_fields/{custom_field_gid}/enum_options/insert | Reorder a custom field's enum |
| PUT | /enum_options/{enum_option_gid} | Update an enum option |
| GET | /events | Get events on a resource |
| GET | /goal_relationships | Get goal relationships |
| GET | /goal_relationships/{goal_relationship_gid} | Get a goal relationship |
| PUT | /goal_relationships/{goal_relationship_gid} | Update a goal relationship |
| GET | /goals | Get goals |
| POST | /goals | Create a goal |
| GET | /goals/{goal_gid} | Get a goal |
| PUT | /goals/{goal_gid} | Update a goal |
| DELETE | /goals/{goal_gid} | Delete a goal |
| POST | /goals/{goal_gid}/addFollowers | Add a collaborator to a goal |
| POST | /goals/{goal_gid}/addSupportingRelationship | Add a supporting goal relationship |
| GET | /goals/{goal_gid}/parentGoals | Get parent goals from a goal |
| POST | /goals/{goal_gid}/removeFollowers | Remove a collaborator from a goal |
Showing 25 of 167 endpoints. The full list is in the spec above.