From a0dcf8a8f40d50fa95207cd8cf76c96612fcf321 Mon Sep 17 00:00:00 2001 From: ManHat Date: Wed, 10 Sep 2025 16:49:54 +0300 Subject: [PATCH 1/4] Message forwards do not require other fields --- docs/resources/message.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/resources/message.mdx b/docs/resources/message.mdx index 2c035e262f..eab5e1f226 100644 --- a/docs/resources/message.mdx +++ b/docs/resources/message.mdx @@ -821,7 +821,7 @@ Files must be attached using a `multipart/form-data` body as described in [Uploa ###### JSON/Form Params :::info -When creating a message, apps must provide a value for **at least one of** `content`, `embeds`, `sticker_ids`, `components`, `files[n]`, or `poll`. +When creating a message, apps must provide a value for **at least one of** `content`, `embeds`, `sticker_ids`, `components`, `files[n]`, `message_reference` or `poll`. ::: | Field | Type | Description | From bd010a646aad53da8dd317bee6762b160629eedf Mon Sep 17 00:00:00 2001 From: ManHat Date: Sat, 13 Sep 2025 19:46:28 +0300 Subject: [PATCH 2/4] clarify wording --- docs/resources/message.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/resources/message.mdx b/docs/resources/message.mdx index eab5e1f226..56a57ed3f0 100644 --- a/docs/resources/message.mdx +++ b/docs/resources/message.mdx @@ -821,7 +821,7 @@ Files must be attached using a `multipart/form-data` body as described in [Uploa ###### JSON/Form Params :::info -When creating a message, apps must provide a value for **at least one of** `content`, `embeds`, `sticker_ids`, `components`, `files[n]`, `message_reference` or `poll`. +When creating a message, apps must provide a value for **at least one of** `content`, `embeds`, `sticker_ids`, `components`, `files[n]`, `poll`, or `message_reference` (only when type is [`FORWARD`](/docs/resources/message#message-reference-types)). ::: | Field | Type | Description | From 828314d4f0dcc5914b2245487c1bc0936bcef47d Mon Sep 17 00:00:00 2001 From: ManHat Date: Sat, 13 Sep 2025 19:48:56 +0300 Subject: [PATCH 3/4] Update message.mdx --- docs/resources/message.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/resources/message.mdx b/docs/resources/message.mdx index 56a57ed3f0..d1864ae886 100644 --- a/docs/resources/message.mdx +++ b/docs/resources/message.mdx @@ -821,7 +821,7 @@ Files must be attached using a `multipart/form-data` body as described in [Uploa ###### JSON/Form Params :::info -When creating a message, apps must provide a value for **at least one of** `content`, `embeds`, `sticker_ids`, `components`, `files[n]`, `poll`, or `message_reference` (only when type is [`FORWARD`](/docs/resources/message#message-reference-types)). +When creating a message, apps must provide a value for **at least one of** `content`, `embeds`, `sticker_ids`, `components`, `files[n]`, `poll`, or `message_reference` (only when reference type is [`FORWARD`](/docs/resources/message#message-reference-types)). ::: | Field | Type | Description | From 093e4424fec3b660e356d3b6568d9c725c8bd5ae Mon Sep 17 00:00:00 2001 From: ManHatos Date: Sat, 13 Sep 2025 20:06:57 +0300 Subject: [PATCH 4/4] remove duplicate note, reword --- docs/resources/message.mdx | 40 +++++++++++++++++--------------------- 1 file changed, 18 insertions(+), 22 deletions(-) diff --git a/docs/resources/message.mdx b/docs/resources/message.mdx index d1864ae886..843d1a1371 100644 --- a/docs/resources/message.mdx +++ b/docs/resources/message.mdx @@ -820,28 +820,24 @@ Files must be attached using a `multipart/form-data` body as described in [Uploa ###### JSON/Form Params -:::info -When creating a message, apps must provide a value for **at least one of** `content`, `embeds`, `sticker_ids`, `components`, `files[n]`, `poll`, or `message_reference` (only when reference type is [`FORWARD`](/docs/resources/message#message-reference-types)). -::: - -| Field | Type | Description | -|--------------------|-----------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| content?\* | string | Message contents (up to 2000 characters) | -| nonce? | integer or string | Can be used to verify a message was sent (up to 25 characters). Value will appear in the [Message Create event](/docs/events/gateway-events#message-create). | -| tts? | boolean | `true` if this is a TTS message | -| embeds?\* | array of [embed](/docs/resources/message#embed-object) objects | Up to 10 `rich` embeds (up to 6000 characters) | -| allowed_mentions? | [allowed mention object](/docs/resources/message#allowed-mentions-object) | Allowed mentions for the message | -| message_reference? | [message reference](/docs/resources/message#message-reference-structure) | Include to make your message a reply or a forward | -| components?\* | array of [message component](/docs/components/reference#component-object) objects | Components to include with the message | -| sticker_ids?\* | array of snowflakes | IDs of up to 3 [stickers](/docs/resources/sticker#sticker-object) in the server to send in the message | -| files[n]?\* | file contents | Contents of the file being sent. See [Uploading Files](/docs/reference#uploading-files) | -| payload_json? | string | JSON-encoded body of non-file params, only for `multipart/form-data` requests. See [Uploading Files](/docs/reference#uploading-files) | -| attachments? | array of partial [attachment](/docs/resources/message#attachment-object) objects | Attachment objects with filename and description. See [Uploading Files](/docs/reference#uploading-files) | -| flags?\*\* | integer | [Message flags](/docs/resources/message#message-object-message-flags) combined as a [bitfield](https://en.wikipedia.org/wiki/Bit_field) (only `SUPPRESS_EMBEDS`, `SUPPRESS_NOTIFICATIONS`, `IS_VOICE_MESSAGE`, and `IS_COMPONENTS_V2` can be set) | -| enforce_nonce? | boolean | If true and nonce is present, it will be checked for uniqueness in the past few minutes. If another message was created by the same author with the same nonce, that message will be returned and no new message will be created. | -| poll? | [poll](/docs/resources/poll#poll-create-request-object) request object | A poll! | - -\* At least one of `content`, `embeds`, `sticker_ids`, `components`, `files[n]`, or `poll` is required. +| Field | Type | Description | +|----------------------|-----------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| content?\* | string | Message contents (up to 2000 characters) | +| nonce? | integer or string | Can be used to verify a message was sent (up to 25 characters). Value will appear in the [Message Create event](/docs/events/gateway-events#message-create). | +| tts? | boolean | `true` if this is a TTS message | +| embeds?\* | array of [embed](/docs/resources/message#embed-object) objects | Up to 10 `rich` embeds (up to 6000 characters) | +| allowed_mentions? | [allowed mention object](/docs/resources/message#allowed-mentions-object) | Allowed mentions for the message | +| message_reference?\* | [message reference](/docs/resources/message#message-reference-structure) | Include to make your message a reply or a forward | +| components?\* | array of [message component](/docs/components/reference#component-object) objects | Components to include with the message | +| sticker_ids?\* | array of snowflakes | IDs of up to 3 [stickers](/docs/resources/sticker#sticker-object) in the server to send in the message | +| files[n]?\* | file contents | Contents of the file being sent. See [Uploading Files](/docs/reference#uploading-files) | +| payload_json? | string | JSON-encoded body of non-file params, only for `multipart/form-data` requests. See [Uploading Files](/docs/reference#uploading-files) | +| attachments? | array of partial [attachment](/docs/resources/message#attachment-object) objects | Attachment objects with filename and description. See [Uploading Files](/docs/reference#uploading-files) | +| flags?\*\* | integer | [Message flags](/docs/resources/message#message-object-message-flags) combined as a [bitfield](https://en.wikipedia.org/wiki/Bit_field) (only `SUPPRESS_EMBEDS`, `SUPPRESS_NOTIFICATIONS`, `IS_VOICE_MESSAGE`, and `IS_COMPONENTS_V2` can be set) | +| enforce_nonce? | boolean | If true and nonce is present, it will be checked for uniqueness in the past few minutes. If another message was created by the same author with the same nonce, that message will be returned and no new message will be created. | +| poll? | [poll](/docs/resources/poll#poll-create-request-object) request object | A poll! | + +\* At least one of `content`, `embeds`, `sticker_ids`, `components`, `files[n]`, or `poll` is required. When forwarding a message, only `message_reference` is required. \*\* When the flag `IS_COMPONENTS_V2` is set, the message can only contain `components`. Providing `content`, `embeds`, `sticker_ids`, `files[n]`, or `poll` will fail with a 400 BAD REQUEST response.