Adding "Portfolio member" role through Jira Align API

Platform Notice: Cloud and Data Center - This article applies equally to both cloud and data center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

Rest API query to add "Portfolio member" role through API.

Solution

When trying to update teams to the Portfolio role with role id “12” or while adding the Portfolio member role, we observe an error message stating, “Cannot update user with id xxxx. ( 12 ) roleId cannot be set for this team type.”

Valid values for Portfolio roleId are:

  • 15 (Business Owner)

  • 16 (Enterprise Architect)

  • 17 (Epic Owner)

In UI, if you go to a team's slide-out > Members tab and click the appropriate dropdown, you should be able to select only 15, 16, or 17 roles.

Please use the syntax below to add "Portfolio member" role IDs 15, 16, and 17 through API.

1 2 3 4 5 6 7 8 9 10 11 [ { "op": "add", "path": "teams/-", "value": { "teamId": 111111, "roleId": 15 } } ]

Updated on April 14, 2025

Still need help?

The Atlassian Community is here for you.