# Mover conexión de grupo

> Mueve una conexión.



{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}

|                     |                                                                     |
| ------------------- | ------------------------------------------------------------------- |
| **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 [#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 [#entrada]

| Campo        | Tipo   | Requerido | Descripción                     |                                                              |
| ------------ | ------ | --------- | ------------------------------- | ------------------------------------------------------------ |
| `conexionId` | string | sí        | conn\_… de la conexión a mover. |                                                              |
| `grupoId`    | string | null      | sí                              | cgrp\_… del grupo de destino, o null para dejarla sin grupo. |

<details>
  <summary>
    JSON Schema de entrada
  </summary>

  ```json
  {
    "$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"
    ]
  }
  ```
</details>

## Ejemplo [#ejemplo]

```bash title="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"}}'
```

```json title="MCP · meta-tool execute_write"
{
  "tool": "conexiones.grupos.mover",
  "params": {
    "conexionId": "conn_9tKfR2mQx4Vb",
    "grupoId": "cgrp_9f2c1a7d"
  }
}
```

**Salida esperada (200):**

```json
{
  "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 [#salida]

| Campo        | Tipo     | Requerido | Descripción                                                              |                                                              |
| ------------ | -------- | --------- | ------------------------------------------------------------------------ | ------------------------------------------------------------ |
| `conexionId` | string   | sí        | La conexión que se movió (conn\_…).                                      |                                                              |
| `grupoId`    | string   | null      | sí                                                                       | El grupo donde quedó la conexión, o null si quedó sin grupo. |
| `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.                      |                                                              |

<details>
  <summary>
    JSON Schema de salida
  </summary>

  ```json
  {
    "$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
  }
  ```
</details>

## Errores de esta tool [#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](/docs/referencia/errores).


---

Esta página es parte de la documentación de Emisso Connect. El índice completo, con cada página y su descripción, está en https://connect.emisso.ai/llms.txt. Esta misma página en HTML: https://connect.emisso.ai/docs/referencia/conexiones/grupos-mover.