Discord icon

Discord

Interact with Discord API - Full Bot Features
Join our community

Actions53

Overview

This node operation allows moving a member from one voice channel to another within a Discord server (guild). It is useful for managing voice channel memberships dynamically, such as relocating users during events, organizing meetings, or moderating voice channels. For example, an admin can automatically move a user to a different voice channel based on certain triggers or commands.

Use Case Examples

  1. Move a user to a different voice channel to organize participants during a live event.
  2. Automatically relocate a user to a specific voice channel when they join the server.

Properties

Name Meaning
Guild ID The ID of the Discord server (guild) where the voice channel and member exist.
User ID The ID of the user (member) to be moved between voice channels.
Target Channel ID The ID of the voice channel to which the member will be moved.
Additional Fields Optional additional parameters such as embed JSON, text-to-speech flag, reason for audit logs, and other miscellaneous settings.

Output

JSON

  • success - Indicates if the move operation was successful.
  • userId - The ID of the user who was moved.
  • movedTo - The ID of the voice channel to which the user was moved.

Dependencies

  • Discord API with a bot token credential

Troubleshooting

  • Ensure the user is currently connected to a voice channel before attempting to move them; otherwise, an error will be thrown.
  • Verify that the bot has the necessary permissions to move members between voice channels in the guild.
  • Check that the target channel ID corresponds to a valid voice channel within the guild.
  • Common error: 'Member is not in a voice channel' occurs if the user is not connected to any voice channel when the move is attempted. To resolve, confirm the user's voice channel status before moving.

Links

Discussion