> ## Documentation Index > Fetch the complete documentation index at: https://docs.ridergy.com/llms.txt > Use this file to discover all available pages before exploring further. # Quitar una ubicación de un clúster > Elimina una ubicación de la lista `locationIds` de un clúster. Es una alternativa atómica a `PATCH /clusters/{clusterId}` con un array `locationIds` más corto, de modo que las eliminaciones concurrentes no puedan competir entre sí. Un clúster debe tener siempre al menos una ubicación miembro. Eliminar la última falla con `400 CLUSTER_EMPTY`. En ese caso, elimina el clúster en su lugar con `DELETE /clusters/{clusterId}`. ## OpenAPI ````yaml api-reference/energy-management/openapi.es.yaml DELETE /clusters/{clusterId}/locations/{locationId} openapi: 3.1.0 info: title: RiDERgy Energy Management API version: '1.0' license: name: Proprietary identifier: LicenseRef-Proprietary description: > Control programático de los límites de potencia de carga en ubicaciones, cargadores individuales, organizaciones y clústeres entre ubicaciones. ## Autenticación Todos los endpoints excepto `GET /health` y `POST /oauth/token` requieren un token Bearer obtenido mediante el flujo OAuth 2.0 client_credentials: 1. Crea credenciales de cliente OAuth en el panel de RiDERgy. 2. Intercámbialas por un token de acceso de corta duración mediante `POST /oauth/token`. 3. Pasa el token como `Authorization: Bearer ` en cada solicitud. Los tokens expiran tras 3600 segundos. Tu tenant está integrado en el token y no puede ser suplantado. Las credenciales de un tenant no pueden acceder a otro. Tu tenant debe tener habilitada la función Energy Management API; de lo contrario, las solicitudes fallarán con `403 FEATURE_NOT_ENABLED`. Contacta con RiDERgy para habilitarla. ## Scopes Los tokens llevan scopes que controlan qué endpoints son accesibles: `locations:read`, `locations:write`, `clusters:read`, `clusters:write`, `chargers:write`, `org:write`. Las solicitudes a endpoints que requieran un scope que el token no posea fallarán con `403 INSUFFICIENT_SCOPE`. ## Modelo de prioridad Los límites de ubicación y de cargador se controlan mediante **perfiles con ventanas de prioridad**: - Las prioridades van de **0 (la más baja) a 10 (la más alta)**, al estilo de la pila OCPP. - Un objetivo (ubicación o conector de cargador) puede tener hasta 11 perfiles, uno por nivel de prioridad, cada uno con su propia ventana `[startTime, endTime)`. - En cualquier momento, el **límite efectivo** es el `limitKw` del perfil de mayor prioridad cuya ventana esté actualmente activa. - Si no hay ningún perfil activo, una ubicación recurre a su `permanentLimitKw`. - Enviar un perfil con una prioridad que ya tiene uno para ese objetivo lo **reemplaza**. - Los perfiles se aplican y revierten automáticamente en su `startTime`/`endTime`. No se necesitan más llamadas a la API una vez creado un perfil. Los registros de perfiles nunca se eliminan, por lo que el historial sigue siendo consultable. ## Errores Todos los errores comparten esta forma: ```json { "error": { "code": "LOCATION_NOT_FOUND", "message": "Location 123 was not found for the provided tenant", "requestId": "b1f6e6b0-..." } } ``` servers: - url: https://api.ridergy.com/v1 description: Production security: - BearerAuth: [] tags: - name: Auth description: Endpoint de token OAuth 2.0 para el grant client_credentials. - name: Health description: Comprobación de estado del servicio sin autenticación. - name: Locations description: >- Consultar y establecer límites de potencia y perfiles de prioridad a nivel de ubicación. - name: Chargers description: >- Bloquear conectores de cargadores individuales a un límite de potencia fijo durante una ventana de tiempo. - name: Organizations description: >- Perfiles de límite a nivel de organización (solo se registran; la aplicación aún no está activa). - name: Clusters description: >- Agrupar ubicaciones bajo un límite de kW compartido y aplicar horarios entre ellas. paths: /clusters/{clusterId}/locations/{locationId}: delete: tags: - Clusters summary: Remove a location from a cluster description: | Elimina una ubicación de la lista `locationIds` de un clúster. Es una alternativa atómica a `PATCH /clusters/{clusterId}` con un array `locationIds` más corto, de modo que las eliminaciones concurrentes no puedan competir entre sí. Un clúster debe tener siempre al menos una ubicación miembro. Eliminar la última falla con `400 CLUSTER_EMPTY`. En ese caso, elimina el clúster en su lugar con `DELETE /clusters/{clusterId}`. operationId: removeClusterLocation parameters: - $ref: '#/components/parameters/ClusterId' - $ref: '#/components/parameters/LocationId' responses: '200': description: Ubicación eliminada, clúster actualizado devuelto content: application/json: schema: $ref: '#/components/schemas/Cluster' '400': description: Al clúster solo le queda una ubicación content: application/json: schema: $ref: '#/components/schemas/Error' examples: clusterEmpty: summary: CLUSTER_EMPTY value: error: code: CLUSTER_EMPTY message: >- Cannot remove the last location from a cluster; delete the cluster instead requestId: b1f6e6b0-1234-4abc-9def-000000000000 '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/FeatureNotEnabled' '404': description: Clúster no encontrado, o la ubicación no es miembro de él content: application/json: schema: $ref: '#/components/schemas/Error' examples: clusterNotFound: summary: CLUSTER_NOT_FOUND value: error: code: CLUSTER_NOT_FOUND message: Cluster clst_20260612_a1b2c3d4 not found requestId: b1f6e6b0-1234-4abc-9def-000000000000 clusterLocationNotFound: summary: CLUSTER_LOCATION_NOT_FOUND value: error: code: CLUSTER_LOCATION_NOT_FOUND message: >- Location 3632155 is not a member of cluster clst_20260612_a1b2c3d4 requestId: b1f6e6b0-1234-4abc-9def-000000000000 components: parameters: ClusterId: name: clusterId description: El identificador único del clúster, devuelto al crearlo. in: path required: true schema: type: string example: clst_20260612_a1b2c3d4 LocationId: name: locationId description: El identificador único de la ubicación. in: path required: true schema: type: string example: '3632155' schemas: Cluster: type: object properties: clusterId: type: string example: clst_20260612_a1b2c3d4 tenantUuid: type: string name: type: string example: North Campus locationIds: type: array items: type: string example: - '3632155' - '3632156' limitKw: type: - number - 'null' example: 200 status: type: string enum: - ACTIVE - INACTIVE createdAt: type: string format: date-time updatedAt: type: string format: date-time Error: type: object properties: error: type: object properties: code: type: string example: LOCATION_NOT_FOUND message: type: string example: Location 123 was not found for the provided tenant requestId: type: string format: uuid responses: Unauthorized: description: Token Bearer ausente, no válido o expirado content: application/json: schema: $ref: '#/components/schemas/Error' examples: unauthorized: value: error: code: UNAUTHORIZED message: Invalid or expired token requestId: b1f6e6b0-1234-4abc-9def-000000000000 FeatureNotEnabled: description: El tenant no tiene habilitada la Energy Management API content: application/json: schema: $ref: '#/components/schemas/Error' examples: featureNotEnabled: value: error: code: FEATURE_NOT_ENABLED message: >- The Energy Management API is not enabled for your account. Contact RiDERgy to enable this feature. requestId: b1f6e6b0-1234-4abc-9def-000000000000 securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: > Token de acceso OAuth 2.0 obtenido mediante `POST /oauth/token` con grant client_credentials. El tenant y los scopes están integrados en el JWT. No se necesitan cabeceras adicionales. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.