Connections
Delete connection
Remove a connection from a team.
DELETE /teams/{teamId}/connections/{connectionId}
Removes the connection from the team. If no other team references the underlying data source, it is deleted entirely.
Authentication: Bearer token · Role: editor · Permission:
connections:delete · Rate limit: default (120 / 60s)This action is permanent. Reports and clients that rely on this connection will stop returning data.
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": "Authentication required" }
}
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 your team role is below editor.
{
"success": false,
"error": { "code": "FORBIDDEN", "message": "You do not have permission to perform this action" }
}
Returned when the connection does not exist or does not belong to the team.
{
"success": false,
"error": { "code": "NOT_FOUND", "message": "The requested resource was not found" }
}