v4

latestOpenAPI 3.0.1Apache 2.02026-08-016079122.3 MB
Permission schemes

Create permission grant

Creates a permission grant in a permission scheme.

Permissions required: Administer Jira global permission.

post/rest/api/2/permissionscheme/{schemeId}/permission

Path parameters

schemeIdinteger required

The ID of the permission scheme in which to create a new permission grant.

Query parameters

expandstring

Use expand to include additional information in the response. This parameter accepts a comma-separated list. Note that permissions are always included when you specify any value. Expand options include:

  • permissions Returns all permission grants for each permission scheme.
  • user Returns information about the user who is granted the permission.
  • group Returns information about the group that is granted the permission.
  • projectRole Returns information about the project role granted the permission.
  • field Returns information about the custom field granted the permission.
  • all Returns all expandable information.

Request body

idinteger

The ID of the permission granted details.

permissionstring

The permission to grant. This permission can be one of the built-in permissions or a custom permission added by an app. See Built-in permissions in Get all permission schemes for more information about the built-in permissions. See the project permission and global permission module documentation for more information about custom permissions.

selfstring uri

The URL of the permission granted details.

Response

Returned if the scheme permission is created.

idinteger

The ID of the permission granted details.

permissionstring

The permission to grant. This permission can be one of the built-in permissions or a custom permission added by an app. See Built-in permissions in Get all permission schemes for more information about the built-in permissions. See the project permission and global permission module documentation for more information about custom permissions.

selfstring uri

The URL of the permission granted details.