The Update task action updates specific properties of an Asana task and returns the new values of the fields in response data.

Overview

The action returns the updated task properties for the specified task GID such as name, assignee, due date, description, parent task details, and completion flag. The parent task details contain the GID, name, and resource type of the parent task. You can specify the parameters directly in the appropriate text box or create and select string variables for each parameter as the input fields support string variables.

Settings

The following settings are available in the Update task action:

Session
Specifies the Asana session that the Connect action creates. Choose one of the following options as per the Connect action settings:
  • Session name: Select the string variable that stores the session name or enter the session name manually in the text box.
  • Variable: Select the Asana session variable that holds the session name.
Task GID
Specifies the GID of the Asana task that the action must update.
Name (optional)
Specifies the new name for the task.
Assignee (optional)
Specifies the new assignee for the task. You can either specify the email address or the GID of the user.
Due on (optional)
Specifies the new due date that the action sets for the task. Specify the date in YYYY-MM-DD format.
Notes (optional)
Specifies the new description for the task.
Completed
Specifies the completion status of the task. Enable the check box to mark the task as complete.
Parent (optional)
Specifies the GID of the new parent task. Use this option to move an existing subtask to a new parent task or change a standalone task into a subtask of the specified parent task.
Assign response to a variable (Optional)
Specifies the output variable that stores the response data after the action updates the task. The response data contains the following keys:
  • taskGid - The unique GID of the task.
  • name - The updated name of the task as specified in Name.
  • notes - The updated description of the task as specified in Notes.
  • due_on - The updated due date that the action sets for the task as specified in Due on.
  • parent - The GID of the new parent task to which the action reassigns the task as specified in Parent.
  • assignee - The name of the new assignee as specified in Assignee. The assignee details contains the name, GID, and resource type of the assignee.
  • projects - The GID of the project to which the action reassigns the task as specified in Parent.
  • completed - The updated completion flag that the action sets for the task as specified in Completed.
  • workspace - The details of the workspace in which the task is available. The workspace details contains the name, GID, and resource type of the workspace.

For more information about all the keys available in the response data, see Asana tasks response data. Use one of the following options to store the response data:

  • Multiple variables: Create and specify individual variables to store specific response data.

    Use the Add variable mapping option to specify the key and corresponding variable type to store the specific response data.

  • Dictionary: Create and specify a dictionary variable to store the entire response data.