Class Guilds

Various methods for interacting with guilds.

Hierarchy

Guilds

Index

Constructors

Methods

addMember addMemberRole beginPrune create createAutoModerationRule createBan createChannel createEmoji createFromTemplate createRole createScheduledEvent createSticker createTemplate delete deleteAutoModerationRule deleteEmoji deleteIntegration deleteRole deleteScheduledEvent deleteSticker deleteTemplate edit editAutoModerationRule editChannelPositions editCurrentMember editCurrentUserVoiceState editEmoji editMFALevel editMember editOnboarding editRole editRolePositions editScheduledEvent editSticker editTemplate editUserVoiceState editWelcomeScreen editWidget get getActiveThreads getAuditLog getAutoModerationRule getAutoModerationRules getBan getBans getChannels getEmoji getEmojis getIntegrations getInvites getMember getMembers getOnboarding getPreview getPruneCount getRoles getScheduledEvent getScheduledEventUsers getScheduledEvents getSticker getStickers getTemplate getTemplates getVanityURL getVoiceRegions getWelcomeScreen getWidget getWidgetImage getWidgetJSON getWidgetSettings removeBan removeMember removeMemberRole searchMembers syncTemplate

Constructors

constructor

new Guilds(manager: RESTManager): Guilds
Parameters
- manager: RESTManager
Returns Guilds
- Defined in lib/routes/Guilds.ts:94

Methods

addMember

addMember(guildID: string, userID: string, options: AddMemberOptions): Promise<void | Member>
Add a member to a guild. Requires an access token with the guilds.join scope.

Returns the newly added member upon success, or void if the member is already in the guild.
Parameters
- guildID: string
  
  The ID of the guild.
- userID: string
  
  The ID of the user to add.
- options: AddMemberOptions
  
  The options for adding the member.
Returns Promise<void | Member>
- Defined in lib/routes/Guilds.ts:106

addMemberRole

addMemberRole(guildID: string, memberID: string, roleID: string, reason?: string): Promise<void>
Add a role to a member.
Parameters
- guildID: string
  
  The ID of the guild.
- memberID: string
  
  The ID of the member.
- roleID: string
  
  The ID of the role to add.
- Optional reason: string
  
  The reason for adding the role.
Returns Promise<void>
- Defined in lib/routes/Guilds.ts:130

beginPrune

beginPrune(guildID: string, options?: BeginPruneOptions): Promise<null | number>
Begin a prune.
Parameters
- guildID: string
  
  The ID of the guild.
- Optional options: BeginPruneOptions
  
  The options for the prune.
Returns Promise<null | number>
- Defined in lib/routes/Guilds.ts:143

create

create(options: CreateGuildOptions): Promise<Guild>
Create a guild. This can only be used by bots in under 10 guilds.

Note: This does NOT add the guild to the client's cache.
Parameters
- options: CreateGuildOptions
  
  The options for creating the guild.
Returns Promise<Guild>
- Defined in lib/routes/Guilds.ts:166

createAutoModerationRule

createAutoModerationRule(guildID: string, options: CreateAutoModerationRuleOptions): Promise<AutoModerationRule>
Create an auto moderation rule for a guild.
Parameters
- guildID: string
  
  The ID of the guild.
- options: CreateAutoModerationRuleOptions
  
  The options for creating the rule.
Returns Promise<AutoModerationRule>
- Defined in lib/routes/Guilds.ts:195

createBan

createBan(guildID: string, userID: string, options?: CreateBanOptions): Promise<void>
Create a ban for a user.
Parameters
- guildID: string
  
  The ID of the guild.
- userID: string
  
  The ID of the user to ban.
- Optional options: CreateBanOptions
  
  The options for creating the ban.
Returns Promise<void>
- Defined in lib/routes/Guilds.ts:236

createChannel

