# Dream Office public APIs

> Dream Office publishes a machine-readable API catalog at /.well-known/api-catalog (RFC 9727). Each entry links to an OpenAPI spec, this documentation, and a live health check.

Canonical: https://www.dreamoffice.ai/developers
Markdown: https://www.dreamoffice.ai/developers.md

Automated clients should fetch [the catalog](https://www.dreamoffice.ai/.well-known/api-catalog) first. Do not scrape HTML for endpoint lists.

## Partner embed

White-label remodel widget for Ultra partners. Visitors upload a photo of a real office, chat a brief, get a remodel with that partner’s catalogue, and submit a lead.

- Anchor: https://www.dreamoffice.ai/api/v1/embed
- OpenAPI: https://www.dreamoffice.ai/openapi/embed
- Auth: publishable key on session create; later calls send `x-embed-session` (or `Authorization: Bearer`)
- Endpoints: GET /api/v1/embed/bootstrap, POST /api/v1/embed/sessions, POST /api/v1/embed/photo, POST /api/v1/embed/chat, POST /api/v1/embed/catalog/match, POST /api/v1/embed/generate, POST /api/v1/embed/leads

## Public designs

Read the public inspiration gallery. Filter by style, room type, tag, segment, or use case. No authentication.

- Anchor: https://www.dreamoffice.ai/api/public-designs
- OpenAPI: https://www.dreamoffice.ai/openapi/public-designs
- Endpoints: GET /api/public-designs, GET /api/public-designs/{id}

## Space calculator

Given room length, width, and headcount, return workstation counts, area per person, and common-area split.

- Anchor: https://www.dreamoffice.ai/api/tools/space-calculator
- OpenAPI: https://www.dreamoffice.ai/openapi/space-calculator
- Endpoint: POST /api/tools/space-calculator

## Health

GET https://www.dreamoffice.ai/api/health/live returns `{ "status": "ok" }` with HTTP 200 and no database or AI checks.


## Related

- [API catalog (RFC 9727)](https://www.dreamoffice.ai/.well-known/api-catalog)
- [Product](https://www.dreamoffice.ai/ai-office-design-generator)