Set actors for project role

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"}}}

Request

Path Params

projectIdOrKey

string

required

The project ID or project key (case sensitive).

integer

required

The ID of the project role. Use Get all project roles to get a list of project role IDs.

Body Params application/json

categorisedActors

object

optional

The actors to add to the project role.

Add groups using:

atlassian-group-role-actor and a list of group names.

atlassian-group-role-actor-id and a list of group IDs.

As a group's name can change, use of atlassian-group-role-actor-id is recommended. For example, "atlassian-group-role-actor-id":["eef79f81-0b89-4fca-a736-4be531a10869","77f6ab39-e755-4570-a6ae-2d7a8df0bcb8"].

Add users using atlassian-user-role-actor and a list of account IDs. For example, "atlassian-user-role-actor":["12345678-9abc-def1-2345-6789abcdef12", "abcdef12-3456-789a-bcde-f123456789ab"].

Additional properties

array[string]

optional

Examples

Responses

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

application/json

Body

Details about the roles in a project.

actors

array[object (RoleActor) {7}]

read-onlyoptional

The list of users who act in this role.

actorGroup

object

read-onlyoptional

Details of the group associated with the role.

actorUser

object

read-onlyoptional

Details of the user associated with the role.

avatarUrl

string <uri>

read-onlyoptional

The avatar of the role actor.

displayName

string

read-onlyoptional

The display name of the role actor. For users, depending on the user’s privacy setting, this may return an alternative value for the user's name.

integer <int64>

read-onlyoptional

The ID of the role actor.

name

string

read-onlyoptional

This property is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

type

enum<string>

read-onlyoptional

The type of role actor.

Allowed values:

atlassian-group-role-actoratlassian-user-role-actor

admin

boolean

read-onlyoptional

Whether this role is the admin role for the project.

currentUserRole

boolean

optional

Whether the calling user is part of this role.

default

boolean

read-onlyoptional

Whether this role is the default role for the project

description

string

read-onlyoptional

The description of the project role.

integer <int64>

read-onlyoptional

The ID of the project role.

name

string

optional

The name of the project role.

roleConfigurable

boolean

read-onlyoptional

Whether the roles are configurable for this project.

scope

object

read-onlyoptional

The scope of the role. Indicated for roles associated with next-gen projects.

project

object

read-onlyoptional

The project the item has scope in.

type

enum<string>

read-onlyoptional

The type of scope.

Allowed values:

PROJECTTEMPLATE

Additional properties

integer | number | string | boolean

optional

self

string <uri>

read-onlyoptional

The URL the project role details.

translatedName

string

optional

The translated name of the project role.

🟠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.