PUT /rest/api/2/project/{projectIdOrKey}/role/{id}

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.

Servers

Path parameters

Name Type Required Description
id Integer Yes

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

projectIdOrKey String Yes

The project ID or project key (case sensitive).

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
id Integer No

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

categorisedActors Object No

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"].

categorisedActors.name String No

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.