Adding "Portfolio member" role through Jira Align API

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.

[ { "op": "add", "path": "teams/-", "value": { "teamId": 111111, "roleId": 15 } } ]

Updated on September 26, 2025

Still need help?

The Atlassian Community is here for you.