Base URL
Authentication
All endpoints (except/health) require a Bearer token:
rail_. Generate yours from the dashboard.
Endpoints
Error codes
Error responses are flat, not nested —
error is a plain string, with code and any
endpoint-specific fields alongside it, not inside it:
code — some (mostly 400s) return just {"error": "..."}. Credits
are metered fire-and-forget rather than pre-flight-blocked, so 402 is defined in the SDKs but
rarely returned in practice today.