Reference
API
A reference for integrators. The gateway is live at api.dracoforce.com and THE LAIR runs on it today; the public endpoint catalog is not published yet.
The gateway
All LAIR calls go to the DRACOFORCE gateway at https://api.dracoforce.com, and every path carries its /api prefix — the prefix is part of the route contract, not decoration. The gateway is a separate host from this website; a browser client builds each URL against the configured API origin rather than assuming same-origin.
Sessions
A caller establishes a session against the identity service, then presents it on each request. A request without a valid session is refused — a response that is merely reachable is not the same as an authenticated session, and the gateway does not treat it as one.
Endpoint shape
The workspace endpoints follow a consistent shape:
- Read endpoints return
{ ok: true, … }on success and a named error on failure, so a client branches on the field rather than on a status code alone. - Write endpoints that can be retried accept a stable
clientKeyand are idempotent under it — a repeated call with the same key replays the first result instead of acting twice. - Refusals carry a
codeand, where there is a next step, anactionand anhref, so the client follows the door the server names instead of guessing one.
Status
The public endpoint catalog is not published yet. Until it is, treat this page as the shape to build against, not a list of calls we support for integrators.