v1

latestOpenAPI 3.1.02026-08-0413468163.9 KB
v1-auth

Bootstrap

Bootstrap endpoint - ONE request for complete app initialization.

REQUIRES X-Org-Id header - users must explicitly choose their org context.

This endpoint returns everything the frontend needs to load:

  • User identity
  • List of all user's organizations (lightweight)
  • Active organization details with full permissions

Headers: X-Org-Id: REQUIRED - Organization ID to load context for

Returns: user: Full user profile orgs: Array of lightweight org info (for org switcher) active_org: Full details of active org with permissions

Example response: { "user": { "user_id": "...", "email": "john@example.com", "full_name": "John Doe", "created_at": "2025-01-01T00:00:00Z", "updated_at": "2025-01-01T00:00:00Z" }, "orgs": [ { "org_id": "abc-123", "name": "Acme Corp", "role": "owner", "joined_at": "2025-01-01T00:00:00Z" } ], "active_org": { "org_id": "abc-123", "name": "Acme Corp", "created_at": "2025-01-01T00:00:00Z", "my_role": "owner", "my_permissions": ["org.read", "org.update", "org.delete", ...], "member_count": 5 } }

get/v1/bootstrap

Response

Successful Response

object required