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.
| 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 |
Ruta REST exacta: esta operación es la tool
conexiones.conexion.eliminar, ejecutada mediantePOST /api/v1/tools/conexiones.conexion.eliminar/executeconContent-Type: application/jsony el cuerpo{"input":{...}}de esta ficha. No tiene una ruta REST propia bajo/v1/connections/{id}. El título describe la tool, no una ruta.
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
| 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. |
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 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"
]
}Ejemplo
curl -X POST https://connect.emisso.ai/api/v1/tools/conexiones.conexion.eliminar/execute \
-H "Authorization: Bearer connect_sk_…" \
-H "Idempotency-Key: 9d1f4c2a-7b30-4e58-9c11-2f6a8de5b743" \
-H "Content-Type: application/json" \
-d '{"input":{"conexionId":"conn_9tKfR2mQx4Vb","confirmarNombre":"Comercial Aurora SpA"}}'{
"tool": "conexiones.conexion.eliminar",
"params": {
"conexionId": "conn_9tKfR2mQx4Vb",
"confirmarNombre": "Comercial Aurora SpA"
},
"idempotencyKey": "9d1f4c2a-7b30-4e58-9c11-2f6a8de5b743"
}Clave de idempotencia. Es opcional, pero sin ella cada reintento es una operación nueva. Genera un UUID v4 nuevo por operación y envíalo en
Idempotency-Key(REST) o enidempotencyKey(MCP). Repite la misma clave solo al reintentar esa operación.
Salida esperada (200):
{
"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
| 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. |
JSON Schema de salida
{
"$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
}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.
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.
Habilitar una conexión
Reanuda una conexión deshabilitada de esta organización: vuelve a sincronizar según su cadencia y sus herramientas vuelven a responder.