ATatlassian
Custom user roles

Update custom user role

Updates the details of a custom user role.

  • The user should have admin role and custom user role right.
put/api/{cloudId}/v1/roles/{identifier}

Request

  • Base URL
    https://api.atlassian.com/jsm/ops
  • URL
    https://api.atlassian.com/jsm/ops/api/{cloudId}/v1/roles/{identifier}
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization code: https://auth.stg.atlassian.com/authorize
      Token URL: https://auth.stg.atlassian.com/oauth/token scopes: read:ops-config:jira-service-management, write:ops-config:jira-service-management

Path parameters

identifierstring required

Id of the custom user role.

Query parameters

identifierType'id' | 'name'

Type of the identifier.

Request body

idstring

The id of the custom user role.

namestring

The name of the custom user role.

grantedRightsstring[]

The list of rights to grant to the custom user role.

disallowedRightsstring[]

The list of rights to disallow to the custom user role.

Example request

{
  "name": "conflictRightRole_1",
  "grantedRights": [
    "alerts-access-all",
    "incident-add-note",
    "asdasdad"
  ],
  "disallowedRights": [
    "incident-reopen"
  ]
}

Response

Returned if the request is successful.

messagestring

Changes

No recorded changes to this operation across all 5 revisions of this API.