@resolution/jira-api-client 0.4.2 → 0.4.5

package/lib/openapi/platform/services/PermissionSchemesService.js

@@ -18,551 +18,554 @@ const validationSchemaStorage_1 = require("../validationSchemaStorage");
  * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes
  */
 class PermissionSchemesService extends CommonHttpService_1.CommonHttpService {
-    /**
-     * Creates a permission grant in a permission scheme.
-     *
-     * **[Permissions](#permissions) required:** *Administer Jira* [global
-     * permission](https://confluence.atlassian.com/x/x4dKLg).
-     *
-     * @returns Returned if the scheme permission is created.
-     *
-     * example: {
-     *   "holder": {
-     *     "expand": "group",
-     *     "parameter": "jira-core-users",
-     *     "type": "group",
-     *     "value": "ca85fac0-d974-40ca-a615-7af99c48d24f"
-     *   },
-     *   "id": 10000,
-     *   "permission": "ADMINISTER_PROJECTS",
-     *   "self":
-     * "https://your-domain.atlassian.net/rest/api/3/permissionscheme/permission/10000"
-     * }
-     * @path {POST} /rest/api/3/permissionscheme/{schemeId}/permission
-     * @scopes-current manage:jira-configuration
-     * @scopes-beta read:application-role:jira, read:field:jira, read:group:jira,
-     * read:permission:jira, read:project-role:jira, read:user:jira,
-     * write:permission:jira
-     * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes#api-rest-api-3-permissionscheme-schemeid-permission-post
-     */
-    createPermissionGrant({ schemeId, expand, permissionGrant, }) {
-        return this.getClientInstance()
-            .request({
-            path: "/rest/api/3/permissionscheme/{schemeId}/permission",
-            method: "POST",
-            pathParams: {
-                schemeId,
-            },
-            query: {
-                expand,
-            },
-            headers: {
-                "Content-Type": "application/json",
-            },
-            body: permissionGrant,
-        })
-            .then(this.getClientInstance().responseHandler({
-            201: {
-                "application/json": "json",
-            },
-        }))
-            .then(commonHttpClient.castResponse())
-            .then(validationSchemaStorage_1.validationSchemaStorage.validator("PermissionSchemesService.createPermissionGrant.response"))
-            .then(commonHttpClient.getBody);
-    }
-    /**
-     * Creates a new permission scheme. You can create a permission scheme with or
-     * without defining a set of permission grants.
-     *
-     * **[Permissions](#permissions) required:** *Administer Jira* [global
-     * permission](https://confluence.atlassian.com/x/x4dKLg).
-     *
-     * @returns Returned if the permission scheme is created.
-     *
-     * example: {
-     *   "description": "description",
-     *   "id": 10000,
-     *   "name": "Example permission scheme",
-     *   "permissions": [
-     *     {
-     *       "holder": {
-     *         "expand": "group",
-     *         "parameter": "jira-core-users",
-     *         "type": "group",
-     *         "value": "ca85fac0-d974-40ca-a615-7af99c48d24f"
-     *       },
-     *       "id": 10000,
-     *       "permission": "ADMINISTER_PROJECTS",
-     *       "self":
-     * "https://your-domain.atlassian.net/rest/api/3/permissionscheme/permission/10000"
-     *     }
-     *   ],
-     *   "self": "https://your-domain.atlassian.net/rest/api/3/permissionscheme/10000"
-     * }
-     * @path {POST} /rest/api/3/permissionscheme
-     * @scopes-current manage:jira-configuration
-     * @scopes-beta write:permission-scheme:jira, read:application-role:jira, read:field:jira,
-     * read:group:jira, read:permission-scheme:jira, read:permission:jira,
-     * read:project-role:jira, read:user:jira, read:avatar:jira,
-     * read:project-category:jira, read:project:jira
-     * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes#api-rest-api-3-permissionscheme-post
-     */
-    createPermissionScheme({ expand, permissionScheme, }) {
-        return this.getClientInstance()
-            .request({
-            path: "/rest/api/3/permissionscheme",
-            method: "POST",
-            query: {
-                expand,
-            },
-            headers: {
-                "Content-Type": "application/json",
-            },
-            body: permissionScheme,
-        })
-            .then(this.getClientInstance().responseHandler({
-            201: {
-                "application/json": "json",
-            },
-        }))
-            .then(commonHttpClient.castResponse())
-            .then(validationSchemaStorage_1.validationSchemaStorage.validator("PermissionSchemesService.createPermissionScheme.response"))
-            .then(commonHttpClient.getBody);
-    }
-    /**
-     * Deletes a permission scheme.
-     *
-     * **[Permissions](#permissions) required:** *Administer Jira* [global
-     * permission](https://confluence.atlassian.com/x/x4dKLg).
-     *
-     * @path {DELETE} /rest/api/3/permissionscheme/{schemeId}
-     * @scopes-current manage:jira-configuration
-     * @scopes-beta delete:permission-scheme:jira
-     * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes#api-rest-api-3-permissionscheme-schemeid-delete
-     */
-    deletePermissionScheme({ schemeId, }) {
-        return this.getClientInstance()
-            .request({
-            path: "/rest/api/3/permissionscheme/{schemeId}",
-            method: "DELETE",
-            pathParams: {
-                schemeId,
-            },
-        })
-            .then(commonHttpClient.discardResult);
-    }
-    /**
-     * Deletes a permission grant from a permission scheme. See [About permission
-     * schemes and
-     * grants](../api-group-permission-schemes/#about-permission-schemes-and-grants)
-     * for more details.
-     *
-     * **[Permissions](#permissions) required:** *Administer Jira* [global
-     * permission](https://confluence.atlassian.com/x/x4dKLg).
-     *
-     * @path {DELETE} /rest/api/3/permissionscheme/{schemeId}/permission/{permissionId}
-     * @scopes-current manage:jira-configuration
-     * @scopes-beta delete:permission:jira
-     * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes#api-rest-api-3-permissionscheme-schemeid-permission-permissionid-delete
-     */
-    deletePermissionSchemeEntity({ schemeId, permissionId, }) {
-        return this.getClientInstance()
-            .request({
-            path: "/rest/api/3/permissionscheme/{schemeId}/permission/{permissionId}",
-            method: "DELETE",
-            pathParams: {
-                schemeId,
-                permissionId,
-            },
-        })
-            .then(commonHttpClient.discardResult);
-    }
-    /**
-     * Returns all permission schemes.
-     *
-     * ### About permission schemes and grants ###
-     *
-     * A permission scheme is a collection of permission grants. A permission grant
-     * consists of a `holder` and a `permission`.
-     *
-     * #### Holder object ####
-     *
-     * The `holder` object contains information about the user or group being granted
-     * the permission. For example, the *Administer projects* permission is granted to
-     * a group named *Teams in space administrators*. In this case, the type is
-     * `"type": "group"`, and the parameter is the group name, `"parameter": "Teams in
-     * space administrators"` and the value is group ID, `"value":
-     * "ca85fac0-d974-40ca-a615-7af99c48d24f"`.
-     *
-     * The `holder` object is defined by the following properties:
-     *
-     *  *  `type` Identifies the user or group (see the list of types below).
-     *  *  `parameter` As a group's name can change, use of `value` is recommended.
-     * The value of this property depends on the `type`. For example, if the `type` is
-     * a group, then you need to specify the group name.
-     *  *  `value` The value of this property depends on the `type`. If the `type` is
-     * a group, then you need to specify the group ID. For other `type` it has the
-     * same value as `parameter`
-     *
-     * The following `types` are available. The expected values for `parameter` and
-     * `value` are given in parentheses (some types may not have a `parameter` or
-     * `value`):
-     *
-     *  *  `anyone` Grant for anonymous users.
-     *  *  `applicationRole` Grant for users with access to the specified application
-     * (application name, application name). See [Update product access
-     * settings](https://confluence.atlassian.com/x/3YxjL) for more information.
-     *  *  `assignee` Grant for the user currently assigned to an issue.
-     *  *  `group` Grant for the specified group (`parameter` : group name, `value` :
-     * group ID).
-     *  *  `groupCustomField` Grant for a user in the group selected in the specified
-     * custom field (`parameter` : custom field ID, `value` : custom field ID).
-     *  *  `projectLead` Grant for a project lead.
-     *  *  `projectRole` Grant for the specified project role (`parameter` :project
-     * role ID, `value` : project role ID).
-     *  *  `reporter` Grant for the user who reported the issue.
-     *  *  `sd.customer.portal.only` Jira Service Desk only. Grants customers
-     * permission to access the customer portal but not Jira. See [Customizing Jira
-     * Service Desk permissions](https://confluence.atlassian.com/x/24dKLg) for more
-     * information.
-     *  *  `user` Grant for the specified user (`parameter` : user ID - historically
-     * this was the userkey but that is deprecated and the account ID should be used,
-     * `value` : user ID).
-     *  *  `userCustomField` Grant for a user selected in the specified custom field
-     * (`parameter` : custom field ID, `value` : custom field ID).
-     *
-     * #### Built-in permissions ####
-     *
-     * The [built-in Jira permissions](https://confluence.atlassian.com/x/yodKLg) are
-     * listed below. Apps can also define custom permissions. See the [project
-     * permission](https://developer.atlassian.com/cloud/jira/platform/modules/project-permission/)
-     * and [global
-     * permission](https://developer.atlassian.com/cloud/jira/platform/modules/global-permission/)
-     * module documentation for more information.
-     *
-     * **Project permissions**
-     *
-     *  *  `ADMINISTER_PROJECTS`
-     *  *  `BROWSE_PROJECTS`
-     *  *  `MANAGE_SPRINTS_PERMISSION` (Jira Software only)
-     *  *  `SERVICEDESK_AGENT` (Jira Service Desk only)
-     *  *  `VIEW_DEV_TOOLS` (Jira Software only)
-     *  *  `VIEW_READONLY_WORKFLOW`
-     *
-     * **Issue permissions**
-     *
-     *  *  `ASSIGNABLE_USER`
-     *  *  `ASSIGN_ISSUES`
-     *  *  `CLOSE_ISSUES`
-     *  *  `CREATE_ISSUES`
-     *  *  `DELETE_ISSUES`
-     *  *  `EDIT_ISSUES`
-     *  *  `LINK_ISSUES`
-     *  *  `MODIFY_REPORTER`
-     *  *  `MOVE_ISSUES`
-     *  *  `RESOLVE_ISSUES`
-     *  *  `SCHEDULE_ISSUES`
-     *  *  `SET_ISSUE_SECURITY`
-     *  *  `TRANSITION_ISSUES`
-     *
-     * **Voters and watchers permissions**
-     *
-     *  *  `MANAGE_WATCHERS`
-     *  *  `VIEW_VOTERS_AND_WATCHERS`
-     *
-     * **Comments permissions**
-     *
-     *  *  `ADD_COMMENTS`
-     *  *  `DELETE_ALL_COMMENTS`
-     *  *  `DELETE_OWN_COMMENTS`
-     *  *  `EDIT_ALL_COMMENTS`
-     *  *  `EDIT_OWN_COMMENTS`
-     *
-     * **Attachments permissions**
-     *
-     *  *  `CREATE_ATTACHMENTS`
-     *  *  `DELETE_ALL_ATTACHMENTS`
-     *  *  `DELETE_OWN_ATTACHMENTS`
-     *
-     * **Time tracking permissions**
-     *
-     *  *  `DELETE_ALL_WORKLOGS`
-     *  *  `DELETE_OWN_WORKLOGS`
-     *  *  `EDIT_ALL_WORKLOGS`
-     *  *  `EDIT_OWN_WORKLOGS`
-     *  *  `WORK_ON_ISSUES`
-     *
-     * **[Permissions](#permissions) required:** Permission to access Jira.
-     *
-     * @returns Returned if the request is successful.
-     *
-     * example: {
-     *   "permissionSchemes": [
-     *     {
-     *       "description": "description",
-     *       "id": 10000,
-     *       "name": "Example permission scheme",
-     *       "self":
-     * "https://your-domain.atlassian.net/rest/api/3/permissionscheme/10000"
-     *     }
-     *   ]
-     * }
-     * @path {GET} /rest/api/3/permissionscheme
-     * @scopes-current read:jira-work
-     * @scopes-beta read:application-role:jira, read:field:jira, read:group:jira,
-     * read:permission-scheme:jira, read:permission:jira, read:project-role:jira,
-     * read:user:jira, read:avatar:jira, read:project-category:jira, read:project:jira
-     * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes#api-rest-api-3-permissionscheme-get
-     */
-    getAllPermissionSchemes({ expand, } = {}) {
-        return this.getClientInstance()
-            .request({
-            path: "/rest/api/3/permissionscheme",
-            method: "GET",
-            query: {
-                expand,
-            },
-        })
-            .then(this.getClientInstance().responseHandler({
-            200: {
-                "application/json": "json",
-            },
-        }))
-            .then(commonHttpClient.castResponse())
-            .then(validationSchemaStorage_1.validationSchemaStorage.validator("PermissionSchemesService.getAllPermissionSchemes.response"))
-            .then(commonHttpClient.getBody);
-    }
-    /**
-     * Returns a permission scheme.
-     *
-     * **[Permissions](#permissions) required:** Permission to access Jira.
-     *
-     * @returns Returned if the request is successful.
-     *
-     * example: {
-     *   "description": "description",
-     *   "id": 10000,
-     *   "name": "Example permission scheme",
-     *   "permissions": [
-     *     {
-     *       "holder": {
-     *         "expand": "group",
-     *         "parameter": "jira-core-users",
-     *         "type": "group",
-     *         "value": "ca85fac0-d974-40ca-a615-7af99c48d24f"
-     *       },
-     *       "id": 10000,
-     *       "permission": "ADMINISTER_PROJECTS",
-     *       "self":
-     * "https://your-domain.atlassian.net/rest/api/3/permissionscheme/permission/10000"
-     *     }
-     *   ],
-     *   "self": "https://your-domain.atlassian.net/rest/api/3/permissionscheme/10000"
-     * }
-     * @path {GET} /rest/api/3/permissionscheme/{schemeId}
-     * @scopes-current read:jira-work
-     * @scopes-beta read:application-role:jira, read:field:jira, read:group:jira,
-     * read:permission-scheme:jira, read:permission:jira, read:project-role:jira,
-     * read:user:jira, read:avatar:jira, read:project-category:jira, read:project:jira
-     * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes#api-rest-api-3-permissionscheme-schemeid-get
-     */
-    getPermissionScheme({ schemeId, expand, }) {
-        return this.getClientInstance()
-            .request({
-            path: "/rest/api/3/permissionscheme/{schemeId}",
-            method: "GET",
-            pathParams: {
-                schemeId,
-            },
-            query: {
-                expand,
-            },
-        })
-            .then(this.getClientInstance().responseHandler({
-            200: {
-                "application/json": "json",
-            },
-        }))
-            .then(commonHttpClient.castResponse())
-            .then(validationSchemaStorage_1.validationSchemaStorage.validator("PermissionSchemesService.getPermissionScheme.response"))
-            .then(commonHttpClient.getBody);
-    }
-    /**
-     * Returns a permission grant.
-     *
-     * **[Permissions](#permissions) required:** Permission to access Jira.
-     *
-     * @returns Returned if the request is successful.
-     *
-     * example: {
-     *   "holder": {
-     *     "expand": "group",
-     *     "parameter": "jira-core-users",
-     *     "type": "group",
-     *     "value": "ca85fac0-d974-40ca-a615-7af99c48d24f"
-     *   },
-     *   "id": 10000,
-     *   "permission": "ADMINISTER_PROJECTS",
-     *   "self":
-     * "https://your-domain.atlassian.net/rest/api/3/permissionscheme/permission/10000"
-     * }
-     * @path {GET} /rest/api/3/permissionscheme/{schemeId}/permission/{permissionId}
-     * @scopes-current read:jira-work
-     * @scopes-beta read:application-role:jira, read:field:jira, read:group:jira,
-     * read:permission:jira, read:project-role:jira, read:user:jira
-     * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes#api-rest-api-3-permissionscheme-schemeid-permission-permissionid-get
-     */
-    getPermissionSchemeGrant({ schemeId, permissionId, expand, }) {
-        return this.getClientInstance()
-            .request({
-            path: "/rest/api/3/permissionscheme/{schemeId}/permission/{permissionId}",
-            method: "GET",
-            pathParams: {
-                schemeId,
-                permissionId,
-            },
-            query: {
-                expand,
-            },
-        })
-            .then(this.getClientInstance().responseHandler({
-            200: {
-                "application/json": "json",
-            },
-        }))
-            .then(commonHttpClient.castResponse())
-            .then(validationSchemaStorage_1.validationSchemaStorage.validator("PermissionSchemesService.getPermissionSchemeGrant.response"))
-            .then(commonHttpClient.getBody);
-    }
-    /**
-     * Returns all permission grants for a permission scheme.
-     *
-     * **[Permissions](#permissions) required:** Permission to access Jira.
-     *
-     * @returns Returned if the request is successful.
-     *
-     * example: {
-     *   "expand": "user,group,projectRole,field,all",
-     *   "permissions": [
-     *     {
-     *       "holder": {
-     *         "expand": "group",
-     *         "parameter": "jira-core-users",
-     *         "type": "group",
-     *         "value": "ca85fac0-d974-40ca-a615-7af99c48d24f"
-     *       },
-     *       "id": 10000,
-     *       "permission": "ADMINISTER_PROJECTS",
-     *       "self":
-     * "https://your-domain.atlassian.net/rest/api/3/permissionscheme/permission/10000"
-     *     }
-     *   ]
-     * }
-     * @path {GET} /rest/api/3/permissionscheme/{schemeId}/permission
-     * @scopes-current read:jira-work
-     * @scopes-beta read:application-role:jira, read:field:jira, read:group:jira,
-     * read:permission:jira, read:project-role:jira, read:user:jira
-     * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes#api-rest-api-3-permissionscheme-schemeid-permission-get
-     */
-    getPermissionSchemeGrants({ schemeId, expand, }) {
-        return this.getClientInstance()
-            .request({
-            path: "/rest/api/3/permissionscheme/{schemeId}/permission",
-            method: "GET",
-            pathParams: {
-                schemeId,
-            },
-            query: {
-                expand,
-            },
-        })
-            .then(this.getClientInstance().responseHandler({
-            200: {
-                "application/json": "json",
-            },
-        }))
-            .then(commonHttpClient.castResponse())
-            .then(validationSchemaStorage_1.validationSchemaStorage.validator("PermissionSchemesService.getPermissionSchemeGrants.response"))
-            .then(commonHttpClient.getBody);
-    }
-    /**
-     * Updates a permission scheme. Below are some important things to note when using
-     * this resource:
-     *
-     *  *  If a permissions list is present in the request, then it is set in the
-     * permission scheme, overwriting *all existing* grants.
-     *  *  If you want to update only the name and description, then do not send a
-     * permissions list in the request.
-     *  *  Sending an empty list will remove all permission grants from the permission
-     * scheme.
-     *
-     * If you want to add or delete a permission grant instead of updating the whole
-     * list, see [Create permission
-     * grant](#api-rest-api-3-permissionscheme-schemeId-permission-post) or [Delete
-     * permission scheme
-     * entity](#api-rest-api-3-permissionscheme-schemeId-permission-permissionId-delete).
-     *
-     * See [About permission schemes and
-     * grants](../api-group-permission-schemes/#about-permission-schemes-and-grants)
-     * for more details.
-     *
-     * **[Permissions](#permissions) required:** *Administer Jira* [global
-     * permission](https://confluence.atlassian.com/x/x4dKLg).
-     *
-     * @returns Returned if the scheme is updated.
-     *
-     * example: {
-     *   "description": "description",
-     *   "id": 10000,
-     *   "name": "Example permission scheme",
-     *   "permissions": [
-     *     {
-     *       "holder": {
-     *         "expand": "group",
-     *         "parameter": "jira-core-users",
-     *         "type": "group",
-     *         "value": "ca85fac0-d974-40ca-a615-7af99c48d24f"
-     *       },
-     *       "id": 10000,
-     *       "permission": "ADMINISTER_PROJECTS",
-     *       "self":
-     * "https://your-domain.atlassian.net/rest/api/3/permissionscheme/permission/10000"
-     *     }
-     *   ],
-     *   "self": "https://your-domain.atlassian.net/rest/api/3/permissionscheme/10000"
-     * }
-     * @path {PUT} /rest/api/3/permissionscheme/{schemeId}
-     * @scopes-current manage:jira-configuration
-     * @scopes-beta write:permission-scheme:jira, read:application-role:jira, read:field:jira,
-     * read:group:jira, read:permission-scheme:jira, read:permission:jira,
-     * read:project-role:jira, read:user:jira, read:avatar:jira,
-     * read:project-category:jira, read:project:jira
-     * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes#api-rest-api-3-permissionscheme-schemeid-put
-     */
-    updatePermissionScheme({ schemeId, expand, permissionScheme, }) {
-        return this.getClientInstance()
-            .request({
-            path: "/rest/api/3/permissionscheme/{schemeId}",
-            method: "PUT",
-            pathParams: {
-                schemeId,
-            },
-            query: {
-                expand,
-            },
-            headers: {
-                "Content-Type": "application/json",
-            },
-            body: permissionScheme,
-        })
-            .then(this.getClientInstance().responseHandler({
-            200: {
-                "application/json": "json",
-            },
-        }))
-            .then(commonHttpClient.castResponse())
-            .then(validationSchemaStorage_1.validationSchemaStorage.validator("PermissionSchemesService.updatePermissionScheme.response"))
-            .then(commonHttpClient.getBody);
+    constructor() {
+        super(...arguments);
+        /**
+         * Creates a permission grant in a permission scheme.
+         *
+         * **[Permissions](#permissions) required:** *Administer Jira* [global
+         * permission](https://confluence.atlassian.com/x/x4dKLg).
+         *
+         * @returns Returned if the scheme permission is created.
+         *
+         * example: {
+         *   "holder": {
+         *     "expand": "group",
+         *     "parameter": "jira-core-users",
+         *     "type": "group",
+         *     "value": "ca85fac0-d974-40ca-a615-7af99c48d24f"
+         *   },
+         *   "id": 10000,
+         *   "permission": "ADMINISTER_PROJECTS",
+         *   "self":
+         * "https://your-domain.atlassian.net/rest/api/3/permissionscheme/permission/10000"
+         * }
+         * @path {POST} /rest/api/3/permissionscheme/{schemeId}/permission
+         * @scopes-current manage:jira-configuration
+         * @scopes-beta read:application-role:jira, read:field:jira, read:group:jira,
+         * read:permission:jira, read:project-role:jira, read:user:jira,
+         * write:permission:jira
+         * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes#api-rest-api-3-permissionscheme-schemeid-permission-post
+         */
+        this.createPermissionGrant = ({ schemeId, expand, permissionGrant, }) => {
+            return this.getClientInstance()
+                .request({
+                path: "/rest/api/3/permissionscheme/{schemeId}/permission",
+                method: "POST",
+                pathParams: {
+                    schemeId,
+                },
+                query: {
+                    expand,
+                },
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: permissionGrant,
+            })
+                .then(this.getClientInstance().responseHandler({
+                201: {
+                    "application/json": "json",
+                },
+            }))
+                .then(commonHttpClient.castResponse())
+                .then(validationSchemaStorage_1.validationSchemaStorage.validator("PermissionSchemesService.createPermissionGrant.response"))
+                .then(commonHttpClient.getBody);
+        };
+        /**
+         * Creates a new permission scheme. You can create a permission scheme with or
+         * without defining a set of permission grants.
+         *
+         * **[Permissions](#permissions) required:** *Administer Jira* [global
+         * permission](https://confluence.atlassian.com/x/x4dKLg).
+         *
+         * @returns Returned if the permission scheme is created.
+         *
+         * example: {
+         *   "description": "description",
+         *   "id": 10000,
+         *   "name": "Example permission scheme",
+         *   "permissions": [
+         *     {
+         *       "holder": {
+         *         "expand": "group",
+         *         "parameter": "jira-core-users",
+         *         "type": "group",
+         *         "value": "ca85fac0-d974-40ca-a615-7af99c48d24f"
+         *       },
+         *       "id": 10000,
+         *       "permission": "ADMINISTER_PROJECTS",
+         *       "self":
+         * "https://your-domain.atlassian.net/rest/api/3/permissionscheme/permission/10000"
+         *     }
+         *   ],
+         *   "self": "https://your-domain.atlassian.net/rest/api/3/permissionscheme/10000"
+         * }
+         * @path {POST} /rest/api/3/permissionscheme
+         * @scopes-current manage:jira-configuration
+         * @scopes-beta write:permission-scheme:jira, read:application-role:jira, read:field:jira,
+         * read:group:jira, read:permission-scheme:jira, read:permission:jira,
+         * read:project-role:jira, read:user:jira, read:avatar:jira,
+         * read:project-category:jira, read:project:jira
+         * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes#api-rest-api-3-permissionscheme-post
+         */
+        this.createPermissionScheme = ({ expand, permissionScheme, }) => {
+            return this.getClientInstance()
+                .request({
+                path: "/rest/api/3/permissionscheme",
+                method: "POST",
+                query: {
+                    expand,
+                },
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: permissionScheme,
+            })
+                .then(this.getClientInstance().responseHandler({
+                201: {
+                    "application/json": "json",
+                },
+            }))
+                .then(commonHttpClient.castResponse())
+                .then(validationSchemaStorage_1.validationSchemaStorage.validator("PermissionSchemesService.createPermissionScheme.response"))
+                .then(commonHttpClient.getBody);
+        };
+        /**
+         * Deletes a permission scheme.
+         *
+         * **[Permissions](#permissions) required:** *Administer Jira* [global
+         * permission](https://confluence.atlassian.com/x/x4dKLg).
+         *
+         * @path {DELETE} /rest/api/3/permissionscheme/{schemeId}
+         * @scopes-current manage:jira-configuration
+         * @scopes-beta delete:permission-scheme:jira
+         * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes#api-rest-api-3-permissionscheme-schemeid-delete
+         */
+        this.deletePermissionScheme = ({ schemeId, }) => {
+            return this.getClientInstance()
+                .request({
+                path: "/rest/api/3/permissionscheme/{schemeId}",
+                method: "DELETE",
+                pathParams: {
+                    schemeId,
+                },
+            })
+                .then(commonHttpClient.discardResult);
+        };
+        /**
+         * Deletes a permission grant from a permission scheme. See [About permission
+         * schemes and
+         * grants](../api-group-permission-schemes/#about-permission-schemes-and-grants)
+         * for more details.
+         *
+         * **[Permissions](#permissions) required:** *Administer Jira* [global
+         * permission](https://confluence.atlassian.com/x/x4dKLg).
+         *
+         * @path {DELETE} /rest/api/3/permissionscheme/{schemeId}/permission/{permissionId}
+         * @scopes-current manage:jira-configuration
+         * @scopes-beta delete:permission:jira
+         * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes#api-rest-api-3-permissionscheme-schemeid-permission-permissionid-delete
+         */
+        this.deletePermissionSchemeEntity = ({ schemeId, permissionId, }) => {
+            return this.getClientInstance()
+                .request({
+                path: "/rest/api/3/permissionscheme/{schemeId}/permission/{permissionId}",
+                method: "DELETE",
+                pathParams: {
+                    schemeId,
+                    permissionId,
+                },
+            })
+                .then(commonHttpClient.discardResult);
+        };
+        /**
+         * Returns all permission schemes.
+         *
+         * ### About permission schemes and grants ###
+         *
+         * A permission scheme is a collection of permission grants. A permission grant
+         * consists of a `holder` and a `permission`.
+         *
+         * #### Holder object ####
+         *
+         * The `holder` object contains information about the user or group being granted
+         * the permission. For example, the *Administer projects* permission is granted to
+         * a group named *Teams in space administrators*. In this case, the type is
+         * `"type": "group"`, and the parameter is the group name, `"parameter": "Teams in
+         * space administrators"` and the value is group ID, `"value":
+         * "ca85fac0-d974-40ca-a615-7af99c48d24f"`.
+         *
+         * The `holder` object is defined by the following properties:
+         *
+         *  *  `type` Identifies the user or group (see the list of types below).
+         *  *  `parameter` As a group's name can change, use of `value` is recommended.
+         * The value of this property depends on the `type`. For example, if the `type` is
+         * a group, then you need to specify the group name.
+         *  *  `value` The value of this property depends on the `type`. If the `type` is
+         * a group, then you need to specify the group ID. For other `type` it has the
+         * same value as `parameter`
+         *
+         * The following `types` are available. The expected values for `parameter` and
+         * `value` are given in parentheses (some types may not have a `parameter` or
+         * `value`):
+         *
+         *  *  `anyone` Grant for anonymous users.
+         *  *  `applicationRole` Grant for users with access to the specified application
+         * (application name, application name). See [Update product access
+         * settings](https://confluence.atlassian.com/x/3YxjL) for more information.
+         *  *  `assignee` Grant for the user currently assigned to an issue.
+         *  *  `group` Grant for the specified group (`parameter` : group name, `value` :
+         * group ID).
+         *  *  `groupCustomField` Grant for a user in the group selected in the specified
+         * custom field (`parameter` : custom field ID, `value` : custom field ID).
+         *  *  `projectLead` Grant for a project lead.
+         *  *  `projectRole` Grant for the specified project role (`parameter` :project
+         * role ID, `value` : project role ID).
+         *  *  `reporter` Grant for the user who reported the issue.
+         *  *  `sd.customer.portal.only` Jira Service Desk only. Grants customers
+         * permission to access the customer portal but not Jira. See [Customizing Jira
+         * Service Desk permissions](https://confluence.atlassian.com/x/24dKLg) for more
+         * information.
+         *  *  `user` Grant for the specified user (`parameter` : user ID - historically
+         * this was the userkey but that is deprecated and the account ID should be used,
+         * `value` : user ID).
+         *  *  `userCustomField` Grant for a user selected in the specified custom field
+         * (`parameter` : custom field ID, `value` : custom field ID).
+         *
+         * #### Built-in permissions ####
+         *
+         * The [built-in Jira permissions](https://confluence.atlassian.com/x/yodKLg) are
+         * listed below. Apps can also define custom permissions. See the [project
+         * permission](https://developer.atlassian.com/cloud/jira/platform/modules/project-permission/)
+         * and [global
+         * permission](https://developer.atlassian.com/cloud/jira/platform/modules/global-permission/)
+         * module documentation for more information.
+         *
+         * **Project permissions**
+         *
+         *  *  `ADMINISTER_PROJECTS`
+         *  *  `BROWSE_PROJECTS`
+         *  *  `MANAGE_SPRINTS_PERMISSION` (Jira Software only)
+         *  *  `SERVICEDESK_AGENT` (Jira Service Desk only)
+         *  *  `VIEW_DEV_TOOLS` (Jira Software only)
+         *  *  `VIEW_READONLY_WORKFLOW`
+         *
+         * **Issue permissions**
+         *
+         *  *  `ASSIGNABLE_USER`
+         *  *  `ASSIGN_ISSUES`
+         *  *  `CLOSE_ISSUES`
+         *  *  `CREATE_ISSUES`
+         *  *  `DELETE_ISSUES`
+         *  *  `EDIT_ISSUES`
+         *  *  `LINK_ISSUES`
+         *  *  `MODIFY_REPORTER`
+         *  *  `MOVE_ISSUES`
+         *  *  `RESOLVE_ISSUES`
+         *  *  `SCHEDULE_ISSUES`
+         *  *  `SET_ISSUE_SECURITY`
+         *  *  `TRANSITION_ISSUES`
+         *
+         * **Voters and watchers permissions**
+         *
+         *  *  `MANAGE_WATCHERS`
+         *  *  `VIEW_VOTERS_AND_WATCHERS`
+         *
+         * **Comments permissions**
+         *
+         *  *  `ADD_COMMENTS`
+         *  *  `DELETE_ALL_COMMENTS`
+         *  *  `DELETE_OWN_COMMENTS`
+         *  *  `EDIT_ALL_COMMENTS`
+         *  *  `EDIT_OWN_COMMENTS`
+         *
+         * **Attachments permissions**
+         *
+         *  *  `CREATE_ATTACHMENTS`
+         *  *  `DELETE_ALL_ATTACHMENTS`
+         *  *  `DELETE_OWN_ATTACHMENTS`
+         *
+         * **Time tracking permissions**
+         *
+         *  *  `DELETE_ALL_WORKLOGS`
+         *  *  `DELETE_OWN_WORKLOGS`
+         *  *  `EDIT_ALL_WORKLOGS`
+         *  *  `EDIT_OWN_WORKLOGS`
+         *  *  `WORK_ON_ISSUES`
+         *
+         * **[Permissions](#permissions) required:** Permission to access Jira.
+         *
+         * @returns Returned if the request is successful.
+         *
+         * example: {
+         *   "permissionSchemes": [
+         *     {
+         *       "description": "description",
+         *       "id": 10000,
+         *       "name": "Example permission scheme",
+         *       "self":
+         * "https://your-domain.atlassian.net/rest/api/3/permissionscheme/10000"
+         *     }
+         *   ]
+         * }
+         * @path {GET} /rest/api/3/permissionscheme
+         * @scopes-current read:jira-work
+         * @scopes-beta read:application-role:jira, read:field:jira, read:group:jira,
+         * read:permission-scheme:jira, read:permission:jira, read:project-role:jira,
+         * read:user:jira, read:avatar:jira, read:project-category:jira, read:project:jira
+         * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes#api-rest-api-3-permissionscheme-get
+         */
+        this.getAllPermissionSchemes = ({ expand, } = {}) => {
+            return this.getClientInstance()
+                .request({
+                path: "/rest/api/3/permissionscheme",
+                method: "GET",
+                query: {
+                    expand,
+                },
+            })
+                .then(this.getClientInstance().responseHandler({
+                200: {
+                    "application/json": "json",
+                },
+            }))
+                .then(commonHttpClient.castResponse())
+                .then(validationSchemaStorage_1.validationSchemaStorage.validator("PermissionSchemesService.getAllPermissionSchemes.response"))
+                .then(commonHttpClient.getBody);
+        };
+        /**
+         * Returns a permission scheme.
+         *
+         * **[Permissions](#permissions) required:** Permission to access Jira.
+         *
+         * @returns Returned if the request is successful.
+         *
+         * example: {
+         *   "description": "description",
+         *   "id": 10000,
+         *   "name": "Example permission scheme",
+         *   "permissions": [
+         *     {
+         *       "holder": {
+         *         "expand": "group",
+         *         "parameter": "jira-core-users",
+         *         "type": "group",
+         *         "value": "ca85fac0-d974-40ca-a615-7af99c48d24f"
+         *       },
+         *       "id": 10000,
+         *       "permission": "ADMINISTER_PROJECTS",
+         *       "self":
+         * "https://your-domain.atlassian.net/rest/api/3/permissionscheme/permission/10000"
+         *     }
+         *   ],
+         *   "self": "https://your-domain.atlassian.net/rest/api/3/permissionscheme/10000"
+         * }
+         * @path {GET} /rest/api/3/permissionscheme/{schemeId}
+         * @scopes-current read:jira-work
+         * @scopes-beta read:application-role:jira, read:field:jira, read:group:jira,
+         * read:permission-scheme:jira, read:permission:jira, read:project-role:jira,
+         * read:user:jira, read:avatar:jira, read:project-category:jira, read:project:jira
+         * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes#api-rest-api-3-permissionscheme-schemeid-get
+         */
+        this.getPermissionScheme = ({ schemeId, expand, }) => {
+            return this.getClientInstance()
+                .request({
+                path: "/rest/api/3/permissionscheme/{schemeId}",
+                method: "GET",
+                pathParams: {
+                    schemeId,
+                },
+                query: {
+                    expand,
+                },
+            })
+                .then(this.getClientInstance().responseHandler({
+                200: {
+                    "application/json": "json",
+                },
+            }))
+                .then(commonHttpClient.castResponse())
+                .then(validationSchemaStorage_1.validationSchemaStorage.validator("PermissionSchemesService.getPermissionScheme.response"))
+                .then(commonHttpClient.getBody);
+        };
+        /**
+         * Returns a permission grant.
+         *
+         * **[Permissions](#permissions) required:** Permission to access Jira.
+         *
+         * @returns Returned if the request is successful.
+         *
+         * example: {
+         *   "holder": {
+         *     "expand": "group",
+         *     "parameter": "jira-core-users",
+         *     "type": "group",
+         *     "value": "ca85fac0-d974-40ca-a615-7af99c48d24f"
+         *   },
+         *   "id": 10000,
+         *   "permission": "ADMINISTER_PROJECTS",
+         *   "self":
+         * "https://your-domain.atlassian.net/rest/api/3/permissionscheme/permission/10000"
+         * }
+         * @path {GET} /rest/api/3/permissionscheme/{schemeId}/permission/{permissionId}
+         * @scopes-current read:jira-work
+         * @scopes-beta read:application-role:jira, read:field:jira, read:group:jira,
+         * read:permission:jira, read:project-role:jira, read:user:jira
+         * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes#api-rest-api-3-permissionscheme-schemeid-permission-permissionid-get
+         */
+        this.getPermissionSchemeGrant = ({ schemeId, permissionId, expand, }) => {
+            return this.getClientInstance()
+                .request({
+                path: "/rest/api/3/permissionscheme/{schemeId}/permission/{permissionId}",
+                method: "GET",
+                pathParams: {
+                    schemeId,
+                    permissionId,
+                },
+                query: {
+                    expand,
+                },
+            })
+                .then(this.getClientInstance().responseHandler({
+                200: {
+                    "application/json": "json",
+                },
+            }))
+                .then(commonHttpClient.castResponse())
+                .then(validationSchemaStorage_1.validationSchemaStorage.validator("PermissionSchemesService.getPermissionSchemeGrant.response"))
+                .then(commonHttpClient.getBody);
+        };
+        /**
+         * Returns all permission grants for a permission scheme.
+         *
+         * **[Permissions](#permissions) required:** Permission to access Jira.
+         *
+         * @returns Returned if the request is successful.
+         *
+         * example: {
+         *   "expand": "user,group,projectRole,field,all",
+         *   "permissions": [
+         *     {
+         *       "holder": {
+         *         "expand": "group",
+         *         "parameter": "jira-core-users",
+         *         "type": "group",
+         *         "value": "ca85fac0-d974-40ca-a615-7af99c48d24f"
+         *       },
+         *       "id": 10000,
+         *       "permission": "ADMINISTER_PROJECTS",
+         *       "self":
+         * "https://your-domain.atlassian.net/rest/api/3/permissionscheme/permission/10000"
+         *     }
+         *   ]
+         * }
+         * @path {GET} /rest/api/3/permissionscheme/{schemeId}/permission
+         * @scopes-current read:jira-work
+         * @scopes-beta read:application-role:jira, read:field:jira, read:group:jira,
+         * read:permission:jira, read:project-role:jira, read:user:jira
+         * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes#api-rest-api-3-permissionscheme-schemeid-permission-get
+         */
+        this.getPermissionSchemeGrants = ({ schemeId, expand, }) => {
+            return this.getClientInstance()
+                .request({
+                path: "/rest/api/3/permissionscheme/{schemeId}/permission",
+                method: "GET",
+                pathParams: {
+                    schemeId,
+                },
+                query: {
+                    expand,
+                },
+            })
+                .then(this.getClientInstance().responseHandler({
+                200: {
+                    "application/json": "json",
+                },
+            }))
+                .then(commonHttpClient.castResponse())
+                .then(validationSchemaStorage_1.validationSchemaStorage.validator("PermissionSchemesService.getPermissionSchemeGrants.response"))
+                .then(commonHttpClient.getBody);
+        };
+        /**
+         * Updates a permission scheme. Below are some important things to note when using
+         * this resource:
+         *
+         *  *  If a permissions list is present in the request, then it is set in the
+         * permission scheme, overwriting *all existing* grants.
+         *  *  If you want to update only the name and description, then do not send a
+         * permissions list in the request.
+         *  *  Sending an empty list will remove all permission grants from the permission
+         * scheme.
+         *
+         * If you want to add or delete a permission grant instead of updating the whole
+         * list, see [Create permission
+         * grant](#api-rest-api-3-permissionscheme-schemeId-permission-post) or [Delete
+         * permission scheme
+         * entity](#api-rest-api-3-permissionscheme-schemeId-permission-permissionId-delete).
+         *
+         * See [About permission schemes and
+         * grants](../api-group-permission-schemes/#about-permission-schemes-and-grants)
+         * for more details.
+         *
+         * **[Permissions](#permissions) required:** *Administer Jira* [global
+         * permission](https://confluence.atlassian.com/x/x4dKLg).
+         *
+         * @returns Returned if the scheme is updated.
+         *
+         * example: {
+         *   "description": "description",
+         *   "id": 10000,
+         *   "name": "Example permission scheme",
+         *   "permissions": [
+         *     {
+         *       "holder": {
+         *         "expand": "group",
+         *         "parameter": "jira-core-users",
+         *         "type": "group",
+         *         "value": "ca85fac0-d974-40ca-a615-7af99c48d24f"
+         *       },
+         *       "id": 10000,
+         *       "permission": "ADMINISTER_PROJECTS",
+         *       "self":
+         * "https://your-domain.atlassian.net/rest/api/3/permissionscheme/permission/10000"
+         *     }
+         *   ],
+         *   "self": "https://your-domain.atlassian.net/rest/api/3/permissionscheme/10000"
+         * }
+         * @path {PUT} /rest/api/3/permissionscheme/{schemeId}
+         * @scopes-current manage:jira-configuration
+         * @scopes-beta write:permission-scheme:jira, read:application-role:jira, read:field:jira,
+         * read:group:jira, read:permission-scheme:jira, read:permission:jira,
+         * read:project-role:jira, read:user:jira, read:avatar:jira,
+         * read:project-category:jira, read:project:jira
+         * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permission-schemes#api-rest-api-3-permissionscheme-schemeid-put
+         */
+        this.updatePermissionScheme = ({ schemeId, expand, permissionScheme, }) => {
+            return this.getClientInstance()
+                .request({
+                path: "/rest/api/3/permissionscheme/{schemeId}",
+                method: "PUT",
+                pathParams: {
+                    schemeId,
+                },
+                query: {
+                    expand,
+                },
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: permissionScheme,
+            })
+                .then(this.getClientInstance().responseHandler({
+                200: {
+                    "application/json": "json",
+                },
+            }))
+                .then(commonHttpClient.castResponse())
+                .then(validationSchemaStorage_1.validationSchemaStorage.validator("PermissionSchemesService.updatePermissionScheme.response"))
+                .then(commonHttpClient.getBody);
+        };
     }
     static initialize() {
         validationSchemaStorage_1.validationSchemaStorage.registerExtensible("PermissionSchemesService.getAllPermissionSchemes.response", zod_1.z