GEgetsales
gtm_connections

Revoke gtm connection

Disconnect a linked gtm-api workspace (scope workspace, the default) or the whole consent it came from (scope consent: every sibling row of the same grant). The sender profiles that ran on it read disconnected, their work holds; nothing is deleted. The managed row is platform-owned and refuses (409).

Contract:

  • MCP tool revoke_gtm_connection, registry package mcp.id/gtm_connections, mount id.identity.
  • Operation action, response envelope action.
  • Flags: dangerous: the MCP layer gates it behind a preview/commit token, and the effect cannot be undone through this API.
post/api/gtm-connections/{sid}/revoke

Request

  • Base URL
    https://beta.getsales.io/id/v1
  • Auth
    HTTP bearer and API key in header Team-SID

Path parameters

sidstring required

Gtm connection sid (gt_cn_...).

Request body

scopestring

workspace (default: this row alone) or consent (every row of the same gtm grant).

Response

action success envelope.

successtrue required
operation'action' required
actionstring required

kebab-case verb; matches the route segment.

Changes

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