action atlassian_get_permission_scheme {
  label: "Get permission scheme"
  description: "Returns a permission scheme.\n\n**[Permissions](#permissions) required:** Permission to access Jira."
  provider: atlassian
  method: GET
  path: "/rest/api/3/permissionscheme/{schemeId}"
  encoding: json
  input: {
    type: "object"
    properties: {
      expand: {
        type: "string"
      }
      schemeId: {
        type: "integer"
        format: "int64"
      }
    }
    required: ["schemeId"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "Details of a permission scheme."
    required: ["name"]
    properties: {
      description: {
        type: "string"
        description: "A description for the permission scheme."
      }
      expand: {
        type: "string"
        description: "The expand options available for the permission scheme."
      }
      id: {
        type: "integer"
        format: "int64"
        description: "The ID of the permission scheme."
      }
      name: {
        type: "string"
        description: "The name of the permission scheme. Must be unique."
      }
      permissions: {
        type: "array"
        description: "The permission scheme to create or update. See [About permission schemes and grants](../api-group-permission-schemes/#about-permission-schemes-and-grants) for more information."
        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
        }
      }
      scope: {
        description: "The scope of the permission scheme."
        type: "object"
      }
      self: {
        type: "string"
        format: "uri"
        description: "The URL of the permission scheme."
      }
    }
  }
}