Discord icon

Discord

Interact with Discord API - users, messages, webhooks, guilds, interactions, and more

Actions193

Guild → Modify Channel Positions

AI-generated

Summary

Updates the positions of channels in a Discord guild by sending a raw channel-position array to Discord. Use it to reorder channels and, for entries that include them, update parent categories or permission-lock settings.

Inputs

  • Guild (required) — The Discord guild ID whose channels to modify.
  • Positions (required) — A JSON array of channel entries. Each entry has an id and may include position, lock_permissions, or parent_id to specify the channel position, permission-lock behavior, or parent category.
  • Audit Log Reason — Optional reason recorded in the guild audit log; Discord limits it to 512 characters.
  • Authentication — Choose Bot Token (default) or OAuth2 (User Token), using the corresponding Discord credential.
  • Request Options — Optional request settings, including batching, proxy, timeout, and whether to accept invalid SSL certificates.

Output shape

A single Discord REST response for the channel position modification.

The Positions field is passed as raw JSON. The operation-scoped properties and source pack provided do not expose a more specific response schema.

Links

Discussion