| name | discord |
| description | Discord API interactions, message components, slash commands, modals, webhooks, and embeds. Use when building Discord bots, creating slash commands (application commands), adding interactive components (buttons, select menus, text inputs), implementing modal forms, sending webhook messages, constructing rich embeds, handling interaction responses (defer, reply, followup, edit), registering global/guild commands, configuring command permissions, or working with discord.py (Python) and discord.js (TypeScript/JavaScript) libraries. |
Discord API Interactions
Build Discord bots with interactive components, slash commands, modals, and webhooks.
When to Use
Activate when working with:
- Slash commands (application commands) — registration, options, permissions
- Message components — buttons, select menus, action rows
- Modal dialogs — text inputs, form collection, file uploads
- Interaction responses — reply, defer, followup, edit, ephemeral
- Webhooks — sending messages, embeds, managing webhook messages
- Rich embeds — structured message formatting
- discord.py or discord.js library code
Discord API References
Core API concepts and object structures from the official Discord developer docs.
| Reference | Content |
|---|
| Components | All component types (buttons, selects, text inputs, V2 layout), fields, constraints |
| Interactions | Interaction object, types, callback types, response endpoints, security |
| Slash Commands | Command types, option types, registration, permissions, subcommands, autocomplete |
| Modals | Modal structure, text inputs, selects, file uploads, submission handling |
| Webhooks | Webhook types, execution, message CRUD, Slack/GitHub compatibility |
| Embeds | Embed structure, field limits, allowed mentions, message flags |
Framework References
Library-specific patterns for the two most popular Discord bot frameworks.
discord.py (Python)
| Reference | Content |
|---|
| Components | Views, Buttons, Selects, Modals, TextInput, interaction callbacks |
| Commands | app_commands, hybrid commands, tree.sync, groups, error handling |
| Webhooks | Webhook class, sending embeds/files, editing/deleting messages |
discord.js (TypeScript/JavaScript)
| Reference | Content |
|---|
| Components | ButtonBuilder, SelectMenuBuilders, ModalBuilder, TextInputBuilder, LabelBuilder |
| Commands | SlashCommandBuilder, response methods, options, subcommands, registering |
| Webhooks & Embeds | WebhookClient, EmbedBuilder, sending/editing/deleting webhook messages |
Quick Patterns
Interaction Response Flow
User action → Interaction received → Must respond within 3s
├── reply() → Immediate message
├── deferReply() → "Thinking..." then editReply() within 15m
├── showModal() → Open modal form (must be first response)
├── update() → Edit originating message (components only)
└── deferUpdate() → Ack without visible change (components only)
Component Limits
- 40 components max per message
- Action Row: 5 buttons OR 1 select menu
- Select menu: 25 options max, 0-25 selectable
- custom_id: 1-100 characters, unique per component
- Interaction token valid 15 minutes
Embed Limits
- Title: 256 chars | Description: 4096 chars
- Fields: 25 max (name 256, value 1024)
- Footer: 2048 chars | Author name: 256 chars
- Total across all embeds: 6000 chars | Max 10 embeds/message
