Updating documentation

signal-server-openapi.yaml

@@ -75,20 +75,6 @@ paths:
       security:
       - authenticatedAccount: []
   /v1/accounts/me:
-    get:
-      tags:
-      - Account
-      operationId: getMe
-      responses:
-        default:
-          description: default response
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/AccountIdentityResponse'
-      deprecated: true
-      security:
-      - authenticatedAccount: []
     delete:
       tags:
       - Account
@@ -562,6 +548,8 @@ paths:
     put:
       tags:
       - Account
+      summary: Sets whether the account should be discoverable by phone number in
+        the directory.
       operationId: setPhoneNumberDiscoverability
       requestBody:
         content:
@@ -570,10 +558,8 @@ paths:
               $ref: '#/components/schemas/PhoneNumberDiscoverabilityRequest'
         required: true
       responses:
-        default:
+        "204":
-          description: default response
+          description: The setting was successfully updated.
-          content:
-            application/json: {}
       security:
       - authenticatedAccount: []
   /v1/archives/upload/form:
@@ -3851,71 +3837,6 @@ components:
           type: string
           description: The url-safe base64-encoded encrypted username to be stored
             for username links
-    AccountIdentityResponse:
-      type: object
-      properties:
-        uuid:
-          type: string
-          description: the account identifier for this account
-          format: uuid
-        number:
-          type: string
-          description: the phone number associated with this account
-        pni:
-          type: string
-          description: the account identifier for this account's phone-number identity
-          format: uuid
-        usernameHash:
-          type: string
-          description: "a hash of this account's username, if set"
-          format: byte
-        usernameLinkHandle:
-          type: string
-          description: "this account's username link handle, if set"
-          format: uuid
-        storageCapable:
-          type: boolean
-          description: whether any of this account's devices support storage
-        entitlements:
-          $ref: '#/components/schemas/Entitlements'
-    BackupEntitlement:
-      type: object
-      properties:
-        backupLevel:
-          type: integer
-          description: The backup level of the account
-          format: int64
-        expirationSeconds:
-          type: integer
-          description: "When the backup entitlement expires, in number of seconds\
-            \ since epoch"
-          format: int64
-      description: "If present, the backup level set via /v1/archives/redeem-receipt"
-    BadgeEntitlement:
-      type: object
-      properties:
-        id:
-          type: string
-          description: The badge id
-        visible:
-          type: boolean
-          description: Whether the badge is currently configured to be visible
-        expirationSeconds:
-          type: integer
-          description: "When the badge expires, in number of seconds since epoch"
-          format: int64
-      description: Active badges added via /v1/donation/redeem-receipt
-    Entitlements:
-      type: object
-      properties:
-        badges:
-          type: array
-          description: Active badges added via /v1/donation/redeem-receipt
-          items:
-            $ref: '#/components/schemas/BadgeEntitlement'
-        backup:
-          $ref: '#/components/schemas/BackupEntitlement'
-      description: entitlements for this account and their current expirations
     TurnToken:
       type: object
       properties:
@@ -4068,6 +3989,71 @@ components:
           description: A handle that can be included in username links to retrieve
             the stored encrypted username
           format: uuid
+    AccountIdentityResponse:
+      type: object
+      properties:
+        uuid:
+          type: string
+          description: the account identifier for this account
+          format: uuid
+        number:
+          type: string
+          description: the phone number associated with this account
+        pni:
+          type: string
+          description: the account identifier for this account's phone-number identity
+          format: uuid
+        usernameHash:
+          type: string
+          description: "a hash of this account's username, if set"
+          format: byte
+        usernameLinkHandle:
+          type: string
+          description: "this account's username link handle, if set"
+          format: uuid
+        storageCapable:
+          type: boolean
+          description: whether any of this account's devices support storage
+        entitlements:
+          $ref: '#/components/schemas/Entitlements'
+    BackupEntitlement:
+      type: object
+      properties:
+        backupLevel:
+          type: integer
+          description: The backup level of the account
+          format: int64
+        expirationSeconds:
+          type: integer
+          description: "When the backup entitlement expires, in number of seconds\
+            \ since epoch"
+          format: int64
+      description: "If present, the backup level set via /v1/archives/redeem-receipt"
+    BadgeEntitlement:
+      type: object
+      properties:
+        id:
+          type: string
+          description: The badge id
+        visible:
+          type: boolean
+          description: Whether the badge is currently configured to be visible
+        expirationSeconds:
+          type: integer
+          description: "When the badge expires, in number of seconds since epoch"
+          format: int64
+      description: Active badges added via /v1/donation/redeem-receipt
+    Entitlements:
+      type: object
+      properties:
+        badges:
+          type: array
+          description: Active badges added via /v1/donation/redeem-receipt
+          items:
+            $ref: '#/components/schemas/BadgeEntitlement'
+        backup:
+          $ref: '#/components/schemas/BackupEntitlement'
+      description: entitlements for this account and their current expirations
     MismatchedDevices:
       type: object
       properties: