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

# Get Bootstrap

`GET /v1/bootstrap`

Return the deployment context the dashboard shell renders from.

Public: the shell fetches this before it knows whether it can authenticate.

## Response `200`

Successful Response

- DeploymentBootstrap — What the dashboard shell needs before it can render anything.
  - `deployment_type` 'standalone' | 'hosted' | 'hybrid', required — Which deployment serves this URL. 'standalone' owns its own data; 'hosted' is otari.ai; 'hybrid' is a gateway attached to otari.ai, which is data-plane only and holds no management surface of its own.
  - `invitation_mail_ready` boolean, required — Whether this deployment can actually deliver mail (an invitation's accept link), not merely whether an SMTP host is set: it also needs to know its own public URL to put in one. Named for the specific thing it gates rather than 'mail_enabled', since a deployment could one day have mail configured for something else while this is still false. Lets the dashboard hide or disable the invite affordance instead of offering one that would fail at send time. False for a hybrid gateway, which holds no tenancy state to invite anyone into.
  - `management_url` string, nullable, required — Where the authoritative control plane lives when it is not this deployment. Set for a hybrid gateway so its landing page can link to otari.ai; null otherwise.
  - `session_type` 'local_operator' | 'hosted_user' | 'none', required — The kind of session this deployment issues, not whether the caller holds one. 'local_operator' is the standalone master-key sign-in, 'hosted_user' an otari.ai account, and 'none' a deployment that issues no management session at all.
  - `surfaces` string[], required — Management API groups this deployment serves, sorted, which is what its dashboard pages gate on. Named surfaces, not capabilities: capability is otari.ai's word for the entitlement (licensing) axis, and this is the deployment (topology) axis. Empty for a hybrid gateway.

---

[API](https://skmtc.net/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.net/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mozilla-ai/otari/revisions/2ebadef75cc8/schema)