Project role actors

Add actors to project role

Changed on

Adds actors to a project role for the project.

To replace all actors for the project, use Set actors for project role.

This operation can be accessed anonymously.

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

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

Request

  • Base URL: https://your-domain.atlassian.net
  • URL: https://your-domain.atlassian.net/rest/api/2/project/{projectIdOrKey}/role/{id}
  • Auth: one of:
    • HTTP basic
    • OAuth 2 (authorization code, authorization URL https://auth.atlassian.com/authorize, token URL https://auth.atlassian.com/oauth/token, scopes: manage:jira-configuration)
    • none

Path parameters

projectIdOrKeystring required

The project ID or project key (case sensitive).

idinteger required

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

Request body

groupstring[]

The name of the group to add. This parameter cannot be used with the groupId parameter. As a group's name can change, use of groupId is recommended.

groupIdstring[]

The ID of the group to add. This parameter cannot be used with the group parameter.

userstring[]

The user account ID of the user to add.

Response

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

For example, the cURL request above adds a group, jira-developers. For the response below to be returned as a result of that request, the user Mia Krystof would have previously been added as a user actor for this project.

adminboolean

Whether this role is the admin role for the project.

currentUserRoleboolean

Whether the calling user is part of this role.

defaultboolean

Whether this role is the default role for the project

descriptionstring

The description of the project role.

idinteger

The ID of the project role.

namestring

The name of the project role.

roleConfigurableboolean

Whether the roles are configurable for this project.

selfstring uri

The URL the project role details.

translatedNamestring

The translated name of the project role.

Changes

  • 38a98954789eRevision changes
    • warning

      added the new product_discovery enum value to the ////////// response property for the response status