> ## 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`. Devuelve los recursos de operación creados con el mismo contrato canónico de consulta por id. **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-v2.json post /v2/organizations/{organization_id}/operations openapi: 3.0.3 info: title: API Pública Portal version: 2.0.0 description: API pública REST para Portal servers: - url: https://api.flexxible.net description: Portal API (production) security: - bearerAuth: [] tags: - name: Actividad digital description: Creación de grupos de procesos core por organización - name: Roles description: Endpoint de creaciÓn de roles de organización - name: Usuarios description: Endpoint de creación de usuarios de organización - name: Grupos de workspaces description: Endpoints de gestión de grupos de workspaces - name: Workspaces description: Endpoint de eliminacion de workspaces de la organización - name: Aplicaciones instaladas description: Endpoint de detalle de aplicación instalada de la organización - name: Autenticación description: Endpoints de autenticación y contexto de sesión - name: Microservicios description: Detalle de microservicios por organización - name: Operaciones description: Consulta de detalle de operaciones por organización - name: Organización description: Operaciones de organización - name: Objetivos de política de parches description: Endpoints de gestión de objetivos de política de parches - name: Configuraciones de producto description: Endpoints de gestión de configuraciones de producto - name: Grupos de reporte description: Operaciones sobre grupos de reporte - name: Sesiones description: Endpoint de detalle de sesión de la organización - name: Tenants description: Endpoints de gestión de tenants paths: /v2/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`. Devuelve los recursos de operación creados con el mismo contrato canónico de consulta por id. **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}$ requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateOperationV2Request' responses: '201': description: Operaciones creadas correctamente. content: application/json: schema: $ref: '#/components/schemas/CreateOperationV2Response' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '422': $ref: '#/components/responses/UnprocessableEntity' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: CreateOperationV2Request: type: object required: - type - target properties: type: type: string enum: - execute_microservice - delete_workspaces - shutdown_workspaces - restart_workspaces - suspend_workspaces target: type: object required: - type - ids properties: type: type: string enum: - workspaces - sessions ids: type: array minItems: 1 maxItems: 20000 items: type: string minLength: 1 maxLength: 64 additionalProperties: false expiration_in_seconds: type: integer maximum: 84600 minimum: 600 payload: type: object additionalProperties: true additionalProperties: false CreateOperationV2Response: type: object required: - data properties: data: type: array minItems: 1 items: $ref: '#/components/schemas/GetOperationByIdResponseV1' GetOperationByIdResponseV1: type: object properties: id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de la ejecución de operación. name: type: string description: Nombre de la operación. organization_id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de la organización propietaria de la operación. description: type: string description: >- Descripción de la operación. Se devuelve cadena vacía cuando no existe en origen. status: type: string enum: - finished - unknown - error - pending - in-progress - timeout - cancelled - scheduled description: Estado actual de la operación. created_at: type: string format: date-time description: Marca temporal de creación. started_at: type: string format: date-time nullable: true description: Marca temporal de inicio. ended_at: type: string format: date-time nullable: true description: Marca temporal de finalización. microservice_id: type: string nullable: true pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador del microservicio relacionado, cuando exista. flow_id: type: string nullable: true pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador del flujo relacionado, cuando exista. remote_support: $ref: '#/components/schemas/GetOperationByIdRemoteSupportV1' required: - id - organization_id - name - description - status - created_at ErrorResponse: type: object properties: error: type: object properties: message: type: string code: type: string details: type: string required: - message - code required: - error GetOperationByIdRemoteSupportV1: type: object nullable: true properties: start_date: type: string format: date-time nullable: true description: Fecha de inicio del soporte remoto. end_date: type: string format: date-time nullable: true description: Fecha de fin del soporte remoto. type: type: string nullable: true description: Tipo de sesión de soporte remoto. 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 ````