---
title: "Eliminar una conexión"
method: POST
path: "/v1/tools/conexiones.conexion.eliminar/execute"
tags: ["conexiones"]
---

# Eliminar una conexión

`POST /v1/tools/conexiones.conexion.eliminar/execute`

## Request

- Base URL: `https://connect.emisso.ai/api`
- URL: `https://connect.emisso.ai/api/v1/tools/conexiones.conexion.eliminar/execute`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://connect.emisso.ai/authorize`, token URL `https://connect.emisso.ai/token`, scopes: `conexiones:delete`)

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. 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.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `input` ConexionesConexionEliminarInput, required
    - `conexionId` string, required: conn_… de la conexión a eliminar.
    - `confirmarNombre` string, required: 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.

## Response `200`

La tool corrió bien. 'data' es la salida de la tool tal cual, y 'meta' trae el 'request_id' que identifica esta llamada en la bitácora.

- object
  - `data` ConexionesConexionEliminarOutput, required
    - `id` string, required: El id de la conexión que se eliminó (conn_…). Ya no sirve como connectionId.
    - `sistema` string, required: El código del sistema de la conexión eliminada.
    - `nombre` string, required: El nombre que tenía la conexión.
    - `registros` integer, required: Cuántos registros guardados de ese sistema se borraron con ella (documentos, movimientos, saldos y respuestas guardadas).
    - `sincronizaciones` integer, required: Cuántas sincronizaciones de su historial se borraron.
    - `webhooks` integer, required: Cuántas suscripciones de webhook atadas a esta conexión se borraron.
  - `meta` ResponseMeta
    - `request_id` string, required: Identificador que el servidor le da a esta llamada (req_…). Correlaciona con la fila de la bitácora y es lo primero que pide soporte: guárdalo en tus logs.
    - `operation_request_id` string, uuid: Identidad del intento e-Boleta original. Se conserva al reproducir el resultado del journal; request_id identifica la llamada actual.
    - `tool_id` string, required: La tool que se ejecutó, con su id punteado.
    - `plane` 'action' | 'read', required: 'read' = la llamada escribió en el plano persistido (un sync). 'action' = efímera, no persistió nada de negocio: actuar afuera, o leer lo que un sync ya dejó.
    - `latency_ms` integer, required: Cuánto tardó la ejecución, en milisegundos.
    - `audit_status` 'recorded' | 'degraded', required: 'recorded' = la bitácora recibió la fila de esta llamada. 'degraded' = la acción se hizo pero el registro cayó a un respaldo duradero. Nunca convierte una acción exitosa en un error, porque reintentar por eso sería pagar o emitir dos veces.
    - `idempotency` 'replayed': Presente solo cuando una tool destructiva devolvió la respuesta guardada de un intento previo con la misma Idempotency-Key. Significa que en ESTA llamada no ocurrió ningún efecto nuevo.

## Other responses

- `400`: validation_error (400)
- `401`: unauthorized (401)
- `403`: scope_not_granted | connection_scope_not_enabled | alcance_not_enabled
- `404`: tool_not_found (404)
- `409`: connection_ambiguous | connection_busy
- `428`: connection_credential_required (428)
- `500`: internal_error (500)

---

[API](https://skmtc.dev/emisso/apis/emisso-connect-api.md) · [All operations](https://skmtc.dev/emisso/apis/emisso-connect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emisso/apis/emisso-connect-api/revisions/e766c01ef2a0?raw)