---
title: "Bootstrap"
method: GET
path: "/v1/bootstrap"
tags: ["v1-auth"]
---

# Bootstrap

`GET /v1/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
    }
}

## Response `200`

Successful Response

- object

---

[API](https://skmtc.net/tryardent/apis/fastapi.md) · [All operations](https://skmtc.net/tryardent/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryardent/fastapi/revisions/71b66f68e19c/schema)