Updating documentation

signal-server-openapi.yaml

@@ -1691,7 +1691,12 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/TransferArchiveResult'
+                description: |
+                  The location of the transfer archive if the archive was successfully uploaded, otherwise a error indicating that
+                   the upload has failed and the destination device should stop waiting
+                oneOf:
+                - $ref: '#/components/schemas/RemoteAttachment'
+                - $ref: '#/components/schemas/RemoteAttachmentError'
         "204":
           description: No transfer archive was uploaded before the call completed;
             clients may repeat the call to continue waiting
@@ -4264,9 +4269,6 @@ components:
       - cdn
       - key
       type: object
-      allOf:
-      - $ref: '#/components/schemas/TransferArchiveResult'
-      - type: object
       properties:
         cdn:
           type: integer
@@ -4664,10 +4666,6 @@ components:
       required:
       - error
       type: object
-      description: Indicates an attachment failed to upload
-      allOf:
-      - $ref: '#/components/schemas/TransferArchiveResult'
-      - type: object
       properties:
         error:
           type: string
@@ -4675,14 +4673,15 @@ components:
           enum:
           - RELINK_REQUESTED
           - CONTINUE_WITHOUT_UPLOAD
+      description: Indicates an attachment failed to upload
     TransferArchiveResult:
       type: object
       description: |
         The location of the transfer archive if the archive was successfully uploaded, otherwise a error indicating that
          the upload has failed and the destination device should stop waiting
       oneOf:
-      - $ref: '#/components/schemas/RemoteAttachmentError'
       - $ref: '#/components/schemas/RemoteAttachment'
+      - $ref: '#/components/schemas/RemoteAttachmentError'
     TransferArchiveUploadedRequest:
       required:
       - transferArchive