Mover conexión de grupo


Tool ID	`conexiones.grupos.mover`
Nombre MCP	`conexiones__grupos__mover`
Conector	`conexiones`
Plano	`action`
Scope (permiso)	`conexiones:grupos:write`
Auth	`none`
Versión	`1`
Sensible	no
Deprecado	no
Comportamiento	readOnly=false, destructive=false, idempotent=true, openWorld=false

Qué hace

La deja al final del grupo indicado, o sin grupo con 'grupoId' en null. No cambia ninguna otra conexión ni grupo. Si ya estaba en ese destino, no cambia nada y responde 'cambiada' en false. Los ids salen de conexiones.grupos.listar y de conexiones.estado.consultar.

Entrada

Campo	Tipo	Requerido	Descripción
`conexionId`	string	sí	conn_… de la conexión a mover.
`grupoId`	string	null	sí

JSON Schema de entrada

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "conexionId": {
      "type": "string",
      "description": "conn_… de la conexión a mover."
    },
    "grupoId": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "cgrp_… del grupo de destino, o null para dejarla sin grupo."
    }
  },
  "required": [
    "conexionId",
    "grupoId"
  ]
}

Ejemplo

curl

curl -X POST https://connect.emisso.ai/api/v1/tools/conexiones.grupos.mover/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "Content-Type: application/json" \
  -d '{"input":{"conexionId":"conn_9tKfR2mQx4Vb","grupoId":"cgrp_9f2c1a7d"}}'

MCP · meta-tool execute_write

{
  "tool": "conexiones.grupos.mover",
  "params": {
    "conexionId": "conn_9tKfR2mQx4Vb",
    "grupoId": "cgrp_9f2c1a7d"
  }
}

Salida esperada (200):

{
  "data": {
    "conexionId": "conn_9tKfR2mQx4Vb",
    "grupoId": "cgrp_9f2c1a7d",
    "cambiada": true,
    "revision": 6
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "conexiones.grupos.mover",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}

Salida

Campo	Tipo	Requerido	Descripción
`conexionId`	string	sí	La conexión que se movió (conn_…).
`grupoId`	string	null	sí
`cambiada`	booleano	sí	true si esta llamada la movió; false si ya estaba ahí y no se tocó nada.
`revision`	entero	sí	La revisión de la estructura después de la llamada.

JSON Schema de salida

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "conexionId": {
      "type": "string",
      "description": "La conexión que se movió (conn_…)."
    },
    "grupoId": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "El grupo donde quedó la conexión, o null si quedó sin grupo."
    },
    "cambiada": {
      "type": "boolean",
      "description": "true si esta llamada la movió; false si ya estaba ahí y no se tocó nada."
    },
    "revision": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "La revisión de la estructura después de la llamada."
    }
  },
  "required": [
    "conexionId",
    "grupoId",
    "cambiada",
    "revision"
  ],
  "additionalProperties": false
}

Errores de esta tool

Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.