Set actors for project role

Sets the actors for a project role for a project, replacing all existing actors.

To add actors to the project without overwriting the existing list, use Add actors to project role.

Permissions required: Administer Projects project permission for the project or Administer Jira global permission.

curl --location --request PUT 'http://jira.local:8080/jira/rest//rest/api/3/project//role/' \ --header 'Content-Type: application/json' \ --data-raw '{ "categorisedActors": { "atlassian-group-role-actor-id": [ "952d12c3-5b5b-4d04-bb32-44d383afc4b2" ], "atlassian-user-role-actor": [ "12345678-9abc-def1-2345-6789abcdef12" ] } }'

{"self":"https://your-domain.atlassian.net/rest/api/3/project/MKY/role/10360","name":"Developers","id":10360,"description":"A project role that represents developers in a project","actors":[{"id":10240,"displayName":"jira-developers","type":"atlassian-group-role-actor","name":"jira-developers","actorGroup":{"name":"jira-developers","displayName":"jira-developers","groupId":"952d12c3-5b5b-4d04-bb32-44d383afc4b2"}},{"id":10241,"displayName":"Mia Krystof","type":"atlassian-user-role-actor","actorUser":{"accountId":"5b10a2844c20165700ede21g"}}],"scope":{"type":"PROJECT","project":{"id":"10000","key":"KEY","name":"Next Gen Project"}}}

Responses

🟢200Returned if the request is successful. The complete list of actors for the project is returned.

application/json

Body

🟠400Returned if the request is not valid.

🟠401Returned if the authentication credentials are incorrect or missing or if the calling user lacks administrative permissions for the project.

🟠404Returned if: * the project is not found. * a user or group is not found. * a group or user is not active.

Set actors for project role

Request

Responses