Docs/User API/Roles/Object

The role object

A member's role within an organization.

  • id

    string

    The system-assigned identifier of the role.

  • uniqueId

    string

    The client defined unique identifier of the role.

    It is restricted to letters, numbers, underscores, and hyphens, with the first character a letter or a number, and a 255 character maximum.

    ID's starting with role_ are reserved.

  • displayName

    string

    The human-readable display name of the role.

  • type

    enum

    The role type.

    Possible values:
    OWNERMEMBERGUEST
  • description

    string

    The description of the role.

    The maximum length is 1000 characters.

  • seatPolicy

    enum

    The policy that defines how a member is assigned a seat.

    Possible values:
    DEFAULTMANUAL
  • permissionSets

    string[]

    The additional permissions allowed by the role.

  • default

    boolean

    Whether the role is the default for the tenant.

PreviousRoles
NextList roles

Build software thatmonetizes
$

Subscribe to monthly product updates

© 2025 UserHub

Integrations

    UserHub & Auth0UserHub & Stripe BillingUserHub & Google CloudUserHub & FirebaseUserHub & custom auth