Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 21, 22:15 UTC
docs: clarify connectedAccounts.delete() does not revoke OAuth tokens upstream (T-10452)
Replaces PR #3286. The auth-configuration "Delete accounts" page also claimed deletion revokes credentials, which is incorrect — `delete()` only soft-deletes the Composio record; upstream OAuth tokens remain valid with the provider until manually revoked or the refresh token expires. Updates both docs pages to match actual behavior.
Uday Sidagana committed
Apr 30, 2026 at 10:10 UTC
8d53b12b869570d66596398a31b21532f13a0dce
2 files changed
+8
-4
docs/content/docs/auth-configuration/connected-accounts.mdx
+2
-2
@@ -192,7 +192,7 @@ INACTIVE accounts cannot execute tools. Tool execution will fail until the statu
192
193
## Delete accounts
194
195
-Permanently remove a connected account and revoke all credentials:
195
+Soft-delete a connected account so it can no longer be used for API calls. This does **not** revoke the upstream OAuth grant — any access or refresh tokens previously issued remain valid with the third-party provider until they expire or the user revokes them. To revoke upstream access, the end user must do so through the provider's account settings (for example, [Google Account Permissions](https://myaccount.google.com/permissions) for Google).
196
197
<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
198
<Tab value="Python">
@@ -216,7 +216,7 @@ console.log('Account deleted successfully');
216
</Tabs>
217
218
<Callout type="warn">
219
-Deletion is permanent. Users must re-authenticate to reconnect.
219
+The Composio record is soft-deleted, but the upstream OAuth grant is unaffected — it remains valid with the provider until the user revokes it from their account settings or the refresh token expires. If the user later reconnects from scratch, the provider will prompt them to re-authorize.
220
</Callout>
221
222
## Credential masking
docs/content/reference/sdk-reference/typescript/connected-accounts.mdx
+6
-2
@@ -18,8 +18,12 @@ const result = await composio.connectedAccounts.list();
18
19
Deletes a connected account.
20
21
-This method permanently removes a connected account from the Composio platform.
22
-This action cannot be undone and will revoke any access tokens associated with the account.
21
+This method soft-deletes the connected account record on the Composio platform so it can
22
+no longer be used for API calls. It does **not** revoke OAuth tokens upstream with the
23
+third-party provider — any access or refresh tokens previously issued remain valid until
24
+they expire or are revoked by the user. To revoke upstream access, the end user must do
25
+so through the provider's account settings (for example,
26
+[Google Account Permissions](https://myaccount.google.com/permissions) for Google).
27
28
```typescript
29
async delete(nanoid: string): Promise<ConnectedAccountDeleteResponse>