chore(oas): [18/n] improve oas schemas (#9311)

Improve OAS schemas [18/n]

www/utils/generated/oas-output/operations/admin/get_admin_reservations.ts

@@ -558,9 +558,9 @@
  *               properties:
  *                 reservations:
  *                   type: array
- *                   description: The list of reservations`.
+ *                   description: The list of reservations.
  *                   items:
- *                     $ref: "#/components/schemas/ReservationResponse"
+ *                     $ref: "#/components/schemas/AdminReservation"
  *   "400":
  *     $ref: "#/components/responses/400_error"
  *   "401":

www/utils/generated/oas-output/operations/admin/post_admin_uploads.ts

@@ -14,17 +14,17 @@
  *       schema:
  *         oneOf:
  *           - type: object
- *             description: The files to upload.
+ *             description: SUMMARY
  *             required:
  *               - files
  *             properties:
  *               files:
  *                 type: array
- *                 description: The files to upload.
+ *                 description: The upload's files.
  *                 items:
  *                   oneOf:
  *                     - type: object
- *                       description: A file's details.
+ *                       description: The file's files.
  *                       required:
  *                         - name
  *                         - content
@@ -36,9 +36,22 @@
  *                         content:
  *                           type: string
  *                           title: content
- *                           description: The file's base64 content.
- *                     - $ref: "#/components/schemas/File"
- *           - $ref: "#/components/schemas/FileList"
+ *                           description: The file's content.
+ *                     - type: object
+ *                       description: A File to upload.
+ *                       externalDocs:
+ *                         url: https://developer.mozilla.org/en-US/docs/Web/API/File
+ *                         description: Learn more about the File API
+ *                       title: files
+ *           - type: array
+ *             description: list of files to upload.
+ *             items:
+ *               type: object
+ *               description: A File to upload.
+ *               externalDocs:
+ *                 url: https://developer.mozilla.org/en-US/docs/Web/API/File
+ *                 description: Learn more about the File API
+ *             title: FileList
  *         description: The files to upload.
  * x-codeSamples:
  *   - lang: Shell

www/utils/generated/oas-output/operations/store/post_store_carts_[id]_taxes.ts

@@ -30,11 +30,6 @@
  *       title: fields
  *       description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default
  *         fields. without prefix it will replace the entire default fields.
- * requestBody:
- *   content:
- *     application/json:
- *       schema:
- *         $ref: "#/components/schemas/StoreCalculateCartTaxes"
  * x-codeSamples:
  *   - lang: Shell
  *     label: cURL