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

Creates a permission grant in a permission scheme.

Permissions required: Administer Jira global permission.

Servers

Path parameters

Name Type Required Description
schemeId Integer Yes

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

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Query parameters

Name Type Required Description
expand String No

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 fields

Name Type Required Description
id Integer No

The ID of the permission granted details.

permission String No

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.

self String No

The URL of the permission granted details.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.