action atlassian_get_permission_scheme_grants {
  label: "Get permission scheme grants"
  description: "Returns all permission grants for a permission scheme.\n\n**[Permissions](#permissions) required:** Permission to access Jira."
  provider: atlassian
  method: GET
  path: "/rest/api/3/permissionscheme/{schemeId}/permission"
  encoding: json
  input: {
    type: "object"
    properties: {
      expand: {
        type: "string"
      }
      schemeId: {
        type: "integer"
        format: "int64"
      }
    }
    required: ["schemeId"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "List of permission grants."
    properties: {
      expand: {
        type: "string"
        description: "Expand options that include additional permission grant details in the response."
      }
      permissions: {
        type: "array"
        description: "Permission grants list."
        items: {
          type: "object"
          description: "Details about a permission granted to a user or group."
          properties: {
            holder: {
              description: "The user or group being granted the permission. It consists of a `type`, a type-dependent `parameter` and a type-dependent `value`. See [Holder object](../api-group-permission-schemes/#holder-object) in *Get all permission schemes* for more information."
              type: "object"
            }
            id: {
              type: "integer"
              format: "int64"
              description: "The ID of the permission granted details."
            }
            permission: {
              type: "string"
              description: "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](../api-group-permission-schemes/#built-in-permissions) in *Get all permission schemes* for more information about the built-in 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 about custom permissions."
            }
            self: {
              type: "string"
              format: "uri"
              description: "The URL of the permission granted details."
            }
          }
          additionalProperties: false
        }
      }
    }
    additionalProperties: false
  }
}