LabelGrid-opdrachtregeltool (CLI)

Q: Heeft LabelGrid een opdrachtregeltool?

Ja. LabelGrid publiceert een officiële opdrachtregeltool als het npm-pakket @labelgrid/cli. Je installeert die met npm install -g @labelgrid/cli en daarmee komt de opdracht labelgrid beschikbaar in je terminal. Je hebt Node.js 20 of nieuwer nodig. De CLI is een dunne schil om de publieke LabelGrid API heen en werkt dus met dezelfde acties voor catalogus, bestanden, analytics en distributie.

Q: Wat kan ik met de LabelGrid CLI?

Je kunt inloggen en tokens beheren; labels, artiesten, schrijvers, uitgevers, releases en tracks zoeken, bekijken, aanmaken, bijwerken en verwijderen; audio, artwork, songteksten en motion artwork uploaden; releases valideren, indienen voor distributie en offline halen; overzichten, transacties, royalty's en streaminganalytics ophalen; reviewpunten en kwaliteitsrapporten bekijken; webhooks beheren; en Beatport in- en uitschakelen. Alles wat de publieke LabelGrid API toestaat, kan de CLI ook, en wat de API weigert, weigert de CLI op precies dezelfde manier.

Q: Hoe authenticeer ik de CLI?

De CLI gebruikt een LabelGrid API-token. Hij zoekt dat token op drie plekken, in deze volgorde: de omgevingsvariabele LABELGRID_API_TOKEN, dan een token dat je opslaat met labelgrid auth login (in je macOS Keychain, of op andere systemen in een bestand met beperkte rechten onder ~/.config/labelgrid), en dan de vlag --token. De CLI toont tokenwaarden nooit.

Bijgewerkt juli 2026.

LabelGrid publiceert een officiële opdrachtregeltool waarmee je rechtstreeks vanuit de terminal of vanuit een script met je account werkt. Het is het npm-pakket @labelgrid/cli, en na de installatie is de opdracht labelgrid op je machine beschikbaar.

De CLI is een dunne schil om de publieke LabelGrid API heen: dezelfde mogelijkheden, dezelfde validatie en dezelfde rechten. Alles wat de publieke API toestaat, kan de CLI ook, en wat de API weigert, weigert de CLI op precies dezelfde manier. Werk je liever in gewone taal met een AI-assistent, dan publiceert LabelGrid ook een MCP-server op basis van diezelfde API.

Wat je ermee kunt

De opdrachten zijn ingedeeld in groepen. Vanuit je terminal kun je:

auth — inloggen, uitloggen, controleren met welk account je bent ingelogd en een token intrekken
catalog — labels, artiesten, schrijvers, uitgevers, releases en tracks zoeken, bekijken, aanmaken, bijwerken en verwijderen
release — een release valideren, indienen voor distributie, offline halen, de review bevestigen en de landingspagina en korte link beheren
upload — audio, artwork, songteksten en motion artwork toevoegen (elk type accepteert alleen de toegestane bestandsextensies)
download, asset, license — bestanden ophalen en licenties beheren
statement, transactions, royalties, analytics — overzichten, transacties, royaltyuitsplitsingen en streaminganalytics ophalen
review — reviewpunten bekijken, kwaliteitsrapporten lezen en notities toevoegen
webhook — webhooks registreren en beheren voor asynchrone meldingen
beatport — Beatport in- en uitschakelen

Wat je nodig hebt

Een LabelGrid-account met API-toegang. API-toegang hoort bij de API-abonnementen van LabelGrid; zie het API-overzicht voor hoe je die krijgt.
Een API-token. Dat genereer je in je LabelGrid-dashboard onder Profiel → API-tokens.
Node.js 20 of nieuwer op de computer waarop je de CLI draait.

Installeren

Installeer de CLI globaal met npm:

npm install -g @labelgrid/cli

Daarmee komt de opdracht labelgrid beschikbaar. Controleer of het gelukt is met:

labelgrid --version

Authenticatie

De CLI heeft je API-token nodig. Hij zoekt dat op drie plekken, in deze volgorde:

De omgevingsvariabele LABELGRID_API_TOKEN — het handigst voor scripts en CI.
Een opgeslagen token dat je eenmalig bewaart met labelgrid auth login. Op macOS staat dat in je Keychain; op andere systemen in een bestand met beperkte rechten onder ~/.config/labelgrid/.
De vlag --token bij een losse opdracht.

Geef het token mee via een omgevingsvariabele:

export LABELGRID_API_TOKEN=your-api-token
labelgrid auth whoami

Of sla het token één keer op en laat de CLI het hergebruiken:

labelgrid auth login

De CLI toont tokenwaarden nooit. Wil je de toegang intrekken, log dan uit met labelgrid auth logout of trek het token in vanuit je dashboard; dat werkt direct.

