Edit scheduled event
discord_
Write
- Toolset
- Scheduled events
scheduled_events - Discord permission
- Manage Events
- Context cost
- 651 tokens, estimated2,603 bytes of definition, divided by 4
Update a scheduled event; only provided fields change. Use the status field to start ('ACTIVE'), end ('COMPLETED'), or cancel ('CANCELED') an event; Discord only allows certain status transitions. Discord rejects a location on VOICE and STAGE_INSTANCE events. An ACTIVE voice or stage event ends on its own a few minutes after its channel empties. Requires the Manage Events permission, or Create Events for an event the bot created, plus the same channel permissions as creating it.
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). |
| event_ | string | pattern ^\d{17,20}$ | ID (snowflake) of the event to edit. |
| nameoptional | string | none | New event name (max 100 characters). |
| descriptionoptional | string | none | New event description (max 1000 characters). |
| scheduled_ | string | format date-timepattern (288 characters)^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ | New start time as an ISO 8601 datetime. |
| scheduled_ | string | format date-timepattern (288 characters)^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ | New end time as an ISO 8601 datetime. |
| channel_ | string | pattern ^\d{17,20}$ | New voice/stage channel ID (snowflake) for VOICE/STAGE_INSTANCE events. |
| locationoptional | string | none | New free-text location for EXTERNAL events. |
| imageoptional | string | format uripattern ^https?:// | New cover image URL. |
| statusoptional | string | one of "ACTIVE""COMPLETED""CANCELED" | Change event status. Allowed transitions only: SCHEDULED→ACTIVE→COMPLETED, or SCHEDULED→CANCELED (no transition back to SCHEDULED exists). |
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 Scheduled events
-
List scheduled events, Read-only
discord_list_ scheduled_ events -
Get scheduled event, Read-only
discord_get_ scheduled_ event -
Create scheduled event, Write
discord_create_ scheduled_ event -
Delete scheduled event, Destructive
discord_delete_ scheduled_ event -
Get event subscribers, Read-only
discord_get_ event_ subscribers -
Create event invite, Write
discord_create_ event_ invite
Raw definition (2,603 bytes)
{
"name": "discord_edit_scheduled_event",
"description": "Update a scheduled event; only provided fields change. Use the status field to start ('ACTIVE'), end ('COMPLETED'), or cancel ('CANCELED') an event; Discord only allows certain status transitions. Discord rejects a location on VOICE and STAGE_INSTANCE events. An ACTIVE voice or stage event ends on its own a few minutes after its channel empties. Requires the Manage Events permission, or Create Events for an event the bot created, plus the same channel permissions as creating it.",
"inputSchema": {
"type": "object",
"properties": {
"guild_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "Discord server (guild) ID (snowflake)."
},
"event_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "ID (snowflake) of the event to edit."
},
"name": {
"description": "New event name (max 100 characters).",
"type": "string"
},
"description": {
"description": "New event description (max 1000 characters).",
"type": "string"
},
"scheduled_start_time": {
"description": "New start time as an ISO 8601 datetime.",
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"scheduled_end_time": {
"description": "New end time as an ISO 8601 datetime.",
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"channel_id": {
"description": "New voice/stage channel ID (snowflake) for VOICE/STAGE_INSTANCE events.",
"type": "string",
"pattern": "^\\d{17,20}$"
},
"location": {
"description": "New free-text location for EXTERNAL events.",
"type": "string"
},
"image": {
"description": "New cover image URL.",
"type": "string",
"format": "uri",
"pattern": "^https?://"
},
"status": {
"description": "Change event status. Allowed transitions only: SCHEDULED→ACTIVE→COMPLETED, or SCHEDULED→CANCELED (no transition back to SCHEDULED exists).",
"type": "string",
"enum": [
"ACTIVE",
"COMPLETED",
"CANCELED"
]
}
},
"required": [
"guild_id",
"event_id"
],
"additionalProperties": false
},
"annotations": {
"title": "Edit scheduled event",
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true
}
}