move_channel

Move a channel to a different position or category. This is a access-sensitive action requiring the destructive tier that follows the requester action tier and approval mode. Can be used to reorder channels or move them into/out of categories.

User guide / All capabilities

Contract

Effect: destructive. Evidence role: discovery_only.

Move a channel to a different position or category. Access-sensitive change; follows the requester action tier and approval mode.

Parameters

This is the current provider-facing JSON Schema, generated from the runtime definition.

{
  "type": "object",
  "properties": {
    "channel_id": {
      "type": "string",
      "description": "The channel ID to move."
    },
    "category_id": {
      "type": "string",
      "description": "Target category ID to move the channel into. Use null or omit to remove from category."
    },
    "position": {
      "type": "number",
      "description": "New position index within the category or guild. 0 = top."
    },
    "lock_permissions": {
      "type": "boolean",
      "description": "Whether to sync permissions with the new category. Default: true."
    }
  },
  "required": [
    "channel_id"
  ]
}

Execution requirements

• actor_grant
• guild context should exist

Expected postconditions

• moves the channel to the specified position/category