For the complete documentation index, see llms.txt. This page is also available as Markdown.

How do I delete a duplicate user or connection?

The dashboard user list is read-only, with no delete button.

The dashboard user list is read-only, with no delete button.

To remove a user, call DELETE /v2/auth/deauthenticateUser?user_id=USER_ID with your dev-id and x-api-key headers.

A 200 means the connection is removed, events stop, it no longer counts as an active authentication, and you receive a deauth webhook confirming it.

Provider-side revocation:

  • For many providers (Strava, Fitbit, Garmin, Google, Polar, Suunto, Wahoo, Whoop, Hammerhead, TrainingPeaks, Zepp), the same call also asks the provider to revoke the grant, but only when removing the user's last connection for that provider, and it is best-effort.

  • For other providers and mobile-SDK sources, deauth clears Terra's side only, and the user must revoke at the provider.

Last updated

Was this helpful?