Tenant configuration

Tenant preview domain

A tenant preview domain is an apex hostname that replaces the MIOSA fallback preview domain in every sandbox preview URL your end users see. It is set per tenant.

When you set and verify a preview domain (for example, yourproduct.com), sandbox previews for your tenant are served at:

https://<sandbox-slug>.yourproduct.com

Setup is a two-step DNS verification: add a wildcard CNAME (*.yourproduct.com) pointing to proxy.miosa.ai, then call POST /api/v1/tenant/preview-domain/verify. MIOSA auto-provisions a wildcard TLS certificate once the CNAME resolves. Only apex domains are accepted - subdomains and protocol prefixes are rejected.

One preview domain per tenant. The domain applies to all sandboxes under that tenant.

# Set
curl -X PUT https://api.miosa.ai/api/v1/tenant/preview-domain 
  -H "Authorization: Bearer msk_u_..." 
  -H "Content-Type: application/json" 
  -d '{"preview_domain": "yourproduct.com"}'

# Verify
curl -X POST https://api.miosa.ai/api/v1/tenant/preview-domain/verify 
  -H "Authorization: Bearer msk_u_..."

Tenant Preview Domain API →

Tenant branding

Tenant branding controls what your end users see on MIOSA-rendered error pages - the 404, 502, and gateway-timeout pages displayed when a sandbox is unavailable, a preview URL is invalid, or a custom domain is not yet verified.

Configurable fields:

Field	Description
`logo_url`	HTTPS URL to your logo image
`name`	Product or company name
`support_url`	Optional link shown on error pages for end-user support
`primary_color`	Hex color for CTA buttons (for example `#0066FF`)

Branding is set via PUT /api/v1/tenant/branding and served immediately from cache - there is no propagation delay. Deleting it resets the error pages to the MIOSA defaults.

# Set branding
curl -X PUT https://api.miosa.ai/api/v1/tenant/branding 
  -H "Authorization: Bearer msk_u_..." 
  -H "Content-Type: application/json" 
  -d '{
    "branding": {
      "logo_url": "https://cdn.lumen.app/logo.png",
      "name": "Lumen",
      "primary_color": "#0066FF"
    }
  }'

Tenant Branding API →

Preview and share tokens: browser access to a sandbox preview.
Tenant Preview Domain API: the full request schema.
Core Concepts: the one-screen overview.

Tenant configuration

Tenant preview domain

Tenant branding

Next