# RiDERgy

## Docs

- [Apply a schedule to every location in a cluster](https://docs.ridergy.com/api-reference/energy-management/apply-cluster-schedule.md): Applies the same `LimitProfileRequest` to every location in the cluster (equivalent to calling `POST /locations/{locationId}/schedules` for each member).
- [Create or replace a charger-level limit lock](https://docs.ridergy.com/api-reference/energy-management/create-charger-lock.md): Creates a time-windowed power limit + lock for a single connector.
- [Create a cluster](https://docs.ridergy.com/api-reference/energy-management/create-cluster.md): Creates a cluster grouping multiple locations under a single optional kW cap. All `locationIds` must belong to the calling tenant.
- [Create or replace a location priority limit profile](https://docs.ridergy.com/api-reference/energy-management/create-location-schedule.md): Creates a time-windowed power limit profile for a location at the given priority. If a profile already exists at that priority for this location, it is replaced. The effective limit is recomputed immediately and written through to the location.
- [Create or replace an organization-wide cap profile](https://docs.ridergy.com/api-reference/energy-management/create-organization-schedule.md): Records an organization-wide cap profile for the calling tenant (derived from the API key — no `orgId` in the path or body).
- [Delete a cluster](https://docs.ridergy.com/api-reference/energy-management/delete-cluster.md): Deletes the cluster record. Member locations are not affected.
- [Get a cluster's live status](https://docs.ridergy.com/api-reference/energy-management/get-cluster.md): Returns the cluster plus a `liveStatus` block: actual total kW draw, sum of member location limits, and per-location `{setLimitKw, effectiveLimitKw, actualKw}` after proportional scaling (`scale = min(1, clusterLimitKw / sumLocationLimits)`).
- [Get a location's permanent limit and all priority profiles](https://docs.ridergy.com/api-reference/energy-management/get-location-limits.md): Returns the location's permanent fallback limit, the current effective limit, and every priority profile (including expired and scheduled ones) with a recomputed `status`.
- [Health check](https://docs.ridergy.com/api-reference/energy-management/health.md): Unauthenticated health check. Does not require an API key.
- [List clusters](https://docs.ridergy.com/api-reference/energy-management/list-clusters.md): Lists all clusters for the calling tenant, newest first.
- [List organization-wide cap profiles](https://docs.ridergy.com/api-reference/energy-management/list-organization-limits.md): Lists all org-wide cap profiles for the calling tenant with computed status.
- [Set a location's permanent (fallback) limit](https://docs.ridergy.com/api-reference/energy-management/set-location-limit.md): Sets the permanent limit used when no priority profile is currently active for this location.
- [Update a cluster](https://docs.ridergy.com/api-reference/energy-management/update-cluster.md): Partially updates a cluster. Any of `name`, `limitKw` (or `null` to remove the cap), `locationIds`, or `status` (`ACTIVE`/`INACTIVE`) may be supplied.
- [Authentication](https://docs.ridergy.com/authentication.md): How to authenticate requests to the RiDERgy APIs
- [Errors](https://docs.ridergy.com/concepts/errors.md): Error response format and codes
- [Priority model](https://docs.ridergy.com/concepts/priority-model.md): How limit profiles, priorities, and effective limits work
- [Introduction](https://docs.ridergy.com/index.md): RiDERgy public API documentation

## OpenAPI Specs

- [openapi.zh](https://docs.ridergy.com/api-reference/energy-management/openapi.zh.yaml)
- [openapi.pt](https://docs.ridergy.com/api-reference/energy-management/openapi.pt.yaml)
- [openapi.it](https://docs.ridergy.com/api-reference/energy-management/openapi.it.yaml)
- [openapi.fr](https://docs.ridergy.com/api-reference/energy-management/openapi.fr.yaml)
- [openapi.es](https://docs.ridergy.com/api-reference/energy-management/openapi.es.yaml)
- [openapi.en](https://docs.ridergy.com/api-reference/energy-management/openapi.en.yaml)
- [openapi.de](https://docs.ridergy.com/api-reference/energy-management/openapi.de.yaml)