---
title: "Member"
url: "https://rolebase.io/en/api/member"
---

[Rolebase](/) ⟩ [API Reference](/en/api)

 API Reference

# `member`

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

## Fields

Field

Type

Description

`id`

`uuid`

Unique identifier for the member

`orgId`

`uuid`

Reference to the organization

`name`

`String`

Display name of the member

`description`

`String`

Description or bio of the member

`archived`

`Boolean`

Whether the member is archived (default: false)

`picture`

`String`

URL of the member’s profile picture (optional)

`pictureFileId`

`uuid`

Reference to the stored profile picture file (optional)

`userId`

`uuid`

Reference to the associated user account (optional)

`inviteEmail`

`String`

Email address used for invitation (optional)

`inviteDate`

`Timestamp`

When the invitation was sent (optional)

`role`

`Member_Role_Enum`

Member’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

** 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.