> ## 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. # Crear o reemplazar un perfil de límite para toda la organización > Registra un perfil de límite a nivel de organización para el tenant que realiza la llamada (derivado de la clave de API — sin `orgId` en la ruta ni en el cuerpo). > **Aún no aplicado.** La aplicación del límite a nivel de > organización en las ubicaciones del tenant todavía no está activa > (Fase 3, pospuesta). Los perfiles solo se registran para uso futuro. ## OpenAPI ````yaml /api-reference/energy-management/openapi.es.yaml POST /organizations/schedules 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` requieren una cabecera `x-api-key`. La clave determina tu tenant — nunca se lee del cuerpo de la solicitud ni de ninguna otra cabecera, por lo que una clave de un tenant no puede acceder a los datos de otro tenant. 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. ## 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: - ApiKeyAuth: [] tags: - 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: /organizations/schedules: post: tags: - Organizations summary: Create or replace an organization-wide cap profile description: | Registra un perfil de límite a nivel de organización para el tenant que realiza la llamada (derivado de la clave de API — sin `orgId` en la ruta ni en el cuerpo). > **Aún no aplicado.** La aplicación del límite a nivel de > organización en las ubicaciones del tenant todavía no está activa > (Fase 3, pospuesta). Los perfiles solo se registran para uso futuro. operationId: createOrganizationSchedule requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LimitProfileRequest' examples: example: value: startTime: '2026-06-12T08:00:00Z' endTime: '2026-06-12T18:00:00Z' limitKw: 500 priority: 5 responses: '200': description: Perfil de organización creado/reemplazado content: application/json: schema: $ref: '#/components/schemas/OrgScheduleResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/FeatureNotEnabled' components: schemas: LimitProfileRequest: type: object required: - startTime - endTime - limitKw properties: startTime: type: string format: date-time description: Marca de tiempo UTC en formato ISO-8601. Obligatorio. example: '2026-06-12T08:00:00Z' endTime: type: string format: date-time description: >- Marca de tiempo UTC en formato ISO-8601. Debe ser posterior a `startTime` y futura. Obligatorio. example: '2026-06-12T18:00:00Z' limitKw: type: number format: float exclusiveMinimum: 0 description: Límite de potencia en kW. Debe ser mayor que 0. Obligatorio. example: 50 priority: type: integer minimum: 0 maximum: 10 default: 0 description: | Nivel de prioridad al estilo de la pila OCPP, de 0 (la más baja) a 10 (la más alta). Enviar un perfil con una prioridad que ya existe para este objetivo lo reemplaza. example: 5 OrgScheduleResponse: type: object properties: tenantUuid: type: string priority: type: integer example: 5 limitKw: type: number example: 500 startTime: type: string format: date-time endTime: type: string format: date-time status: $ref: '#/components/schemas/ProfileStatus' note: type: string example: >- Organization-wide cap enforcement is not yet active; this profile is recorded for future use. ProfileStatus: type: string enum: - SCHEDULED - ACTIVE - EXPIRED 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: BadRequest: description: Cuerpo de la solicitud no válido o el objetivo está inactivo content: application/json: schema: $ref: '#/components/schemas/Error' examples: invalidBody: summary: INVALID_REQUEST_BODY value: error: code: INVALID_REQUEST_BODY message: limitKw must be a positive number requestId: b1f6e6b0-1234-4abc-9def-000000000000 targetInactive: summary: TARGET_INACTIVE value: error: code: TARGET_INACTIVE message: Location 123 is not active requestId: b1f6e6b0-1234-4abc-9def-000000000000 Unauthorized: description: Clave de API ausente, no válida o expirada content: application/json: schema: $ref: '#/components/schemas/Error' examples: unauthorized: value: error: code: UNAUTHORIZED message: Invalid or inactive API key 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: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Clave de API por tenant. El tenant se deriva de la clave — nunca de la solicitud. ````