Connectors
Disable account
Disable a connector account so it is no longer available for reporting.
POST /teams/{teamId}/connectors/{connectorId}/accounts/{accountId}/disable
Disables a single account under a connector. The operation is idempotent: disabling an account that is already disabled, or was never enabled, succeeds and changes nothing. Disabling an account frees a slot against your plan's per-connector limit. Responds with 200 OK.
Authentication: Bearer token · Permission:
connectors:write · Team permission:connector_accounts.disable · Rate limit: default (120 / 60s)This needs a role that includes Disable accounts. Owner, Admin, Deputy Admin and Data Manager
include it. Editor and Viewer do not, although Editor was enough before. Disabling is a separate
permission from enabling, so a role can stop spend without being able to start it. The API checks
the same permission as every other surface. The key holder also needs a seat.
Path parameters
teamId
string · uuid v7 required
The team that owns the connector.
connectorId
string required
The connector ID (for example
gadw). A value that is not a recognized connector returns 400 BAD_REQUEST.accountId
string required
The provider-defined account ID to disable.
Request
curl -X POST https://api.twominutereports.com/v1/teams/0190f8b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/connectors/gadw/accounts/1234567890/disable \
-H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"success": true,
"data": { "disabled": true }
}
{
"success": false,
"error": { "code": "INSUFFICIENT_ROLE", "message": "[email protected] is not allowed to use connector_accounts.disable. This needs a role that includes it; their role is editor." }
}
{
"success": false,
"error": {
"code": "PAYMENT_REQUIRED",
"message": "Your team's plan has been cancelled. Please reactivate your subscription to continue."
}
}
{
"success": false,
"error": { "code": "UNAUTHORIZED", "message": "Invalid or expired session" }
}