create_thread

Create a new thread in a channel. This is a WRITE action that follows the requester action tier and approval mode. Use only when explicitly asked to create a thread.

User guide / All capabilities

Contract

Effect: write. Evidence role: discovery_only.

Create a new thread in a channel. 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": {
    "channel_id": {
      "type": "string",
      "description": "The parent channel ID to create the thread in."
    },
    "name": {
      "type": "string",
      "description": "The name for the new thread."
    },
    "message": {
      "type": "string",
      "description": "Optional initial message to post in the thread."
    },
    "auto_archive_duration": {
      "type": "number",
      "description": "Auto-archive duration in minutes. Must be one of: 60 (1h), 1440 (1d), 4320 (3d), 10080 (7d). Default: 1440."
    }
  },
  "required": [
    "channel_id",
    "name"
  ]
}

Execution requirements

• actor_grant
• guild context should exist
• channel must support threads

Expected postconditions

• creates a new thread in the channel