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.


Tool ID	`conexiones.conexion.renombrar`
Nombre MCP	`conexiones__conexion__renombrar`
Conector	`conexiones`
Plano	`action`
Scope (permiso)	`conexiones:rename`
Auth	`none`
Versión	`1`
Sensible	sí
Deprecado	no
Comportamiento	readOnly=false, destructive=false, idempotent=true, openWorld=false

Qué hace

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.

Entrada

Campo	Tipo	Requerido	Descripción
`conexionId`	string	sí	conn_… de la conexión a renombrar, tal como lo devuelve conexiones.estado.consultar.
`nombre`	string	sí	El nombre nuevo, de 1 a 80 caracteres. Se quitan los espacios de los extremos.

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 renombrar, tal como lo devuelve conexiones.estado.consultar."
    },
    "nombre": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "El nombre nuevo, de 1 a 80 caracteres. Se quitan los espacios de los extremos."
    }
  },
  "required": [
    "conexionId",
    "nombre"
  ]
}

Ejemplo

curl

curl -X POST https://connect.emisso.ai/api/v1/tools/conexiones.conexion.renombrar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "Content-Type: application/json" \
  -d '{"input":{"conexionId":"conn_9tKfR2mQx4Vb","nombre":"Comercial Aurora SpA"}}'

MCP · meta-tool execute_write

{
  "tool": "conexiones.conexion.renombrar",
  "params": {
    "conexionId": "conn_9tKfR2mQx4Vb",
    "nombre": "Comercial Aurora SpA"
  }
}

Salida esperada (200):

{
  "data": {
    "id": "conn_9tKfR2mQx4Vb",
    "sistema": "sii",
    "nombre": "Comercial Aurora SpA",
    "cambiada": true
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "conexiones.conexion.renombrar",
    "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 después de la llamada.
`cambiada`	booleano	sí	true si esta llamada cambió el nombre; false si la conexión ya se llamaba 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 después de la llamada."
    },
    "cambiada": {
      "type": "boolean",
      "description": "true si esta llamada cambió el nombre; false si la conexión ya se llamaba así y no se tocó nada."
    }
  },
  "required": [
    "id",
    "sistema",
    "nombre",
    "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.