//Tenant Home Discovery API

Tenant Home Discovery API

Public, pre-auth discovery for multi-homed tenants. Before authenticating, a client may need to learn where to talk to — its organization's home region and base URL. This endpoint resolves an active tenant's home, keyed by (org, app).

Endpoint

GET /api/tenant/home?org_uuid=…&app_id=…

Resolve an active tenant's public routing info.

Auth: none (pre-auth by design — the client is still figuring out where to talk).

Query Parameters:

  • org_uuid (required): the organization UUID.
  • app_id (optional): the application id.

Output (200): ~~~json { "data": { "tenancy_mode": "dedicated", "home_region": "us-east-1", "home_base_url": "https://acme.example.com" } } ~~~

The response carries only public routing info — no secrets, no infra pointers. tenancy_mode is shared or dedicated.

A home is returned only for tenants whose lifecycle status is active. An unknown or non-active tenant returns 404 no active tenant home for this org/app.