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

Related topics

Asana connector

Cards in flows

Asana API documentation