createChannel<T>(guildID: string, type: T, options: Omit<CreateChannelOptions<GUILD_TEXT | GUILD_VOICE | GUILD_CATEGORY | GUILD_ANNOUNCEMENT | GUILD_STAGE_VOICE | GUILD_DIRECTORY | GUILD_FORUM>, "type">): Promise<ChannelTypeMap[T]>
Create a channel in a guild.
Type Parameters
- T extends GUILD_TEXT | GUILD_VOICE | GUILD_CATEGORY | GUILD_ANNOUNCEMENT | GUILD_STAGE_VOICE | GUILD_DIRECTORY | GUILD_FORUM
Parameters
- guildID: string
  
  The ID of the guild.
- type: T
- options: Omit<CreateChannelOptions<GUILD_TEXT | GUILD_VOICE | GUILD_CATEGORY | GUILD_ANNOUNCEMENT | GUILD_STAGE_VOICE | GUILD_DIRECTORY | GUILD_FORUM>, "type">
  
  The options for creating the channel.
Returns Promise<ChannelTypeMap[T]>
- Defined in lib/routes/Guilds.ts:257

createEmoji

createEmoji(guildID: string, options: CreateEmojiOptions): Promise<GuildEmoji>
Create an emoji in a guild.
Parameters
- guildID: string
  
  The ID of the guild.
- options: CreateEmojiOptions
  
  The options for creating the emoji.
Returns Promise<GuildEmoji>
- Defined in lib/routes/Guilds.ts:298

createFromTemplate

createFromTemplate(code: string, options: CreateGuildFromTemplateOptions): Promise<Guild>
Create a guild from a template. This can only be used by bots in less than 10 guilds.

Note: This does NOT add the guild to the client's cache.
Parameters
- code: string
  
  The code of the template to use.
- options: CreateGuildFromTemplateOptions
  
  The options for creating the guild.
Returns Promise<Guild>
- Defined in lib/routes/Guilds.ts:328

createRole

createRole(guildID: string, options?: CreateRoleOptions): Promise<Role>
Create a role.
Parameters
- guildID: string
  
  The ID of the guild.
- Optional options: CreateRoleOptions
  
  The options for creating the role.
Returns Promise<Role>
- Defined in lib/routes/Guilds.ts:347

createScheduledEvent

createScheduledEvent(guildID: string, options: CreateScheduledEventOptions): Promise<GuildScheduledEvent>
Create a scheduled event in a guild.
Parameters
- guildID: string
  
  The ID of the guild.
- options: CreateScheduledEventOptions
  
  The options for creating the scheduled event.
Returns Promise<GuildScheduledEvent>
- Defined in lib/routes/Guilds.ts:376

createSticker

createSticker(guildID: string, options: CreateStickerOptions): Promise<Sticker>
Create a sticker.
Parameters
- guildID: string
  
  The ID of the guild.
- options: CreateStickerOptions
  
  The options for creating the sticker.
Returns Promise<Sticker>
- Defined in lib/routes/Guilds.ts:407

createTemplate

createTemplate(guildID: string, options: CreateTemplateOptions): Promise<GuildTemplate>
Create a guild template.
Parameters
- guildID: string
  
  The ID of the guild to create a template from.
- options: CreateTemplateOptions
  
  The options for creating the template.
Returns Promise<GuildTemplate>
- Defined in lib/routes/Guilds.ts:440

delete

delete(guildID: string): Promise<void>
Delete a guild.
Parameters
- guildID: string
  
  The ID of the guild.
Returns Promise<void>
- Defined in lib/routes/Guilds.ts:455

deleteAutoModerationRule

deleteAutoModerationRule(guildID: string, ruleID: string, reason?: string): Promise<void>
Delete an auto moderation rule.
Parameters
- guildID: string
  
  The ID of the guild.
- ruleID: string
  
  The ID of the rule to delete.
- Optional reason: string
  
  The reason for deleting the rule.
Returns Promise<void>
- Defined in lib/routes/Guilds.ts:468

deleteEmoji

deleteEmoji(guildID: string, emojiID: string, reason?: string): Promise<void>
Delete an emoji.
Parameters
- guildID: string
  
  The ID of the guild.
- emojiID: string
  
  The ID of the emoji.
