ATatlassian
Team roles

Update team role

Updates the details of a team role

patch/api/{cloudId}/v1/teams/{teamId}/roles/{identifier}

Request

  • Base URL
    https://api.atlassian.com/jsm/ops
  • URL
    https://api.atlassian.com/jsm/ops/api/{cloudId}/v1/teams/{teamId}/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 team role.

teamId'id' | 'name' required

Id of the team.

Request body

namestring

The name of the custom user role.

Example request

{
  "name": "updatedRole",
  "rights": [
    {
      "right": "access-reports",
      "granted": true
    },
    {
      "right": "delete-escalations",
      "granted": false
    }
  ]
}

Response

Returned if the request is successful.

idstring

The id of the team role.

namestring

The name of the team role.

Changes

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