import type { Snowflake } from '../../globals'; export * from '../common'; export * from './application'; export * from './auditLog'; export * from './autoModeration'; export * from './channel'; export * from './emoji'; export * from './gateway'; export * from './guild'; export * from './guildScheduledEvent'; export * from './interactions'; export * from './invite'; export * from './oauth2'; export * from './stageInstance'; export * from './sticker'; export * from './template'; export * from './user'; export * from './voice'; export * from './webhook'; export const APIVersion = '9'; export const Routes = { /** * Route for: * - GET `/applications/{application.id}/role-connections/metadata` * - PUT `/applications/{application.id}/role-connections/metadata` */ applicationRoleConnectionMetadata(applicationId: Snowflake) { return `/applications/${applicationId}/role-connections/metadata` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/auto-moderation/rules` * - POST `/guilds/{guild.id}/auto-moderation/rules` */ guildAutoModerationRules(guildId: Snowflake) { return `/guilds/${guildId}/auto-moderation/rules` as const; }, /** * Routes for: * - GET `/guilds/{guild.id}/auto-moderation/rules/{rule.id}` * - PATCH `/guilds/{guild.id}/auto-moderation/rules/{rule.id}` * - DELETE `/guilds/{guild.id}/auto-moderation/rules/{rule.id}` */ guildAutoModerationRule(guildId: Snowflake, ruleId: Snowflake) { return `/guilds/${guildId}/auto-moderation/rules/${ruleId}` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/audit-logs` */ guildAuditLog(guildId: Snowflake) { return `/guilds/${guildId}/audit-logs` as const; }, /** * Route for: * - GET `/channels/{channel.id}` * - PATCH `/channels/{channel.id}` * - DELETE `/channels/{channel.id}` */ channel(channelId: Snowflake) { return `/channels/${channelId}` as const; }, /** * Route for: * - GET `/channels/{channel.id}/messages` * - POST `/channels/{channel.id}/messages` */ channelMessages(channelId: Snowflake) { return `/channels/${channelId}/messages` as const; }, /** * Route for: * - GET `/channels/{channel.id}/messages/{message.id}` * - PATCH `/channels/{channel.id}/messages/{message.id}` * - DELETE `/channels/{channel.id}/messages/{message.id}` */ channelMessage(channelId: Snowflake, messageId: Snowflake) { return `/channels/${channelId}/messages/${messageId}` as const; }, /** * Route for: * - POST `/channels/{channel.id}/messages/{message.id}/crosspost` */ channelMessageCrosspost(channelId: Snowflake, messageId: Snowflake) { return `/channels/${channelId}/messages/${messageId}/crosspost` as const; }, /** * Route for: * - PUT `/channels/{channel.id}/messages/{message.id}/reactions/{emoji}/@me` * - DELETE `/channels/{channel.id}/messages/{message.id}/reactions/{emoji}/@me` * * **Note**: You need to URL encode the emoji yourself */ channelMessageOwnReaction(channelId: Snowflake, messageId: Snowflake, emoji: string) { return `/channels/${channelId}/messages/${messageId}/reactions/${emoji}/@me` as const; }, /** * Route for: * - DELETE `/channels/{channel.id}/messages/{message.id}/reactions/{emoji}/{user.id}` * * **Note**: You need to URL encode the emoji yourself */ channelMessageUserReaction(channelId: Snowflake, messageId: Snowflake, emoji: string, userId: Snowflake) { return `/channels/${channelId}/messages/${messageId}/reactions/${emoji}/${userId}` as const; }, /** * Route for: * - GET `/channels/{channel.id}/messages/{message.id}/reactions/{emoji}` * - DELETE `/channels/{channel.id}/messages/{message.id}/reactions/{emoji}` * * **Note**: You need to URL encode the emoji yourself */ channelMessageReaction(channelId: Snowflake, messageId: Snowflake, emoji: string) { return `/channels/${channelId}/messages/${messageId}/reactions/${emoji}` as const; }, /** * Route for: * - DELETE `/channels/{channel.id}/messages/{message.id}/reactions` */ channelMessageAllReactions(channelId: Snowflake, messageId: Snowflake) { return `/channels/${channelId}/messages/${messageId}/reactions` as const; }, /** * Route for: * - POST `/channels/{channel.id}/messages/bulk-delete` */ channelBulkDelete(channelId: Snowflake) { return `/channels/${channelId}/messages/bulk-delete` as const; }, /** * Route for: * - PUT `/channels/{channel.id}/permissions/{overwrite.id}` * - DELETE `/channels/{channel.id}/permissions/{overwrite.id}` */ channelPermission(channelId: Snowflake, overwriteId: Snowflake) { return `/channels/${channelId}/permissions/${overwriteId}` as const; }, /** * Route for: * - GET `/channels/{channel.id}/invites` * - POST `/channels/{channel.id}/invites` */ channelInvites(channelId: Snowflake) { return `/channels/${channelId}/invites` as const; }, /** * Route for: * - POST `/channels/{channel.id}/followers` */ channelFollowers(channelId: Snowflake) { return `/channels/${channelId}/followers` as const; }, /** * Route for: * - POST `/channels/{channel.id}/typing` */ channelTyping(channelId: Snowflake) { return `/channels/${channelId}/typing` as const; }, /** * Route for: * - GET `/channels/{channel.id}/pins` */ channelPins(channelId: Snowflake) { return `/channels/${channelId}/pins` as const; }, /** * Route for: * - PUT `/channels/{channel.id}/pins/{message.id}` * - DELETE `/channels/{channel.id}/pins/{message.id}` */ channelPin(channelId: Snowflake, messageId: Snowflake) { return `/channels/${channelId}/pins/${messageId}` as const; }, /** * Route for: * - PUT `/channels/{channel.id}/recipients/{user.id}` * - DELETE `/channels/{channel.id}/recipients/{user.id}` */ channelRecipient(channelId: Snowflake, userId: Snowflake) { return `/channels/${channelId}/recipients/${userId}` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/emojis` * - POST `/guilds/{guild.id}/emojis` */ guildEmojis(guildId: Snowflake) { return `/guilds/${guildId}/emojis` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/emojis/{emoji.id}` * - PATCH `/guilds/{guild.id}/emojis/{emoji.id}` * - DELETE `/guilds/{guild.id}/emojis/{emoji.id}` */ guildEmoji(guildId: Snowflake, emojiId: Snowflake) { return `/guilds/${guildId}/emojis/${emojiId}` as const; }, /** * Route for: * - POST `/guilds` */ guilds() { return '/guilds' as const; }, /** * Route for: * - GET `/guilds/{guild.id}` * - PATCH `/guilds/{guild.id}` * - DELETE `/guilds/{guild.id}` */ guild(guildId: Snowflake) { return `/guilds/${guildId}` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/preview` */ guildPreview(guildId: Snowflake) { return `/guilds/${guildId}/preview` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/channels` * - POST `/guilds/{guild.id}/channels` * - PATCH `/guilds/{guild.id}/channels` */ guildChannels(guildId: Snowflake) { return `/guilds/${guildId}/channels` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/members/{user.id}` * - PUT `/guilds/{guild.id}/members/{user.id}` * - PATCH `/guilds/{guild.id}/members/@me` * - PATCH `/guilds/{guild.id}/members/{user.id}` * - DELETE `/guilds/{guild.id}/members/{user.id}` */ guildMember(guildId: Snowflake, userId: Snowflake | '@me' = '@me') { return `/guilds/${guildId}/members/${userId}` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/members` */ guildMembers(guildId: Snowflake) { return `/guilds/${guildId}/members` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/members/search` */ guildMembersSearch(guildId: Snowflake) { return `/guilds/${guildId}/members/search` as const; }, /** * Route for: * - PATCH `/guilds/{guild.id}/members/@me/nick` * @deprecated Use {@link Routes.guildMember} instead. */ guildCurrentMemberNickname(guildId: Snowflake) { return `/guilds/${guildId}/members/@me/nick` as const; }, /** * Route for: * - PUT `/guilds/{guild.id}/members/{user.id}/roles/{role.id}` * - DELETE `/guilds/{guild.id}/members/{user.id}/roles/{role.id}` */ guildMemberRole(guildId: Snowflake, memberId: Snowflake, roleId: Snowflake) { return `/guilds/${guildId}/members/${memberId}/roles/${roleId}` as const; }, /** * Route for: * - POST `/guilds/{guild.id}/mfa` */ guildMFA(guildId: Snowflake) { return `/guilds/${guildId}/mfa` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/bans` */ guildBans(guildId: Snowflake) { return `/guilds/${guildId}/bans` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/bans/{user.id}` * - PUT `/guilds/{guild.id}/bans/{user.id}` * - DELETE `/guilds/{guild.id}/bans/{user.id}` */ guildBan(guildId: Snowflake, userId: Snowflake) { return `/guilds/${guildId}/bans/${userId}` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/roles` * - POST `/guilds/{guild.id}/roles` * - PATCH `/guilds/{guild.id}/roles` */ guildRoles(guildId: Snowflake) { return `/guilds/${guildId}/roles` as const; }, /** * Route for: * - PATCH `/guilds/{guild.id}/roles/{role.id}` * - DELETE `/guilds/{guild.id}/roles/{role.id}` */ guildRole(guildId: Snowflake, roleId: Snowflake) { return `/guilds/${guildId}/roles/${roleId}` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/prune` * - POST `/guilds/{guild.id}/prune` */ guildPrune(guildId: Snowflake) { return `/guilds/${guildId}/prune` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/regions` */ guildVoiceRegions(guildId: Snowflake) { return `/guilds/${guildId}/regions` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/invites` */ guildInvites(guildId: Snowflake) { return `/guilds/${guildId}/invites` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/integrations` */ guildIntegrations(guildId: Snowflake) { return `/guilds/${guildId}/integrations` as const; }, /** * Route for: * - DELETE `/guilds/{guild.id}/integrations/{integration.id}` */ guildIntegration(guildId: Snowflake, integrationId: Snowflake) { return `/guilds/${guildId}/integrations/${integrationId}` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/widget` * - PATCH `/guilds/{guild.id}/widget` */ guildWidgetSettings(guildId: Snowflake) { return `/guilds/${guildId}/widget` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/widget.json` */ guildWidgetJSON(guildId: Snowflake) { return `/guilds/${guildId}/widget.json` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/vanity-url` */ guildVanityUrl(guildId: Snowflake) { return `/guilds/${guildId}/vanity-url` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/widget.png` */ guildWidgetImage(guildId: Snowflake) { return `/guilds/${guildId}/widget.png` as const; }, /** * Route for: * - GET `/invites/{invite.code}` * - DELETE `/invites/{invite.code}` */ invite(code: string) { return `/invites/${code}` as const; }, /** * Route for: * - GET `/guilds/templates/{template.code}` * - POST `/guilds/templates/{template.code}` */ template(code: string) { return `/guilds/templates/${code}` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/templates` * - POST `/guilds/{guild.id}/templates` */ guildTemplates(guildId: Snowflake) { return `/guilds/${guildId}/templates` as const; }, /** * Route for: * - PUT `/guilds/{guild.id}/templates/{template.code}` * - PATCH `/guilds/{guild.id}/templates/{template.code}` * - DELETE `/guilds/{guild.id}/templates/{template.code}` */ guildTemplate(guildId: Snowflake, code: string) { return `/guilds/${guildId}/templates/${code}` as const; }, /** * Route for: * - POST `/channels/{channel.id}/threads` * - POST `/channels/{channel.id}/messages/{message.id}/threads` */ threads(parentId: Snowflake, messageId?: Snowflake) { const parts = ['', 'channels', parentId]; if (messageId) parts.push('messages', messageId); parts.push('threads'); return parts.join('/') as `/channels/${Snowflake}/threads` | `/channels/${Snowflake}/messages/${Snowflake}/threads`; }, /** * Route for: * - GET `/guilds/{guild.id}/threads/active` */ guildActiveThreads(guildId: Snowflake) { return `/guilds/${guildId}/threads/active` as const; }, /** * Route for: * - GET `/channels/{channel.id}/threads/active` * (deprecated, removed in API v10, use [List Active Guild Threads](https://discord.com/developers/docs/resources/guild#list-active-threads) instead.) * - GET `/channels/{channel.id}/threads/archived/public` * - GET `/channels/{channel.id}/threads/archived/private` */ channelThreads(channelId: Snowflake, archived?: 'public' | 'private') { const parts = ['', 'channels', channelId, 'threads']; if (archived) parts.push('archived', archived); else parts.push('active'); return parts.join('/') as | `/channels/${Snowflake}/threads/active` | `/channels/${Snowflake}/threads/archived/${'public' | 'private'}`; }, /** * Route for: * - GET `/channels/{channel.id}/users/@me/threads/archived/prviate` */ channelJoinedArchivedThreads(channelId: Snowflake) { return `/channels/${channelId}/users/@me/threads/archived/private` as const; }, /** * Route for: * - GET `/channels/{thread.id}/thread-members` * - GET `/channels/{thread.id}/thread-members/{user.id}` * - PUT `/channels/{thread.id}/thread-members/@me` * - PUT `/channels/{thread.id}/thread-members/{user.id}` * - DELETE `/channels/{thread.id}/thread-members/@me` * - DELETE `/channels/{thread.id}/thread-members/{user.id}` */ threadMembers(threadId: Snowflake, userId?: Snowflake | '@me') { const parts = ['', 'channels', threadId, 'thread-members']; if (userId) parts.push(userId); return parts.join('/') as | `/channels/${Snowflake}/thread-members` | `/channels/${Snowflake}/thread-members/${Snowflake | '@me'}`; }, /** * Route for: * - GET `/users/@me` * - GET `/users/{user.id}` * - PATCH `/users/@me` * * @param [userId='@me'] The user ID, defaulted to `@me` */ user(userId: Snowflake | '@me' = '@me') { return `/users/${userId}` as const; }, /** * Route for: * - GET `/users/@me/applications/{application.id}/role-connection` * - PUT `/users/@me/applications/{application.id}/role-connection` */ userApplicationRoleConnection(applicationId: Snowflake) { return `/users/@me/applications/${applicationId}/role-connection` as const; }, /** * Route for: * - GET `/users/@me/guilds` */ userGuilds() { return `/users/@me/guilds` as const; }, /** * Route for: * - GET `/users/@me/guilds/{guild.id}/member` */ userGuildMember(guildId: Snowflake) { return `/users/@me/guilds/${guildId}/member` as const; }, /** * Route for: * - DELETE `/users/@me/guilds/{guild.id}` */ userGuild(guildId: Snowflake) { return `/users/@me/guilds/${guildId}` as const; }, /** * Route for: * - POST `/users/@me/channels` */ userChannels() { return `/users/@me/channels` as const; }, /** * Route for: * - GET `/users/@me/connections` */ userConnections() { return `/users/@me/connections` as const; }, /** * Route for: * - GET `/voice/regions` */ voiceRegions() { return `/voice/regions` as const; }, /** * Route for: * - GET `/channels/{channel.id}/webhooks` * - POST `/channels/{channel.id}/webhooks` */ channelWebhooks(channelId: Snowflake) { return `/channels/${channelId}/webhooks` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/webhooks` */ guildWebhooks(guildId: Snowflake) { return `/guilds/${guildId}/webhooks` as const; }, /** * Route for: * - GET `/webhooks/{webhook.id}` * - GET `/webhooks/{webhook.id}/{webhook.token}` * - PATCH `/webhooks/{webhook.id}` * - PATCH `/webhooks/{webhook.id}/{webhook.token}` * - DELETE `/webhooks/{webhook.id}` * - DELETE `/webhooks/{webhook.id}/{webhook.token}` * - POST `/webhooks/{webhook.id}/{webhook.token}` * * - POST `/webhooks/{application.id}/{interaction.token}` */ webhook(webhookId: Snowflake, webhookToken?: string) { const parts = ['', 'webhooks', webhookId]; if (webhookToken) parts.push(webhookToken); return parts.join('/') as `/webhooks/${Snowflake}` | `/webhooks/${Snowflake}/${string}`; }, /** * Route for: * - GET `/webhooks/{webhook.id}/{webhook.token}/messages/@original` * - GET `/webhooks/{webhook.id}/{webhook.token}/messages/{message.id}` * - PATCH `/webhooks/{webhook.id}/{webhook.token}/messages/@original` * - PATCH `/webhooks/{webhook.id}/{webhook.token}/messages/{message.id}` * - DELETE `/webhooks/{webhook.id}/{webhook.token}/messages/@original` * - DELETE `/webhooks/{webhook.id}/{webhook.token}/messages/{message.id}` * * - PATCH `/webhooks/{application.id}/{interaction.token}/messages/@original` * - PATCH `/webhooks/{application.id}/{interaction.token}/messages/{message.id}` * - DELETE `/webhooks/{application.id}/{interaction.token}/messages/{message.id}` * * @param [messageId='@original'] The message ID to change, defaulted to `@original` */ webhookMessage(webhookId: Snowflake, webhookToken: string, messageId: Snowflake | '@original' = '@original') { return `/webhooks/${webhookId}/${webhookToken}/messages/${messageId}` as const; }, /** * Route for: * - POST `/webhooks/{webhook.id}/{webhook.token}/github` * - POST `/webhooks/{webhook.id}/{webhook.token}/slack` */ webhookPlatform(webhookId: Snowflake, webhookToken: string, platform: 'github' | 'slack') { return `/webhooks/${webhookId}/${webhookToken}/${platform}` as const; }, /** * Route for: * - GET `/gateway` */ gateway() { return `/gateway` as const; }, /** * Route for: * - GET `/gateway/bot` */ gatewayBot() { return `/gateway/bot` as const; }, /** * Route for: * - GET `/oauth2/applications/@me` */ oauth2CurrentApplication() { return `/oauth2/applications/@me` as const; }, /** * Route for: * - GET `/oauth2/@me` */ oauth2CurrentAuthorization() { return `/oauth2/@me` as const; }, /** * Route for: * - GET `/oauth2/authorize` */ oauth2Authorization() { return `/oauth2/authorize` as const; }, /** * Route for: * - POST `/oauth2/token` */ oauth2TokenExchange() { return `/oauth2/token` as const; }, /** * Route for: * - POST `/oauth2/token/revoke` */ oauth2TokenRevocation() { return `/oauth2/token/revoke` as const; }, /** * Route for: * - GET `/applications/{application.id}/commands` * - PUT `/applications/{application.id}/commands` * - POST `/applications/{application.id}/commands` */ applicationCommands(applicationId: Snowflake) { return `/applications/${applicationId}/commands` as const; }, /** * Route for: * - GET `/applications/{application.id}/commands/{command.id}` * - PATCH `/applications/{application.id}/commands/{command.id}` * - DELETE `/applications/{application.id}/commands/{command.id}` */ applicationCommand(applicationId: Snowflake, commandId: Snowflake) { return `/applications/${applicationId}/commands/${commandId}` as const; }, /** * Route for: * - GET `/applications/{application.id}/guilds/{guild.id}/commands` * - PUT `/applications/{application.id}/guilds/{guild.id}/commands` * - POST `/applications/{application.id}/guilds/{guild.id}/commands` */ applicationGuildCommands(applicationId: Snowflake, guildId: Snowflake) { return `/applications/${applicationId}/guilds/${guildId}/commands` as const; }, /** * Route for: * - GET `/applications/{application.id}/guilds/{guild.id}/commands/{command.id}` * - PATCH `/applications/{application.id}/guilds/{guild.id}/commands/{command.id}` * - DELETE `/applications/{application.id}/guilds/{guild.id}/commands/{command.id}` */ applicationGuildCommand(applicationId: Snowflake, guildId: Snowflake, commandId: Snowflake) { return `/applications/${applicationId}/guilds/${guildId}/commands/${commandId}` as const; }, /** * Route for: * - POST `/interactions/{interaction.id}/{interaction.token}/callback` */ interactionCallback(interactionId: Snowflake, interactionToken: string) { return `/interactions/${interactionId}/${interactionToken}/callback` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/member-verification` * - PATCH `/guilds/{guild.id}/member-verification` */ guildMemberVerification(guildId: Snowflake) { return `/guilds/${guildId}/member-verification` as const; }, /** * Route for: * - PATCH `/guilds/{guild.id}/voice-states/@me` * - PATCH `/guilds/{guild.id}/voice-states/{user.id}` */ guildVoiceState(guildId: Snowflake, userId: Snowflake | '@me' = '@me') { return `/guilds/${guildId}/voice-states/${userId}` as const; }, /** * Route for: * - GET `/applications/{application.id}/guilds/{guild.id}/commands/permissions` * - PUT `/applications/{application.id}/guilds/{guild.id}/commands/permissions` */ guildApplicationCommandsPermissions(applicationId: Snowflake, guildId: Snowflake) { return `/applications/${applicationId}/guilds/${guildId}/commands/permissions` as const; }, /** * Route for: * - GET `/applications/{application.id}/guilds/{guild.id}/commands/{command.id}/permissions` * - PUT `/applications/{application.id}/guilds/{guild.id}/commands/{command.id}/permissions` */ applicationCommandPermissions(applicationId: Snowflake, guildId: Snowflake, commandId: Snowflake) { return `/applications/${applicationId}/guilds/${guildId}/commands/${commandId}/permissions` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/welcome-screen` * - PATCH `/guilds/{guild.id}/welcome-screen` */ guildWelcomeScreen(guildId: Snowflake) { return `/guilds/${guildId}/welcome-screen` as const; }, /** * Route for: * - POST `/stage-instances` */ stageInstances() { return `/stage-instances` as const; }, /** * Route for: * - GET `/stage-instances/{channel.id}` * - PATCH `/stage-instances/{channel.id}` * - DELETE `/stage-instances/{channel.id}` */ stageInstance(channelId: Snowflake) { return `/stage-instances/${channelId}` as const; }, /** * Route for: * - GET `/stickers/{sticker.id}` */ sticker(stickerId: Snowflake) { return `/stickers/${stickerId}` as const; }, /** * Route for: * - GET `/sticker-packs` */ nitroStickerPacks() { return '/sticker-packs' as const; }, /** * Route for: * - GET `/guilds/{guild.id}/stickers` * - POST `/guilds/{guild.id}/stickers` */ guildStickers(guildId: Snowflake) { return `/guilds/${guildId}/stickers` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/stickers/{sticker.id}` * - PATCH `/guilds/{guild.id}/stickers/{sticker.id}` * - DELETE `/guilds/{guild.id}/stickers/{sticker.id}` */ guildSticker(guildId: Snowflake, stickerId: Snowflake) { return `/guilds/${guildId}/stickers/${stickerId}` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/scheduled-events` * - POST `/guilds/{guild.id}/scheduled-events` */ guildScheduledEvents(guildId: Snowflake) { return `/guilds/${guildId}/scheduled-events` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/scheduled-events/{guildScheduledEvent.id}` * - PATCH `/guilds/{guild.id}/scheduled-events/{guildScheduledEvent.id}` * - DELETE `/guilds/{guild.id}/scheduled-events/{guildScheduledEvent.id}` */ guildScheduledEvent(guildId: Snowflake, guildScheduledEventId: Snowflake) { return `/guilds/${guildId}/scheduled-events/${guildScheduledEventId}` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/scheduled-events/{guildScheduledEvent.id}/users` */ guildScheduledEventUsers(guildId: Snowflake, guildScheduledEventId: Snowflake) { return `/guilds/${guildId}/scheduled-events/${guildScheduledEventId}/users` as const; }, /* ---------- Auth routes -------------------- */ login() { return '/auth/login' as const; }, logout() { return '/auth/logout' as const; }, register() { return '/auth/register' as const; }, reset() { return '/auth/reset' as const; }, locationMetadata() { return '/auth/location-metadata' as const; }, generateRegistrationTokens() { return '/auth/generate-registration-tokens' as const; }, forgot() { return '/auth/forgot' as const; }, emailVerify() { return '/auth/verify' as const; }, emailVerifyResend() { return '/auth/verify/resend' as const; }, viewBackupCodesChallenge() { return '/auth/verify/view-backup-codes-challenge' as const; }, mfaTotp() { return '/auth/mfa/totp' as const; }, mfaWebauthn() { return '/auth/mfa/webauthn' as const; }, /* ---------- Polices routes -------------------- */ stats() { return '/policies/stats' as const; }, instance() { return '/policies/instance' as const; }, instanceDomains() { return '/policies/instance/domains' as const; }, instanceLimits() { return '/policies/instance/limits' as const; }, }; export const StickerPackApplicationId = '710982414301790216'; export const CDNRoutes = { /** * Route for: * - GET `/emojis/{emoji.id}.{png|jpeg|webp|gif}` * * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format * * This route supports the extensions: PNG, JPEG, WebP, GIF */ emoji(emojiId: Snowflake, format: EmojiFormat) { return `/emojis/${emojiId}.${format}` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/icons/{guild.id}.{png|jpeg|webp|gif}` * * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format * * This route supports the extensions: PNG, JPEG, WebP, GIF */ guildIcon(guildId: Snowflake, guildIcon: string, format: GuildIconFormat) { return `/icons/${guildId}/${guildIcon}.${format}` as const; }, /** * Route for: * - GET `/splashes/{guild.id}/{guild.splash}.{png|jpeg|webp}` * * This route supports the extensions: PNG, JPEG, WebP */ guildSplash(guildId: Snowflake, guildSplash: string, format: GuildSplashFormat) { return `/splashes/${guildId}/${guildSplash}.${format}` as const; }, /** * Route for: * - GET `/discovery-splashes/{guild.id}/{guild.discovery_splash}.{png|jpeg|webp}` * * This route supports the extensions: PNG, JPEG, WebP */ guildDiscoverySplash(guildId: Snowflake, guildDiscoverySplash: string, format: GuildDiscoverySplashFormat) { return `/discovery-splashes/${guildId}/${guildDiscoverySplash}.${format}` as const; }, /** * Route for: * - GET `/banners/{guild.id}/{guild.banner}.{png|jpeg|webp|gif}` * * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format * * This route supports the extensions: PNG, JPEG, WebP, GIF */ guildBanner(guildId: Snowflake, guildBanner: string, format: GuildBannerFormat) { return `/banners/${guildId}/${guildBanner}.${format}` as const; }, /** * Route for: * - GET `/banners/{user.id}/{user.banner}.{png|jpeg|webp|gif}` * * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format * * This route supports the extensions: PNG, JPEG, WebP, GIF */ userBanner(userId: Snowflake, userBanner: string, format: UserBannerFormat) { return `/banners/${userId}/${userBanner}.${format}` as const; }, /** * Route for: * - GET `/embed/avatars/{user.discriminator % 5}.png` * * The `userDiscriminator` parameter should be the user discriminator modulo 5 (e.g. 1337 % 5 = 2) * * This route supports the extension: PNG */ defaultUserAvatar(userDiscriminator: DefaultUserAvatarAssets) { return `/embed/avatars/${userDiscriminator}.png` as const; }, /** * Route for: * - GET `/avatars/{user.id}/{user.avatar}.{png|jpeg|webp|gif}` * * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format * * This route supports the extensions: PNG, JPEG, WebP, GIF */ userAvatar(userId: Snowflake, userAvatar: string, format: UserAvatarFormat) { return `/avatars/${userId}/${userAvatar}.${format}` as const; }, /** * Route for: * - GET `/guilds/{guild.id}/users/{user.id}/{guild_member.avatar}.{png|jpeg|webp|gif}` * * As this route supports GIFs, the hash will begin with `a_` if it is available in GIF format * * This route supports the extensions: PNG, JPEG, WebP, GIF */ guildMemberAvatar(guildId: Snowflake, userId: Snowflake, memberAvatar: string, format: GuildMemberAvatarFormat) { return `/guilds/${guildId}/users/${userId}/avatars/${memberAvatar}.${format}` as const; }, /** * Route for: * - GET `/app-icons/{application.id}/{application.icon}.{png|jpeg|webp}` * * This route supports the extensions: PNG, JPEG, WebP */ applicationIcon(applicationId: Snowflake, applicationIcon: string, format: ApplicationIconFormat) { return `/app-icons/${applicationId}/${applicationIcon}.${format}` as const; }, /** * Route for: * - GET `/app-icons/{application.id}/{application.cover_image}.{png|jpeg|webp}` * * This route supports the extensions: PNG, JPEG, WebP */ applicationCover(applicationId: Snowflake, applicationCoverImage: string, format: ApplicationCoverFormat) { return `/app-icons/${applicationId}/${applicationCoverImage}.${format}` as const; }, /** * Route for: * - GET `/app-assets/{application.id}/{application.asset_id}.{png|jpeg|webp}` * * This route supports the extensions: PNG, JPEG, WebP */ applicationAsset(applicationId: Snowflake, applicationAssetId: string, format: ApplicationAssetFormat) { return `/app-assets/${applicationId}/${applicationAssetId}.${format}` as const; }, /** * Route for: * - GET `/app-assets/{application.id}/achievements/{achievement.id}/icons/{achievement.icon}.{png|jpeg|webp}` * * This route supports the extensions: PNG, JPEG, WebP */ achievementIcon( applicationId: Snowflake, achievementId: Snowflake, achievementIconHash: string, format: AchievementIconFormat, ) { return `/app-assets/${applicationId}/achievements/${achievementId}/icons/${achievementIconHash}.${format}` as const; }, /** * Route for: * - GET `/app-assets/710982414301790216/store/{sticker_pack.banner.asset_id}.{png|jpeg|webp}` * * This route supports the extensions: PNG, JPEG, WebP */ stickerPackBanner(stickerPackBannerAssetId: Snowflake, format: StickerPackBannerFormat) { return `/app-assets/${StickerPackApplicationId}/store/${stickerPackBannerAssetId}.${format}` as const; }, /** * Route for: * - GET `/app-assets/${application.id}/store/${asset.id}.{png|jpeg|webp}}` * * This route supports the extensions: PNG, JPEG, WebP */ storePageAsset(applicationId: Snowflake, assetId: string) { return `/app-assets/${applicationId}/store/${assetId}.png` as const; }, /** * Route for: * - GET `team-icons/{team.id}/{team.icon}.{png|jpeg|webp}` * * This route supports the extensions: PNG, JPEG, WebP */ teamIcon(teamId: Snowflake, teamIcon: string, format: TeamIconFormat) { return `/team-icons/${teamId}/${teamIcon}.${format}` as const; }, /** * Route for: * - GET `/stickers/{sticker.id}.{png|json}` * * This route supports the extensions: PNG, Lottie, GIF */ sticker(stickerId: Snowflake, format: StickerFormat) { return `/stickers/${stickerId}.${format}` as const; }, /** * Route for: * - GET `/role-icons/{role.id}/{role.icon}.{png|jpeg|webp}` * * This route supports the extensions: PNG, JPEG, WebP */ roleIcon(roleId: Snowflake, roleIcon: string, format: RoleIconFormat) { return `/role-icons/${roleId}/${roleIcon}.${format}` as const; }, /** * Route for: * - GET `/guild-events/{guild_scheduled_event.id}/{guild_scheduled_event.image}.{png|jpeg|webp}` * * This route supports the extensions: PNG, JPEG, WebP */ guildScheduledEventCover( guildScheduledEventId: Snowflake, guildScheduledEventCoverImage: string, format: GuildScheduledEventCoverFormat, ) { return `/guild-events/${guildScheduledEventId}/${guildScheduledEventCoverImage}.${format}` as const; }, /** * Route for: * - GET `/guilds/${guild.id}/users/${user.id}/banners/${guild_member.banner}.{png|jpeg|webp|gif}` * * This route supports the extensions: PNG, JPEG, WebP, GIF */ guildMemberBanner(guildId: Snowflake, userId: Snowflake, guildMemberBanner: string, format: GuildMemberBannerFormat) { return `/guilds/${guildId}/users/${userId}/banners/${guildMemberBanner}.${format}` as const; }, }; export type DefaultUserAvatarAssets = 0 | 1 | 2 | 3 | 4 | 5; export type EmojiFormat = Exclude; export type GuildIconFormat = Exclude; export type GuildSplashFormat = Exclude; export type GuildDiscoverySplashFormat = Exclude; export type GuildBannerFormat = Exclude; export type UserBannerFormat = Exclude; export type DefaultUserAvatar = Extract; export type UserAvatarFormat = Exclude; export type GuildMemberAvatarFormat = Exclude; export type ApplicationIconFormat = Exclude; export type ApplicationCoverFormat = Exclude; export type ApplicationAssetFormat = Exclude; export type AchievementIconFormat = Exclude; export type StickerPackBannerFormat = Exclude; export type TeamIconFormat = Exclude; export type StickerFormat = Extract; export type RoleIconFormat = Exclude; export type GuildScheduledEventCoverFormat = Exclude; export type GuildMemberBannerFormat = Exclude; export enum ImageFormat { JPEG = 'jpeg', PNG = 'png', WebP = 'webp', GIF = 'gif', Lottie = 'json', } export interface CDNQuery { /** * The returned image can have the size changed by using this query parameter * * Image size can be any power of two between 16 and 4096 */ size?: number; } export const RouteBases = { api: `https://discord.com/api/v${APIVersion}`, cdn: 'https://cdn.discordapp.com', invite: 'https://discord.gg', template: 'https://discord.new', gift: 'https://discord.gift', scheduledEvent: 'https://discord.com/events', } as const; // Freeze bases object Object.freeze(RouteBases); export const OAuth2Routes = { authorizationURL: `${RouteBases.api}${Routes.oauth2Authorization()}`, tokenURL: `${RouteBases.api}${Routes.oauth2TokenExchange()}`, /** * See https://tools.ietf.org/html/rfc7009 */ tokenRevocationURL: `${RouteBases.api}${Routes.oauth2TokenRevocation()}`, } as const; // Freeze OAuth2 route object Object.freeze(OAuth2Routes);