Membros

Seus artistas e gravadoras: liste-os e convide novos.

URL base https://api.hillsmusic.com/v1. Toda requisição envia uma chave de API: Authorization: Bearer hm_live_….

• Listar artistas e gravadoras
• Convidar um artista ou gravadora

Listar artistas e gravadoras

GET /v1/members · Escopo: members:read

Todos os artistas e gravadoras da sua conta, dos mais recentes para os mais antigos, com o número de lançamentos de cada um.

Parâmetros

Exemplo de requisição

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

Resposta 200

{
  "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
    }
  ]
}

Erros

Convidar um artista ou gravadora

POST /v1/members/invite · Escopo: members:write

Cria a conta vinculada à sua e envia por e-mail um link (válido por 7 dias) para a pessoa definir a senha. 409 se o e-mail já tiver uma conta.

Corpo da requisição

JSON.

Exemplo de requisição

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

Resposta 201

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

Erros