> ## Documentation Index > Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt > Use this file to discover all available pages before exploring further. # Crear una programación cron > Crea una nueva programación cron para un grupo de workspaces. Las programaciones definen operaciones automatizadas de energía (START, STOP, RESTART) que se ejecutan en programaciones especificadas según expresiones cron y zona horaria. Las programaciones START pueden incluir opcionalmente un ID de Workspace de dispositivo intermedio para operaciones Wake on LAN en redes seguras. Si se proporciona intermediate_device, indica que se debe usar un dispositivo intermedio. El sistema valida que no exista una programación en conflicto (mismo tipo, hora y día después de la conversión de zona horaria). ## OpenAPI ````yaml /api-reference/openapi-v1.json post /v1/organizations/{organization_id}/workspace-groups/{workspace_group_id}/schedules openapi: 3.0.3 info: title: API Publica Portal version: 1.0.0 description: Api publica REST para portal servers: - url: https://api.staging.flxwvdexternal.com description: Staging API server security: - bearerAuth: [] tags: [] paths: /v1/organizations/{organization_id}/workspace-groups/{workspace_group_id}/schedules: post: tags: - Grupos de workspaces summary: Crear una programación cron description: >- Crea una nueva programación cron para un grupo de workspaces. Las programaciones definen operaciones automatizadas de energía (START, STOP, RESTART) que se ejecutan en programaciones especificadas según expresiones cron y zona horaria. Las programaciones START pueden incluir opcionalmente un ID de Workspace de dispositivo intermedio para operaciones Wake on LAN en redes seguras. Si se proporciona intermediate_device, indica que se debe usar un dispositivo intermedio. El sistema valida que no exista una programación en conflicto (mismo tipo, hora y día después de la conversión de zona horaria). operationId: createWorkspaceGroupSchedule parameters: - name: organization_id in: path required: true schema: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: El identificador único de la organización example: 507f1f77bcf86cd799439011 - name: workspace_group_id in: path required: true schema: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: El identificador único del grupo de workspaces example: 507f1f77bcf86cd799439020 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateWorkspaceGroupScheduleRequestV1' examples: create-start-schedule: summary: Crear una programación START para días laborables a las 8 AM value: cron_expression: 0 8 * * 1-5 time_zone: Eastern Standard Time type: start create-start-schedule-with-intermediate-device: summary: >- Crear una programación START con dispositivo intermedio para Wake-on-LAN value: cron_expression: 0 8 * * 1-5 time_zone: Eastern Standard Time type: start intermediate_device: 507f1f77bcf86cd799439050 create-stop-schedule: summary: Crear una programación STOP para días laborables a las 6 PM value: cron_expression: 0 18 * * 1-5 time_zone: UTC type: stop create-restart-schedule: summary: >- Crear una programación RESTART para fines de semana a la medianoche value: cron_expression: 0 0 * * 0,6 time_zone: Pacific Standard Time type: restart responses: '201': description: >- Programación creada correctamente. La respuesta contiene el recurso de programación creado. content: application/json: schema: $ref: '#/components/schemas/WorkspaceGroupScheduleV1' '400': $ref: '#/components/responses/BadRequest' description: >- Solicitud incorrecta. Causas comunes: - Faltan campos obligatorios (cron_expression, time_zone, type) - Formato de expresión cron inválido - Valor de zona horaria inválido - Tipo de programación inválido (debe ser START, STOP o RESTART) - Formato de ID de Workspace de intermediate_device inválido '401': $ref: '#/components/responses/Unauthorized' description: >- No autorizado: el usuario no tiene acceso a la organización o la organización no existe '404': $ref: '#/components/responses/NotFound' description: >- Grupo de workspaces no encontrado o el grupo de workspaces pertenece a una organización diferente (después de pasar la autorización) '409': $ref: '#/components/responses/Conflict' description: >- Conflicto: ya existe una programación con el mismo tipo, hora y día (después de la conversión de zona horaria) '422': $ref: '#/components/responses/UnprocessableEntity' description: >- Entidad no procesable. Causas comunes: - El ID de Workspace de intermediate_device no existe o no pertenece a la organización '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: CreateWorkspaceGroupScheduleRequestV1: type: object properties: cron_expression: type: string description: >- Expresión cron que define cuándo debe ejecutarse la programación. Formato: minuto hora día-del-mes mes día-de-la-semana. Ejemplos: '0 8 * * 1-5' (8 AM en días laborables), '0 0 * * 0' (medianoche del domingo), '30 14 * * *' (2:30 PM diariamente). Día-de-la-semana: 0=domingo, 1=lunes, ..., 6=sábado. Admite rangos (1-5), listas (1,3,5) y comodines (*). Debe ser un formato de expresión cron válido con 5 campos separados por espacios. example: 0 8 * * 1-5 time_zone: type: string description: >- Zona horaria para la ejecución de la programación. Admite identificadores IANA (p. ej., 'America/New_York') y Windows (p. ej., 'Pacific Standard Time'). example: Eastern Standard Time type: type: string enum: - start - stop - restart description: >- Tipo de operación de energía a realizar. START: Enciende los Workspaces del grupo. STOP: Apaga los Workspaces del grupo. RESTART: Reinicia los Workspaces del grupo. example: start intermediate_device: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: >- Opcional. El identificador único del Workspace de dispositivo intermedio. Si se proporciona, indica que se debe usar un dispositivo intermedio para operaciones Wake on LAN. Solo aplicable a programaciones START. Se usa para acciones Wake on LAN en redes seguras. El Workspace debe existir y pertenecer a la organización. example: 507f1f77bcf86cd799439050 required: - cron_expression - time_zone - type WorkspaceGroupScheduleV1: type: object required: - id - cron_expression - time_zone - type properties: id: type: string pattern: ^[0-9a-f]{24}$ description: El identificador único de la programación example: 507f1f77bcf86cd799439060 cron_expression: type: string description: >- Expresión cron que define cuándo se ejecuta la programación. Formato: minuto hora día-del-mes mes día-de-la-semana. example: 0 8 * * 1-5 time_zone: type: string description: >- Zona horaria para la ejecución de la programación. Admite identificadores IANA (p. ej., 'America/New_York') y Windows (p. ej., 'Pacific Standard Time'). example: Eastern Standard Time type: type: string enum: - start - stop - restart description: >- Tipo de operación de energía: START (enciende), STOP (apaga), RESTART (reinicia Workspaces) intermediate_device: type: string pattern: ^[0-9a-f]{24}$ nullable: true description: >- El identificador único del workspace del dispositivo intermedio, si está configurado. Se usa para acciones de Wake on LAN en redes seguras. example: 507f1f77bcf86cd799439050 created_by: type: string pattern: ^[0-9a-f]{24}$ nullable: true description: ID de usuario que creó la programación example: 507f1f77bcf86cd799439070 ErrorResponse: type: object properties: error: type: object properties: message: type: string code: type: string details: type: string required: - message - code required: - error responses: BadRequest: description: Solicitud incorrecta content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: No autorizado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' NotFound: description: No encontrado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Conflict: description: Conflicto content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' UnprocessableEntity: description: Entidad no procesable content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' TooManyRequests: description: Demasiadas solicitudes content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalServerError: description: Error interno del servidor content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````