Common Control Plane API

Common is the control plane for identity, tenancy, directory, and infra lifecycle.

Core endpoint families

• auth/session: /v1/auth/*, /v1/me, /v1/me/preferences
• user lifecycle: /v1/users*, home-tenant conversion
• tenant governance: /v1/tenants*, invites, members, groups, guest invites
• routing/directory: /v1/directory/resolve, /v1/directory/repo/{repo_id}
• snapshots: entitlement and authz snapshot endpoints
• infra lifecycle: /v1/infrastructures*, infra tokens
• repo registry and placement: /v1/repos*

Integration practice

• use OpenAPI (common-control-plane/docs/openapi/v1.yaml) for generated client contracts
• treat Common as source of truth for routing and home-tenant decisions
• do not assume control-plane availability for every data-plane request