action atlassian_get_project_role_by_id {
  label: "Get project role by ID"
  description: "Gets the project role details and the default actors associated with the role. The list of default actors is sorted by display name.\n\n**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg)."
  provider: atlassian
  method: GET
  path: "/rest/api/3/role/{id}"
  encoding: json
  input: {
    type: "object"
    properties: {
      id: {
        type: "integer"
        format: "int64"
      }
    }
    required: ["id"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "Details about the roles in a project."
    properties: {
      actors: {
        type: "array"
        description: "The list of users who act in this role."
        items: {
          type: "object"
          description: "Details about a user assigned to a project role."
          properties: {
            actorGroup: {
              type: "object"
            }
            actorUser: {
              type: "object"
            }
            avatarUrl: {
              type: "string"
              format: "uri"
              description: "The avatar of the role actor."
            }
            displayName: {
              type: "string"
              description: "The display name of the role actor. For users, depending on the user’s privacy setting, this may return an alternative value for the user's name."
            }
            id: {
              type: "integer"
              format: "int64"
              description: "The ID of the role actor."
            }
            name: {
              type: "string"
              description: "This property is no longer available and will be removed from the documentation soon. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details."
            }
            type: {
              type: "string"
              description: "The type of role actor."
              enum: ["atlassian-group-role-actor", "atlassian-user-role-actor"]
            }
          }
          additionalProperties: false
        }
      }
      admin: {
        type: "boolean"
        description: "Whether this role is the admin role for the project."
      }
      currentUserRole: {
        type: "boolean"
        description: "Whether the calling user is part of this role."
      }
      default: {
        type: "boolean"
        description: "Whether this role is the default role for the project"
      }
      description: {
        type: "string"
        description: "The description of the project role."
      }
      id: {
        type: "integer"
        format: "int64"
        description: "The ID of the project role."
      }
      name: {
        type: "string"
        description: "The name of the project role."
      }
      roleConfigurable: {
        type: "boolean"
        description: "Whether the roles are configurable for this project."
      }
      scope: {
        description: "The scope of the role. Indicated for roles associated with [next-gen projects](https://confluence.atlassian.com/x/loMyO)."
        type: "object"
      }
      self: {
        type: "string"
        format: "uri"
        description: "The URL the project role details."
      }
      translatedName: {
        type: "string"
        description: "The translated name of the project role."
      }
    }
    additionalProperties: false
  }
}