- Optional reason: string
  
  The reason for deleting the emoji.
Returns Promise<void>
- Defined in lib/routes/Guilds.ts:482

deleteIntegration

deleteIntegration(guildID: string, integrationID: string, reason?: string): Promise<void>
Delete an integration.
Parameters
- guildID: string
  
  The ID of the guild.
- integrationID: string
  
  The ID of the integration.
- Optional reason: string
  
  The reason for deleting the integration.
Returns Promise<void>
- Defined in lib/routes/Guilds.ts:496

deleteRole

deleteRole(guildID: string, roleID: string, reason?: string): Promise<void>
Delete a role.
Parameters
- guildID: string
  
  The ID of the guild.
- roleID: string
  
  The ID of the role to delete.
- Optional reason: string
  
  The reason for deleting the role.
Returns Promise<void>
- Defined in lib/routes/Guilds.ts:510

deleteScheduledEvent

deleteScheduledEvent(guildID: string, eventID: string, reason?: string): Promise<void>
Delete a scheduled event.
Parameters
- guildID: string
  
  The ID of the guild.
- eventID: string
  
  The ID of the scheduled event.
- Optional reason: string
  
  The reason for deleting the scheduled event. Discord's docs do not explicitly state a reason can be provided, so it may not be used.
Returns Promise<void>
- Defined in lib/routes/Guilds.ts:524

deleteSticker

deleteSticker(guildID: string, stickerID: string, reason?: string): Promise<void>
Delete a sticker.
Parameters
- guildID: string
  
  The ID of the guild.
- stickerID: string
  
  The ID of the sticker to delete.
- Optional reason: string
  
  The reason for deleting the sticker.
Returns Promise<void>
- Defined in lib/routes/Guilds.ts:538

deleteTemplate

deleteTemplate(guildID: string, code: string): Promise<void>
Delete a template.
Parameters
- guildID: string
  
  The ID of the guild.
- code: string
  
  The code of the template.
Returns Promise<void>
- Defined in lib/routes/Guilds.ts:551

edit

edit(guildID: string, options: EditGuildOptions): Promise<Guild>
Edit a guild.

Note: If the client's cache does not already contain the guild, it will not be added.
Parameters
- guildID: string
  
  The ID of the guild.
- options: EditGuildOptions
  
  The options for editing the guild.
Returns Promise<Guild>
- Defined in lib/routes/Guilds.ts:565

editAutoModerationRule

editAutoModerationRule(guildID: string, ruleID: string, options: Partial<Pick<CreateAutoModerationRuleOptions, "name" | "actions" | "enabled" | "reason" | "eventType" | "triggerMetadata" | "exemptRoles" | "exemptChannels">>): Promise<AutoModerationRule>
Edit an existing auto moderation rule.
Parameters
- guildID: string
  
  The ID of the guild.
- ruleID: string
  
  The ID of the rule to edit.
- options: Partial<Pick<CreateAutoModerationRuleOptions, "name" | "actions" | "enabled" | "reason" | "eventType" | "triggerMetadata" | "exemptRoles" | "exemptChannels">>
  
  The options for editing the rule.
Returns Promise<AutoModerationRule>
- Defined in lib/routes/Guilds.ts:618

editChannelPositions

editChannelPositions(guildID: string, options: ModifyChannelPositionsEntry[]): Promise<void>
Edit the positions of channels in a guild.
Parameters
- guildID: string
  
  The ID of the guild.
- options: ModifyChannelPositionsEntry[]
  
  The channels to move. Unedited channels do not need to be specified.
Returns Promise<void>
- Defined in lib/routes/Guilds.ts:658

editCurrentMember

editCurrentMember(guildID: string, options: EditCurrentMemberOptions): Promise<Member>
Modify the current member in a guild.
Parameters
- guildID: string
  
  The ID of the guild.
- options: EditCurrentMemberOptions
  
  The options for editing the member.
Returns Promise<Member>
- Defined in lib/routes/Guilds.ts:676

editCurrentUserVoiceState

