Authentication
Send the private-beta key in the X-Calviro-Key request header. The endpoint fails closed when no server key is configured.
POST /api/v1/concepts
curl -X POST https://calvirostudio.com/api/v1/concepts \
-H 'Content-Type: application/json' \
-H 'X-Calviro-Key: YOUR_PRIVATE_BETA_KEY' \
-d '{"room_type":"living-room","style":"warm-modern","budget_usd":3200}'Copy the example or swipe horizontally to inspect long lines.
Request fields
| Field | Type | Current rule |
|---|---|---|
room_type | string | living-room, bedroom, office, or dining-room |
style | string | One of four bounded style identifiers |
budget_usd | integer | 500–100,000 |
webhook | string or null | Reserved in the schema; callback delivery is not active |
GET /api/v1/concepts/{concept_id}
Send the same X-Calviro-Key header to retrieve a result from shared process memory. Only the 500 most recent results are retained, and a process restart clears the local store. Responses are returned with Cache-Control: no-store, private.
webhook status
The webhook field documents a future asynchronous integration surface. The current synchronous endpoint does not send callbacks.
The machine-readable schema is available at /openapi.json.