Preview what deleting a connection would remove
Reports what disconnecting would affect — the connector-owned databases, mirrored resources, and placements that depend on the connection — so the consequences can be shown before the delete. Read-only, but gated on the `integrations:write` workspace permission because only a caller who could perform the delete may see the preview.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Path Parameters
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/workspaces/string/integrations/connections/string/disconnect-preview"{ "data": { "connectionId": "string", "linkedWorkspaceItems": 0, "disabledDataSources": 0, "disabledActions": 0, "retainedNativeRecords": 0 }}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}Call a tool on a remote MCP connection
Invokes one tool on the connection's remote MCP server with the supplied arguments and returns its result. Requires the `integrations:write` workspace permission and an explicit `confirmed: true` in the body, because the call runs against the third-party system; a tool outside the connection's allowlist is refused. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.
Run a sync for an integration connection
Runs the provider adapter's sync once for the connection, with an optional `trigger` and `scope` to narrow what is pulled, and returns the resulting run with its statistics. Requires the `integrations:write` workspace permission; a connection whose provider has no registered adapter is rejected as invalid.