editCurrentUserVoiceState(guildID: string, options: EditCurrentUserVoiceStateOptions): Promise<void>
Edit the current member's voice state in a guild. channelID is required, and the current member must already be in that channel. See Discord's docs for more information.
Parameters
- guildID: string
  
  The ID of the guild.
- options: EditCurrentUserVoiceStateOptions
  
  The options for editing the voice state.
Returns Promise<void>
- Defined in lib/routes/Guilds.ts:694

editEmoji

editEmoji(guildID: string, emojiID: string, options: EditEmojiOptions): Promise<GuildEmoji>
Edit an existing emoji.
Parameters
- guildID: string
  
  The ID of the guild the emoji is in.
- emojiID: string
- options: EditEmojiOptions
  
  The options for editing the emoji.
Returns Promise<GuildEmoji>
- Defined in lib/routes/Guilds.ts:711

editMFALevel

editMFALevel(guildID: string, options: EditMFALevelOptions): Promise<MFALevels>
Edit the mfa level of a guild. This can only be used by the guild owner.
Parameters
- guildID: string
  
  The ID of the guild.
- options: EditMFALevelOptions
  
  The options for editing the MFA level.
Returns Promise<MFALevels>
- Defined in lib/routes/Guilds.ts:735

editMember

editMember(guildID: string, memberID: string, options: EditMemberOptions): Promise<Member>
Edit a guild member. Use editCurrentMember if you wish to update the nick of this client using the CHANGE_NICKNAME permission.
Parameters
- guildID: string
  
  The ID of the guild.
- memberID: string
  
  The ID of the member.
- options: EditMemberOptions
  
  The options for editing the member.
Returns Promise<Member>
- Defined in lib/routes/Guilds.ts:754

editOnboarding

editOnboarding(guildID: string, options: EditOnboardingOptions): Promise<Onboarding>
Edit a guild's onboarding configuration.
Parameters
- guildID: string
  
  The ID of the guild.
- options: EditOnboardingOptions
  
  The options for editing the onboarding configuration.
Returns Promise<Onboarding>
- Defined in lib/routes/Guilds.ts:779

editRole

editRole(guildID: string, roleID: string, options: EditRoleOptions): Promise<Role>
Edit an existing role.
Parameters
- guildID: string
  
  The ID of the guild.
- roleID: string
- options: EditRoleOptions
  
  The options for editing the role.
Returns Promise<Role>
- Defined in lib/routes/Guilds.ts:836

editRolePositions

editRolePositions(guildID: string, options: EditRolePositionsEntry[], reason?: string): Promise<Role[]>
Edit the position of roles in a guild.
Parameters
- guildID: string
  
  The ID of the guild.
- options: EditRolePositionsEntry[]
  
  The roles to move.
- Optional reason: string
Returns Promise<Role[]>
- Defined in lib/routes/Guilds.ts:865

editScheduledEvent

editScheduledEvent(guildID: string, options: EditScheduledEventOptions): Promise<GuildScheduledEvent>
Edit an existing scheduled event in a guild.
Parameters
- guildID: string
  
  The ID of the guild.
- options: EditScheduledEventOptions
  
  The options for editing the scheduled event.
Returns Promise<GuildScheduledEvent>
- Defined in lib/routes/Guilds.ts:883

editSticker

editSticker(guildID: string, stickerID: string, options: EditStickerOptions): Promise<Sticker>
Edit a sticker.
Parameters
- guildID: string
  
  The ID of the guild.
- stickerID: string
- options: EditStickerOptions
  
  The options for editing the sticker.
Returns Promise<Sticker>
- Defined in lib/routes/Guilds.ts:915

editTemplate

editTemplate(guildID: string, code: string, options: EditGuildTemplateOptions): Promise<GuildTemplate>
Edit a guild template.
Parameters
- guildID: string
  
  The ID of the guild.
- code: string
  
  The code of the template.
- options: EditGuildTemplateOptions
  
  The options for editing the template.
Returns Promise<GuildTemplate>
- Defined in lib/routes/Guilds.ts:934

