To increase the speed and stability of the API, we are transitioning to a world with fewer non-paginated fields.
Deprecations are never fun. Thankfully, this one only affects a small number of apps and we’ve built a workaround that will be useful for many more Asana developers.
What’s Going to Break
subtasks field on tasks is being deprecated. For example, these requests will fail:
This was never an official part of our API, however, it was accidentally leaked and a small percentage of developers started using it.
subtasks field on tasks will be permanently deprecated from the API in 3 months.
We have a new task field
num_subtasks that allows apps to know how many subtasks are on a task. Use
num_subtasks to check if a task has subtasks and then make a subsequent request to
GET /tasks/task-id/subtasks to fetch the subtasks instead of requesting them as a field on the parent task.
If you have questions, please ask them in this topic and we’ll be happy to answer them.