Definition

The "Update Project" action in Jira allows users to modify the details of an existing project. This includes updating the project name, project key, project lead, and project type. It ensures that project details stay relevant, aligned with business requirements, and properly managed within Jira. This action is useful for keeping projects structured and up to date as teams evolve.

Example Use Cases

1. Rebranding a Project
   If a project undergoes a name change due to rebranding, this action allows updating the project name and key to reflect the new identity.

2. Changing the Project Lead
   When a project manager transitions to a new role, updating the project lead ensures that the correct person has administrative control.

3. Modifying Project Type
   If a project originally created as a business project needs to be switched to a service desk, this action helps adjust the project type accordingly.

4. Standardizing Project Keys
   If a company follows a new naming convention, project keys can be updated to align with the new standard.

Inputs

1. Connection
   The authentication method used to connect to Jira. This ensures secure access to the Jira instance.

2. Jira Cloud
   The unique Cloud ID of your Jira instance. This ID is automatically generated when the Jira instance is created and is required for authentication and integration with other Atlassian products.

3. Project Key or ID
   The unique identifier for the project you want to update. It can be selected from previous steps or manually entered.

4. Select Fields for Update

   Choose which project details you want to update. Available fields include:

   • Project Name
     Updates the name of the project. This is useful when rebranding or renaming projects for better clarity.

   • Project Key
     Changes the project's unique key. This is typically used when standardizing project keys across an organization.

   • Lead User ID
     Specifies the new project lead’s unique identifier. Assigning a new lead ensures project responsibilities are correctly managed.

   • Project Type
     Defines the type of project. Jira offers different project types such as software development, service desk, and business projects. Changing the project type adjusts its configuration accordingly.

Step-by-Step Guide

Follow these steps to update a project in Jira using the Update Project action:

1. Establish a Connection
   Ensure you have a valid Connection to Jira. Select or authenticate your Jira instance to enable API access.

2. Select the Jira Cloud Instance
   Choose the Jira Cloud ID associated with your Jira workspace. This identifies the specific Jira environment where the project exists.

3. Specify the Project to Update
   Enter or select the Project Key or ID of the project that needs an update.

   • You can use a value retrieved from a previous action (e.g., "List Projects").

4. Choose Fields to Update
   Select one or more fields that require updating:

   • Project Name – Enter a new name for the project.
   • Project Key – Modify the unique key of the project if needed.
   • Lead User ID – Assign a new project lead by specifying their user ID.
   • Project Type – Change the type of project (e.g., from software to service desk).

5. Execute the Action
   Run the flow to apply the changes.

   • The system will update the project details in Jira based on the selected fields.

6. Verify the Output
   Once executed, the action will return the Project ID and Project Key to confirm that the update was successful. You can check the updated details in your Jira project settings.

Outputs

When the Update Project action is successfully executed, it provides the following outputs:

1. Project ID
   A unique identifier for the updated project in Jira.

   • This can be used in future actions that require project identification.

2. Project Key
   The key assigned to the project, which may have been updated during the action.

   • This is useful for referencing the project in Jira workflows, issue creation, or other integrations.

Example Scenario

Updating a Project Lead in Jira

A project manager realizes that the current Project Lead for an ongoing software development project is changing due to internal restructuring. To reflect this change in Jira, they use the Update Project action.

• They input the Jira Cloud ID and select the Project Key of the project that needs updating.
• They choose the Lead User ID of the new project lead.
• Once the action is executed, the project’s details are updated in Jira, ensuring the new lead has proper access and visibility over the project.

This automation helps keep project ownership up-to-date without requiring manual changes in Jira’s settings.