discord-is.fun
API changelog ·

Account Linking Failure-Mode Documentation

New documentation covering what happens when a Discord account is banned, when OAuth2 tokens are revoked, and how to design account linking for resilience.

We've expanded documentation across the Social SDK guides to cover what happens when the Discord-to-game account link is severed — whether by a Discord account ban, an explicit unmerge, or an OAuth2 token revocation. Highlights:

  • Ban-Driven Unmerge documents the full lifecycle when a user's Discord account is banned: tokens are deleted immediately, a new cross-platform-restricted provisional account is created carrying the original external identity, and merge attempts return error 530017 until the ban lifts (or, for permanent bans, indefinitely).
  • Out-of-Band Revocation describes the auth-side observable signals (APPLICATION_DEAUTHORIZED webhook + invalid_grant on refresh) when a user removes your app from Discord or has their account banned.
  • When Refresh Fails documents the /oauth2/token response when the underlying token has been deleted, and recommends treating invalid_grant as equivalent to receiving the webhook.
↑ ↓ navigate↵ open> commands/ focus filter

Appearance

Theme

Accent colour

Font

Density

Corners

Motion

Sidebar

Keyboard shortcuts

CtrlK
Search everything
>
In search: run a command (theme, density, copy URL…)
/
Filter the current list
W
Watch the current page
JK
Older, newer build (Shift: with notes)
[
Collapse or expand the sidebar
,
Appearance
?
Keyboard shortcuts
Esc
Close

Press G and then a letter to jump straight to a page

Overview

D
Dashboard
A
Activity
J
This week
Z
Daily digests
N
News
W
Watchlist
U
Status

Client

B
Builds
X
Compare builds
S
Strings
L
Client flags
M
Mobile builds
I
Release stats

Experiments & rollouts

E
Experiments
R
Rollouts

Developer API

C
API changelog
H
OpenAPI changes
Y
Endpoints
Q
Upcoming
P
API routes

Platform

V
Versions
K
Stickers
G
Games

Data & tools

T
Tools
F
Reference
O
Feeds & data

Keyboard shortcuts

CtrlK
Search everything
>
In search: run a command (theme, density, copy URL…)
/
Filter the current list
W
Watch the current page
JK
Older, newer build (Shift: with notes)
[
Collapse or expand the sidebar
,
Appearance
?
Keyboard shortcuts
Esc
Close

Press G and then a letter to jump straight to a page

Overview

D
Dashboard
A
Activity
J
This week
Z
Daily digests
N
News
W
Watchlist
U
Status

Client

B
Builds
X
Compare builds
S
Strings
L
Client flags
M
Mobile builds
I
Release stats

Experiments & rollouts

E
Experiments
R
Rollouts

Developer API

C
API changelog
H
OpenAPI changes
Y
Endpoints
Q
Upcoming
P
API routes

Platform

V
Versions
K
Stickers
G
Games

Data & tools

T
Tools
F
Reference
O
Feeds & data