Uitvoer en exitcodes

Standaard geeft de CLI overzichtelijke, leesbare uitvoer. Voor scripts voeg je --json toe aan een opdracht; dan toont hij de ruwe API-respons, zodat je die naar andere tools kunt doorsluizen:

labelgrid catalog search releases --query "summer" --json

Opdrachten geven standaard exitcodes terug, zodat je scripts op het resultaat kunnen reageren:

Exitcode	Betekenis
`0`	Gelukt
`1`	API-fout (het verzoek heeft LabelGrid bereikt en is geweigerd)
`2`	Gebruiksfout (een fout in de opdracht zelf)

Veiligheid

Ingrijpende en onomkeerbare opdrachten vragen eerst om een bevestiging voordat er iets wordt verstuurd. Bij het indienen van een release voor distributie, het offline halen van een release, het bevestigen van een review, het verwijderen van catalogusitems en het inschakelen van Beatport vraagt de CLI je eerst om y te typen ter bevestiging, en pas daarna doet hij een API-aanroep.

Voor automatiseringen waarbij niemand achter het toetsenbord zit, voeg je --yes toe om die vraag over te slaan:

labelgrid release distribute REL123 --yes

Alle beveiligingen op je account (validatie, abonnementslimieten en rate limits) worden door de servers van LabelGrid afgedwongen, dus hoe je de CLI ook gebruikt, hij kan er niet omheen.

Problemen oplossen

command not found: labelgrid — de globale installatie is niet afgerond of staat niet in je PATH. Voer npm install -g @labelgrid/cli opnieuw uit en controleer met node --version of je Node.js 20 of nieuwer hebt.
Token ongeldig of geweigerd — maak het token opnieuw aan in je dashboard onder Profiel → API-tokens en stel het daarna opnieuw in met export LABELGRID_API_TOKEN=... of labelgrid auth login.
Je ziet geen pagina “API-tokens” — je account heeft nog geen API-toegang. Zie het API-overzicht voor hoe je die inschakelt.
Een opdracht mislukt in een script — kijk naar de exitcode (1 is een API-fout, 2 een gebruiksfout) en voer dezelfde opdracht opnieuw uit met --json om de volledige respons te lezen.

FAQ

”Heeft LabelGrid een opdrachtregeltool?”

Ja. LabelGrid publiceert een officiële CLI als het npm-pakket @labelgrid/cli. Je installeert die met npm install -g @labelgrid/cli en daarmee komt de opdracht labelgrid beschikbaar in je terminal. Je hebt Node.js 20 of nieuwer nodig, en de tool is een dunne schil om de publieke LabelGrid API heen.

”Wat kan ik ermee?”

Inloggen en tokens beheren; labels, artiesten, schrijvers, uitgevers, releases en tracks zoeken, bekijken, aanmaken, bijwerken en verwijderen; audio, artwork, songteksten en motion artwork uploaden; releases valideren, indienen voor distributie en offline halen; overzichten, transacties, royalty’s en streaminganalytics ophalen; reviewpunten en kwaliteitsrapporten bekijken; webhooks beheren; en Beatport in- en uitschakelen.

”Hoe authenticeer ik de CLI?”

Met een LabelGrid API-token. De CLI zoekt dat op drie plekken, in deze volgorde: de omgevingsvariabele LABELGRID_API_TOKEN, dan een token dat is opgeslagen met labelgrid auth login, en dan de vlag --token. De CLI toont tokenwaarden nooit.

”Heb ik een API-abonnement nodig?”

Ja. De CLI werkt via de publieke LabelGrid API, dus je account heeft API-toegang nodig en die hoort bij de API-abonnementen van LabelGrid. Zie het API-overzicht voor hoe je toegang krijgt.

”Wat is het verschil tussen de CLI en de MCP-server?”

Allebei zijn het officiële tools van LabelGrid op dezelfde publieke API. De CLI is bedoeld voor je terminal en je scripts; de MCP-server is bedoeld voor AI-assistenten zoals Claude en Cursor, die in gewone taal de API-aanroepen voor je doen. Kies wat bij je workflow past, of gebruik allebei.

Gerelateerd

API-overzicht en Quickstart — hoe je API-toegang krijgt en authenticeert
Koppel je AI-assistent aan LabelGrid (MCP) — dezelfde acties, in gewone taal
Webhooks — asynchrone meldingen van gebeurtenissen
@labelgrid/cli op npm
Documentatie op GitHub — CLI-referentie onder packages/cli

Hulp nodig?

Heb je vragen over de CLI, neem dan contact op met ons supportteam.

Gebruik je LabelGrid nog niet?

Alles wat je net hebt gelezen, kun je gebruiken op ons platform.

Ontdek wat LabelGrid kan →