SESAME API

Start hotel websites, build them, present them to the customer, and see what they cost, as yourself. Every call acts as the person whose Hotelwize token it carries, with the roles and project access they have in SESAME.

Signing in

Send a Hotelwize access token as a bearer: Authorization: Bearer <token>. The token must be issued by auth.hotelwize.com to one of SESAME's clients (sesame.cli for scripts, sesame.mcp for AI assistants) with the sesame scope, and website for the calls that reach Hotelwize. Making and building a website needs sesame.build, and what it cost sesame.consumption; a call without its scope answers 403 insufficient_scope, naming it.

REST

The description is at /openapi.json. In short:

GET    /projects?name=
POST   /projects                 Idempotency-Key supported
GET    /projects/{id}
PATCH  /projects/{id}
DELETE /projects/{id}
POST   /projects/{id}/read-property
POST   /projects/{id}/build      Idempotency-Key supported
POST   /projects/{id}/rebuild
GET    /projects/{id}/build
PUT    /projects/{id}/customer   GET, DELETE
PUT    /projects/{id}/presentation   PATCH, GET, DELETE
PUT    /projects/{id}/presentation/screenshots   multipart, four JPEGs
GET    /themes
GET    /personas
GET    /consumption?days=30

A refusal is { "code": "...", "message": "..." } with its status. Branch on the code; show the message.

MCP

The same calls are MCP tools at /mcp (Streamable HTTP). With Claude Code:

claude mcp add --transport http sesame https://api.sesamecreate.com/mcp --client-id sesame.mcp --callback-port 8765

A client that already holds a token can send it as a bearer header instead.