Project roles

Create project role

Changed on

Creates a new project role with no default actors. You can use the Add default actors to project role operation to add default actors to the project role after creating it.

Note that although a new project role is available to all projects upon creation, any default actors that are associated with the project role are not added to projects that existed prior to the role being created.<

Permissions required: Administer Jira global permission.

post/rest/api/2/role

Request

  • Base URL: https://your-domain.atlassian.net
  • URL: https://your-domain.atlassian.net/rest/api/2/role
  • 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)

Request body

descriptionstring

A description of the project role. Required when fully updating a project role. Optional when creating or partially updating a project role.

namestring

The name of the project role. Must be unique. Cannot begin or end with whitespace. The maximum length is 255 characters. Required when creating a project role. Optional when partially updating a project role.

Response

Returned if the request is successful.

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