SnozeDevelopers
API referenceIntegrations

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.

GET
/v1/workspaces/{workspaceId}/integrations/connections/{connectionId}/disconnect-preview

Authorization

apiKey
headerAuthorizationBearer <snoze_sk_…>

Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.

Path Parameters

workspaceId*string
connectionId*string

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X GET 'https://api.snoze.dev/v1/workspaces/string/integrations/connections/string/disconnect-preview'
Example Response
{  "data": {    "connectionId": "string",    "linkedWorkspaceItems": 0,    "disabledDataSources": 0,    "disabledActions": 0,    "retainedNativeRecords": 0  }}

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.