Class Channels

Index

Constructors

Methods

archive bulkCalendarRSVPUpdate bulkDeleteReactions completeListItem createAnnouncement createAnnouncementComment createCalendarComment createCalendarEvent createCalendarEventSeries createDoc createDocComment createForumComment createForumThread createListItem createMessage createPermission createReaction createReactionToSubcategory delete deleteAnnouncement deleteAnnouncementComment deleteCalendarComment deleteCalendarEvent deleteCalendarEventSeries deleteCalendarRSVP deleteDoc deleteDocComment deleteForumComment deleteForumThread deleteListItem deleteMessage deletePermission deleteReaction deleteReactionFromSubcategory edit editAnnouncement editAnnouncementComment editCalendarComment editCalendarEvent editCalendarEventSeries editCalendarRSVP editDoc editDocComment editForumComment editForumThread editListItem editMessage editPermission get getAnnouncement getAnnouncementComment getAnnouncementComments getAnnouncements getCalendarEvent getCalendarEventComment getCalendarEventComments getCalendarEvents getCalendarRSVP getCalendarRSVPs getDoc getDocComment getDocComments getDocs getForumComment getForumComments getForumThread getForumThreads getListItem getListItems getMessage getMessages getPermission getPermissions getRolePermissions getUserPermissions lockForumThread pinForumThread pinMessage restore uncompleteListItem unlockForumThread unpinForumThread unpinMessage

Constructors

constructor

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

Methods

bulkCalendarRSVPUpdate

bulkCalendarRSVPUpdate(
    channelID: string,
    eventID: number,
    memberIDs: string[],
    options: EditCalendarRSVPOptions,
): Promise<void>
Bulk create/update calendar rsvps.
Parameters
- channelID: string
  ID of the Calendar channel.
- eventID: number
  ID of a calendar event.
- memberIDs: string[]
  List of multiple member ids.
- options: EditCalendarRSVPOptions
  Update options.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:146

bulkDeleteReactions

bulkDeleteReactions(
    channelID: string,
    channelType: "ChannelMessage",
    targetID: string | number,
    filter?: { emoteId?: number },
): Promise<void>
Bulk delete every reaction from a target.
Parameters
- channelID: string
  ID of a channel.
- channelType: "ChannelMessage"
  Type of channel.
- targetID: string | number
  Target to remove reactions from it.
- Optionalfilter: { emoteId?: number }
  Filter options.
  - OptionalemoteId?: number
    Example
    90000000
Returns Promise<void>
- Defined in lib/routes/Channels.ts:168

completeListItem

completeListItem(channelID: string, itemID: string): Promise<void>
Mark a list item as completed.
Parameters
- channelID: string
  ID of a "Lists" channel.
- itemID: string
  ID of a list item.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:191

createAnnouncement

createAnnouncement(
channelID: string,
options: { content: string | Record<string, never>; title: string },
): Promise<Announcement>
Create a new announcement within an announcement channel.
Parameters
- channelID: string
  ID of the Announcement channel.
- options: { content: string | Record<string, never>; title: string }
  Announcement creation options.
  - content: string | Record<string, never>
    Content
    
    Description
    The content of the announcement
  - title: string
    Title
    
    Description
    The title of the announcement
Returns Promise<Announcement>
- Defined in lib/routes/Channels.ts:202

createAnnouncementComment

createAnnouncementComment(
    channelID: string,
    announcementID: string,
    options: { content: string },
): Promise<AnnouncementComment>
Create a comment inside an announcement.
Parameters
- channelID: string
  ID of the Announcement channel.
- announcementID: string
  ID of the announcement to create the comment in.
- options: { content: string }
  Comment creation options.
  - content: string
    Content Format: long-form markdown
    
    Description
    The content of the announcement comment
Returns Promise<AnnouncementComment>
- Defined in lib/routes/Channels.ts:217

createCalendarComment

createCalendarComment(
    channelID: string,
    eventID: number,
    options: CreateCalendarCommentOptions,
): Promise<CalendarComment>
Create a comment inside a calendar event.
Parameters
- channelID: string
  The ID of a "Calendar" channel.
- eventID: number
  The ID of a calendar event.
- options: CreateCalendarCommentOptions
  Comment options, includes content, and more.
Returns Promise<CalendarComment>
- Defined in lib/routes/Channels.ts:235

createCalendarEvent

createCalendarEvent(
    channelID: string,
    options: CreateCalendarEventOptions,
    createSeries?: {
        endDate?: string;
        endsAfterOccurrences?: number;
        every?: {
            count: number;
            interval: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoEveryInterval;
        };
        on?: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoOn[];
        type: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoType;
    },
): Promise<CalendarEvent>
Create an event into a "Calendar" channel.
Parameters
- channelID: string
  ID of a "Calendar" channel.
- options: CreateCalendarEventOptions
  Event options.
