Organizations Endpoint

GET /api/v1/organizations/current

Details of whichever org owns the API key. Scope: read:org.

{
  "id": 1,
  "name": "Acme Inc",
  "plan": "business",
  "status": "active",
  "limits": {
    "servers": 50,
    "databases_per_server": 100,
    "alert_rules": "unlimited"
  },
  "usage": {
    "servers": 12,
    "databases": 342,
    "alert_rules": 87
  },
  "created_at": "2025-08-10T00:00:00Z"
}

The usage block is what you want for capacity planning — if servers usage is at 48 and the limit is 50, you're about to hit a wall.

GET /api/v1/organizations/current/members

List members and their roles. Scope: read:org.

POST /api/v1/organizations/current/invitations

Invite by email. Role is one of viewer, admin, owner. Scope: admin:org.

{
  "email": "[email protected]",
  "role": "admin"
}

DELETE /api/v1/organizations/current/members/:user_id

Remove a member. Scope: admin:org. Their workbooks and dashboards survive (orphaned to the org); their personal API keys are revoked.