# Eliminar una conexión

> Elimina una conexión de esta organización y todo lo que cuelga de ella: la credencial guardada, los datos sincronizados, su historial de sincronizaciones y sus webhooks.



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

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

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

NO SE PUEDE DESHACER: para volver a usar el sistema hay que conectarlo de nuevo y sincronizar desde cero. Úsala sólo si la persona pidió eliminar esa conexión en particular; para renovar una credencial usa conexiones.enlace.crear en modo 'reconectar'. Pide 'conexionId' y 'confirmarNombre', ambos tal como los devuelve conexiones.estado.consultar. La conexión deja de sumarse a los próximos cobros.

## Entrada [#entrada]

| Campo             | Tipo   | Requerido | Descripción                                                                                                                                                               |
| ----------------- | ------ | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `conexionId`      | string | sí        | conn\_… de la conexión a eliminar.                                                                                                                                        |
| `confirmarNombre` | string | sí        | El nombre exacto de la conexión, tal como aparece en 'nombre' de conexiones.estado.consultar. Es la confirmación: si no coincide carácter por carácter, no se borra nada. |

<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 eliminar."
      },
      "confirmarNombre": {
        "type": "string",
        "description": "El nombre exacto de la conexión, tal como aparece en 'nombre' de conexiones.estado.consultar. Es la confirmación: si no coincide carácter por carácter, no se borra nada."
      }
    },
    "required": [
      "conexionId",
      "confirmarNombre"
    ]
  }
  ```
</details>

## Ejemplo [#ejemplo]

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

```ts title="SDK TypeScript"
const data = await connect.tools.conexiones.conexion.eliminar({ conexionId: "conn_9tKfR2mQx4Vb", confirmarNombre: "Comercial Aurora SpA" });
```

```json title="MCP · meta-tool execute"
{
  "tool": "conexiones.conexion.eliminar",
  "params": {
    "conexionId": "conn_9tKfR2mQx4Vb",
    "confirmarNombre": "Comercial Aurora SpA"
  }
}
```

**Salida esperada (200):**

```json
{
  "data": {
    "id": "conn_9tKfR2mQx4Vb",
    "sistema": "sii",
    "nombre": "Comercial Aurora SpA",
    "registros": 1842,
    "sincronizaciones": 37,
    "webhooks": 0
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "conexiones.conexion.eliminar",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}
```

> Irreversible. Con una sincronización en curso responde 'connection\_busy': espera a que termine y reintenta.

## Salida [#salida]

| Campo              | Tipo   | Requerido | Descripción                                                                                                               |
| ------------------ | ------ | --------- | ------------------------------------------------------------------------------------------------------------------------- |
| `id`               | string | sí        | El id de la conexión que se eliminó (conn\_…). Ya no sirve como connectionId.                                             |
| `sistema`          | string | sí        | El código del sistema de la conexión eliminada.                                                                           |
| `nombre`           | string | sí        | El nombre que tenía la conexión.                                                                                          |
| `registros`        | entero | sí        | Cuántos registros guardados de ese sistema se borraron con ella (documentos, movimientos, saldos y respuestas guardadas). |
| `sincronizaciones` | entero | sí        | Cuántas sincronizaciones de su historial se borraron.                                                                     |
| `webhooks`         | entero | sí        | Cuántas suscripciones de webhook atadas a esta conexión se borraron.                                                      |

<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 que se eliminó (conn_…). Ya no sirve como connectionId."
      },
      "sistema": {
        "type": "string",
        "description": "El código del sistema de la conexión eliminada."
      },
      "nombre": {
        "type": "string",
        "description": "El nombre que tenía la conexión."
      },
      "registros": {
        "type": "integer",
        "minimum": -9007199254740991,
        "maximum": 9007199254740991,
        "description": "Cuántos registros guardados de ese sistema se borraron con ella (documentos, movimientos, saldos y respuestas guardadas)."
      },
      "sincronizaciones": {
        "type": "integer",
        "minimum": -9007199254740991,
        "maximum": 9007199254740991,
        "description": "Cuántas sincronizaciones de su historial se borraron."
      },
      "webhooks": {
        "type": "integer",
        "minimum": -9007199254740991,
        "maximum": 9007199254740991,
        "description": "Cuántas suscripciones de webhook atadas a esta conexión se borraron."
      }
    },
    "required": [
      "id",
      "sistema",
      "nombre",
      "registros",
      "sincronizaciones",
      "webhooks"
    ],
    "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).