• Approval
  • Customer
  • Customer Request
  • Customer Transition
  • Jira Service Management Application
  • Organization
  • Organization Service Desk
  • Portals
  • Queue
  • Queue Settings
  • Request Attachment
  • Request Type
  • Request Type Permissions
  • Service Desk
  • Service Desk Customer
  • application-properties
  • applicationrole
  • attachment
  • avatar
  • cluster
  • comment
  • component
  • configuration
  • customFieldOption
  • customFields
  • dashboard
  • email-templates
  • field
  • filter
  • group
  • groups
  • groupuserpicker
  • index
  • index-snapshot
  • issue
  • issueLinkType
  • issuesecurityschemes
  • issuetype
  • issuetypescheme
  • jql
  • licenseValidator
  • monitoring
  • mypermissions
  • mypreferences
  • myself
  • notificationscheme
  • password
  • permissions
  • permissionscheme
  • priority
  • priorityschemes
  • project
  • projectCategory
  • projects
  • projectvalidate
  • reindex
  • resolution
  • role
  • screens
  • securitylevel
  • serverInfo
  • session
  • settings
  • status
  • statuscategory
  • terminology
  • universal_avatar
  • upgrade
  • user
  • version
  • websudo
  • workflow
  • workflowscheme
  • worklog
  • Assets - AQL
  • Assets - Analytics
  • Assets - Archived Objects
  • Assets - Attachments
  • Assets - Comments
  • Assets - Icons
  • Assets - Index Configuration
  • Assets - Object
  • Assets - Object Archive
  • Assets - Object Attribute
  • Assets - Object Connected Tickets
  • Assets - Object Restore
  • Assets - Object Schema
  • Assets - Object Type
  • Assets - Object Type Attribute
  • Assets - Progress
  • Assets - QR Code
  • Assets - Status Types
Server
Jira Service Management / Reference / REST API

role

Postman Collection
OpenAPI
GET

Get all project roles

Get all the ProjectRoles available in Jira. Currently this list is global.

Request

This request has no parameters.

Responses

Returns full details of the roles available in Jira.

application/json

ProjectRoleBean
GET/api/2/role
1 2 3 4 curl --request GET \ --url 'http://{baseurl}/rest/api/2/role' \ --user 'email@example.com:<api_token>' \ --header 'Accept: application/json'
POST

Create a new project role

Creates a new ProjectRole to be available in Jira. The created role does not have any default actors assigned.

Request

Request bodyapplication/json

The role to create

description

string

name

string

Responses

Returns full details of the created role

application/json

ProjectRoleBean
POST/api/2/role
1 2 3 4 5 curl --request POST \ --url 'http://{baseurl}/rest/api/2/role' \ --user 'email@example.com:<api_token>' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json'
GET

Get a specific project role

Get a specific ProjectRole available in Jira.

Request

Path parameters

id

integer

Required

Responses

Returns full details of the role available in Jira.

application/json

ProjectRoleBean
GET/api/2/role/{id}