move_category

Move a category to a different position in the guild channel list. This is a WRITE action that follows the requester action tier and approval mode. Use to reorder categories.

User guide / All capabilities

Contract

Effect: write. Evidence role: discovery_only.

Move a category to a different position in the guild. Write — 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": {
    "category_id": {
      "type": "string",
      "description": "The category ID to move."
    },
    "position": {
      "type": "number",
      "description": "New position index among categories in the guild. 0 = top."
    }
  },
  "required": [
    "category_id",
    "position"
  ]
}

Execution requirements

• actor_grant
• guild context should exist

Expected postconditions

• moves the category to the specified position in the guild