From 5b82aa564c40c0fdc035c01b3c54f3469dd11ac8 Mon Sep 17 00:00:00 2001
From: Copilot <198982749+Copilot@users.noreply.github.com>
Date: Wed, 10 Dec 2025 00:31:15 +0200
Subject: [PATCH] docs(APIAttachment): clarify title field distinction from
 filename (#1450)

Co-authored-by: Jiralite <33201955+Jiralite@users.noreply.github.com>
Co-authored-by: almeidx <42935195+almeidx@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
---
 deno/payloads/v10/message.ts | 5 ++++-
 deno/payloads/v9/message.ts  | 5 ++++-
 payloads/v10/message.ts      | 5 ++++-
 payloads/v9/message.ts       | 5 ++++-
 4 files changed, 16 insertions(+), 4 deletions(-)

diff --git a/deno/payloads/v10/message.ts b/deno/payloads/v10/message.ts
index 6616c62c..d8f472d1 100644
--- a/deno/payloads/v10/message.ts
+++ b/deno/payloads/v10/message.ts
@@ -810,7 +810,10 @@ export interface APIAttachment {
 	 */
 	filename: string;
 	/**
-	 * The title of the file
+	 * The original filename of the upload with special characters preserved
+	 *
+	 * This will be present when the filename contains special characters (e.g. Cyrillic),
+	 * in which case the `filename` field will be a sanitized version without those characters
 	 */
 	title?: string;
 	/**
diff --git a/deno/payloads/v9/message.ts b/deno/payloads/v9/message.ts
index 2d4c42d6..3c525782 100644
--- a/deno/payloads/v9/message.ts
+++ b/deno/payloads/v9/message.ts
@@ -805,7 +805,10 @@ export interface APIAttachment {
 	 */
 	filename: string;
 	/**
-	 * The title of the file
+	 * The original filename of the upload with special characters preserved
+	 *
+	 * This will be present when the filename contains special characters (e.g. Cyrillic),
+	 * in which case the `filename` field will be a sanitized version without those characters
 	 */
 	title?: string;
 	/**
diff --git a/payloads/v10/message.ts b/payloads/v10/message.ts
index 3e012630..b44c8045 100644
--- a/payloads/v10/message.ts
+++ b/payloads/v10/message.ts
@@ -810,7 +810,10 @@ export interface APIAttachment {
 	 */
 	filename: string;
 	/**
-	 * The title of the file
+	 * The original filename of the upload with special characters preserved
+	 *
+	 * This will be present when the filename contains special characters (e.g. Cyrillic),
+	 * in which case the `filename` field will be a sanitized version without those characters
 	 */
 	title?: string;
 	/**
diff --git a/payloads/v9/message.ts b/payloads/v9/message.ts
index d507ea02..7729ff99 100644
--- a/payloads/v9/message.ts
+++ b/payloads/v9/message.ts
@@ -805,7 +805,10 @@ export interface APIAttachment {
 	 */
 	filename: string;
 	/**
-	 * The title of the file
+	 * The original filename of the upload with special characters preserved
+	 *
+	 * This will be present when the filename contains special characters (e.g. Cyrillic),
+	 * in which case the `filename` field will be a sanitized version without those characters
 	 */
 	title?: string;
 	/**