Public API
Overview
Braiins Manager exposes a Public API so you can integrate your own systems and tooling with the platform programmatically. It lets enterprise customers, energy management platforms, and third-party automation tools read fleet data and trigger actions without using the dashboard.
The API is a versioned REST API, authenticated with API keys and rate-limited per key. V2 is the current generation; V1 is the legacy surface and receives no new endpoints.
Access and Permissions
API keys are managed by Provider Admins in Settings → API.
- Click Add API Key, give it a name, and choose an expiration of one month or one year.
- The full key value is shown only once, at creation. Copy it immediately; it cannot be retrieved again.
- A Provider can have up to 5 active keys at a time.
- Provider Admins can revoke a key at any time. A revoked or expired key is rejected on all subsequent requests.
Key creation and revocation are restricted to Provider Admins. Other users can call the API with an existing key but cannot manage keys.
Authentication
Pass your API key in the X-API-KEY request header on every call. Each successful response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers so you can track your remaining quota.
API Documentation
The full, interactive reference lists every endpoint with request and response schemas and a built-in Try It console you can use to make live calls with your API key.
Braiins Manager Public API reference
Related: Workers list · Curtailment