From 104dac6243a7adfcdde39bcbb3301d1e8364d644 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 21 Jul 2026 23:14:58 +0000
Subject: [PATCH 1/2] docs: add changelog entries for X Chat launch and Chat
XDK v0.4.0
---
changelog.mdx | 26 ++++++++++++++++++++++++++
1 file changed, 26 insertions(+)
diff --git a/changelog.mdx b/changelog.mdx
index 73a152811..b6cfbba2f 100644
--- a/changelog.mdx
+++ b/changelog.mdx
@@ -15,6 +15,32 @@ To subscribe to updates, please [**“Turn on notifications”**](https://help.x
These are private events: they require user-context (OAuth 2.0) authentication with the `mute.read` or `block.read` scope, respectively, and the `user_id` filter matches the user performing the action.
+
+ ### Chat XDK v0.4.0
+
+ Today, we shipped **Chat XDK v0.4.0**, updating the encryption SDK's API surface across Python, TypeScript, Rust, Go, C#, and Java:
+
+ - Unified `prepare_*` helpers for conversation key changes, group creation, and member changes — each returns the fresh key material plus the required action signatures in one call.
+ - Action signatures are now required and validated at the API boundary. Group endpoints return stable, human-readable error messages.
+ - Public-key responses use the `public_key_version` field, and conversation-id form is flexible (colon, hyphen, or bare recipient id all sign identically).
+ - Incremental streaming API for large media, `keyVersion`-per-event media key selection, and fail-closed verification by default.
+
+ See the updated [Chat XDK reference](/xchat/xchat-xdk) and [Getting Started](/xchat/getting-started).
+
+
+
+ ### X Chat API and Chat XDK now public
+
+ Today, we published documentation for the **[X Chat API](/xchat/introduction)** — end-to-end encrypted, signed direct messages on X. Message bodies are encrypted on the client and X routes only ciphertext; recipients verify each sender by signature.
+
+ Alongside the API, we shipped the **[Chat XDK](/xchat/xchat-xdk)**, an encryption SDK covering key management, encryption, decryption, and signing across **Python, TypeScript, Rust, Go, C#, and Java**. Pair it with the [Python](/xdks/python/overview) or [TypeScript](/xdks/typescript/overview) XDK (or plain HTTPS) to build encrypted messaging into your app.
+
+ New guides:
+ - [Getting Started](/xchat/getting-started) — end-to-end app walkthrough
+ - [Cryptography primer](/xchat/cryptography-primer) — how keys, signatures, and encrypted state changes work
+ - [Groups](/xchat/groups), [Media](/xchat/media), [Real-time events](/xchat/real-time-events), [Troubleshooting](/xchat/troubleshooting)
+
+
### Articles draft and publish endpoints
From 518a9876bbd88b77e3d35b73a906fb90d0a04cc6 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 21 Jul 2026 23:19:03 +0000
Subject: [PATCH 2/2] docs: translate changelog entries for X Chat launch and
Chat XDK v0.4.0 (es/ja/ko/pt)
---
es/changelog.mdx | 26 ++++++++++++++++++++++++++
ja/changelog.mdx | 26 ++++++++++++++++++++++++++
ko/changelog.mdx | 26 ++++++++++++++++++++++++++
pt/changelog.mdx | 26 ++++++++++++++++++++++++++
4 files changed, 104 insertions(+)
diff --git a/es/changelog.mdx b/es/changelog.mdx
index f8078cb12..42a5136c0 100644
--- a/es/changelog.mdx
+++ b/es/changelog.mdx
@@ -7,6 +7,32 @@ keywords: ["registro de cambios", "actualizaciones de la API", "notas de la vers
Para suscribirte a las actualizaciones, [**"Activa las notificaciones"**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) para [**@API**](https://x.com/api). También puedes seguir este registro de cambios en tu lector de feeds mediante el [**feed RSS**](https://docs.x.com/changelog/rss.xml).
+
+ ### Chat XDK v0.4.0
+
+ Hoy lanzamos **Chat XDK v0.4.0**, actualizando la superficie de la API del SDK de cifrado en Python, TypeScript, Rust, Go, C# y Java:
+
+ - Helpers unificados `prepare_*` para cambios de clave de conversación, creación de grupos y cambios de miembros: cada uno devuelve el nuevo material de clave junto con las firmas de acción requeridas en una sola llamada.
+ - Las firmas de acción ahora son obligatorias y se validan en el límite de la API. Los endpoints de grupos devuelven mensajes de error estables y legibles.
+ - Las respuestas de clave pública usan el campo `public_key_version`, y la forma del ID de conversación es flexible (dos puntos, guion o el ID de destinatario simple se firman de forma idéntica).
+ - API de streaming incremental para archivos multimedia de gran tamaño, selección de clave multimedia mediante `keyVersion` por evento y verificación fail-closed de forma predeterminada.
+
+ Consulta la [referencia actualizada del Chat XDK](/xchat/xchat-xdk) y la [Guía de inicio](/xchat/getting-started).
+
+
+
+ ### La X Chat API y el Chat XDK ya son públicos
+
+ Hoy publicamos la documentación de la **[X Chat API](/xchat/introduction)**: mensajes directos cifrados de extremo a extremo y firmados en X. Los cuerpos de los mensajes se cifran en el cliente y X solo enruta el texto cifrado; los destinatarios verifican a cada remitente mediante firma.
+
+ Junto con la API, lanzamos el **[Chat XDK](/xchat/xchat-xdk)**, un SDK de cifrado que cubre gestión de claves, cifrado, descifrado y firma en **Python, TypeScript, Rust, Go, C# y Java**. Combínalo con el XDK de [Python](/xdks/python/overview) o [TypeScript](/xdks/typescript/overview) (o HTTPS simple) para incorporar mensajería cifrada en tu aplicación.
+
+ Nuevas guías:
+ - [Guía de inicio](/xchat/getting-started): recorrido de una aplicación de extremo a extremo
+ - [Introducción a la criptografía](/xchat/cryptography-primer): cómo funcionan las claves, las firmas y los cambios de estado cifrados
+ - [Grupos](/xchat/groups), [Medios](/xchat/media), [Eventos en tiempo real](/xchat/real-time-events), [Solución de problemas](/xchat/troubleshooting)
+
+
### Endpoints de borrador y publicación de Articles
diff --git a/ja/changelog.mdx b/ja/changelog.mdx
index c46353e1b..9262c0aa9 100644
--- a/ja/changelog.mdx
+++ b/ja/changelog.mdx
@@ -7,6 +7,32 @@ keywords: ["変更履歴", "API 更新", "リリースノート", "新着情報"
更新情報の通知を受け取るには、[**@API**](https://x.com/api) の [**「通知をオンにする」**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) を有効にしてください。また、この変更履歴は [**RSS フィード**](https://docs.x.com/changelog/rss.xml)を使ってフィードリーダーで購読することもできます。
+
+ ### Chat XDK v0.4.0
+
+ 本日、**Chat XDK v0.4.0** をリリースし、Python、TypeScript、Rust、Go、C#、Java にまたがる暗号化 SDK の API サーフェスを更新しました。
+
+ - 会話キーの変更、グループの作成、メンバーの変更に対応する統一された `prepare_*` ヘルパー — それぞれ新しい鍵素材と必要なアクション署名を 1 回の呼び出しで返します。
+ - アクション署名は必須となり、API 境界で検証されるようになりました。グループエンドポイントは安定した、人間が読めるエラーメッセージを返します。
+ - 公開鍵のレスポンスは `public_key_version` フィールドを使用し、会話 ID の形式は柔軟です (コロン、ハイフン、または裸の recipient id はすべて同一の署名になります)。
+ - 大容量メディア向けの増分ストリーミング API、`keyVersion` によるイベントごとのメディアキー選択、およびデフォルトでのフェイルクローズ検証。
+
+ 更新された [Chat XDK リファレンス](/xchat/xchat-xdk) および [Getting Started](/xchat/getting-started) を参照してください。
+
+
+
+ ### X Chat API と Chat XDK が一般公開
+
+ 本日、**[X Chat API](/xchat/introduction)** のドキュメントを公開しました — X 上でエンドツーエンドに暗号化・署名されたダイレクトメッセージです。メッセージ本文はクライアントで暗号化され、X は暗号文のみをルーティングします。受信者は署名によって各送信者を検証します。
+
+ API と併せて、**[Chat XDK](/xchat/xchat-xdk)** をリリースしました。これは **Python、TypeScript、Rust、Go、C#、Java** にまたがる鍵管理、暗号化、復号、署名を網羅する暗号化 SDK です。[Python](/xdks/python/overview) または [TypeScript](/xdks/typescript/overview) XDK (あるいは素の HTTPS) と組み合わせて、アプリに暗号化メッセージング機能を組み込めます。
+
+ 新しいガイド:
+ - [Getting Started](/xchat/getting-started) — エンドツーエンドのアプリチュートリアル
+ - [Cryptography primer](/xchat/cryptography-primer) — 鍵、署名、暗号化された状態変更の仕組み
+ - [Groups](/xchat/groups)、[Media](/xchat/media)、[Real-time events](/xchat/real-time-events)、[Troubleshooting](/xchat/troubleshooting)
+
+
### Articles のドラフトおよび公開エンドポイント
diff --git a/ko/changelog.mdx b/ko/changelog.mdx
index 29a6c76fa..f9d87f8c7 100644
--- a/ko/changelog.mdx
+++ b/ko/changelog.mdx
@@ -7,6 +7,32 @@ keywords: ["변경 로그", "API 업데이트", "릴리스 노트", "새로운
업데이트를 구독하려면 [**@API**](https://x.com/api)의 [**"알림 켜기"**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive)를 활성화하세요. 또한 [**RSS 피드**](https://docs.x.com/changelog/rss.xml)를 통해 피드 리더에서 이 변경 로그를 구독할 수도 있습니다.
+
+ ### Chat XDK v0.4.0
+
+ 오늘, **Chat XDK v0.4.0**을 출시하여 Python, TypeScript, Rust, Go, C#, Java에 걸쳐 암호화 SDK의 API 표면을 업데이트했습니다:
+
+ - 대화 키 변경, 그룹 생성, 멤버 변경을 위한 통합된 `prepare_*` 헬퍼 — 각각 새로운 키 자료와 필요한 액션 서명을 한 번의 호출로 반환합니다.
+ - 이제 액션 서명은 필수이며 API 경계에서 검증됩니다. 그룹 엔드포인트는 안정적이고 사람이 읽을 수 있는 오류 메시지를 반환합니다.
+ - 공개 키 응답은 `public_key_version` 필드를 사용하며, 대화 ID 형식은 유연합니다(콜론, 하이픈 또는 순수한 수신자 ID 모두 동일하게 서명됩니다).
+ - 대용량 미디어를 위한 증분 스트리밍 API, 이벤트별 `keyVersion` 미디어 키 선택, 기본적으로 실패 시 폐쇄(fail-closed) 검증.
+
+ 업데이트된 [Chat XDK 참조](/xchat/xchat-xdk) 및 [시작하기](/xchat/getting-started)를 확인하세요.
+
+
+
+ ### X Chat API 및 Chat XDK 공개
+
+ 오늘, **[X Chat API](/xchat/introduction)** 문서를 공개했습니다 — X에서의 종단 간 암호화 및 서명된 다이렉트 메시지입니다. 메시지 본문은 클라이언트에서 암호화되며 X는 암호문만 라우팅합니다. 수신자는 서명으로 각 발신자를 검증합니다.
+
+ API와 함께 **[Chat XDK](/xchat/xchat-xdk)**를 출시했습니다. 이는 **Python, TypeScript, Rust, Go, C#, Java**에 걸쳐 키 관리, 암호화, 복호화 및 서명을 다루는 암호화 SDK입니다. [Python](/xdks/python/overview) 또는 [TypeScript](/xdks/typescript/overview) XDK(또는 일반 HTTPS)와 함께 사용하여 앱에 암호화된 메시징을 구축하세요.
+
+ 새로운 가이드:
+ - [시작하기](/xchat/getting-started) — 종단 간 앱 워크스루
+ - [암호화 입문서](/xchat/cryptography-primer) — 키, 서명 및 암호화된 상태 변경이 작동하는 방식
+ - [그룹](/xchat/groups), [미디어](/xchat/media), [실시간 이벤트](/xchat/real-time-events), [문제 해결](/xchat/troubleshooting)
+
+
### Articles 초안 작성 및 게시 엔드포인트
diff --git a/pt/changelog.mdx b/pt/changelog.mdx
index a636b9560..bf2a1b9e0 100644
--- a/pt/changelog.mdx
+++ b/pt/changelog.mdx
@@ -7,6 +7,32 @@ keywords: ["registro de alterações", "atualizações da API", "notas de versã
Para se inscrever para receber atualizações, [**"Ative as notificações"**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) para [**@API**](https://x.com/api). Você também pode acompanhar este registro de alterações no seu leitor de feeds por meio do [**feed RSS**](https://docs.x.com/changelog/rss.xml).
+
+ ### Chat XDK v0.4.0
+
+ Hoje, lançamos o **Chat XDK v0.4.0**, atualizando a superfície de API do SDK de criptografia em Python, TypeScript, Rust, Go, C# e Java:
+
+ - Helpers unificados `prepare_*` para alterações de chave de conversa, criação de grupos e alterações de membros — cada um retorna o novo material de chave e as assinaturas de ação necessárias em uma única chamada.
+ - As assinaturas de ação agora são obrigatórias e validadas na fronteira da API. Os endpoints de grupo retornam mensagens de erro estáveis e legíveis.
+ - As respostas de chave pública usam o campo `public_key_version`, e o formato do id de conversa é flexível (dois-pontos, hífen ou id de destinatário puro são assinados de forma idêntica).
+ - API de streaming incremental para mídia grande, seleção de chave de mídia por evento com `keyVersion` e verificação fail-closed por padrão.
+
+ Consulte a [referência atualizada do Chat XDK](/xchat/xchat-xdk) e o [Guia de introdução](/xchat/getting-started).
+
+
+
+ ### X Chat API e Chat XDK agora públicos
+
+ Hoje, publicamos a documentação da **[X Chat API](/xchat/introduction)** — mensagens diretas assinadas e com criptografia de ponta a ponta no X. Os corpos das mensagens são criptografados no cliente e o X roteia apenas o texto cifrado; os destinatários verificam cada remetente pela assinatura.
+
+ Junto com a API, lançamos o **[Chat XDK](/xchat/xchat-xdk)**, um SDK de criptografia que abrange gerenciamento de chaves, criptografia, descriptografia e assinatura em **Python, TypeScript, Rust, Go, C# e Java**. Combine-o com o XDK de [Python](/xdks/python/overview) ou [TypeScript](/xdks/typescript/overview) (ou HTTPS puro) para incorporar mensagens criptografadas ao seu app.
+
+ Novos guias:
+ - [Guia de introdução](/xchat/getting-started) — passo a passo completo de um app
+ - [Introdução à criptografia](/xchat/cryptography-primer) — como funcionam chaves, assinaturas e alterações de estado criptografadas
+ - [Grupos](/xchat/groups), [Mídia](/xchat/media), [Eventos em tempo real](/xchat/real-time-events), [Solução de problemas](/xchat/troubleshooting)
+
+
### Endpoints de rascunho e publicação de Articles