API Reference
Integrate with GRIP OS programmatically. All authenticated endpoints accept either a session cookie or a Authorization: Bearer <service_role_key> header.
/api/webhookImport GIR data from Google Apps Script or Make.com. Accepts a JSON payload containing workspace metrics and writes them into the target workspace.
Auth: Service Role Key (Bearer token)
Request Body
{
"workspaceId": "<uuid>",
"metrics": {
"arr": 12000000,
"net_revenue_retention": 112,
"cac_payback_months": 18
}
}Response
{
"ok": true,
"imported": 3
}/api/workspace/{id}/exportExport all workspace data as JSON. Useful for backups or feeding data into external BI tools.
Auth: Authenticated user (session cookie) or Service Role Key
Response
{
"workspace": {
"id": "<uuid>",
"name": "Acme Corp",
"tier": "full"
},
"metrics": {
"arr": 12000000,
"growth_rate": 42
},
"gripScores": {
"overall": 72,
"g": 80,
"r": 65,
"i": 70,
"p": 73
}
}/api/healthReturns the service status. Use for uptime monitoring and health checks.
Auth: None
Response
{
"status": "ok",
"timestamp": "2026-04-10T12:00:00Z"
}/api/workspace/{id}/brainAsk the GRIP Brain a question about your workspace data. Returns an AI-generated answer grounded in your metrics, benchmarks, and GRIP scores.
Auth: Authenticated user (session cookie)
Request Body
{
"question": "What is my biggest growth bottleneck?"
}Response
{
"answer": "Based on your metrics, CAC payback of 24 months is well above the cohort median of 16 months. Improving sales efficiency would have the highest leverage on your growth trajectory."
}Questions? Reach out at support@caugia.com