---
title: "member | GraphQL API | Rolebase"
description: "Member, represents a member of an organization. Members can be assigned to roles, and participate in meetings and tasks."
url: "https://rolebase.io/en/developers/graphql-api/member"
---

[Rolebase](/) ⟩[Developers](/en/developers) ⟩[GraphQL API](/en/developers/graphql-api)

# member

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

`archivedAt`

`Timestamp`

When the member was archived; null if active

`createdAt`

`Timestamp`

When the member was created

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