Clients
Delete client account
Unlink a connector account from a client.
DELETE /teams/{teamId}/clients/{clientId}/accounts/{connectorId}/{accountId}
Unlinks a connector account from the client. The account ID is provider-defined and is passed straight through in the path. Returns { "deleted": true } on success.
Authentication: Bearer token · Role: editor · Permission:
clients:delete · Rate limit: default (120 / 60s)Path parameters
teamId
string · uuid v7 required
The team the client belongs to.
clientId
string · uuid v7 required
The ID of the client to unlink the account from.
connectorId
string required
The connector the account belongs to (e.g.
gadw, fb).accountId
string required
The provider-defined account ID. This is not a UUID — it is whatever the connector uses to identify the account.
A team whose plan has been cancelled cannot make changes. Write requests will fail with
402 PAYMENT_REQUIRED until the subscription is reactivated.Request
curl -X DELETE https://api.twominutereports.com/v1/teams/0190f8b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/clients/0190f8c0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/accounts/gadw/1234567890 \
-H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"success": true,
"data": { "deleted": true }
}
Returned when connectorId is not a recognised connector.
{
"success": false,
"error": { "code": "BAD_REQUEST", "message": "Invalid connector ID: \"foo\"" }
}
{
"success": false,
"error": { "code": "PAYMENT_REQUIRED", "message": "Your team's plan has been cancelled. Please reactivate your subscription to continue." }
}
Returned when your role is below editor.
{
"success": false,
"error": { "code": "FORBIDDEN", "message": "You do not have permission to perform this action" }
}
Returned when the client or the linked account does not exist.
{
"success": false,
"error": { "code": "NOT_FOUND", "message": "Client account not found" }
}