circle_member

Fields

Field	Type	Description
id	uuid	Unique identifier for the circle membership
circleId	uuid	Reference to the circle
memberId	uuid	Reference to the member
createdAt	Timestamp	When the membership was created
archived	Boolean	Whether the membership is archived (default: false)

Relationships

Object Relationships:

• circle — The circle this membership belongs to
• member — The member associated with this circle membership

Query Examples

Get Members of a Specific Circle

query GetCircleMembers($circleId: uuid!) {
  circle_member(
    where: { circleId: { _eq: $circleId }, archived: { _eq: false } }
  ) {
    id
    circle {
      id
      role {
        name
      }
    }
    member {
      id
      name
      description
    }
    createdAt
  }
}

Mutation Examples

Add a Member to a Circle

mutation AddCircleMember {
  insert_circle_member_one(
    object: { circleId: "circle-id", memberId: "member-id" }
  ) {
    id
    circle {
      id
      role {
        name
      }
    }
    member {
      name
    }
  }
}

Archive a Circle Membership

mutation UpdateCircleMember {
  update_circle_member_by_pk(
    pk_columns: { id: "circle-member-id" }
    _set: { archived: true }
  ) {
    id
    archived
  }
}

Permissions

• Organization owners and admins: Can add and remove members from any circle
• Circle leaders: Can manage members in their circles
• Members: Can view circle memberships in circles they belong to
• A member cannot be added to a circle if they already have an active membership