Clients
Unassign client account
Unassign a connector account from a client.
DELETE /teams/{teamId}/clients/{clientId}/accounts/{connectorId}/{accountId}
Unassigns a connector account from the client. The account stays enabled for the team. The account ID is provider-defined, and you send it as it is in the path.
The key holder's role must include Unmap accounts (Owner, Admin, Deputy Admin and Data Manager include it), and the key holder must have a seat in the team. Returns { "deleted": true } on success.
Authentication: Bearer token · Permission:
clients:delete · Team permission:client_accounts.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 unassign the account from.
connectorId
string required
The connector the account belongs to (for example
gadw or fads).accountId
string required
The provider-defined account ID. This is not a UUID. It is the ID that the connector uses for the account.
A team whose plan has been cancelled cannot make changes. Write requests 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 recognized 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 the key holder's role does not include Unmap accounts.
{
"success": false,
"error": { "code": "INSUFFICIENT_ROLE", "message": "[email protected] is not allowed to use client_accounts.delete. This needs a role that includes it; their role is editor." }
}
Returned when the client does not exist, or the account is not assigned to it.
{
"success": false,
"error": { "code": "NOT_FOUND", "message": "Client account not found" }
}