Start linking a Discord account to the caller
POST/api/v1/orgs/:org/users/me/discord/link-start
Mints a single-use link token (TTL 15 minutes) and returns the Discord
authorization URL carrying it. Discord sends the browser back to
/api/v1/auth/discord/callback, which binds the Discord account that
completed the round trip to the caller and emails the account owner a
"Discord account linked" notice.
A linked Discord identity signs in, so this is a new sign-in factor and
needs a re-authentication: currentPassword when the account has a
password, otherwise a sign-in within the last 10 minutes. Every attempt
spends the per-user change-password budget. Refused for personal
access tokens and impersonation tokens. Returns VALIDATION_ERROR when
the instance has no Discord bot configured.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 429
Link round trip started
Validation error
Not authenticated, or currentPassword is missing or wrong (error code INVALID_CURRENT_PASSWORD).
The account has no password and the session's sign-in is more than 10 minutes old (error code REAUTHENTICATION_REQUIRED), or the request runs under impersonation or a personal access token.
Resource not found
Too many requests