# Gérer les équipes

> Créer des équipes dans un client, y ajouter des membres avec un niveau d'équipe et des droits d'équipe, changer ces niveaux et supprimer une équipe.

Une [équipe](/v1.0/glossaire#équipe) regroupe des utilisateurs d'un même client : un service, un site, un groupe projet. Chaque membre y a un niveau, et éventuellement des droits d'équipe que votre application interprète. Le modèle est expliqué dans [Équipes et droits d'équipe](/v1.0/droits-et-profils/equipes-et-droits-d-equipe).

## Avant de commencer

- Vous appelez l'API avec une [clé API](/v1.0/cles-api) ou le jeton d'un administrateur, de niveau Administrateur client au moins.
- Droits nécessaires : `teams.read` pour lire, `teams.create`, `teams.update`, `teams.delete` pour gérer les équipes, `teams.members.add` pour gérer leurs membres.
- Renommer une équipe exige en plus d'en être membre au niveau `ADMIN` ou `MANAGER` ; la supprimer, au niveau `ADMIN`. Ces deux opérations se font donc avec le jeton d'un utilisateur membre.

## Créer une équipe

::endpoint{method="POST" path="/api/config/teams"}

```bash
curl -X POST "https://api.wakastart.app/api/config/teams" \
  -H "x-api-key: sk_test_exemple" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Secrétariat Lyon", "description": "Accueil et prise de rendez-vous" }'
```

```ts
const response = await fetch("https://api.wakastart.app/api/config/teams", {
  method: "POST",
  headers: { "x-api-key": process.env.WAKASTART_API_KEY!, "Content-Type": "application/json" },
  body: JSON.stringify({ name: "Secrétariat Lyon", description: "Accueil et prise de rendez-vous" }),
});
const team = await response.json();
```

Réponse attendue (extrait) :

```json
{ "id": "4e5f6a7b-8c9d-4e0f-9a1b-2c3d4e5f6a7b", "wid": "Tm3qX7", "name": "Secrétariat Lyon" }
```

L'équipe est créée dans votre client (`customerId` permet d'en viser un autre de votre périmètre). Le nom fait 100 caractères au plus. Le créateur n'est pas ajouté automatiquement comme membre.

## Ajouter un membre

::endpoint{method="POST" path="/api/config/teams/{wid}/members"}

| Champ | Obligatoire | Description |
|---|---|---|
| `userId` | oui | UUID de l'utilisateur (champ `id` de la liste des utilisateurs) |
| `teamLevel` | non | `ADMIN`, `MANAGER`, `MEMBER` (par défaut), `CONTRIBUTOR`, `VIEWER` ou `NONE` |
| `appRights` | non | Droits d'équipe : de 0 à 52 lettres `A-Z` et `a-z`, par exemple `"RW"` |

```bash
curl -X POST "https://api.wakastart.app/api/config/teams/Tm3qX7/members" \
  -H "x-api-key: sk_test_exemple" \
  -H "Content-Type: application/json" \
  -d '{ "userId": "8b9c0d1e-2f3a-4b4c-9d5e-6f7a8b9c0d1e", "teamLevel": "MANAGER", "appRights": "RW" }'
```

```ts
await fetch("https://api.wakastart.app/api/config/teams/Tm3qX7/members", {
  method: "POST",
  headers: { "x-api-key": process.env.WAKASTART_API_KEY!, "Content-Type": "application/json" },
  body: JSON.stringify({
    userId: "8b9c0d1e-2f3a-4b4c-9d5e-6f7a8b9c0d1e",
    teamLevel: "MANAGER",
    appRights: "RW",
  }),
});
```

Réponse attendue : le membre ajouté. Un utilisateur déjà membre renvoie 409.

## Changer le niveau d'un membre

::endpoint{method="PATCH" path="/api/config/teams/{teamWid}/members/{userWid}/role"}

```bash
curl -X PATCH "https://api.wakastart.app/api/config/teams/Tm3qX7/members/Us2mK6/role" \
  -H "x-api-key: sk_test_exemple" \
  -H "Content-Type: application/json" \
  -d '{ "teamLevel": "MEMBER", "appRights": "R" }'
```

`teamLevel` est obligatoire, `appRights` facultatif. Le nouveau niveau est pris en compte à la prochaine émission de jeton enrichi de l'utilisateur.

## Retirer un membre

::endpoint{method="DELETE" path="/api/config/teams/{teamWid}/members/{userWid}"}

```bash
curl -X DELETE "https://api.wakastart.app/api/config/teams/Tm3qX7/members/Us2mK6" \
  -H "x-api-key: sk_test_exemple"
```

## Renommer ou supprimer une équipe

::endpoint{method="PUT" path="/api/config/teams/{wid}"}

::endpoint{method="DELETE" path="/api/config/teams/{wid}"}

`PUT` accepte `name` et `description`. `DELETE` supprime l'équipe et toutes ses appartenances ; les utilisateurs, eux, sont conservés. Avec un niveau d'équipe insuffisant, l'API répond « Vous n'avez pas les droits pour modifier cette équipe » ou « Vous n'avez pas les droits pour supprimer cette équipe ».

## Vérifier le résultat

`GET /api/config/teams/Tm3qX7/members` liste les membres avec leur niveau et leurs droits d'équipe. `GET /api/config/teams` affiche le nombre de membres de chaque équipe.

## Voir aussi

- [Équipes et droits d'équipe](/v1.0/droits-et-profils/equipes-et-droits-d-equipe)
- [Référence API des équipes](/v1.0/reference-api/equipes)
