API-sleutels

Genereer en beheer API-sleutels voor programmatische toegang.

API-sleutels maken programmatische toegang tot je agents mogelijk. Gebruik ze om Agentkit te integreren in je eigen applicaties of om externe diensten aan te sluiten.

Voor het aanmaken van sleutels en het gebruik van de API is een Hobby-plan of hoger met actieve facturering vereist. Leden van de werkruimte kunnen bestaande sleutels blijven bekijken en intrekken nadat dat toegangsrecht vervalt. Upgrade je plan →

Een API-sleutel aanmaken

Ga naar je werkruimte
Klik op API Keys in de zijbalk
Klik op API-sleutel maken
Bevestig in het dialoogvenster

De nieuwe sleutel verschijnt in de lijst en kan op elk moment worden onthuld of gekopieerd.

Sleutels bekijken en kopiëren

Elke sleutel in de lijst is standaard gemaskeerd. Gebruik het oogicoon om een sleutel te onthullen en het kopieericoon om hem naar je klembord te kopiëren.

API-sleutels gebruiken

Neem de sleutel op in je API-aanroepen:

curl -X POST 'https://your-domain.com/api/v1/chat' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"chatbotId": "uuid", "messages": [{"role": "user", "content": "Hello"}]}'

Volledige API-documentatie →

Sleutels beheren

Alle sleutels bekijken

Alle API-sleutels van de werkruimte staan vermeld op de pagina API Keys.

Een sleutel verwijderen

Zoek de sleutel in de lijst
Klik op het prullenbakicoon
Bevestig de verwijdering

Verwijderde sleutels stoppen direct met werken.

Sleutels intrekken nadat toegang verloopt

Als je werkruimte API-toegang verliest, meld je je aan en verwijder je onnodige sleutels op de pagina API-sleutels. Je hoeft de facturering niet te vernieuwen om ze in te trekken. Je moet wel lid van de werkruimte blijven. Als je MFA hebt ingeschakeld, voltooi dan de MFA-controle voordat je sleutels beheert. Tot die tijd verbergt de database de sleutels van de werkruimte en weigert deze verwijdering. Dit herstelt het API-gebruik of de toestemming om sleutels aan te maken niet.

Agentkit controleerde eerder het betaalde API-toegangsrecht voordat een sleutel werd verwijderd. Ook het databasebeleid vereiste dat recht om sleutels te lezen of te verwijderen. Verlies van toegang kon daardoor het opruimen van bestaande inloggegevens blokkeren.

De correctie scheidt aanmaken van opruimen. Lidmaatschap van de werkruimte bepaalt de lees- en verwijdertoegang tot bestaande sleutels; een afzonderlijk databasebeleid dwingt MFA af. Voor het aanmaken en bijwerken van sleutels blijft het API-toegangsrecht vereist. De verwijderactie controleert zowel de sleutel-ID als de werkruimte-ID en meldt alleen succes als de database een verwijderde rij teruggeeft.

Dit vereenvoudigde voorbeeld beschrijft de gewijzigde controle:

Before
  Require API entitlement before deleting an existing key.

After
  Delete only a key belonging to the requested workspace.
  Require a returned deleted row before reporting success.
  Keep membership checks and enforce MFA in the database.

De applicatietests simuleren de databaseclient. Ze controleren filters en resultaatverwerking, niet het databasebeleid. De SQL-tests gebruiken synthetische accounts en draaien wijzigingen terug. De verwachte uitkomsten omvatten:

Controle	Testlaag	Verwachte uitkomst
Bevoegd lid trekt in zonder API-toegangsrecht	Applicatiesimulatie	Geen controle op het toegangsrecht; sleutel- en werkruimtefilters; succes vereist een teruggegeven rij
Bevoegd lid trekt in zonder API-toegangsrecht	SQL	Eén sleutel van de eigen werkruimte verwijderd
Lid maakt een sleutel aan zonder toegangsrecht	Applicatiesimulatie en SQL	Geweigerd
Lid probeert een sleutel van een andere werkruimte te verwijderen	SQL	Geen rij verwijderd
Vereiste MFA is niet voldaan	SQL	Geen rij verwijderd
Gevraagde sleutel ontbreekt of is onzichtbaar voor de aanroeper	Applicatiesimulatie	Actie meldt een fout

Dit zijn regressieverwachtingen, geen resultaten van een productieproef. Pas hetzelfde testpatroon toe op tijdelijke inloggegevens in agentworkflows. Wijzig toegang vóór het opruimen en controleer of bevoegd opruimen slaagt en onbevoegd opruimen wordt geweigerd.

Best practices voor beveiliging

Sleutels nooit blootstellen

Commit geen sleutels naar git-repositories
Neem geen sleutels op in client-side code
Gebruik omgevingsvariabelen

Roteer sleutels periodiek

Maak periodiek nieuwe sleutels aan
Werk je applicaties bij
Verwijder oude sleutels

Gebruik gescheiden sleutels

Maak aparte sleutels voor:

Productie versus ontwikkeling
Verschillende applicaties
Verschillende teamleden of diensten

Reikwijdte van sleutels

API-sleutels zijn gebonden aan de werkruimte waarin ze zijn aangemaakt en hebben toegang tot:

Alle agents in de werkruimte
Chat-API-endpoints
Webhookbeheer

Sleutels kunnen niet:

Teamleden beheren
Facturering inzien
Andere API-sleutels aanmaken

Zapier-koppeling

Bij het koppelen met Zapier:

Maak een aparte API-sleutel voor Zapier
Gebruik deze sleutel in de Zapier-koppeling
Houd de sleutel gescheiden van ander gebruik

Zapier instellen →

Problemen oplossen

Foutmelding "Invalid API key"

Controleer of de sleutel correct is gekopieerd
Let op spaties aan het begin of einde
Bevestig dat de sleutel niet verwijderd is

Foutmelding "Key not authorized"

Zorg dat de agent bij je werkruimte hoort
Controleer of de werkruimte van de sleutel overeenkomt
Bevestig voor API-verzoeken dat je werkruimte op Hobby of hoger staat met actieve facturering

Sleutel werkt niet na aanmaak

Ververs de pagina
Wacht 30 seconden totdat de sleutel actief wordt
Maak een nieuwe sleutel aan als het probleem blijft bestaan