From ab6b6ab09d8609b4fde383d099f5f544cba6da11 Mon Sep 17 00:00:00 2001
From: Documentation Updater <github@signal.org>
Date: Wed, 19 Jul 2023 18:50:27 +0000
Subject: [PATCH] Updating documentation

---
 signal-server-openapi.yaml | 50 +++++++++++++++++++++-----------------
 1 file changed, 28 insertions(+), 22 deletions(-)

diff --git a/signal-server-openapi.yaml b/signal-server-openapi.yaml
index ff0a486e4..72f85bbe2 100644
--- a/signal-server-openapi.yaml
+++ b/signal-server-openapi.yaml
@@ -2459,9 +2459,21 @@ components:
       properties:
         usernameHash:
           type: array
+          description: "The hash of the confirmed username, as supplied in the request"
           items:
             type: string
+            description: "The hash of the confirmed username, as supplied in the request"
             format: byte
+        usernameLinkHandle:
+          $ref: '#/components/schemas/UsernameLinkHandle'
+    UsernameLinkHandle:
+      required:
+      - usernameLinkHandle
+      type: object
+      properties:
+        usernameLinkHandle:
+          type: string
+          format: uuid
     ConfirmUsernameHashRequest:
       type: object
       properties:
@@ -2475,6 +2487,20 @@ components:
           items:
             type: string
             format: byte
+        encryptedUsername:
+          $ref: '#/components/schemas/EncryptedUsername'
+    EncryptedUsername:
+      required:
+      - usernameLinkEncryptedValue
+      type: object
+      properties:
+        usernameLinkEncryptedValue:
+          maxItems: 128
+          minItems: 1
+          type: array
+          items:
+            type: string
+            format: byte
     AccountIdentityResponse:
       type: object
       properties:
@@ -2518,18 +2544,6 @@ components:
         uuid:
           type: string
           format: uuid
-    EncryptedUsername:
-      required:
-      - usernameLinkEncryptedValue
-      type: object
-      properties:
-        usernameLinkEncryptedValue:
-          maxItems: 128
-          minItems: 1
-          type: array
-          items:
-            type: string
-            format: byte
     ReserveUsernameHashResponse:
       type: object
       properties:
@@ -2659,14 +2673,6 @@ components:
           maxLength: 64
           minLength: 64
           type: string
-    UsernameLinkHandle:
-      required:
-      - usernameLinkHandle
-      type: object
-      properties:
-        usernameLinkHandle:
-          type: string
-          format: uuid
     MismatchedDevices:
       type: object
       properties:
@@ -3678,10 +3684,10 @@ components:
           $ref: '#/components/schemas/ApnRegistrationId'
         gcmToken:
           $ref: '#/components/schemas/GcmRegistrationId'
-        everySignedKeyValid:
-          type: boolean
         completeRequest:
           type: boolean
+        everySignedKeyValid:
+          type: boolean
         valid:
           type: boolean
     UserRemoteConfig: