Verify Discord social link

Verify ownership of a Discord social link using an OAuth 2.0 access token.

Flow:

Client obtains a Discord OAuth 2.0 access token via authorization code flow
Client sends the token to this endpoint
API validates the token against Discord's GET /api/v10/users/@me endpoint
If the returned user ID matches the account's existing Discord social link, it's marked as verified

Prerequisites:

Account must have a Discord social link already added (via POST /v1/account/social-links)
Client must have a valid Discord OAuth 2.0 access token with identify scope

Idempotent: Calling this on an already-verified Discord link returns success.

Authentication: Authorization: Bearer <CLIENT_JWT>

authorizationstring nullable

Bearer JWT issued by Grove that identifies the account.

Request body

access_tokenstring required

Discord OAuth 2.0 access token obtained via authorization code flow

Successful Response

verifiedboolean required

Whether the Discord link is now verified

platformstring

Platform that was verified

usernamestring required

Discord username that was verified

verification_methodstring required

Method used for verification