Update Project

Update an existing project in your Asana instance.

Options

Field	Definition	Type	Required
Organization	Organizations in your Asana workspace. 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

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.	Text	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 & 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.	True/False	FALSE
Archived?	Indicates whether the project is archived; True if the project is archived, or False if it is not archived.	True/False	FALSE
Description	New description of the new project.	Text	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.	Text	FALSE
Team	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. 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.	Text	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.	Text	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

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

Update Project

Options

Input

Output

Related topics