> ## 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 operacions > Crea una o diverses operacions basades en l'abast i els objectius enviats. Tipus d'operació actualment disponibles: `execute_microservice`, `delete_workspaces`, `shutdown_workspaces` i `restart_workspaces`. Retorna els recursos d'operació creats amb el mateix contracte canònic de consulta per id. **Compatibilitat de paràmetres per a `execute_microservice`** `payload.parameters` només aplica a execucions de microserveis PowerShell en Windows i només està suportat en dispositius amb el nou agent instal·lat. Els valors enviats a `payload.parameters` es transmeten com a text (`string`). La interpretació de tipus depèn de la definició de paràmetres i del parseig implementat en el script del microservei. Per a aquest context, tipus de dades dels paràmetres recomanats: - `string`, `integer`, `double`, `decimal` i `datetime`. - Per a `double` i `decimal`, useu notació amb punt decimal (`.`). - Per a `datetime`, useu el format ISO 8601 (per exemple: `2026-07-09T10:30:00Z`). - A l'executar-se al destí, els valors `datetime` es poden representar en hora local. - L'execució correcta també depèn de la qualitat i validacions de l'script. ## OpenAPI ````yaml /ca/api-reference/openapi.ca-v2.json post /v2/organizations/{organization_id}/operations openapi: 3.0.3 info: title: API Publica Portal version: 2.0.0 description: API pública REST per al portal servers: - url: https://api.flexxible.net description: Portal API (production) security: - bearerAuth: [] tags: - name: Activitat digital description: Creació de grups de processos core per organització - name: Roles description: Endpoint de creacion de roles de organizacion - name: Usuarios description: Endpoint de creacion de usuarios de organizacion - name: Grupos de workspaces description: Endpoints de gestión de grupos de workspaces - name: Workspaces description: Endpoint de eliminacion de workspaces de la organizacion - 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 organizacion - 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 sesion de la organizacion - name: Tenants description: Endpoints de gestión de tenants paths: /v2/organizations/{organization_id}/operations: post: tags: - Operacions summary: Crear operacions description: >- Crea una o diverses operacions basades en l'abast i els objectius enviats. Tipus d'operació actualment disponibles: `execute_microservice`, `delete_workspaces`, `shutdown_workspaces` i `restart_workspaces`. Retorna els recursos d'operació creats amb el mateix contracte canònic de consulta per id. **Compatibilitat de paràmetres per a `execute_microservice`** `payload.parameters` només aplica a execucions de microserveis PowerShell en Windows i només està suportat en dispositius amb el nou agent instal·lat. Els valors enviats a `payload.parameters` es transmeten com a text (`string`). La interpretació de tipus depèn de la definició de paràmetres i del parseig implementat en el script del microservei. Per a aquest context, tipus de dades dels paràmetres recomanats: - `string`, `integer`, `double`, `decimal` i `datetime`. - Per a `double` i `decimal`, useu notació amb punt decimal (`.`). - Per a `datetime`, useu el format ISO 8601 (per exemple: `2026-07-09T10:30:00Z`). - A l'executar-se al destí, els valors `datetime` es poden representar en hora local. - L'execució correcta també depèn de la qualitat i validacions de l'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: Operacions creades correctament. 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 l'execució de l'operació. name: type: string description: Nom de l'operació. organization_id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de l'organització propietària de l'operació. description: type: string description: >- Descripció de l'operació. Es retorna cadena buida quan no existeix en origen. status: type: string enum: - finished - unknown - error - pending - in-progress - timeout - cancelled - scheduled description: Estat actual de l'operació. created_at: type: string format: date-time description: Marca temporal de creació. started_at: type: string format: date-time nullable: true description: Marca temporal d'inici. ended_at: type: string format: date-time nullable: true description: Marca temporal de finalització. microservice_id: type: string nullable: true pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador del microservei relacionat, quan existeixi. flow_id: type: string nullable: true pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador del flux relacionat, quan existeixi. 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: Data d'inici del suport remot. end_date: type: string format: date-time nullable: true description: Data de finalització del suport remot. type: type: string nullable: true description: Tipus de sessió de suport remot. responses: BadRequest: description: Sol·licitud incorrecta content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: No autoritzat content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' NotFound: description: No trobat content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' UnprocessableEntity: description: Entitat no processable content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' TooManyRequests: description: Masses sol·licituds content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalServerError: description: Error intern del servidor content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````