---
title: "Membre de cercle"
url: "https://rolebase.io/fr/api/circle_member"
---

[Rolebase](/) ⟩ [Référence API](/fr/api)

 Référence API

# `circle_member`

Représente une relation d'appartenance entre un membre et un cercle, avec suivi du statut d'association et de l'historique.

## Champs

Champ

Type

Description

`id`

`uuid`

Identifiant unique de l’appartenance au cercle

`circleId`

`uuid`

Référence au cercle

`memberId`

`uuid`

Référence au membre

`createdAt`

`Timestamp`

Date de création de l’appartenance

`archived`

`Boolean`

Indique si l’appartenance est archivée (par défaut : false)

## Relations

**Relations objet :**

*   `circle` — Le cercle auquel cette appartenance se rapporte
*   `member` — Le membre associé à cette appartenance au cercle

## Exemples de requêtes

### Obtenir les membres d’un cercle spécifique

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

## Exemples de mutations

### Ajouter un membre à un cercle

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

### Archiver une appartenance à un cercle

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

## Permissions

*   **Propriétaires et administrateurs de l’organisation :** Peuvent ajouter et retirer des membres de n’importe quel cercle
*   **Leaders de cercle :** Peuvent gérer les membres de leurs cercles
*   **Membres :** Peuvent consulter les appartenances aux cercles auxquels ils appartiennent
*   Un membre ne peut pas être ajouté à un cercle s’il a déjà une appartenance active

** Notes**

L’indicateur `archived` préserve l’historique des appartenances tout en marquant les appartenances inactives. L’appartenance à un cercle détermine l’accès aux ressources du cercle comme les réunions, tâches et décisions. Les membres peuvent appartenir à plusieurs cercles simultanément.