Create thread
discord_
Write
- Toolset
- Messages
messages - Discord permission
- Create Public Threads
- Context cost
- 321 tokens, estimated1,285 bytes of definition, divided by 4
Create a thread, either branching from an existing message (pass message_id) or as a standalone thread in a text channel (omit message_id). Standalone creation requires a parent text channel and fails if channel_id is itself a thread. Requires the Create Public Threads permission, plus Read Message History when message_id is set. Returns the new thread's ID.
Risk and annotations
Read-onlyreadOnlyHint | no | Can modify your server. |
|---|---|---|
DestructivedestructiveHint | no | Declared non-destructive. |
IdempotentidempotentHint | no | Repeating the call can have an additional effect. |
Open worldopenWorldHint | yes | Interacts with an external system: Discord. |
Annotations are hints the server declares. Clients use them to decide when to ask you before a call.
Parameters
| Parameter | Type | Rules | Description |
|---|---|---|---|
| channel_ | string | pattern ^\d{17,20}$ | ID (snowflake) of the parent text channel. For a message-based thread, the channel containing message_id. |
| namerequired | string | none | Name of the thread to create (max 100 characters). |
| message_ | string | pattern ^\d{17,20}$ | Optional. Message to branch the thread from. If omitted, a standalone thread is created in the channel. |
| auto_ | number | one of 601440432010080default 1440 | Minutes of inactivity before auto-archiving: 60, 1440, 4320, or 10080. Default 1440 (24h). |
Output
This tool declares no output schema. Its description says what it returns; this page shows no example rather than invent one.
Related tools
Also in Messages
-
Read messages, Read-only
discord_read_ messages -
Send message, Write
discord_send_ message -
Reply to message, Write
discord_reply_ message -
Edit message, Write
discord_edit_ message -
Add reaction, Write
discord_add_ reaction -
List channel threads, Read-only
discord_list_ channel_ threads -
Bulk delete messages, Destructive
discord_bulk_ delete_ messages -
Send embed, Write
discord_send_ embed -
Edit embed, Write
discord_edit_ embed -
Send multiple embeds, Write
discord_send_ multiple_ embeds -
Delete message, Destructive
discord_delete_ message -
Pin or unpin message, Write
discord_pin_ message -
Search messages, Read-only
discord_search_ messages -
Search guild messages, Read-only
discord_search_ guild_ messages -
Crosspost message, Write
discord_crosspost_ message -
Remove reactions, Destructive
discord_remove_ reactions -
Get reactions, Read-only
discord_get_ reactions -
Get message attachments, Read-only
discord_get_ message_ attachments -
Fetch pinned messages, Read-only
discord_fetch_ pinned_ messages -
Forward message, Write
discord_forward_ message
Raw definition (1,285 bytes)
{
"name": "discord_create_thread",
"description": "Create a thread, either branching from an existing message (pass message_id) or as a standalone thread in a text channel (omit message_id). Standalone creation requires a parent text channel and fails if channel_id is itself a thread. Requires the Create Public Threads permission, plus Read Message History when message_id is set. Returns the new thread's ID.",
"inputSchema": {
"type": "object",
"properties": {
"channel_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "ID (snowflake) of the parent text channel. For a message-based thread, the channel containing message_id."
},
"name": {
"type": "string",
"description": "Name of the thread to create (max 100 characters)."
},
"message_id": {
"description": "Optional. Message to branch the thread from. If omitted, a standalone thread is created in the channel.",
"type": "string",
"pattern": "^\\d{17,20}$"
},
"auto_archive_duration": {
"default": 1440,
"description": "Minutes of inactivity before auto-archiving: 60, 1440, 4320, or 10080. Default 1440 (24h).",
"type": "number",
"enum": [
60,
1440,
4320,
10080
]
}
},
"required": [
"channel_id",
"name"
],
"additionalProperties": false
},
"annotations": {
"title": "Create thread",
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": true
}
}