- OptionalcreateSeries: {
      endDate?: string;
      endsAfterOccurrences?: number;
      every?: {
          count: number;
          interval: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoEveryInterval;
      };
      on?: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoOn[];
      type: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoType;
  }
  (optional) Create a series. (event's repetition)
  - OptionalendDate?: string
    Ends at Format: date-time
    
    Description
    The ISO 8601 timestamp that the event ends at. Used to control the end date of the event repeat (only used when type is custom; if used with endsAfterOccurrences, the earliest resultant date of the two will be used)
  - OptionalendsAfterOccurrences?: number
    Occurrences
    
    Description
    Used to control the end date of the event repeat (only used when type is custom; if used with endDate, the earliest resultant date of the two will be used)
  - Optionalevery?: {
    count: number;
    interval: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoEveryInterval;
    }
    Description
    Apply further clarification to your events. This must have type set to custom
    
    count: number
    Count
    
    Description
    How often between your interval the event should repeat. For example, 1 would be every interval, 2 would be every second occurrence of the interval
    
    interval: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoEveryInterval
    Interval
    
    Description
    Coupled with count, this indicates the time range you are repeating your event over
  - Optionalon?: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoOn[]
    Description
    Used to control the day of the week that the event should repeat on (only used when type is custom and when every.interval is week)
  - type: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoType
    Repeat Type
    
    Description
    How often you want your event to repeat (important note: this will repeat for the next 365 days unless custom is defined)
    
    Default
    once @enum {string}
Returns Promise<CalendarEvent>
- Defined in lib/routes/Channels.ts:254

createCalendarEventSeries

createCalendarEventSeries(): Error
The Guilded API only allows series on the event's creation.

Use createCalendarEvent and set the createSeries property to create a series.

Returns Error
- Defined in lib/routes/Channels.ts:292

createDoc

createDoc(channelID: string, options: CreateDocOptions): Promise<Doc>
Create a doc in a "Docs" channel.
Parameters
- channelID: string
  ID pf a "Docs" channel.
- options: CreateDocOptions
  Doc's options.
Returns Promise<Doc>
- Defined in lib/routes/Channels.ts:302

createDocComment

createDocComment(
    channelID: string,
    docID: number,
    options: CreateDocCommentOptions,
): Promise<DocComment>
Create a comment in a doc.
Parameters
- channelID: string
  ID of the docs channel.
- docID: number
  ID of the doc.
- options: CreateDocCommentOptions
  Create options.
Returns Promise<DocComment>
- Defined in lib/routes/Channels.ts:316

createForumComment

createForumComment(
    channelID: string,
    threadID: number,
    options: CreateForumCommentOptions,
): Promise<ForumThreadComment>
Add a comment to a forum thread.
Parameters
- channelID: string
  ID of a "Forums" channel.
- threadID: number
  ID of a forum thread.
- options: CreateForumCommentOptions
  Comment's options.
Returns Promise<ForumThreadComment>
- Defined in lib/routes/Channels.ts:328

createForumThread

createForumThread<T extends ForumChannel = ForumChannel>(
channelID: string,
options: CreateForumThreadOptions,
): Promise<ForumThread<T>>
Create a forum thread in a specified forum channel.
Type Parameters
- T extends ForumChannel = ForumChannel
Parameters
- channelID: string
  ID of a "Forums" channel.
- options: CreateForumThreadOptions
  Thread's options including title & content.
Returns Promise<ForumThread<T>>
- Defined in lib/routes/Channels.ts:348

createListItem

createListItem(
    channelID: string,
    content: string | Record<string, never>,
    note?: { content: string | Record<string, never> },
): Promise<ListItem>
Create a new item in a list channel.
Parameters
- channelID: string
  ID of a "Lists" channel.
- content: string | Record<string, never>
  String content of the new item.
- Optionalnote: { content: string | Record<string, never> }
  Add a note to the new item.
  - content: string | Record<string, never>
    Note
    
    Description
    The note of the list item
Returns Promise<ListItem>
- Defined in lib/routes/Channels.ts:366

createMessage

createMessage<T extends TextChannel = TextChannel>(
    channelID: string,
    options: CreateMessageOptions,
    params?: MessageConstructorParams,
): Promise<Message<T>>
Send a message in a specified channel.
Type Parameters
- T extends TextChannel = TextChannel
Parameters
- channelID: string
  ID of the channel.
- options: CreateMessageOptions
  Message options
- Optionalparams: MessageConstructorParams
  Optional parameters.
Returns Promise<Message<T>>
- Defined in lib/routes/Channels.ts:383

createPermission

createPermission(
    guildID: string,
    channelID: string,
    targetID: string | number,
    options:
        | { permissions: Record<string, never> }
        | { permissions: Record<string, never> },
): Promise<Permission>
Add a new user permission to a channel.
Parameters
- guildID: string
  ID of the guild the channel is in
- channelID: string
  ID of the channel
- targetID: string | number
  ID of the user or role to assign the permission to
- options: { permissions: Record<string, never> } | { permissions: Record<string, never> }
  Create options
  
  Warning: targetID must have the correct type (number=role, string=user).
  - { permissions: Record<string, never> }
    permissions: Record<string, never>
    Description
    A JSON object of Enums/Permissions with true, false or null values. Permission list can only contain relevant permissions for the channel type
  - { permissions: Record<string, never> }
    permissions: Record<string, never>
    Description
    A JSON object of Enums/Permissions with true, false or null values. Permission list can only contain relevant permissions for the channel type
Returns Promise<Permission>
- Defined in lib/routes/Channels.ts:419

createReaction

createReaction(
    channelID: string,
    channelType: ChannelReactionTypes,
    targetID: string | number,
    reaction: number,
): Promise<void>
Add a reaction to a specified object from a channel.
Parameters
- channelID: string
  ID of a channel that supports reaction.
- channelType: ChannelReactionTypes
  Type of the selected channel. (e.g: "ChannelMessage")
- targetID: string | number
  ID of the object you'd like to add the reaction to. (e.g: a message ID)
- reaction: number
  ID of the reaction to add.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:444

createReactionToSubcategory

createReactionToSubcategory(
    channelID: string,
    subcategoryType: ChannelSubcategoryReactionTypes,
    subcategoryID: string | number,
    targetID: string | number,
    reaction: number,
): Promise<void>
Add a reaction to a target from a subcategory (e.g: a comment from Forum Thread)
Parameters
- channelID: string
  ID of a channel that supports reaction.
- subcategoryType: ChannelSubcategoryReactionTypes
  Type of the selected subcategory. (e.g: "CalendarEvent")
- subcategoryID: string | number
  ID of the subcategory you selected.
- targetID: string | number
  ID of the target you'd like to add the reaction to. (e.g: a comment id)
- reaction: number
  ID of the reaction to add.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:481

delete

delete(channelID: string): Promise<void>
Delete a channel.
Parameters
- channelID: string
  ID of the channel to delete.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:517

deleteAnnouncement

deleteAnnouncement(channelID: string, announcementID: string): Promise<void>
Delete an announcement.
Parameters
- channelID: string
  ID of an Announcement channel.
- announcementID: string
  ID of the announcement to delete.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:529

deleteAnnouncementComment

deleteAnnouncementComment(
    channelID: string,
    announcementID: string,
    commentID: number,
): Promise<void>
Delete an announcement comment.
Parameters
- channelID: string
  ID of an Announcement channel.
- announcementID: string
  ID of the announcement where the comment is in.
- commentID: number
  ID of the comment to delete.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:541

deleteCalendarComment

deleteCalendarComment(
    channelID: string,
    eventID: number,
    commentID: number,
): Promise<void>
Delete a comment from a calendar event.
Parameters
- channelID: string
  ID of the channel containing the event.
- eventID: number
  ID of the event containing the comment.
- commentID: number
  ID of the comment to delete.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:560

deleteCalendarEvent

deleteCalendarEvent(channelID: string, eventID: number): Promise<void>
Delete an event from a "Calendar" channel.
Parameters
- channelID: string
  ID of a "Calendar" channel.
- eventID: number
  ID of a calendar event.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:570

deleteCalendarEventSeries

deleteCalendarEventSeries(
    channelID: string,
    eventID: number,
    seriesID: string,
): Promise<void>
Delete a CalendarEventSeries.
Parameters
- channelID: string
  ID of the channel.
- eventID: number
  ID of the event.
- seriesID: string
  ID of the series.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:582

deleteCalendarRSVP

deleteCalendarRSVP(
    channelID: string,
    eventID: number,
    memberID: string,
): Promise<void>
Delete an RSVP from a calendar event.
Parameters
- channelID: string
  ID of a "Calendar" channel.
- eventID: number
  ID of a calendar event.
- memberID: string
  ID of a member.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:594

deleteDoc

deleteDoc(channelID: string, docID: number): Promise<void>
Delete a doc from a "Docs" channel.
Parameters
- channelID: string
  ID of a "Docs" channel.
- docID: number
  ID of a doc.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:605

deleteDocComment

deleteDocComment(
    channelID: string,
    docID: number,
    commentID: number,
): Promise<void>
Delete a doc comment.
Parameters
- channelID: string
  ID of the docs channel.
- docID: number
  ID of the doc.
- commentID: number
  ID of the comment to delete.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:617

deleteForumComment

deleteForumComment(
    channelID: string,
    threadID: number,
    commentID: number,
): Promise<void>
Delete a forum thread comment.
Parameters
- channelID: string
  ID of a "Forums" channel.
- threadID: number
  ID of a forum thread.
- commentID: number
  ID of a forum thread comment.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:628

deleteForumThread

deleteForumThread(channelID: string, threadID: number): Promise<void>
Delete a forum thread from a specific forum channel
Parameters
- channelID: string
  ID of a "Forums" channel.
- threadID: number
  ID of a forum thread.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:640

deleteListItem

deleteListItem(channelID: string, itemID: string): Promise<void>
Delete an item from a list channel.
Parameters
- channelID: string
  ID of a "Lists" channel.
- itemID: string
  ID of a list item.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:652

deleteMessage

deleteMessage(channelID: string, messageID: string): Promise<void>
Delete a specific message.
Parameters
- channelID: string
  ID of the channel containing the message.
- messageID: string
  ID of the message you'd like to delete.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:662

deletePermission

deletePermission(
    guildID: string,
    channelID: string,
    targetID: string | number,
): Promise<void>
Delete a channel permission.
Parameters
- guildID: string
  ID of the guild where the channel is in
- channelID: string
  ID of the channel
- targetID: string | number
  ID of the target user (string) or role (number)
  
  Warning: targetID must have the correct type (number=role, string=user).
Returns Promise<void>
- Defined in lib/routes/Channels.ts:678

deleteReaction

deleteReaction(
    channelID: string,
    channelType: ChannelReactionTypes,
    targetID: string | number,
    reaction: number,
    targetUserID?: string,
): Promise<void>
Remove a reaction from a specified message.
Parameters
- channelID: string
  ID of a channel that supports reaction.
- channelType: ChannelReactionTypes
  Type of the selected channel. (e.g: "ChannelMessage")
- targetID: string | number
  ID of the target you'd like to add the reaction to. (e.g: a message ID)
- reaction: number
  ID of the reaction.
- OptionaltargetUserID: string
  ID of the user to remove reaction from. (works only on Channel Messages | default: @me)
Returns Promise<void>
- Defined in lib/routes/Channels.ts:695

deleteReactionFromSubcategory

deleteReactionFromSubcategory(
    channelID: string,
    subcategoryType: ChannelSubcategoryReactionTypes,
    subcategoryID: string | number,
    targetID: string | number,
    reaction: number,
): Promise<void>
Remove a reaction from a target from a subcategory (e.g: a comment from Forum Thread)
Parameters
- channelID: string
  ID of a channel that supports reaction.
- subcategoryType: ChannelSubcategoryReactionTypes
  Type of the selected subcategory. (e.g: "CalendarEvent")
- subcategoryID: string | number
  ID of the subcategory you selected.
- targetID: string | number
  ID of the target you'd like to remove the reaction from. (e.g: a comment id)
- reaction: number
  ID of the reaction to add.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:739

edit

edit<T extends AnyChannel = AnyChannel>(
channelID: string,
options: EditChannelOptions,
): Promise<T>
Edit a channel.
Type Parameters
- T extends AnyChannel = AnyChannel
Parameters
- channelID: string
  ID of the channel to edit.
- options: EditChannelOptions
  Channel edit options.
Returns Promise<T>
- Defined in lib/routes/Channels.ts:776

editAnnouncement

editAnnouncement(
    channelID: string,
    announcementID: string,
    options: { content?: string | Record<string, never>; title?: string },
): Promise<Announcement>
Edit an existing announcement.
Parameters
- channelID: string
  ID of the Announcement channel.
- announcementID: string
  ID of the announcement to edit.
- options: { content?: string | Record<string, never>; title?: string }
  Edit options
  - Optionalcontent?: string | Record<string, never>
    Content
    
    Description
    The content of the announcement
  - Optionaltitle?: string
    Title
    
    Description
    The title of the announcement
Returns Promise<Announcement>
- Defined in lib/routes/Channels.ts:794

editAnnouncementComment

editAnnouncementComment(
    channelID: string,
    announcementID: string,
    commentID: number,
    options: { content: string },
): Promise<AnnouncementComment>
Edit an announcement comment.
Parameters
- channelID: string
  ID of an Announcement channel.
- announcementID: string
  ID of an announcement where the comment is in.
- commentID: number
  ID of the comment to edit.
- options: { content: string }
  Edit options.
  - content: string
    Content Format: long-form markdown
    
    Description
    The content of the announcement comment
Returns Promise<AnnouncementComment>
- Defined in lib/routes/Channels.ts:814

editCalendarComment

editCalendarComment(
    channelID: string,
    eventID: number,
    commentID: number,
    options: EditCalendarCommentOptions,
): Promise<CalendarComment>
Edit an existing calendar event comment.
Parameters
- channelID: string
  The ID of a "Calendar" channel.
- eventID: number
  The ID of an event from the channel.
- commentID: number
  The ID of the comment to edit.
- options: EditCalendarCommentOptions
  Edit options.
Returns Promise<CalendarComment>
- Defined in lib/routes/Channels.ts:838

editCalendarEvent

editCalendarEvent(
    channelID: string,
    eventID: number,
    options: EditCalendarEventOptions,
): Promise<CalendarEvent>
Edit an event from a "Calendar" channel.
Parameters
- channelID: string
  ID of a "Calendar" channel.
- eventID: number
  ID of a calendar event.
- options: EditCalendarEventOptions
  Edit options.
Returns Promise<CalendarEvent>
- Defined in lib/routes/Channels.ts:858

editCalendarEventSeries

editCalendarEventSeries(
    channelID: string,
    eventID: number,
    seriesID: string,
    options:
        | undefined
        | {
            endDate?: string;
            endsAfterOccurrences?: number;
            every?: {
                count: number;
                interval: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoEveryInterval;
            };
            on?: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoOn[];
            type: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoType;
        },
): Promise<void>
Edit a CalendarEventSeries.
Parameters
- channelID: string
  ID of the channel.
- eventID: number
  ID of the event.
- seriesID: string
  ID of the series.
- options:
      | undefined
      | {
          endDate?: string;
          endsAfterOccurrences?: number;
          every?: {
              count: number;
              interval: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoEveryInterval;
          };
          on?: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoOn[];
          type: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoType;
      }
  Edit repetition options.
  - undefined
  - {
        endDate?: string;
        endsAfterOccurrences?: number;
        every?: {
            count: number;
            interval: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoEveryInterval;
        };
        on?: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoOn[];
        type: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoType;
    }
    OptionalendDate?: string
    Ends at Format: date-time
    
    Description
    The ISO 8601 timestamp that the event ends at. Used to control the end date of the event repeat (only used when type is custom; if used with endsAfterOccurrences, the earliest resultant date of the two will be used)
    
    OptionalendsAfterOccurrences?: number
    Occurrences
    
    Description
    Used to control the end date of the event repeat (only used when type is custom; if used with endDate, the earliest resultant date of the two will be used)
    
    Optionalevery?: {
        count: number;
        interval: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoEveryInterval;
    }
    Description
    Apply further clarification to your events. This must have type set to custom
    
    count: number
    Count
    
    Description
    How often between your interval the event should repeat. For example, 1 would be every interval, 2 would be every second occurrence of the interval
    
    interval: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoEveryInterval
    Interval
    
    Description
    Coupled with count, this indicates the time range you are repeating your event over
    
    Optionalon?: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoOn[]
    Description
    Used to control the day of the week that the event should repeat on (only used when type is custom and when every.interval is week)
    
    type: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoType
    Repeat Type
    
    Description
    How often you want your event to repeat (important note: this will repeat for the next 365 days unless custom is defined)
    
    Default
    once @enum {string}
Returns Promise<void>
- Defined in lib/routes/Channels.ts:896

editCalendarRSVP

editCalendarRSVP(
    channelID: string,
    eventID: number,
    memberID: string,
    options: EditCalendarRSVPOptions,
): Promise<CalendarEventRSVP>
Add/Edit an RSVP in a calendar event.
Parameters
- channelID: string
  ID of a "Calendar" channel.
- eventID: number
  ID of a calendar event.
- memberID: string
  ID of a member.
- options: EditCalendarRSVPOptions
  Edit options.
Returns Promise<CalendarEventRSVP>
- Defined in lib/routes/Channels.ts:914

editDoc

editDoc(channelID: string, docID: number, options: EditDocOptions): Promise<Doc>
Edit a doc from a "Docs" channel.
Parameters
- channelID: string
  ID of a "Docs" channel.
- docID: number
  ID of a doc.
- options: EditDocOptions
  Edit options.
Returns Promise<Doc>
- Defined in lib/routes/Channels.ts:934

editDocComment

editDocComment(
    channelID: string,
    docID: number,
    commentID: number,
    options: EditDocCommentOptions,
): Promise<DocComment>
Edit a doc comment.
Parameters
- channelID: string
  ID of the docs channel.
- docID: number
  ID of the doc.
- commentID: number
  ID of the comment to edit.
- options: EditDocCommentOptions
  Edit options.
Returns Promise<DocComment>
- Defined in lib/routes/Channels.ts:949

editForumComment

editForumComment(
    channelID: string,
    threadID: number,
    commentID: number,
    options?: EditForumCommentOptions,
): Promise<ForumThreadComment>
Edit a forum thread's comment.
Parameters
- channelID: string
  ID of a "Forums" channel.
- threadID: number
  ID of a forum thread.
- commentID: number
  ID of a thread comment.
- Optionaloptions: EditForumCommentOptions
  Edit options.
Returns Promise<ForumThreadComment>
- Defined in lib/routes/Channels.ts:967

editForumThread

editForumThread<T extends ForumChannel = ForumChannel>(
    channelID: string,
    threadID: number,
    options: EditForumThreadOptions,
): Promise<ForumThread<T>>
Edit a forum thread from a specified forum channel.
Type Parameters
- T extends ForumChannel = ForumChannel
Parameters
- channelID: string
  ID of a "Forums" channel.
- threadID: number
  ID of a forum thread.
- options: EditForumThreadOptions
  Edit options.
Returns Promise<ForumThread<T>>
- Defined in lib/routes/Channels.ts:989

editListItem

editListItem(
    channelID: string,
    itemID: string,
    options?: { content?: string; note?: null | { content: string } },
): Promise<ListItem>
Edit an item from a list channel.
Parameters
- channelID: string
  ID of a "Lists" channel.
- itemID: string
  ID of a list item.
- Optionaloptions: { content?: string; note?: null | { content: string } }
  Edit options.
Returns Promise<ListItem>
- Defined in lib/routes/Channels.ts:1008

editMessage

editMessage<T extends TextChannel = TextChannel>(
    channelID: string,
    messageID: string,
    newMessage: EditMessageOptions,
    params?: MessageConstructorParams,
): Promise<Message<T>>
Edit a specific message coming from a specified channel.
Type Parameters
- T extends TextChannel = TextChannel
Parameters
- channelID: string
  The ID of the channel.
- messageID: string
  The ID of the message you'd like to edit.
- newMessage: EditMessageOptions
  object containing new message's options.
- Optionalparams: MessageConstructorParams
  Optional parameters.
Returns Promise<Message<T>>
- Defined in lib/routes/Channels.ts:1025

editPermission

editPermission(
    guildID: string,
    channelID: string,
    targetID: string | number,
    options: { permissions: Record<string, never> },
): Promise<Permission>
Update a channel permission.
Parameters
- guildID: string
  ID of the guild the channel is in
- channelID: string
  ID of the channel
- targetID: string | number
  ID of the target user (string) or role (number)
- options: { permissions: Record<string, never> }
  Edit options
  
  Warning: targetID must have the correct type (number=role, string=user).
  - permissions: Record<string, never>
    Description
    A JSON object of Enums/Permissions with true, false or null values. Permission list can only contain relevant permissions for the channel type
Returns Promise<Permission>
- Defined in lib/routes/Channels.ts:1064

get

get(channelID: string): Promise<AnyChannel>
This method is used to get a guild channel.
Parameters
- channelID: string
  The ID of the channel to get.
Returns Promise<AnyChannel>
- Defined in lib/routes/Channels.ts:1086

getAnnouncement

getAnnouncement(
channelID: string,
announcementID: string,
): Promise<Announcement>
Get a specific announcement from a channel.
Parameters
- channelID: string
  ID of an Announcement channel.
- announcementID: string
  ID of the announcement to get.
Returns Promise<Announcement>
- Defined in lib/routes/Channels.ts:1097

getAnnouncementComment

getAnnouncementComment(
    channelID: string,
    announcementID: string,
    commentID: number,
): Promise<AnnouncementComment>
Get a specific comment from an announcement.
Parameters
- channelID: string
  ID of an Announcement channel.
- announcementID: string
  ID of the announcement where the comment is in.
- commentID: number
  ID of the comment to get.
Returns Promise<AnnouncementComment>
- Defined in lib/routes/Channels.ts:1111

getAnnouncementComments

getAnnouncementComments(
channelID: string,
announcementID: string,
): Promise<AnnouncementComment[]>
Get comments from an announcement.
Parameters
- channelID: string
  ID of an Announcement channel.
- announcementID: string
  ID of an announcement.
Returns Promise<AnnouncementComment[]>
- Defined in lib/routes/Channels.ts:1132

getAnnouncements

getAnnouncements(
channelID: string,
filter?: { before?: string; limit?: number },
): Promise<Announcement[]>
Get a list of announcements from a channel.
Parameters
- channelID: string
  ID of an Announcement channel.
- Optionalfilter: { before?: string; limit?: number }
  Filter to apply.
  - Optionalbefore?: string
    Example
    2021-06-15T20:15:00.706Z
  - Optionallimit?: number
    Example
    25
Returns Promise<Announcement[]>
- Defined in lib/routes/Channels.ts:1150

getCalendarEvent

getCalendarEvent(channelID: string, eventID: number): Promise<CalendarEvent>
This method is used to get a specific calendar event.

Note: this method requires a "Calendar" channel.
Parameters
- channelID: string
  ID of a Calendar channel.
- eventID: number
  ID of a Calendar event.
Returns Promise<CalendarEvent>
- Defined in lib/routes/Channels.ts:1170

getCalendarEventComment

getCalendarEventComment(
    channelID: string,
    eventID: number,
    commentID: number,
): Promise<CalendarComment>
This method is used to get a specific event comment coming from a calendar. Note: this method doesn't cache scheduled events due to the API's restrictions.
Parameters
- channelID: string
  ID of a "Calendar" channel.
- eventID: number
  ID of an event containing the comment to get.
- commentID: number
  ID of the comment to get.
Returns Promise<CalendarComment>
- Defined in lib/routes/Channels.ts:1189

getCalendarEventComments

getCalendarEventComments(
channelID: string,
eventID: number,
): Promise<CalendarComment[]>
This method is used to get a list of CalendarEventComment Note: due to API's restrictions, we're not able to cache scheduled events from this method.
Parameters
- channelID: string
  ID of a "Calendar" channel.
- eventID: number
  ID of the event containing comments.
Returns Promise<CalendarComment[]>
- Defined in lib/routes/Channels.ts:1204

getCalendarEvents

getCalendarEvents(
channelID: string,
filter?: GetCalendarEventsFilter,
): Promise<CalendarEvent[]>
This method is used to get a list of CalendarEvent
Parameters
- channelID: string
  ID of a "Calendar" channel.
- Optionalfilter: GetCalendarEventsFilter
  Object to filter the output.
Returns Promise<CalendarEvent[]>
- Defined in lib/routes/Channels.ts:1220

getCalendarRSVP

getCalendarRSVP(
    channelID: string,
    eventID: number,
    memberID: string,
): Promise<CalendarEventRSVP>
This method is used to get a specific CalendarEventRSVP.

Note: this method requires a Calendar channel.
Parameters
- channelID: string
  ID of a Calendar channel
- eventID: number
  ID of a Calendar Event
- memberID: string
  ID of a Guild Member
Returns Promise<CalendarEventRSVP>
- Defined in lib/routes/Channels.ts:1248

getCalendarRSVPs

getCalendarRSVPs(
channelID: string,
eventID: number,
): Promise<CalendarEventRSVP[]>
This method is used to get a list of CalendarEventRSVP.
Parameters
- channelID: string
  ID of a "Calendar" channel.
- eventID: number
  ID of a calendar event.
Returns Promise<CalendarEventRSVP[]>
- Defined in lib/routes/Channels.ts:1266

getDoc

getDoc(channelID: string, docID: number): Promise<Doc>
This method is used to get a channel doc.

Note: This method requires a "Docs" channel.
Parameters
- channelID: string
  ID of the Docs channel.
- docID: number
  ID of the channel doc.
Returns Promise<Doc>
- Defined in lib/routes/Channels.ts:1287

getDocComment

getDocComment(
    channelID: string,
    docID: number,
    commentID: number,
): Promise<DocComment>
Get a specific comment from a doc.
Parameters
- channelID: string
  ID of the channel containing the doc.
- docID: number
  ID of the doc the comment is in.
- commentID: number
  ID of the comment to get.
Returns Promise<DocComment>
- Defined in lib/routes/Channels.ts:1304

getDocComments

getDocComments(channelID: string, docID: number): Promise<DocComment[]>
Get every comment from a doc.
Parameters
- channelID: string
  ID of the channel containing the doc.
- docID: number
  ID of the doc the comment is in.
Returns Promise<DocComment[]>
- Defined in lib/routes/Channels.ts:1315

getDocs

getDocs(
channelID: string,
filter?: { before?: string; limit?: number },
): Promise<Doc[]>
This method is used to get a list of "Channel" Doc.
Parameters
- channelID: string
  ID of a "Docs" channel.
- Optionalfilter: { before?: string; limit?: number }
  Object to filter the output.
Returns Promise<Doc[]>
- Defined in lib/routes/Channels.ts:1328

getForumComment

getForumComment(
    channelID: string,
    threadID: number,
    commentID: number,
): Promise<ForumThreadComment>
This method is used to get a specific forum thread comment.
Parameters
- channelID: string
  ID of a "Forums" channel.
- threadID: number
  ID of a Forum thread.
- commentID: number
  ID of a Forum thread comment.
Returns Promise<ForumThreadComment>
- Defined in lib/routes/Channels.ts:1351

getForumComments

getForumComments(
channelID: string,
threadID: number,
): Promise<ForumThreadComment[]>
This method is used to get a list of ForumThreadComment.
Parameters
- channelID: string
  ID of a "Forums" channel.
- threadID: number
  ID of a Forum Thread.
Returns Promise<ForumThreadComment[]>
- Defined in lib/routes/Channels.ts:1363

getForumThread

getForumThread(
channelID: string,
threadID: number,
): Promise<ForumThread<ForumChannel>>
This method is used to get a specific forum thread.

Note: This method requires a "Forum" channel.
Parameters
- channelID: string
  ID of a specific Forum channel.
- threadID: number
  ID of the specific Forum Thread.
Returns Promise<ForumThread<ForumChannel>>
- Defined in lib/routes/Channels.ts:1378

getForumThreads

getForumThreads(
channelID: string,
filter?: GetForumThreadsFilter,
): Promise<ForumThread<ForumChannel>[]>
This method is used to get a list of ForumThread.
Parameters
- channelID: string
  ID of a "Forum" channel.
- Optionalfilter: GetForumThreadsFilter
  Object to filter the output.
Returns Promise<ForumThread<ForumChannel>[]>
- Defined in lib/routes/Channels.ts:1388

getListItem

getListItem(channelID: string, itemID: string): Promise<ListItem>
This method is used to get a specific list item.
Parameters
- channelID: string
  ID of a "List" channel.
- itemID: string
  ID of a list item.
Returns Promise<ListItem>
- Defined in lib/routes/Channels.ts:1407

getListItems

getListItems(channelID: string): Promise<ListItem[]>
This method is used to get a list of ListItem.
Parameters
- channelID: string
  ID of a "List" channel.
Returns Promise<ListItem[]>
- Defined in lib/routes/Channels.ts:1416

getMessage

getMessage<T extends TextChannel = TextChannel>(
    channelID: string,
    messageID: string,
    params?: MessageConstructorParams,
): Promise<Message<T>>
This method is used to get a channel message.
Type Parameters
- T extends TextChannel = TextChannel
Parameters
- channelID: string
  The ID of the channel containing the message.
- messageID: string
  The ID of the message to get.
- Optionalparams: MessageConstructorParams
  Optional parameters.
Returns Promise<Message<T>>
- Defined in lib/routes/Channels.ts:1430

getMessages

getMessages(
channelID: string,
filter?: GetChannelMessagesFilter,
): Promise<Message<TextChannel>[]>
This method is used to get a list of Message
Parameters
- channelID: string
  ID of a "Chat" channel.
- Optionalfilter: GetChannelMessagesFilter
  Object to filter the output.
Returns Promise<Message<TextChannel>[]>
- Defined in lib/routes/Channels.ts:1452

getPermission

getPermission(
    guildID: string,
    channelID: string,
    targetID: string | number,
): Promise<Permission>
Get the permissions of a user or role for a specified channel.
Parameters
- guildID: string
  ID of the guild the channel is in
- channelID: string
  ID of the channel
- targetID: string | number
  ID of the user or role to get the permission
  
  Warning: targetID must have the correct type (number=role, string=user).
Returns Promise<Permission>
- Defined in lib/routes/Channels.ts:1489

getPermissions

getPermissions(guildID: string, channelID: string): Promise<Permission[]>
Parameters
- guildID: string
- channelID: string
Returns Promise<Permission[]>
- Defined in lib/routes/Channels.ts:1500

getRolePermissions

getRolePermissions(guildID: string, channelID: string): Promise<Permission[]>
Get existing channel permissions for a specified role.
Parameters
- guildID: string
  ID of the guild where the channel is in
- channelID: string
  ID of the channel
Returns Promise<Permission[]>
- Defined in lib/routes/Channels.ts:1516

getUserPermissions

getUserPermissions(guildID: string, channelID: string): Promise<Permission[]>
Get the permissions of every user in the guild for a specified channel.
Parameters
- guildID: string
  ID of the guild where the channel is in
- channelID: string
  ID of the channel
Returns Promise<Permission[]>
- Defined in lib/routes/Channels.ts:1529

lockForumThread

lockForumThread(channelID: string, threadID: number): Promise<void>
Lock a forum thread.
Parameters
- channelID: string
  ID of a "Forums" channel.
- threadID: number
  ID of a forum thread.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:1541

pinForumThread

pinForumThread(channelID: string, threadID: number): Promise<void>
Pin a forum thread.
Parameters
- channelID: string
  ID of a "Forums" channel.
- threadID: number
  ID of a forum thread.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:1553

pinMessage

pinMessage(channelID: string, messageID: string): Promise<void>
Pin a message.
Parameters
- channelID: string
  ID of the channel where the message to pin is in
- messageID: string
  ID of the message to pin
Returns Promise<void>
- Defined in lib/routes/Channels.ts:1566

restore

restore(channelID: string): Promise<void>
Restore a channel.
Parameters
- channelID: string
  ID of the channel to restore
Returns Promise<void>
- Defined in lib/routes/Channels.ts:1576

uncompleteListItem

uncompleteListItem(channelID: string, itemID: string): Promise<void>
Mark a list item as uncompleted.
Parameters
- channelID: string
  ID of a "Lists" channel.
- itemID: string
  ID of a list item.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:1586

unlockForumThread

unlockForumThread(channelID: string, threadID: number): Promise<void>
Unlock a forum thread.
Parameters
- channelID: string
  ID of a "Forums" channel.
- threadID: number
  ID of a forum thread.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:1596

unpinForumThread

unpinForumThread(channelID: string, threadID: number): Promise<void>
Unpin a forum thread.
Parameters
- channelID: string
  ID of a "Forums" channel.
- threadID: number
  ID of a forum thread.
Returns Promise<void>
- Defined in lib/routes/Channels.ts:1608

unpinMessage

unpinMessage(channelID: string, messageID: string): Promise<void>
Unpin a message.
Parameters
- channelID: string
  ID of the channel where the message to unpin is in
- messageID: string
  ID of the message to unpin
Returns Promise<void>
- Defined in lib/routes/Channels.ts:1621

Class Channels

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns Channels

Methods

archive

Parameters

Returns Promise<void>

bulkCalendarRSVPUpdate

Parameters

Returns Promise<void>

bulkDeleteReactions

Parameters

OptionalemoteId?: number

Example

Returns Promise<void>

completeListItem

Parameters

Returns Promise<void>

createAnnouncement

Parameters

content: string | Record<string, never>

Description

title: string

Description

Returns Promise<Announcement>

createAnnouncementComment

Parameters

content: string

Description

Returns Promise<AnnouncementComment>

createCalendarComment

Parameters

Returns Promise<CalendarComment>

createCalendarEvent

Parameters

OptionalendDate?: string

Description

OptionalendsAfterOccurrences?: number

Description

Optionalevery?: { count: number; interval: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoEveryInterval;}

Description

count: number

Description

interval: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoEveryInterval

Description

Optionalon?: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoOn[]

Description

type: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoType

Description

Default

Returns Promise<CalendarEvent>

createCalendarEventSeries

Returns Error

createDoc

Parameters

Returns Promise<Doc>

createDocComment

Parameters

Returns Promise<DocComment>

createForumComment

Parameters

Returns Promise<ForumThreadComment>

createForumThread

Type Parameters

Parameters

Returns Promise<ForumThread<T>>

createListItem

Parameters

content: string | Record<string, never>

Description

Returns Promise<ListItem>

createMessage

Type Parameters

Parameters

Returns Promise<Message<T>>

`Optional`emoteId?: number

`Optional`endDate?: string

`Optional`endsAfterOccurrences?: number

`Optional`every?: {
count: number;
interval: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoEveryInterval;
}

`Optional`on?: PathsChannelsChannelIdEventsPostRequestBodyApplicationJsonRepeatInfoOn[]

`Optional`content?: string | Record<string, never>

`Optional`title?: string