> ## Documentation Index > Fetch the complete documentation index at: https://docsnewgen.flexxible.com/llms.txt > Use this file to discover all available pages before exploring further. # Crear operaciones > Crea una o varias operaciones en base al alcance y objetivos enviados. Tipos de operación disponibles actualmente: `execute_microservice`, `delete_workspaces`, `shutdown_workspaces` y `restart_workspaces`. **Compatibilidad de parámetros para `execute_microservice`** `payload.parameters` solo aplica a ejecuciones de microservicios PowerShell en Windows y solo está soportado en dispositivos con el nuevo agente instalado. Los valores enviados en `payload.parameters` se transmiten como texto (`string`). La interpretación de tipos depende de la definición de parámetros y del parseo implementado en el script del microservicio. Para ese contexto, tipos de datos de los parámetros recomendados: - `string`, `integer`, `double`, `decimal` y `datetime`. - Para `double` y `decimal`, use notación con punto decimal (`.`). - Para `datetime`, use formato ISO 8601 (por ejemplo: `2026-07-09T10:30:00Z`). - Al ejecutarse en el destino, los valores `datetime` pueden representarse en hora local. - La ejecución correcta también depende de la calidad y validaciones del script. ## OpenAPI ````yaml /api-reference/openapi-v1.json post /v1/organizations/{organization_id}/operations openapi: 3.0.3 info: title: API Pública Portal version: 1.0.0 description: API pública REST para Portal servers: - url: https://api.flexxible.net/ description: Portal API security: - bearerAuth: [] tags: [] paths: /v1/organizations/{organization_id}/operations: post: tags: - Operaciones summary: Crear operaciones description: >- Crea una o varias operaciones en base al alcance y objetivos enviados. Tipos de operación disponibles actualmente: `execute_microservice`, `delete_workspaces`, `shutdown_workspaces` y `restart_workspaces`. **Compatibilidad de parámetros para `execute_microservice`** `payload.parameters` solo aplica a ejecuciones de microservicios PowerShell en Windows y solo está soportado en dispositivos con el nuevo agente instalado. Los valores enviados en `payload.parameters` se transmiten como texto (`string`). La interpretación de tipos depende de la definición de parámetros y del parseo implementado en el script del microservicio. Para ese contexto, tipos de datos de los parámetros recomendados: - `string`, `integer`, `double`, `decimal` y `datetime`. - Para `double` y `decimal`, use notación con punto decimal (`.`). - Para `datetime`, use formato ISO 8601 (por ejemplo: `2026-07-09T10:30:00Z`). - Al ejecutarse en el destino, los valores `datetime` pueden representarse en hora local. - La ejecución correcta también depende de la calidad y validaciones del script. operationId: createOperations parameters: - name: organization_id in: path required: true schema: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: Identificador único de la organización. example: 507f1f77bcf86cd799439011 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateOperationV1Request' examples: workspace_scope: summary: Crear operación sobre workspaces value: type: execute_microservice target: type: workspaces ids: - 507f1f77bcf86cd799439011 - 507f1f77bcf86cd799439012 expiration_in_seconds: 600 payload: microservice_id: 507f1f77bcf86cd799439015 parameters: mode: safe session_scope: summary: Crear operación sobre sesiones value: type: execute_microservice target: type: sessions ids: - 550E8400-E29B-41D4-A716-446655440000 - 7F5C3F8D-8A9B-4C8D-B8D1-123456789ABC payload: microservice_id: 507f1f77bcf86cd799439015 parameters: mode: safe delete_workspaces_workspace_scope: summary: Crear operación delete_workspaces sobre workspaces value: type: delete_workspaces target: type: workspaces ids: - 507f1f77bcf86cd799439011 - 507f1f77bcf86cd799439012 shutdown_workspaces_workspace_scope: summary: Crear operación shutdown_workspaces sobre workspaces value: type: shutdown_workspaces target: type: workspaces ids: - 507f1f77bcf86cd799439011 restart_workspaces_workspace_scope_with_expiration: summary: >- Crear operación restart_workspaces sobre workspaces con expiración personalizada value: type: restart_workspaces target: type: workspaces ids: - 507f1f77bcf86cd799439011 expiration_in_seconds: 1200 suspend_workspaces_workspace_scope: summary: Crear operación suspend_workspaces sobre workspaces value: type: suspend_workspaces target: type: workspaces ids: - 507f1f77bcf86cd799439011 responses: '201': description: Operaciones creadas correctamente. content: application/json: schema: $ref: '#/components/schemas/CreateOperationV1Response' example: ids: - organization_id: 507f1f77bcf86cd799439011 operation_id: 507f1f77bcf86cd799439031 '400': $ref: '#/components/responses/BadRequest' description: >- Solicitud incorrecta. Causas comunes: tipo no soportado, target.type inválido, target.ids vacio, expiration_in_seconds fuera de rango, o payload no permitido para delete_workspaces/shutdown_workspaces/restart_workspaces/suspend_workspaces. '401': $ref: '#/components/responses/Unauthorized' description: No autorizado. '404': $ref: '#/components/responses/NotFound' description: Organización no encontrada. '422': $ref: '#/components/responses/UnprocessableEntity' description: >- Entidad no procesable. Causas comunes: objetivos no resolubles en la organización, o permisos insuficientes sobre reporting groups. '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: CreateOperationV1Request: type: object required: - type - target properties: type: type: string description: Tipo de comando de operación. enum: - execute_microservice - delete_workspaces - shutdown_workspaces - restart_workspaces - suspend_workspaces target: type: object description: Objeto de alcance y objetivos. required: - type - ids properties: type: type: string description: >- Alcance de objetivos. Para delete_workspaces/shutdown_workspaces/restart_workspaces/suspend_workspaces solo se permite workspaces. enum: - workspaces - sessions ids: type: array description: >- Lista de identificadores objetivo. Para workspaces se esperan ids; para sessions se esperan UUID en mayuscula. minItems: 1 maxItems: 20000 items: type: string minLength: 1 maxLength: 64 additionalProperties: false expiration_in_seconds: type: integer maximum: 84600 minimum: 600 description: >- Expiración personalizada en segundos. Si se omite se usa el valor por defecto del comando. payload: type: object description: >- Carga específica del tipo de operación. Para delete_workspaces/shutdown_workspaces/restart_workspaces/suspend_workspaces no se permite payload. additionalProperties: true additionalProperties: false CreateOperationV1Response: type: object required: - ids properties: ids: type: array description: >- Identificadores de operaciones creadas en el mismo orden de creación. minItems: 1 items: type: object required: - organization_id - operation_id properties: organization_id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de la organización propietaria de la operación. operation_id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de la operación creada. 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' 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 ````