Project permission schemes

Assign permission scheme

Changed on

Assigns a permission scheme with a project. See Managing project permissions for more information about permission schemes.

Permissions required: Administer Jira global permission

put/rest/api/3/project/{projectKeyOrId}/permissionscheme

Request

  • Base URL
    https://your-domain.atlassian.net
  • URL
    https://your-domain.atlassian.net/rest/api/3/project/{projectKeyOrId}/permissionscheme
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization code: https://auth.atlassian.com/authorize
      Token URL: https://auth.atlassian.com/oauth/token scopes: manage:jira-project

Path parameters

projectKeyOrIdstring required

The project ID or project key (case sensitive).

Query parameters

expandstring

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

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

Request body

idinteger required

The ID of the permission scheme to associate with the project. Use the Get all permission schemes resource to get a list of permission scheme IDs.

Response

Returned if the request is successful.

descriptionstring

A description for the permission scheme.

expandstring

The expand options available for the permission scheme.

idinteger

The ID of the permission scheme.

namestring required

The name of the permission scheme. Must be unique.

selfstring uri

The URL of the permission scheme.

Changes

  • 75c9c58763c9Revision changes
    • warning

      added the new product_discovery enum value to the ////////// response property for the response status