# Deshabilitar una conexión

> Pausa una conexión de esta organización: deja de sincronizar, sus herramientas responden 'connection_disabled' y deja de sumarse a los próximos cobros.



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

|                     |                                                                     |
| ------------------- | ------------------------------------------------------------------- |
| **Tool ID**         | `conexiones.conexion.deshabilitar`                                  |
| **Nombre MCP**      | `conexiones__conexion__deshabilitar`                                |
| **Conector**        | `conexiones`                                                        |
| **Plano**           | `action`                                                            |
| **Scope (permiso)** | `conexiones:disable`                                                |
| **Auth**            | `none`                                                              |
| **Versión**         | `1`                                                                 |
| **Sensible**        | sí                                                                  |
| **Deprecado**       | no                                                                  |
| **Comportamiento**  | readOnly=false, destructive=false, idempotent=true, openWorld=false |

## Qué hace [#qué-hace]

No borra nada: la credencial, los datos ya sincronizados y el historial se conservan, y conexiones.conexion.habilitar la reanuda. Úsala sólo si la persona pidió pausar esa conexión. Si ya estaba deshabilitada, no cambia nada y responde 'cambiada' en false.

## Entrada [#entrada]

| Campo        | Tipo   | Requerido | Descripción                                                                              |
| ------------ | ------ | --------- | ---------------------------------------------------------------------------------------- |
| `conexionId` | string | sí        | conn\_… de la conexión a deshabilitar, tal como lo devuelve conexiones.estado.consultar. |

<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 deshabilitar, tal como lo devuelve conexiones.estado.consultar."
      }
    },
    "required": [
      "conexionId"
    ]
  }
  ```
</details>

## Ejemplo [#ejemplo]

```bash title="curl"
curl -X POST https://connect.emisso.ai/api/v1/tools/conexiones.conexion.deshabilitar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "Content-Type: application/json" \
  -d '{"input":{"conexionId":"conn_9tKfR2mQx4Vb"}}'
```

```ts title="SDK TypeScript"
const data = await connect.tools.conexiones.conexion.deshabilitar({ conexionId: "conn_9tKfR2mQx4Vb" });
```

```json title="MCP · meta-tool execute"
{
  "tool": "conexiones.conexion.deshabilitar",
  "params": {
    "conexionId": "conn_9tKfR2mQx4Vb"
  }
}
```

**Salida esperada (200):**

```json
{
  "data": {
    "id": "conn_9tKfR2mQx4Vb",
    "sistema": "sii",
    "nombre": "Comercial Aurora SpA",
    "estado": "disabled",
    "cambiada": true
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "conexiones.conexion.deshabilitar",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}
```

## Salida [#salida]

| Campo      | Tipo                                    | Requerido | Descripción                                                                                                                                                                        |
| ---------- | --------------------------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`       | string                                  | sí        | El id de la conexión (conn\_…).                                                                                                                                                    |
| `sistema`  | string                                  | sí        | El código del sistema de la conexión.                                                                                                                                              |
| `nombre`   | string                                  | sí        | El nombre de la conexión.                                                                                                                                                          |
| `estado`   | `"active"` · `"disabled"` · `"pending"` | sí        | En qué estado está la conexión. 'active' = utilizable. 'disabled' = pausada, sus tools responden 'connection\_disabled'. 'pending' = creada pero todavía sin credencial vinculada. |
| `cambiada` | booleano                                | sí        | true si esta llamada cambió el estado; false si la conexión ya estaba así y no se tocó nada.                                                                                       |

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

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "description": "El id de la conexión (conn_…)."
      },
      "sistema": {
        "type": "string",
        "description": "El código del sistema de la conexión."
      },
      "nombre": {
        "type": "string",
        "description": "El nombre de la conexión."
      },
      "estado": {
        "type": "string",
        "enum": [
          "active",
          "disabled",
          "pending"
        ],
        "description": "En qué estado está la conexión. 'active' = utilizable. 'disabled' = pausada, sus tools responden 'connection_disabled'. 'pending' = creada pero todavía sin credencial vinculada."
      },
      "cambiada": {
        "type": "boolean",
        "description": "true si esta llamada cambió el estado; false si la conexión ya estaba así y no se tocó nada."
      }
    },
    "required": [
      "id",
      "sistema",
      "nombre",
      "estado",
      "cambiada"
    ],
    "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](../errores).