Update Project

Update an existing project in your Asana instance.

Options

Field Definition Type Required
Organization Organizations in your Asana workspace.
Note

This action is only compatible with organizations. If you do not see your workspace in the menu, then it may not be an organization. To learn about the difference between workspaces and organizations, see https://asana.com/developers/api-reference/workspaces.

Dropdown TRUE

Input

Note

Any data that you add to a field will overwrite existing data in the project. The Update Project action card will disregard any input fields that are left empty or populated with null values, and such values will not be sent to the Asana API.

Field Definition Type Required
Update By
Project ID Unique identifier of the project you want to update. Number TRUE
Project
Name New name of the project. You can have multiple projects with the same name. String FALSE
Due On New due date for the project. You can format the date in one of two ways:
  • To specify a date only, the format must be YYYY-MM-DD

  • To specify a date and time, the format must be YYYY-MM-DDTHH:mm:ss+00:00

Date and Time FALSE
Public? Indicates whether the project is accessible by team members; True if the project should be visible by all team members, or False if the project is restricted. Boolean FALSE
Archived? Indicates whether the project is archived; True if the project is archived, or False if it is not archived. Boolean FALSE
Description New description of the new project. String FALSE
Status Indicate the status of a project by either color or description or both.

Status is not required to create a project. A project status is added or updated if you provide values for both the Status Color and Description when you create or update a project.

Status Color Color that represents the status of the new project; options are On Track, At Risk, Off Track, or On Hold. Dropdown FALSE
Description New description of the project's status. String FALSE

Team

Tip

Find a Team ID or the User ID of a project owner by searching for a Team Name or Owner Name.

Team ID New numeric identifier of the team to whom the new project is assigned.
Note

This field is required. Find a team's identifier by navigating to Team Conversations. The identifier can be found in the team's URL.

This is also a required field if you select an organization from the OptionsOrganization dropdown. You need to identify the team with which you'll share the project.

Number TRUE
Team Name New name of the team to whom the project is assigned. String FALSE
Owner
User ID

Unique identifier of the user.

Number FALSE
Owner Name New name of the user to whom the new project is assigned. String FALSE

Output

Field Definition Type
Status Code

Result of the operation. The connector returns an HTTP status code that indicates whether the action taken by the card succeeded or failed. For example:

  • A 201 Created status code indicates success where a new resource was created.
  • A 403 Forbidden error indicates that the HTTP request wasn't processed because the necessary permissions were missing.

For a full list of possible status codes, see HTTP status codes.

Number

Related topics

Asana connector

Workflow elements

Asana API documentation