Delete Connection

Overview

delete_connection permanently removes an existing data source connection for the current user. This takes real, immediate action — only call it when the user has explicitly asked to delete (not just disconnect) a specific connection.

A critical distinction: unlike disconnect_connection, deletion is not self-service reversible — undoing a deletion requires manual backend intervention by b.well support. Users cannot undo this action themselves.

Required Parameters

connection_id (string)

• The connection identifier to delete. Same value as id from list_connections results.

Returns

• status — the connection's status after deletion (typically DELETED).
• status_updated — datetime the status changed.

Notes

For users seeking to pause synchronization while preserving existing data, disconnect_connection offers a temporary alternative to permanent deletion.