GRIP OS/API Documentation
Back to Demo

API Reference

Integrate with GRIP OS programmatically. All authenticated endpoints accept either a session cookie or a Authorization: Bearer <service_role_key> header.

POST/api/webhook

Import 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
}
GET/api/workspace/{id}/export

Export 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
  }
}
GET/api/health

Returns the service status. Use for uptime monitoring and health checks.

Auth: None

Response

{
  "status": "ok",
  "timestamp": "2026-04-10T12:00:00Z"
}
POST/api/workspace/{id}/brain

Ask 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