Ontwikkelaarsgids
Integreer programmatisch met Agentkit via onze REST API.
Bouw eigen integraties met de Agentkit REST API. Stuur berichten programmatisch, beheer agents, werk bronnen en instellingen bij, beheer contacten, stuur feedback, configureer webhooks en integreer agents in je eigen toepassingen.
Let op: Voor API-toegang heb je minimaal het Hobby-abonnement nodig. Accounts op het Free-abonnement hebben geen toegang tot de REST API. Upgrade je plan →
API-overzicht
De Agentkit API biedt programmatische toegang tot je agents. Gebruik hem om:
- Chatberichten te versturen en AI-antwoorden te ontvangen
- Eigen chatinterfaces te bouwen
- Agents, bronnen, contacten en instellingen te beheren met API v2
- Responses te streamen en met API v2 aangemaakte gesprekken opnieuw te proberen
- Agents in je eigen toepassingen te integreren
- Workflows te automatiseren met webhook-abonnementen
Aan de slag
1. Genereer een API-sleutel
Maak een API-sleutel aan vanuit je werkruimtedashboard om aanvragen te authenticeren.
2. Verstuur je eerste aanvraag
Gebruik het Chat-endpoint om berichten te versturen en antwoorden te ontvangen.
3. API v2 gebruiken (optioneel)
Gebruik API v2 wanneer je agentbeheer, streaming chat, gespreksgeschiedenis, berichtfeedback, bronnen, contacten, instellingen of trainingsendpoints nodig hebt.
API v2-referentie:
4. Webhooks instellen (optioneel)
Abonneer je op gebeurtenissen voor realtime meldingen.
API-endpoints
| Endpoint | Method | Description |
|---|---|---|
/api/v1/auth | GET | API-sleutel testen, accountgegevens ophalen |
/api/v1/chat | POST | Berichten versturen, AI-antwoorden ophalen |
/api/v1/chatbots | GET | Agents in het account weergeven |
/api/v1/webhooks/subscribe | POST | Webhook-abonnement aanmaken |
/api/v1/webhooks/subscribe/[id] | DELETE | Webhook-abonnement verwijderen |
/api/v2/agents en /api/v2/agents/{agentId}/settings/... | Meerdere | Agents en instellingen beheren |
/api/v2/agents/{agentId}/conversations/... | Meerdere | Gesprekken, berichten, retries, toolresultaten en feedback lezen |
/api/v2/agents/{agentId}/sources/... en /train | Meerdere | Bronnen en training beheren |
/api/v2/agents/{agentId}/contacts/... | Meerdere | Contacten beheren |
| API v2-fouten | Alle | Foutcodes en statussen bekijken |
Base-URL
API v1-aanvragen gebruiken je Agentkit-deployment-URL:
https://your-domain.com/api/v1/
API v2-aanvragen gebruiken:
https://your-domain.com/api/v2/
Responsformaat
API v1-chatresponses zijn JSON met deze structuur:
Success:
{
"text": "AI response here"
}
API v2 gebruikt gestructureerde data-, pagination- en error-enveloppen, afhankelijk van het endpoint. Zie het API v2-overzicht voor details.
Error:
{
"message": "Error description",
"details": {}
}
Ratelimieten
API-aanvragen vallen onder de berichtenlimieten van je abonnement. Elk bericht dat via de API wordt verstuurd, telt mee voor je maandelijkse berichtentegoed.