editUserVoiceState

editUserVoiceState(guildID: string, memberID: string, options: EditUserVoiceStateOptions): Promise<void>
Edit a guild member's voice state. channelID is required, and the user must already be in that channel. See Discord's docs for more information.
Parameters
- guildID: string
  
  The ID of the guild.
- memberID: string
  
  The ID of the member.
- options: EditUserVoiceStateOptions
  
  The options for editing the voice state.
Returns Promise<void>
- Defined in lib/routes/Guilds.ts:952

editWelcomeScreen

editWelcomeScreen(guildID: string, options: EditWelcomeScreenOptions): Promise<WelcomeScreen>
Edit the welcome screen in a guild.
Parameters
- guildID: string
  
  The ID of the guild.
- options: EditWelcomeScreenOptions
  
  The options for editing the welcome screen.
Returns Promise<WelcomeScreen>
- Defined in lib/routes/Guilds.ts:968

editWidget

editWidget(guildID: string, options: WidgetSettings): Promise<Widget>
Edit the widget of a guild.
Parameters
- guildID: string
  
  The ID of the guild.
- options: WidgetSettings
  
  The options for editing the widget.
Returns Promise<Widget>
- Defined in lib/routes/Guilds.ts:1003

get

get(guildID: string, withCounts?: boolean): Promise<Guild>
Get a guild.

Note: If the guild is not already in the client's cache, this will not add it.
Parameters
- guildID: string
  
  The ID of the guild.
- Optional withCounts: boolean
  
  If the approximate number of members and online members should be included.
Returns Promise<Guild>
- Defined in lib/routes/Guilds.ts:1037

getActiveThreads

getActiveThreads(guildID: string): Promise<GetActiveThreadsResponse>
Get the active threads in a guild.
Parameters
- guildID: string
  
  The ID of the guild.
Returns Promise<GetActiveThreadsResponse>
- Defined in lib/routes/Guilds.ts:1053

getAuditLog

getAuditLog(guildID: string, options?: GetAuditLogOptions): Promise<AuditLog>
Get a guild's audit log.
Parameters
- guildID: string
  
  The ID of the guild.
- Optional options: GetAuditLogOptions
  
  The options for getting the audit logs.
Returns Promise<AuditLog>
- Defined in lib/routes/Guilds.ts:1073

getAutoModerationRule

getAutoModerationRule(guildID: string, ruleID: string): Promise<AutoModerationRule>
Get an auto moderation rule for a guild.
Parameters
- guildID: string
  
  The ID of the guild.
- ruleID: string
  
  The ID of the rule to get.
Returns Promise<AutoModerationRule>
- Defined in lib/routes/Guilds.ts:1109

getAutoModerationRules

getAutoModerationRules(guildID: string): Promise<AutoModerationRule[]>
Get the auto moderation rules for a guild.
Parameters
- guildID: string
  
  The ID of the guild.
Returns Promise<AutoModerationRule[]>
- Defined in lib/routes/Guilds.ts:1120

getBan

getBan(guildID: string, userID: string): Promise<Ban>
Get a ban.
Parameters
- guildID: string
  
  The ID of the guild.
- userID: string
  
  The ID of the user to get the ban of.
Returns Promise<Ban>
- Defined in lib/routes/Guilds.ts:1132

getBans

getBans(guildID: string, options?: GetBansOptions): Promise<Ban[]>
Get the bans in a guild.
Parameters
- guildID: string
  
  The ID of the guild.
- Optional options: GetBansOptions
  
  The options for getting the bans.
Returns Promise<Ban[]>
- Defined in lib/routes/Guilds.ts:1147

getChannels

getChannels(guildID: string): Promise<AnyGuildChannelWithoutThreads[]>
Get the channels in a guild. Does not include threads.
Parameters
- guildID: string
  
  The ID of the guild.
Returns Promise<AnyGuildChannelWithoutThreads[]>
- Defined in lib/routes/Guilds.ts:1209

getEmoji

