From e0bd0543739910cc78a7aca78a632487a0e3aa96 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Commaille?=
 <76261501+zecakeh@users.noreply.github.com>
Date: Wed, 6 Nov 2024 12:14:24 +0100
Subject: [PATCH] Clarify formats of string types for the `POST
 /_matrix/client/v3/login` endpoint (#1980)

Co-authored-by: Andrew Morgan <1342360+anoadragon453@users.noreply.github.com>
---
 changelogs/client_server/newsfragments/1980.clarification | 1 +
 data/api/client-server/login.yaml                         | 3 +++
 2 files changed, 4 insertions(+)
 create mode 100644 changelogs/client_server/newsfragments/1980.clarification

diff --git a/changelogs/client_server/newsfragments/1980.clarification b/changelogs/client_server/newsfragments/1980.clarification
new file mode 100644
index 000000000..bdcce7771
--- /dev/null
+++ b/changelogs/client_server/newsfragments/1980.clarification
@@ -0,0 +1 @@
+Clarify formats of string types.
diff --git a/data/api/client-server/login.yaml b/data/api/client-server/login.yaml
index 385eb33b6..28de0be12 100644
--- a/data/api/client-server/login.yaml
+++ b/data/api/client-server/login.yaml
@@ -172,6 +172,8 @@ paths:
                 properties:
                   user_id:
                     type: string
+                    format: mx-user-id
+                    pattern: "^@"
                     description: The fully-qualified Matrix ID for the account.
                   access_token:
                     type: string
@@ -197,6 +199,7 @@ paths:
                     x-addedInMatrixVersion: "1.3"
                   home_server:
                     type: string
+                    format: mx-server-name
                     deprecated: true
                     description: |-
                       The server_name of the homeserver on which the account has