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.


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

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

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

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

Ejemplo

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

SDK TypeScript

const data = await connect.tools.conexiones.conexion.deshabilitar({ conexionId: "conn_9tKfR2mQx4Vb" });

MCP · meta-tool execute

{
  "tool": "conexiones.conexion.deshabilitar",
  "params": {
    "conexionId": "conn_9tKfR2mQx4Vb"
  }
}

Salida esperada (200):

{
  "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

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.

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 (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
}

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.