# Membres

> Vos artistes et labels : listez-les et invitez-en de nouveaux.

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

Vos artistes et labels : listez-les et invitez-en de nouveaux.

URL de base `https://api.hillsmusic.com/v1`. Chaque requête envoie une clé d’API : `Authorization: Bearer hm_live_…`.

- Lister les artistes et labels
- Inviter un artiste ou un label

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

## Lister les artistes et labels

`GET /v1/members` · Scope : `members:read`

Tous les artistes et labels rattachés à votre compte, du plus récent au plus ancien, avec le nombre de sorties de chacun.

### Paramètres

| Paramètre | Emplacement | Type | Obligatoire | Description |
| --- | --- | --- | --- | --- |
| `kind` | query | `artist` \| `label` | Non | Uniquement les artistes ou uniquement les labels. |

### Exemple de requête

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

### Réponse `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
    }
  ]
}
```

### Erreurs

| Statut | Quand |
| --- | --- |
| 400 | invalid : un paramètre est incorrect ; field l’indique. |
| 401 | unauthenticated, invalid_key, key_revoked, key_expired ou test_keys_retired. |
| 403 | insufficient_scope : la clé n’a pas le scope requis ; scope l’indique. account_inactive ou api_not_in_plan. |
| 429 | rate_limited : attendez le nombre de secondes indiqué par Retry-After. |

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

## Inviter un artiste ou un label

`POST /v1/members/invite` · Scope : `members:write`

Crée le compte sous le vôtre et envoie par e-mail un lien (valable 7 jours) pour définir le mot de passe. 409 si un compte existe déjà avec cette adresse e-mail.

### Corps de la requête

JSON.

| Champ | Type | Obligatoire | Description |
| --- | --- | --- | --- |
| `email` | string | Oui | Son adresse e-mail. |
| `fname` | string | Oui | Prénom, ou nom du label. |
| `lname` | string | Non | Nom de famille. |
| `kind` | `artist` \| `label` | Oui | Artiste ou label. |

### Exemple de requête

```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"}'
```

### Réponse `201`

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

### Erreurs

| Statut | Quand |
| --- | --- |
| 400 | invalid : un paramètre est incorrect ; field l’indique. |
| 401 | unauthenticated, invalid_key, key_revoked, key_expired ou test_keys_retired. |
| 403 | insufficient_scope : la clé n’a pas le scope requis ; scope l’indique. account_inactive ou api_not_in_plan. |
| 409 | exists : un compte existe déjà avec cette adresse e-mail. |
| 429 | rate_limited : attendez le nombre de secondes indiqué par Retry-After. |

Source: https://developer.hillsmusic.com/fr/reference/members/