messages_create_thread
messages_create_thread
Section titled “messages_create_thread”Category: messages
Start a public thread anchored to an existing message.
When to use
Section titled “When to use”- Spin up discussion off of an announcement or proposal.
When NOT to use
Section titled “When NOT to use”- Forum channels — use
channels_forum_create_thread(Phase B). - Standalone (un-anchored) thread — use a non-message thread tool once available.
| Field | Type | Required | Description |
|---|---|---|---|
channel_id | string | yes | Parent channel containing the anchor message |
message_id | string | yes | Message to anchor the thread to |
name | string | yes | Thread name (1-100 chars) |
auto_archive_duration | unknown | no | Auto-archive after N minutes (60, 1440, 4320, or 10080) |
rate_limit_per_user | integer | no | Slowmode in seconds (0-21600) |
audit_reason | string | no | Reason recorded in audit log (X-Audit-Log-Reason header) |
Returns
Section titled “Returns”\{thread_id, name, parent_id\}.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
thread_id | string | yes | Discord channel ID (snowflake) |
name | string | yes | |
parent_id | unknown | yes |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | no |
| Destructive | no |
| Idempotent | no |
| Open-world | yes |
| Confirmation required | no |