Operaciones

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.

POST

organizations

{organization_id}

operations

curl --request POST \
  --url https://api.flexxible.net/v1/organizations/{organization_id}/operations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "execute_microservice",
  "target": {
    "type": "workspaces",
    "ids": [
      "507f1f77bcf86cd799439011",
      "507f1f77bcf86cd799439012"
    ]
  },
  "expiration_in_seconds": 600,
  "payload": {
    "microservice_id": "507f1f77bcf86cd799439015",
    "parameters": {
      "mode": "safe"
    }
  }
}
'

{
  "ids": [
    {
      "organization_id": "507f1f77bcf86cd799439011",
      "operation_id": "507f1f77bcf86cd799439031"
    }
  ]
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

Autorizaciones

Authorization

string

header

requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parámetros de ruta

organization_id

string

requerido

Identificador único de la organización.

Maximum string length: 24

Pattern: ^[0-9a-f]{24}$

Cuerpo

application/json

type

enum<string>

requerido

Tipo de comando de operación.

Opciones disponibles:

execute_microservice,

delete_workspaces,

shutdown_workspaces,

restart_workspaces,

suspend_workspaces

target

object

requerido

Objeto de alcance y objetivos.

Show child attributes

expiration_in_seconds

integer

Expiración personalizada en segundos. Si se omite se usa el valor por defecto del comando.

Rango requerido: 600 <= x <= 84600

payload

object

Carga específica del tipo de operación. Para delete_workspaces/shutdown_workspaces/restart_workspaces/suspend_workspaces no se permite payload.

Respuesta

Operaciones creadas correctamente.

ids

object[]

requerido

Identificadores de operaciones creadas en el mismo orden de creación.

Minimum array length: 1

Show child attributes

⌘I

curl --request POST \
  --url https://api.flexxible.net/v1/organizations/{organization_id}/operations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "execute_microservice",
  "target": {
    "type": "workspaces",
    "ids": [
      "507f1f77bcf86cd799439011",
      "507f1f77bcf86cd799439012"
    ]
  },
  "expiration_in_seconds": 600,
  "payload": {
    "microservice_id": "507f1f77bcf86cd799439015",
    "parameters": {
      "mode": "safe"
    }
  }
}
'

{
  "ids": [
    {
      "organization_id": "507f1f77bcf86cd799439011",
      "operation_id": "507f1f77bcf86cd799439031"
    }
  ]
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<string>"
  }
}

API Gen 2

Recursos API Gen 2 - v2

Recursos API Gen 2 - v1

Crear operaciones

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta