Renombrar una conexión
Cambia el nombre visible de una conexión de esta organización: el que aparece en el panel, en la bitácora, en los cobros y en 'nombre' de conexiones.estado.consultar. No toca la credencial, los datos ni la sincronización. El nombre es único entre las conexiones del mismo sistema: si otra ya lo usa, falla sin cambiar nada. Si la conexión ya se llamaba así, no cambia nada y responde 'cambiada' en false.
API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.
In: header
Request Body
application/json
La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/tools/conexiones.conexion.renombrar/execute" \ -H "Content-Type: application/json" \ -d '{ "input": { "conexionId": "string", "nombre": "string" } }'{ "data": { "id": "string", "sistema": "string", "nombre": "string", "cambiada": true }, "meta": { "request_id": "string", "operation_request_id": "733a3a71-b72d-4633-94b1-070c6664565f", "tool_id": "string", "plane": "action", "latency_ms": 0, "audit_status": "recorded", "idempotency": "replayed" }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}Habilitar una conexión POST
Reanuda una conexión deshabilitada de esta organización: vuelve a sincronizar según su cadencia y sus herramientas vuelven a responder. La conexión vuelve a sumarse al cobro del plan: si 'costoAdicional' no es null, díselo a la persona. No sirve para una conexión sin credencial: esa se completa con conexiones.enlace.crear. Si ya estaba habilitada, no cambia nada y responde 'cambiada' en false.
Crear un enlace para conectar un sistema POST
Crea un enlace de un solo uso donde la persona entrega sus credenciales del sistema para conectarlo. Devuelve el enlace SIEMPRE con su dominio completo visible y explicando quién lo pidió y para qué; nunca lo presentes como un aviso del banco ni del SII. La credencial se cifra en el vault de esta misma organización y no la ve nadie más, tampoco tú. El enlace vence y sirve una sola vez. Puedes fijar 'acceso', 'emitir' y 'alcances' para que la persona solo entregue sus claves; si los omites, los elige ella. Los códigos de acceso salen de 'accesos' en conexiones.sistemas.listar. Si 'costoAdicional' no es null, la conexión nueva se suma al próximo cobro de la organización: díselo a la persona antes de entregar el enlace. Shopify sólo admite modo reconectar con una conexión existente; las tiendas nuevas se instalan desde Shopify App Store. Los demás sistemas de acceso 'oauth_source' (como Mercado Pago) no se conectan ni se renuevan por enlace: la persona los conecta en el panel (Conexiones → Conectar) o los vuelve a autorizar en Ajustes de la conexión. Después de que la persona lo complete, usa 'conexiones.estado.consultar' para saber si ya hay datos.