getEmoji(guildID: string, emojiID: string): Promise<GuildEmoji>
Get an emoji in a guild.
Parameters
- guildID: string
  
  The ID of the guild.
- emojiID: string
  
  The ID of the emoji to get.
Returns Promise<GuildEmoji>
- Defined in lib/routes/Guilds.ts:1221

getEmojis

getEmojis(guildID: string): Promise<GuildEmoji[]>
Get the emojis in a guild.
Parameters
- guildID: string
  
  The ID of the guild.
Returns Promise<GuildEmoji[]>
- Defined in lib/routes/Guilds.ts:1235

getIntegrations

getIntegrations(guildID: string): Promise<Integration[]>
Get the integrations in a guild.
Parameters
- guildID: string
  
  The ID of the guild.
Returns Promise<Integration[]>
- Defined in lib/routes/Guilds.ts:1249

getInvites

getInvites<CH>(guildID: string): Promise<Invite<"withMetadata", CH>[]>
Get the invites of a guild.
Type Parameters
- CH extends Uncached | AnyInviteChannel | PartialInviteChannel = Uncached | AnyInviteChannel | PartialInviteChannel
Parameters
- guildID: string
  
  The ID of the guild to get the invites of.
Returns Promise<Invite<"withMetadata", CH>[]>
- Defined in lib/routes/Guilds.ts:1260

getMember

getMember(guildID: string, memberID: string): Promise<Member>
Get a guild member.
Parameters
- guildID: string
  
  The ID of the guild.
- memberID: string
  
  The ID of the member.
Returns Promise<Member>
- Defined in lib/routes/Guilds.ts:1272

getMembers

getMembers(guildID: string, options?: GetMembersOptions): Promise<Member[]>
Get a guild's members. This requires the GUILD_MEMBERS intent.
Parameters
- guildID: string
  
  The ID of the guild.
- Optional options: GetMembersOptions
  
  The options for getting the members.
Returns Promise<Member[]>
- Defined in lib/routes/Guilds.ts:1284

getOnboarding

getOnboarding(guildID: string): Promise<Onboarding>
Get a guild's onboarding info.
Parameters
- guildID: string
  
  The ID of the guild.
Returns Promise<Onboarding>
- Defined in lib/routes/Guilds.ts:1303

getPreview

getPreview(guildID: string): Promise<GuildPreview>
Get a preview of a guild. If the client is not already in this guild, the guild must be lurkable.
Parameters
- guildID: string
  
  The ID of the guild.
Returns Promise<GuildPreview>
- Defined in lib/routes/Guilds.ts:1334

getPruneCount

getPruneCount(guildID: string, options?: GetPruneCountOptions): Promise<number>
Get the prune count of a guild.
Parameters
- guildID: string
  
  The ID of the guild.
- Optional options: GetPruneCountOptions
  
  The options for getting the prune count.
Returns Promise<number>
- Defined in lib/routes/Guilds.ts:1346

getRoles

getRoles(guildID: string): Promise<Role[]>
Get the roles in a guild.
Parameters
- guildID: string
  
  The ID of the guild.
Returns Promise<Role[]>
- Defined in lib/routes/Guilds.ts:1365

getScheduledEvent

getScheduledEvent(guildID: string, eventID: string, withUserCount?: number): Promise<GuildScheduledEvent>
Get a scheduled event.
Parameters
- guildID: string
  
  The ID of the guild.
- eventID: string
  
  The ID of the scheduled event to get.
- Optional withUserCount: number
  
  If the number of users subscribed to the event should be included.
Returns Promise<GuildScheduledEvent>
- Defined in lib/routes/Guilds.ts:1379

getScheduledEventUsers

getScheduledEventUsers(guildID: string, eventID: string, options?: GetScheduledEventUsersOptions): Promise<ScheduledEventUser[]>
Get the users subscribed to a scheduled event.
Parameters
- guildID: string
  
  The ID of the guild.
- eventID: string
  
  The ID of the scheduled event.
- Optional options: GetScheduledEventUsersOptions
  
  The options for getting the users.
