# Miembros del equipo

> Listar los miembros de tu espacio de trabajo con sus ids y sus roles, y usar esos ids para asignar leads desde tu CRM.

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

Un miembro del equipo es una persona con acceso a tu espacio de trabajo de WhatSetter. La API los lista para que tus herramientas puedan poner nombre a un responsable y asignar leads por id.

## Endpoints

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

## Listar miembros

**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
    }
  ]
}
```

No hay paginación: los equipos son pequeños, y un espacio de trabajo admite como máximo 200 miembros. La fuente es la misma lista de pertenencias que muestra la página **Equipo** del dashboard.

## Asignar leads con estos ids

`id` es lo que [`PATCH /leads/{id}`](/es/developers/guides/leads/) espera en `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 que no es miembro del espacio de trabajo responde `422 validation_error`. Guarda la lista en caché por tu lado y refréscala cuando una asignación falle: puede que alguien haya dejado el equipo.

## Qué significa el rol

`role` es el preajuste del dashboard al que corresponden los permisos del miembro: `owner`, `admin`, `editor`, `responder`, `viewer`, o `custom` cuando los permisos se ajustaron a mano. `is_owner` es `true` para la persona propietaria del espacio de trabajo. Las personas invitadas pero aún no confirmadas no aparecen: no pueden ser responsables de un lead. Primero el propietario, luego los nombres por orden alfabético.

| Rol | En dos palabras |
|---|---|
| `owner` | Todo, incluida la facturación y la eliminación del espacio de trabajo. |
| `admin` | Gestiona campañas, equipo e integraciones, no la facturación. |
| `editor` | El día a día: campañas, conversaciones, leads. |
| `responder` | Responde conversaciones y gestiona los leads de su alcance. |
| `viewer` | Lo lee todo, no cambia nada. |
| `custom` | Permisos ajustados a mano en el dashboard. |

Los permisos se aplican en el servidor en cada acción del dashboard. La clave API tiene sus propios scopes y no hereda el rol de ningún miembro. Ver [Equipo y roles](/es/dashboard/team/) para los detalles.

## Errores que encontrarás

| HTTP | `code` | Cuándo |
|---|---|---|
| 401 | `missing_api_key`, `invalid_api_key` | Clave ausente, desconocida o revocada. |
| 403 | `insufficient_scope` | La clave no tiene `team:read`. |
| 429 | `rate_limited` | Demasiadas peticiones este minuto. Respeta `Retry-After`. |

## Relacionado

- [Leads: asignar un responsable](/es/developers/guides/leads/)
- [Equipo y roles en el dashboard](/es/dashboard/team/)
- [Autenticación y scopes](/es/developers/authentication/)
