The User Delete API provides a programmatic interface to permanently remove a user profile from Totango. NOTE: This refers to end-users of YOUR application, not Totango platform users.
Use this API to automate data cleanup, or to comply with information removal requests from GDPR or equivalent privacy-frameworks.
Important note, this delete action is IRREVERSIBLE! A deleted user information cannot be retrieved.
Your Authentication Keys
You will need your API key in order to access the API.
Login to Totango, click on your username (top-right corner of the page) and open your user profile. Your API Key is available under the INTEGRATION tab
General restrictions and API limits
Like all APIs, there is a global rate limit of 1,000 calls/minute for each token.
NOTE: This API should not be used to mass delete a large set of users. To do that, please contact email@example.com with your request.
Deleting a user
To delete a user, simply issue a DELETE request to the resource:
where USER-ID is the user-ID on Totango and ACCOUNT-ID is the account the user is associated with.
curl -X DELETE --header 'app-token:YOUR-TOKEN-HERE' 'https://app.totango.com/api/v2/users/account-user/<ACCOUNT-ID>/<USER-ID>'
The API will return a 200 Success code or 401 Unauthorized in case of invalid credentials.
Note that it may take a few minutes for the delete to fully apply.
Question: If the user is deleted from the account, does that user's activity stay associated to the account or is it lost?
Answer: Deleting a user means that it is no longer associated to any account and the account(s) will not contain a history of the user's previous activity. However, their activity will still be a part of historical usage aggregations and the number of activities from that user on the account(s) will remain.