Returns Promise<ScheduledEventUser[]>
- Defined in lib/routes/Guilds.ts:1397

getScheduledEvents

getScheduledEvents(guildID: string, withUserCount?: number): Promise<GuildScheduledEvent[]>
Get a guild's scheduled events.
Parameters
- guildID: string
  
  The ID of the guild.
- Optional withUserCount: number
  
  If the number of users subscribed to the event should be included.
Returns Promise<GuildScheduledEvent[]>
- Defined in lib/routes/Guilds.ts:1428

getSticker

getSticker(guildID: string, stickerID: string): Promise<Sticker>
Get a sticker. Response will include a user if the client has the MANAGE_EMOJIS_AND_STICKERS permissions.
Parameters
- guildID: string
  
  The ID of the guild.
- stickerID: string
  
  The ID of the sticker to get.
Returns Promise<Sticker>
- Defined in lib/routes/Guilds.ts:1446

getStickers

getStickers(guildID: string): Promise<Sticker[]>
Get a guild's stickers. Stickers will include a user if the client has the MANAGE_EMOJIS_AND_STICKERS permissions.
Parameters
- guildID: string
  
  The ID of the guild.
Returns Promise<Sticker[]>
- Defined in lib/routes/Guilds.ts:1457

getTemplate

getTemplate(code: string): Promise<GuildTemplate>
Get a guild template.
Parameters
- code: string
  
  The code of the template to get.
Returns Promise<GuildTemplate>
- Defined in lib/routes/Guilds.ts:1468

getTemplates

getTemplates(guildID: string): Promise<GuildTemplate[]>
Get a guild's templates.
Parameters
- guildID: string
  
  The ID of the guild.
Returns Promise<GuildTemplate[]>
- Defined in lib/routes/Guilds.ts:1479

getVanityURL

getVanityURL(guildID: string): Promise<GetVanityURLResponse>
Get the vanity url of a guild.
Parameters
- guildID: string
  
  The ID of the guild.
Returns Promise<GetVanityURLResponse>
- Defined in lib/routes/Guilds.ts:1490

getVoiceRegions

getVoiceRegions(guildID: string): Promise<VoiceRegion[]>
Get the list of usable voice regions for a guild. This will return VIP servers when the guild is VIP-enabled.
Parameters
- guildID: string
  
  The ID of the guild.
Returns Promise<VoiceRegion[]>
- Defined in lib/routes/Guilds.ts:1501

getWelcomeScreen

getWelcomeScreen(guildID: string): Promise<WelcomeScreen>
Get the welcome screen for a guild.
Parameters
- guildID: string
  
  The ID of the guild.
Returns Promise<WelcomeScreen>
- Defined in lib/routes/Guilds.ts:1512

getWidget

getWidget(guildID: string): Promise<Widget>
Get the widget of a guild.
Parameters
- guildID: string
  
  The ID of the guild.
Returns Promise<Widget>
- Defined in lib/routes/Guilds.ts:1531

getWidgetImage

getWidgetImage(guildID: string, style?: WidgetImageStyle): Promise<Buffer>
Get the widget image of a guild.
Parameters
- guildID: string
  
  The ID of the guild.
- Optional style: WidgetImageStyle
  
  The style of the image.
Returns Promise<Buffer>
- Defined in lib/routes/Guilds.ts:1559

getWidgetJSON

getWidgetJSON(guildID: string): Promise<RawWidget>
Get the raw JSON widget of a guild.
Parameters
- guildID: string
  
  The ID of the guild.
Returns Promise<RawWidget>
- Defined in lib/routes/Guilds.ts:1575

getWidgetSettings

getWidgetSettings(guildID: string): Promise<WidgetSettings>
Get a guild's widget settings.
Parameters
- guildID: string
  
  The ID of the guild.
Returns Promise<WidgetSettings>
- Defined in lib/routes/Guilds.ts:1586

removeBan

removeBan(guildID: string, userID: string, reason?: string): Promise<void>
Remove a ban.
Parameters
- guildID: string
  
  The ID of the guild.
