conexiones

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. 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.

post/v1/tools/conexiones.conexion.eliminar/execute

Request

  • Base URL: https://connect.emisso.ai/api
  • URL: https://connect.emisso.ai/api/v1/tools/conexiones.conexion.eliminar/execute
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://connect.emisso.ai/authorize, token URL https://connect.emisso.ai/token, scopes: conexiones:delete)

Headers

Idempotency-Keystring

Clave de idempotencia para esta acción destructiva. Reenviar la MISMA clave con la misma entrada devuelve la respuesta ya emitida en vez de repetir el efecto; con una entrada distinta responde 'idempotency_conflict', y mientras el primer intento sigue en curso, 'idempotency_in_progress'. Un intento fallido nunca consume la clave. Sin cabecera, el pipeline genera una por ejecución, o sea que no hay deduplicación entre reintentos tuyos: mándala siempre que puedas reintentar.

Request body

Response

La tool corrió bien. 'data' es la salida de la tool tal cual, y 'meta' trae el 'request_id' que identifica esta llamada en la bitácora.

Changes

No recorded changes to this operation across all 1 revision of this API.