ApplicationBotResponse
Detailed bot user metadata| Field | Type | Description |
|---|---|---|
| authenticator_types? | AuthenticatorType[] | The types of authenticators enabled |
| avatar? | ?string | The avatar hash of the bot |
| banner? | ?string | The banner hash of the bot |
| bio | ?string | The bio or description of the bot |
| discriminator | string | The discriminator of the bot |
| flags | BotFlags | |
| id | SnowflakeType | The unique identifier of the bot user |
| mfa_enabled? | boolean | Whether the bot has MFA enabled |
| token? | string | The bot token for authentication |
| username | string | The username of the bot |
ApplicationCreateRequest
Related endpoints| Field | Type | Description |
|---|---|---|
| bot_public? | boolean | Whether the bot can be invited by anyone |
| bot_require_code_grant? | boolean | Whether the bot requires OAuth2 code grant |
| name | string | The name of the application |
| redirect_uris? | ?OAuth2RedirectURICreateType[] | The redirect URIs for OAuth2 flows |
ApplicationFlags
The application flags Type: integer (int32)ApplicationListResponse
Related endpoints Type: ApplicationResponse[]ApplicationPublicResponse
Related endpoints| Field | Type | Description |
|---|---|---|
| bot | ?ApplicationBotResponse | The bot user associated with the application |
| bot_public | boolean | Whether the bot can be invited by anyone |
| description | ?string | The description of the application |
| icon | ?string | The icon hash of the application |
| id | SnowflakeType | The unique identifier of the application |
| name | string | The name of the application |
| redirect_uris | string[] | The registered redirect URIs for OAuth2 |
| scopes | string[] | The available OAuth2 scopes |
ApplicationResponse
Related endpointsGET /oauth2/applications/{id}POST /oauth2/applicationsPOST /oauth2/applications/{id}/client-secret/resetPATCH /oauth2/applications/{id}
| Field | Type | Description |
|---|---|---|
| bot? | ApplicationBotResponse | |
| bot_public | boolean | Whether the bot can be invited by anyone |
| bot_require_code_grant | boolean | Whether the bot requires OAuth2 code grant |
| client_secret? | string | The client secret for OAuth2 authentication |
| id | SnowflakeType | The unique identifier of the application |
| name | string | The name of the application |
| redirect_uris | string[] | The registered redirect URIs for OAuth2 |
ApplicationsMeResponse
Related endpoints| Field | Type | Description |
|---|---|---|
| bot? | ApplicationBotResponse | |
| bot_public | boolean | Whether the bot can be invited by anyone |
| bot_require_code_grant | boolean | Whether the bot requires OAuth2 code grant |
| description | ?string | The description of the application |
| flags | ApplicationFlags | |
| icon | ?string | The icon hash of the application |
| id | SnowflakeType | The unique identifier of the application |
| name | string | The name of the application |
ApplicationUpdateRequest
Related endpoints| Field | Type | Description |
|---|---|---|
| bot_public? | boolean | Whether the bot can be invited by anyone |
| bot_require_code_grant? | boolean | Whether the bot requires OAuth2 code grant |
| name? | string | The name of the application |
| redirect_uris? | ?OAuth2RedirectURIUpdateType[] | The redirect URIs for OAuth2 flows |
AuthorizeConsentRequest
Related endpoints| Field | Type | Description |
|---|---|---|
| client_id | SnowflakeType | |
| guild_id? | SnowflakeType | |
| permissions? | string | The bot permissions to request |
| redirect_uri? | string | The URI to redirect to after authorization |
| response_type? | string | The OAuth2 response type |
| scope | string | The space-separated list of requested scopes |
| state? | string | A random string for CSRF protection |
BotFlags
The bot user flags Type: Bitflags32| Flag | Value | Description |
|---|---|---|
| FRIENDLY_BOT | 16 | Bot accepts friend requests from users |
| FRIENDLY_BOT_MANUAL_APPROVAL | 32 | Bot requires manual approval for friend requests |
BotProfileResponse
Related endpoints| Field | Type | Description |
|---|---|---|
| avatar | ?string | The avatar hash of the bot |
| banner | ?string | The banner hash of the bot |
| bio | ?string | The bio or description of the bot |
| discriminator | string | The discriminator of the bot |
| id | SnowflakeType | The unique identifier of the bot user |
| username | string | The username of the bot |
BotProfileUpdateRequest
Related endpoints| Field | Type | Description |
|---|---|---|
| avatar? | ?Base64ImageType | The avatar image as base64 |
| banner? | ?Base64ImageType | The banner image as base64 |
| bio? | ?string | The bio or description of the bot |
| bot_flags? | BotFlags | |
| discriminator? | string | The discriminator of the bot |
| username? | UsernameType |
BotTokenResetResponse
Related endpoints| Field | Type | Description |
|---|---|---|
| bot | ApplicationBotResponse | |
| token | string | The new bot token |
IntrospectRequestForm
Related endpoints| Field | Type | Description |
|---|---|---|
| client_id? | SnowflakeType | |
| client_secret? | string | The application client secret |
| token | string | The token to introspect |
OAuth2AuthorizationResponse
| Field | Type | Description |
|---|---|---|
| application | OAuth2AuthorizationResponseApplication | The application that was authorized |
| authorized_at | string | The timestamp when the authorization was granted |
| scopes | string[] | The list of granted OAuth2 scopes |
OAuth2AuthorizationsListResponse
Related endpoints Type: OAuth2AuthorizationResponse[]OAuth2ConsentResponse
Related endpoints| Field | Type | Description |
|---|---|---|
| redirect_to | string | The URL to redirect the user to after consent |
OAuth2IntrospectResponse
Related endpoints| Field | Type | Description |
|---|---|---|
| active | boolean | Whether the token is currently active |
| client_id? | SnowflakeType | |
| exp? | Int32Type | |
| iat? | Int32Type | |
| scope? | string | The space-separated list of scopes |
| sub? | SnowflakeType | |
| token_type? | string | The type of token |
| username? | string | The username of the token owner |
OAuth2MeResponse
Related endpoints| Field | Type | Description |
|---|---|---|
| application | OAuth2MeResponseApplication | The application associated with the token |
| expires | string | The expiration timestamp of the token |
| scopes | string[] | The list of granted OAuth2 scopes |
| user? | OAuth2MeResponseUser | The user associated with the token |
OAuth2RedirectURICreateType
Type: stringOAuth2RedirectURIUpdateType
Type: stringOAuth2TokenResponse
Related endpoints| Field | Type | Description |
|---|---|---|
| access_token | string | The access token for API authorization |
| expires_in | integer (int32) | The number of seconds until the access token expires |
| refresh_token | string | The refresh token for obtaining new access tokens |
| scope | string | The space-separated list of granted scopes |
| token_type | string | The type of token, typically “Bearer” |
OAuth2UserInfoResponse
Related endpoints| Field | Type | Description |
|---|---|---|
| avatar | ?string | The avatar hash of the user |
| discriminator | string | The discriminator of the user |
| email? | ?string | The email address of the user |
| flags? | PublicUserFlags | |
| global_name | ?string | The global display name of the user |
| id | SnowflakeType | The unique identifier of the user |
| sub | SnowflakeType | The subject identifier of the user |
| username | string | The username of the user |
| verified? | ?boolean | Whether the user has verified their email |
RevokeRequestForm
Related endpoints| Field | Type | Description |
|---|---|---|
| client_id? | SnowflakeType | |
| client_secret? | string | The application client secret |
| token | string | The token to revoke |
| token_type_hint? | RevokeRequestFormTokenTypeHint | A hint about the type of token being revoked |
TokenRequest
Related endpoints Type: TokenRequestOneOf0 | TokenRequestOneOf1RevokeRequestFormTokenTypeHint
A hint about the type of token being revoked| Value | Description |
|---|---|
access_token | An OAuth2 access token |
refresh_token | An OAuth2 refresh token |
OAuth2AuthorizationResponseApplication
The application that was authorized| Field | Type | Description |
|---|---|---|
| bot_public | boolean | Whether the bot can be invited by anyone |
| description | ?string | The description of the application |
| icon | ?string | The icon hash of the application |
| id | SnowflakeType | The unique identifier of the application |
| name | string | The name of the application |
OAuth2MeResponseApplication
The application associated with the token| Field | Type | Description |
|---|---|---|
| bot_public | boolean | Whether the bot can be invited by anyone |
| bot_require_code_grant | boolean | Whether the bot requires OAuth2 code grant |
| description | ?string | The description of the application |
| flags | ApplicationFlags | |
| icon | ?string | The icon hash of the application |
| id | SnowflakeType | The unique identifier of the application |
| name | string | The name of the application |
OAuth2MeResponseUser
The user associated with the token| Field | Type | Description |
|---|---|---|
| avatar | ?string | The avatar hash of the user |
| avatar_color | ?Int32Type | The default avatar color of the user |
| bot? | boolean | Whether the user is a bot |
| discriminator | string | The discriminator of the user |
| email? | ?string | The email address of the user |
| flags | PublicUserFlags | |
| global_name | ?string | The global display name of the user |
| id | SnowflakeType | The unique identifier of the user |
| system? | boolean | Whether the user is a system user |
| username | string | The username of the user |
| verified? | ?boolean | Whether the user has verified their email |
TokenRequestOneOf0
| Field | Type | Description |
|---|---|---|
| client_id? | SnowflakeType | |
| client_secret? | string | The application client secret |
| code | string | The authorization code received from the authorize endpoint |
| grant_type | enum<authorization_code> | The grant type for exchanging an authorization code |
| redirect_uri | string | The redirect URI used in the authorization request |
TokenRequestOneOf1
| Field | Type | Description |
|---|---|---|
| client_id? | SnowflakeType | |
| client_secret? | string | The application client secret |
| grant_type | enum<refresh_token> | The grant type for refreshing an access token |
| refresh_token | string | The refresh token to exchange for a new access token |