- userID: string
  
  The ID of the user to remove the ban from.
- Optional reason: string
  
  The reason for removing the ban.
Returns Promise<void>
- Defined in lib/routes/Guilds.ts:1602

removeMember

removeMember(guildID: string, memberID: string, reason?: string): Promise<void>
Remove a member from a guild.
Parameters
- guildID: string
  
  The ID of the guild.
- memberID: string
  
  The ID of the user to remove.
- Optional reason: string
  
  The reason for the removal.
Returns Promise<void>
- Defined in lib/routes/Guilds.ts:1616

removeMemberRole

removeMemberRole(guildID: string, memberID: string, roleID: string, reason?: string): Promise<void>
Remove a role from a member.
Parameters
- guildID: string
  
  The ID of the guild.
- memberID: string
  
  The ID of the member.
- roleID: string
  
  The ID of the role to remove.
- Optional reason: string
  
  The reason for removing the role.
Returns Promise<void>
- Defined in lib/routes/Guilds.ts:1631

searchMembers

searchMembers(guildID: string, options: SearchMembersOptions): Promise<Member[]>
Search the username & nicknames of members in a guild.
Parameters
- guildID: string
  
  The ID of the guild.
- options: SearchMembersOptions
  
  The options to search with.
Returns Promise<Member[]>
- Defined in lib/routes/Guilds.ts:1644

syncTemplate

syncTemplate(guildID: string, code: string): Promise<GuildTemplate>
Sync a guild template.
Parameters
- guildID: string
  
  The ID of the guild.
- code: string
  
  The code of the template to sync.
Returns Promise<GuildTemplate>
- Defined in lib/routes/Guilds.ts:1662

Class Guilds

Hierarchy

Index

Constructors

Methods

Constructors

constructor

Parameters

manager: RESTManager

Returns Guilds

Methods

addMember

Parameters

guildID: string

userID: string

options: AddMemberOptions

Returns Promise<void | Member>

addMemberRole

Parameters

guildID: string

memberID: string

roleID: string

Optional reason: string

Returns Promise<void>

beginPrune

Parameters

guildID: string

Optional options: BeginPruneOptions

Returns Promise<null | number>

create

Parameters

options: CreateGuildOptions

Returns Promise<Guild>

createAutoModerationRule

Parameters

guildID: string

options: CreateAutoModerationRuleOptions

Returns Promise<AutoModerationRule>

createBan

Parameters

guildID: string

userID: string

Optional options: CreateBanOptions

Returns Promise<void>

createChannel

Type Parameters

T extends GUILD_TEXT | GUILD_VOICE | GUILD_CATEGORY | GUILD_ANNOUNCEMENT | GUILD_STAGE_VOICE | GUILD_DIRECTORY | GUILD_FORUM

Parameters

guildID: string

type: T

options: Omit<CreateChannelOptions<GUILD_TEXT | GUILD_VOICE | GUILD_CATEGORY | GUILD_ANNOUNCEMENT | GUILD_STAGE_VOICE | GUILD_DIRECTORY | GUILD_FORUM>, "type">

Returns Promise<ChannelTypeMap[T]>

createEmoji

Parameters

guildID: string

options: CreateEmojiOptions

Returns Promise<GuildEmoji>

createFromTemplate

Parameters

code: string

options: CreateGuildFromTemplateOptions

Returns Promise<Guild>

createRole

Parameters

guildID: string

Optional options: CreateRoleOptions

Returns Promise<Role>

createScheduledEvent

Parameters

guildID: string

options: CreateScheduledEventOptions

Returns Promise<GuildScheduledEvent>

createSticker

Parameters

guildID: string

options: CreateStickerOptions

Returns Promise<Sticker>

createTemplate

Parameters

guildID: string

`Optional` reason: string

`Optional` options: BeginPruneOptions

`Optional` options: CreateBanOptions

`Optional` options: CreateRoleOptions

`Optional` reason: string

`Optional` reason: string

`Optional` reason: string

`Optional` reason: string

`Optional` reason: string

`Optional` reason: string