[docs] Add bot token unmerge endpoint documentation #7886
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
spenhand
force-pushed
the
spenhand/bot-unmerge-docs
branch
2 times, most recently
from
8858ef2 to
da70cb5
Compare
markmandel
reviewed
Oct 7, 2025
| @@ -498,6 +498,28 @@ def unmerge_provisional_account(external_auth_token): | |||
| If you have a server backend, you'll want to use the server-to-server unmerge endpoint rather than the SDK helper method to maintain better security and control over the unmerge process. | |||
| ::: | |||
|
|
|||
| #### Unmerging with Bot Token Endpoint | |||
|
|
|||
| If you're using the [Bot Token Endpoint](/docs/discord-social-sdk/development-guides/using-provisional-accounts#server-authentication-with-bot-token-endpoint) for authentication, you can unmerge accounts without an external auth token. | |||
Contributor
There was a problem hiding this comment.
Do we want to mention that you can use this to unmerge even if you've lost the discord auth token?
Something like:
:::info
This endpoint can also be useful in cases where the Discord Auth token has been lost to to error or data loss, and an unmerge operation is required to migrate to a provisional account before re-linking a Discord account.
:::
WDYT?
Document the new /provisional-accounts/unmerge/bot endpoint that allows unmerging provisional accounts using just the bot token and external_user_id, without requiring an external auth token. This ensures identities can always be removed even if the external auth token is no longer accessible. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
Add "Tip" for being able to recover an account that's lost its auth token due to data loss or error.
markmandel
force-pushed
the
spenhand/bot-unmerge-docs
branch
from
da70cb5 to
cf261fd
Compare
Contributor
|
While we're still waiting on previews to work: 
|
anthonydiscord
approved these changes
Nov 7, 2025
| ``` | ||
|
|
||
| <Tip> | ||
| This endpoint can also be useful in cases where the Discord Auth token has been lost to to error or data loss, and an unmerge operation is required to migrate to a provisional account before re-linking a Discord account. |
Contributor
There was a problem hiding this comment.
Looks like autocorrect got involved.
Suggested change
| This endpoint can also be useful in cases where the Discord Auth token has been lost to to error or data loss, and an unmerge operation is required to migrate to a provisional account before re-linking a Discord account. | |
| This endpoint can also be useful in cases where the Discord Auth token has been lost due to error or data loss, and an unmerge operation is required to migrate to a provisional account before re-linking a Discord account. |
Contributor
There was a problem hiding this comment.
Appreciate the find - but this is already merged. Would love a small PR to fix!
AlmostSuspense
added a commit
to AlmostSuspense/discord-api-docs
that referenced
this pull request
Nov 9, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Added a dedicated method for the bot token flow to make unmerging possible even if you've lost the discord auth token. updating the docs to describe it.