Timeout member
discord_
Write
- Toolset
- Members
members - Discord permission
- Moderate Members
- Context cost
- 284 tokens, estimated1,134 bytes of definition, divided by 4
Mute a member for a set duration (Discord 'timeout'): they cannot send messages, react, or speak until it expires. Pass duration_minutes = 0 to remove an active timeout early. Max 28 days (40320 minutes). Requires the Moderate Members permission. Discord refuses to time out the server owner or a member with Administrator.
Risk and annotations
Read-onlyreadOnlyHint | no | Can modify your server. |
|---|---|---|
DestructivedestructiveHint | no | Declared non-destructive. |
IdempotentidempotentHint | yes | Repeating the call with the same arguments has no 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 |
|---|---|---|---|
| guild_ | string | pattern ^\d{17,20}$ | Discord server (guild) ID (snowflake). |
| user_ | string | pattern ^\d{17,20}$ | Discord user ID (snowflake) of the member to time out. |
| duration_ | integer | 0 to 40320 | Timeout length in minutes (0–40320, i.e. up to 28 days). Use 0 to clear an existing timeout. |
| reasonoptional | string | none | Optional reason recorded in the server audit log. |
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 Members
-
List members, Read-only
discord_list_ members -
Get member info, Read-only
discord_get_ member_ info -
Kick member, Destructive
discord_kick_ member -
Ban member, Destructive
discord_ban_ member -
Unban member, Write
discord_unban_ member -
Search members, Read-only
discord_search_ members -
Set nickname, Write
discord_set_ nickname -
List bans, Read-only
discord_list_ bans -
Bulk ban, Destructive
discord_bulk_ ban -
Prune inactive members, Destructive
discord_prune_ members
Raw definition (1,134 bytes)
{
"name": "discord_timeout_member",
"description": "Mute a member for a set duration (Discord 'timeout'): they cannot send messages, react, or speak until it expires. Pass duration_minutes = 0 to remove an active timeout early. Max 28 days (40320 minutes). Requires the Moderate Members permission. Discord refuses to time out the server owner or a member with Administrator.",
"inputSchema": {
"type": "object",
"properties": {
"guild_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "Discord server (guild) ID (snowflake)."
},
"user_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "Discord user ID (snowflake) of the member to time out."
},
"duration_minutes": {
"type": "integer",
"minimum": 0,
"maximum": 40320,
"description": "Timeout length in minutes (0–40320, i.e. up to 28 days). Use 0 to clear an existing timeout."
},
"reason": {
"description": "Optional reason recorded in the server audit log.",
"type": "string"
}
},
"required": [
"guild_id",
"user_id",
"duration_minutes"
],
"additionalProperties": false
},
"annotations": {
"title": "Timeout member",
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true
}
}