Soundboard

Send Sound

PostAPISendSoundboardSound

Send a soundboard sound to a voice channel the user is connected to.

import { sendSound } from "dressed";
await sendSound(channelId, data);
Info

Requires the SPEAK and USE_SOUNDBOARD permissions, and also the USE_EXTERNAL_SOUNDS permission if the sound is from a different server. Additionally, requires the user to be connected to the voice channel, having a voice state without deaf, self_deaf, mute, or suppress enabled.

List Sounds

GetAPISoundboardDefaultSounds

Returns an array of soundboard sound objects that can be used by all users.

  • @param guildId Returns a list of the guild's soundboard sounds.
import { listSounds } from "dressed";
const sounds = await listSounds(guildId);
Info

Includes user fields if the bot has the CREATE_GUILD_EXPRESSIONS or MANAGE_GUILD_EXPRESSIONS permission.

Get Sound

GetAPIGuildSoundboardSound

Returns a soundboard sound object for the given sound id.

import { getSound } from "dressed";
const sound = await getSound(guildId, soundId);
Info

Includes the user field if the bot has the CREATE_GUILD_EXPRESSIONS or MANAGE_GUILD_EXPRESSIONS permission.

Create Sound

PostAPIGuildSoundboardSound

Create a new soundboard sound for the guild.

import { createSound } from "dressed";
await createSound(guildId, data);
Info
  • Requires the CREATE_GUILD_EXPRESSIONS permission.
  • Soundboard sounds have a max file size of 512kb and a max duration of 5.2 seconds.

Modify Sound

PatchAPIGuildSoundboardSound

Modify the given soundboard sound.

import { modifySound } from "dressed";
await modifySound(guildId, soundId, data);
Info
  • For sounds created by the current user, requires either the CREATE_GUILD_EXPRESSIONS or MANAGE_GUILD_EXPRESSIONS permission.
  • For other sounds, requires the MANAGE_GUILD_EXPRESSIONS permission.

Delete Sound

DeleteAPIGuildSoundboardSound

Delete the given soundboard sound.

import { deleteSound } from "dressed";
await deleteSound(guildId, soundId);
Info
  • For sounds created by the current user, requires either the CREATE_GUILD_EXPRESSIONS or MANAGE_GUILD_EXPRESSIONS permission.
  • For other sounds, requires the MANAGE_GUILD_EXPRESSIONS permission.