Bouw Growf in je technische omgeving.

Overzicht

De Growf API is opgebouwd rond REST. De API gebruikt voorspelbare resource-URLs, JSON-responses en standaard HTTP-methodes en statuscodes. Alle requests lopen via HTTPS naar:

https://api.growf.com/v1

Endpoints en velden kunnen meebewegen met het product. Breaking changes worden geversioneerd en vooraf aangekondigd.

Authenticatie

Authenticeer met een geheime API-key die per werkruimte wordt aangemaakt via Instellingen → Ontwikkelaars. Verstuur de key als bearer token bij iedere request. Bewaar keys altijd server-side en toon ze nooit in clientcode.

# Authenticeren met een bearer token
curl https://api.growf.com/v1/clients -H "Authorization: Bearer gf_live_sk_..."

Requests en responses

Stuur request bodies als JSON met de header Content-Type: application/json. Succesvolle responses geven een JSON-object terug. Collecties worden teruggegeven onder een data-array met een cursor voor paginering.

{ "id": "cl_8f2a", "name": "Bambuu", "created_at": "2026-05-12T09:24:00Z", "strategies": 12 }

Eindpunten

Klanten

Briefings en strategie

Agents

Rapportage

Voorbeeld: start de content-agent

# Start de content-agent op basis van een briefing
curl -X POST https://api.growf.com/v1/agents/content/run -H "Authorization: Bearer gf_live_sk_..." -H "Content-Type: application/json" -d '{ "client_id": "cl_8f2a", "brief_id": "br_19d4", "channel": "social" }'

Fouten

Growf gebruikt gangbare HTTP-statuscodes. Codes in de 2xx-range betekenen succes, 4xx wijst op een probleem met de request en 5xx wijst op een tijdelijke fout aan de kant van Growf.

• 400: de request is ongeldig of mist verplichte velden.
• 401: de API-key ontbreekt of is ongeldig.
• 403: de key heeft geen toegang tot deze resource.
• 404: de resource bestaat niet.
• 429: te veel requests. Wacht even en probeer opnieuw.

Limieten

De API staat 120 requests per minuut per werkruimte toe. Bij overschrijding krijg je een 429 met een Retry-After-header die aangeeft hoe lang je moet wachten. Agent-runs worden asynchroon verwerkt en tellen niet mee voor de leeslimiet per minuut.

Webhooks

Gebruik webhooks om je systemen synchroon te houden. Registreer een endpoint via Instellingen → Ontwikkelaars → Webhooks en Growf stuurt een signed payload wanneer er iets verandert.

{ "event": "agent.run.completed", "run_id": "run_4c71", "client_id": "cl_8f2a", "status": "succeeded" }

Controleer de Growf-Signature-header met je signing secret voordat je een payload vertrouwt. Hulp nodig met API-toegang, scopes of integratie? Neem contact op via Contact.