Connections
Delete connection
Remove a connection from a team.
DELETE /teams/{teamId}/connections/{connectionId}
Deletes the connection from the team. If no other team uses the same connection, it is deleted entirely.
Authentication: Bearer token · Permission:
connections:delete · Team permission:connections.delete · Rate limit: default (120 / 60s)This action is permanent. Dashboards, Google Sheets queries and Google Data Studio reports that use this connection stop returning data.
The key holder's role must include Remove connections (Owner, Admin, Deputy Admin and Data Manager include it), and the key holder must have a seat in the team.
Path parameters
teamId
string · uuid v7 required
The ID of the team the connection belongs to.
connectionId
string · uuid v7 required
The ID of the connection to delete.
Request
curl -X DELETE https://api.twominutereports.com/v1/teams/0190f8a0-1a2b-7c3d-9e4f-5a6b7c8d9e0f/connections/0190f8a1-2b3c-7d4e-8f90-1a2b3c4d5e6f \
-H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"success": true,
"data": { "deleted": true }
}
{
"success": false,
"error": { "code": "BAD_REQUEST", "message": "Invalid UUID: \"abc\"" }
}
{
"success": false,
"error": { "code": "UNAUTHORIZED", "message": "Invalid or expired session" }
}
Write operations are blocked while the team's plan is cancelled.
{
"success": false,
"error": { "code": "PAYMENT_REQUIRED", "message": "Your team's plan has been cancelled. Please reactivate your subscription to continue." }
}
Returned when the key holder's role does not include Remove connections.
{
"success": false,
"error": { "code": "INSUFFICIENT_ROLE", "message": "[email protected] is not allowed to use connections.delete. This needs a role that includes it; their role is editor." }
}
Returned when the connection does not exist or does not belong to the team.
{
"success": false,
"error": { "code": "NOT_FOUND", "message": "Connection not found" }
}