tl;dr: Per a previous post, we are making breaking changes to the way that user task lists (i.e. My Tasks) work in Asana. Developers can now test some of the new behavior by passing Asana-Enable: new_user_task_list
as a request header. If your app interacts with user task lists, please read!
Hi everyone,
I’m Yacob and I’m a Product Engineer here at Asana. In this previous post, I came to tell you all about some important changes coming to My Tasks that impact our APIs. I’m back to let you all know about how you can opt-in to test the deprecation.
As I mentioned in the last post, the changes we’re making to user task lists are happening via a migration so after we start the migration, there will be no way to opt-in or opt-out to change the API behavior . To that end, we wanted to give you a way to test the new API behavior before we start the migration.
Important info for updating your app to test the deprecation:
- The name of the deprecation is
new_user_task_list
so as per our deprecation documentation, you can opt in to the new behavior by passing the following header in your requests:Asana-Enable: new_user_task_list
- Notably the two things you’ll be able to test with that header are:
- If an app calls the
PUT /tasks/{task_gid}
endpoint with an assignee_status, no changes will be made to the assignee_status property. - If an app calls the
GET /tasks/{task_gid}
endpoint or any endpoint that returns metadata about a task, we will no longer return the assignee_status property in the response payload, even if it is explicitly requested via opt_fields.
- If an app calls the
- Notably the two things you’ll be able to test with that header are:
- Additionally, as mentioned in the last post, we will be exposing a migration status on user task list resources. The new property is
user_task_list.migration_status
. It is an string with 2 valid values:not_migrated
orcompleted
For understanding the full plan for this deprecation and our breaking changes, please refer to the original post linked above!
Please let us know if you have any questions about this. We’ll be watching this thread for questions and will update this post as necessary to provide more information or clarification.