create_channel

Create a new channel in the guild. This is a WRITE action that follows the requester action tier and approval mode before execution. Use only when explicitly asked to create a channel. Important: topic is channel metadata, not the content to post. If the user asks to post text in the new channel, create the channel first, then call send_message with that text.

User guide / All capabilities

Contract

Effect: write. Evidence role: discovery_only.

Create a new channel in the guild. Write action — follows the requester action tier and approval mode. topic is metadata only; use send_message to post actual content.

Parameters

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

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The name for the new channel."
    },
    "type": {
      "type": "string",
      "enum": [
        "text",
        "voice"
      ],
      "description": "Channel type. Default: text."
    },
    "category_id": {
      "type": "string",
      "description": "Optional: parent category ID to place the channel under."
    },
    "topic": {
      "type": "string",
      "description": "Optional: short channel topic/description metadata (NOT the message body to post in the channel)."
    }
  },
  "required": [
    "name"
  ]
}

Execution requirements

• actor_grant
• guild context should exist

Expected postconditions

• creates a new channel in the guild