Emisso Connect

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

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

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"}}'

SDK TypeScript

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

MCP · meta-tool execute

{
  "tool": "conexiones.conexion.eliminar",
  "params": {
    "conexionId": "conn_9tKfR2mQx4Vb",
    "confirmarNombre": "Comercial Aurora SpA"
  }
}

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.

Eliminar una conexión

Qué hace

Entrada

Ejemplo

Salida

Errores de esta tool

En esta página