components_v2_send
components_v2_send
Section titled “components_v2_send”Category: components_v2
Send a Components V2 message — rich layout (Container, Section, MediaGallery, ActionRow, …). MUTUALLY EXCLUSIVE with content/embed/poll/sticker. Flag IS_COMPONENTS_V2 is irreversible per-message.
When to use
Section titled “When to use”announcements, release notes, dashboards, polls — anything beyond plain text.
When NOT to use
Section titled “When NOT to use”simple text reply → use messages_send.
| Field | Type | Required | Description |
|---|---|---|---|
channel_id | string | yes | Target channel |
components | array | yes | Components V2 array (1-40 items, recursive) |
allowed_mentions | object | no |
Returns
Section titled “Returns”\{message_id, channel_id, jump_url, component_count\}.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
message_id | string | yes | Discord message ID |
channel_id | string | yes | Discord channel ID (snowflake) |
jump_url | string | yes | |
component_count | integer | yes |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | no |
| Destructive | no |
| Idempotent | no |
| Open-world | yes |
| Confirmation required | no |