Rolebase Developers
API Reference

member

Represents a member of an organization. Members can be assigned to roles, and participate in meetings and tasks.

Fields

FieldTypeDescription
iduuidUnique identifier for the member
orgIduuidReference to the organization
nameStringDisplay name of the member
descriptionStringDescription or bio of the member
archivedBooleanWhether the member is archived (default: false)
pictureStringURL of the member’s profile picture (optional)
pictureFileIduuidReference to the stored profile picture file (optional)
userIduuidReference to the associated user account (optional)
inviteEmailStringEmail address used for invitation (optional)
inviteDateTimestampWhen the invitation was sent (optional)
roleMember_Role_EnumMember’s role in the organization: Owner, Admin, Member, or Readonly

Relationships

Object Relationships:

  • org — The organization this member belongs to
  • pictureFile — The stored profile picture file
  • user — The associated user account

Array Relationships:

  • circle_members — Circle memberships
  • meeting_attendees — Meeting attendance records

Query Examples

List Members of an Organization

query GetMembers($orgId: uuid!) {
  member(where: { orgId: { _eq: $orgId } }) {
    id
    name
    description
    role
    circle_members {
      circle {
        name
      }
    }
  }
}

Get a Specific Member

query GetMember($id: uuid!) {
  member_by_pk(id: $id) {
    id
    name
  }
}

Mutation Examples

Create a Member

mutation CreateMember {
  insert_member_one(
    object: {
      name: "John Doe"
      description: "Software Engineer"
      orgId: "your-org-id"
    }
  ) {
    id
    name
    role
  }
}

Update a Member

mutation UpdateMember {
  update_member_by_pk(
    pk_columns: { id: "member-id" }
    _set: { name: "Jane Doe", description: "Senior Engineer" }
  ) {
    id
    name
    description
  }
}

Permissions

  • Owner/Admin: Can create, update, and archive members
  • All organization members can view member information within their organization
Info Circle Notes

The combination of orgId and userId must be unique. When a member is invited, inviteEmail and inviteDate are set. Once the invitation is accepted, userId is linked to the user account.