Base URL
Your deployment. There is no hosted endpoint, because the platform runs single-tenant inside your environment.Authentication
Versioning
The path carries the major version. Withinv1, fields are added and never
removed or repurposed, so a client that ignores unknown fields keeps working.
The decision record is the exception that gets stronger treatment: fields in a
sealed record are never changed, because a record that means something different
after an upgrade is not a record.
The endpoints
Every route
The table above is the part most integrations use. Every route in this section is all of them: 139 routes, each with its parameters, the shape of its answer, and who may call it. Those pages are made from the product’s own route definitions, not written by hand, and the file behind them is at docs.rotascale.com/api/openapi.json if you would rather give it to a tool. Three things to know before relying on it:- It describes one commit of the main line, named in the file as
x-rotascale-source. Your deployment serves its own description at/api/docs, and that one is the authority on what your version has and which features are switched on. - It is version 0.1.0. Routes and shapes can still change.
- There is nothing to send a request to from here. RotaGrant runs in your environment, so these pages show each request and do not offer to make it.
Errors
Refusals are not HTTP errors.POST /v1/authorize returns 200 with an
outcome of deny, exhausted or gated, because a refusal is a successful
decision and the SDK turns it into an exception on your side.
HTTP 4xx means the request was malformed or unauthenticated. 5xx means the
platform failed, and the SDK fails closed on it by default.