# Miembros

> Tus artistas y sellos: consúltalos e invita a otros nuevos.

<!-- Generated from openapi/hills-v1.json by scripts/api-reference.mjs. Edit the operation in hills-music (server/lib/ops), not this page. -->

Tus artistas y sellos: consúltalos e invita a otros nuevos.

URL base `https://api.hillsmusic.com/v1`. Cada solicitud envía una clave de API: `Authorization: Bearer hm_live_…`.

- Listar artistas y sellos
- Invitar a un artista o sello

<a id="list-artists-and-labels"></a>

## Listar artistas y sellos

`GET /v1/members` · Ámbito: `members:read`

Todos los artistas y sellos de tu cuenta, del más reciente al más antiguo, con el número de lanzamientos de cada uno.

### Parámetros

| Parámetro | Ubicación | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- | --- |
| `kind` | query | `artist` \| `label` | No | Solo artistas o solo sellos. |

### Ejemplo de solicitud

```bash
curl "https://api.hillsmusic.com/v1/members?kind=artist" \
  -H "Authorization: Bearer $HILLS_API_KEY"
```

### Respuesta `200`

```json
{
  "data": [
    {
      "id": 41,
      "email": "luna@example.com",
      "name": "Luna",
      "kind": "artist",
      "status": "active",
      "created_at": "2026-08-02T10:11:00Z",
      "last_login_at": null,
      "releases": 4
    }
  ]
}
```

### Errores

| Estado | Cuándo |
| --- | --- |
| 400 | invalid: un parámetro es incorrecto; field indica cuál. |
| 401 | unauthenticated, invalid_key, key_revoked, key_expired o test_keys_retired. |
| 403 | insufficient_scope: a la clave le falta el ámbito; scope indica cuál. account_inactive o api_not_in_plan. |
| 429 | rate_limited: espera los segundos que indique Retry-After. |

<a id="invite-an-artist-or-label"></a>

## Invitar a un artista o sello

`POST /v1/members/invite` · Ámbito: `members:write`

Crea la cuenta dentro de la tuya y le envía por correo un enlace (válido 7 días) para establecer su contraseña. 409 si el correo ya tiene una cuenta.

### Cuerpo de la solicitud

JSON.

| Campo | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `email` | string | Sí | Su dirección de correo electrónico. |
| `fname` | string | Sí | Nombre de pila o nombre del sello. |
| `lname` | string | No | Apellidos. |
| `kind` | `artist` \| `label` | Sí | Qué tipo de cuenta es. |

### Ejemplo de solicitud

```bash
curl -X POST "https://api.hillsmusic.com/v1/members/invite" \
  -H "Authorization: Bearer $HILLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"luna@example.com","fname":"Luna","kind":"artist"}'
```

### Respuesta `201`

```json
{
  "ok": true,
  "id": 57
}
```

### Errores

| Estado | Cuándo |
| --- | --- |
| 400 | invalid: un parámetro es incorrecto; field indica cuál. |
| 401 | unauthenticated, invalid_key, key_revoked, key_expired o test_keys_retired. |
| 403 | insufficient_scope: a la clave le falta el ámbito; scope indica cuál. account_inactive o api_not_in_plan. |
| 409 | exists: ya hay una cuenta con este correo. |
| 429 | rate_limited: espera los segundos que indique Retry-After. |

Fuente: https://developer.hillsmusic.com/es/reference/members/