# Membres de l'équipe

> Lister les membres de ton espace de travail avec leurs ids et leurs rôles, et utiliser ces ids pour attribuer des leads depuis ton CRM.

Source: https://docs.whatsetter.com/fr/developers/guides/team/

Un membre de l'équipe, c'est une personne qui a accès à ton espace de travail WhatSetter. L'API les liste pour que tes outils puissent mettre un nom sur un propriétaire et attribuer des leads par id.

## Endpoints

| Méthode | Chemin | Scope |
|---|---|---|
| GET | [`/team/members`](/api-reference/operations/listteammembers/) | `team:read` |

## Lister les membres

**cURL**

```bash
curl "https://app.whatsetter.com/api/v1/team/members" \
  -H "Authorization: Bearer ws_live_…"
```

**JavaScript**

```js
const res = await fetch('https://app.whatsetter.com/api/v1/team/members', {
  headers: { Authorization: 'Bearer ws_live_…' },
});
const { data: members } = await res.json();
```

**Python**

```python
import requests

r = requests.get(
    "https://app.whatsetter.com/api/v1/team/members",
    headers={"Authorization": "Bearer ws_live_…"},
)
members = r.json()["data"]
```

```json
{
  "data": [
    {
      "id": "66a1b2c3d4e5f6a7b8c9d0e1",
      "name": "Julien Martin",
      "email": "julien@acme.com",
      "role": "editor",
      "is_owner": false
    },
    {
      "id": "66a1b2c3d4e5f6a7b8c9d0e2",
      "name": "Marie Dupont",
      "email": "marie@acme.com",
      "role": "owner",
      "is_owner": true
    }
  ]
}
```

Pas de pagination : les équipes sont petites, et un espace de travail contient 200 membres au maximum. La source est la même liste d'adhésions que la page **Équipe** du dashboard.

## Attribuer des leads avec ces ids

`id` est ce que [`PATCH /leads/{id}`](/fr/developers/guides/leads/) attend dans `assigned_to` :

```bash
curl -X PATCH "https://app.whatsetter.com/api/v1/leads/66f1a2b3c4d5e6f7a8b9c0d1" \
  -H "Authorization: Bearer ws_live_…" \
  -H "Content-Type: application/json" \
  -d '{"assigned_to":"66a1b2c3d4e5f6a7b8c9d0e1"}'
```

Un id qui n'est pas membre de l'espace de travail répond `422 validation_error`. Mets la liste en cache de ton côté et rafraîchis-la quand une attribution échoue : quelqu'un a peut-être quitté l'équipe.

## Ce que signifie le rôle

`role` est le préréglage du dashboard auquel correspondent les permissions du membre : `owner`, `admin`, `editor`, `responder`, `viewer`, ou `custom` quand les permissions ont été ajustées à la main. `is_owner` vaut `true` pour la personne propriétaire de l'espace de travail. Les personnes invitées mais pas encore confirmées ne sont pas listées : elles ne peuvent pas posséder un lead. Le propriétaire vient en premier, puis les noms par ordre alphabétique.

| Rôle | En deux mots |
|---|---|
| `owner` | Tout, y compris la facturation et la suppression de l'espace de travail. |
| `admin` | Gère les campagnes, l'équipe et les intégrations, pas la facturation. |
| `editor` | Le quotidien : campagnes, conversations, leads. |
| `responder` | Répond aux conversations et gère les leads de son périmètre. |
| `viewer` | Lit tout, ne modifie rien. |
| `custom` | Permissions ajustées à la main dans le dashboard. |

Les permissions sont appliquées côté serveur sur chaque action du dashboard. La clé API a ses propres scopes et n'hérite du rôle d'aucun membre. Voir [Équipe et rôles](/fr/dashboard/team/) pour le détail.

## Les erreurs que tu rencontreras

| HTTP | `code` | Quand |
|---|---|---|
| 401 | `missing_api_key`, `invalid_api_key` | Clé absente, inconnue ou révoquée. |
| 403 | `insufficient_scope` | La clé n'a pas `team:read`. |
| 429 | `rate_limited` | Trop de requêtes cette minute. Respecte `Retry-After`. |

## Voir aussi

- [Leads : attribuer un propriétaire](/fr/developers/guides/leads/)
- [Équipe et rôles dans le dashboard](/fr/dashboard/team/)
- [Authentification et scopes](/fr/developers/authentication/)
