chore(docs): Generated API Reference (v2) (#8668)

Co-authored-by: kodiakhq <kodiakhq@users.noreply.github.com>
2024-08-20 12:31:06 +02:00
parent fa44e3f5a8
commit cb2ead3a1c
19 changed files with 487 additions and 31 deletions
--- a/www/utils/generated/oas-output/operations/admin/post_admin_order-edits.ts
+++ b/www/utils/generated/oas-output/operations/admin/post_admin_order-edits.ts
@@ -83,7 +83,7 @@
 *     content:
 *       application/json:
 *         schema:
- *           $ref: "#/components/schemas/AdminOrderResponse"
+ *           $ref: "#/components/schemas/AdminOrderEditResponse"
 *   "400":
 *     $ref: "#/components/responses/400_error"
 *   "401":
--- a/www/utils/generated/oas-output/operations/admin/post_admin_order-edits_[id]_items_item_[item_id].ts
+++ b/www/utils/generated/oas-output/operations/admin/post_admin_order-edits_[id]_items_item_[item_id].ts
@@ -0,0 +1,113 @@
+/**
+ * @oas [post] /admin/order-edits/{id}/items/item/{item_id}
+ * operationId: PostOrderEditsIdItemsItemItem_id
+ * summary: Add Items to Order Edit
+ * description: Add a list of items to a order edit.
+ * x-authenticated: true
+ * parameters:
+ *   - name: id
+ *     in: path
+ *     description: The order edit's ID.
+ *     required: true
+ *     schema:
+ *       type: string
+ *   - name: item_id
+ *     in: path
+ *     description: The order edit's item id.
+ *     required: true
+ *     schema:
+ *       type: string
+ *   - name: expand
+ *     in: query
+ *     description: Comma-separated relations that should be expanded in the returned data.
+ *     required: false
+ *     schema:
+ *       type: string
+ *       title: expand
+ *       description: Comma-separated relations that should be expanded in the returned data.
+ *   - name: fields
+ *     in: query
+ *     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.
+ *     required: false
+ *     schema:
+ *       type: string
+ *       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.
+ *   - name: offset
+ *     in: query
+ *     description: The number of items to skip when retrieving a list.
+ *     required: false
+ *     schema:
+ *       type: number
+ *       title: offset
+ *       description: The number of items to skip when retrieving a list.
+ *   - name: limit
+ *     in: query
+ *     description: Limit the number of items returned in the list.
+ *     required: false
+ *     schema:
+ *       type: number
+ *       title: limit
+ *       description: Limit the number of items returned in the list.
+ *   - name: order
+ *     in: query
+ *     description: The field to sort the data by. By default, the sort order is
+ *       ascending. To change the order to descending, prefix the field name with
+ *       `-`.
+ *     required: false
+ *     schema:
+ *       type: string
+ *       title: order
+ *       description: The field to sort the data by. By default, the sort order is
+ *         ascending. To change the order to descending, prefix the field name with
+ *         `-`.
+ * security:
+ *   - api_token: []
+ *   - cookie_auth: []
+ *   - jwt_token: []
+ * requestBody:
+ *   content:
+ *     application/json:
+ *       schema:
+ *         $ref: "#/components/schemas/AdminPostOrderEditsUpdateItemQuantityReqSchema"
+ * x-codeSamples:
+ *   - lang: Shell
+ *     label: cURL
+ *     source: |-
+ *       curl -X POST '{backend_url}/admin/order-edits/{id}/items/item/{item_id}' \
+ *       -H 'x-medusa-access-token: {api_token}' \
+ *       -H 'Content-Type: application/json' \
+ *       --data-raw '{
+ *         "quantity": 7564330046324736
+ *       }'
+ * tags:
+ *   - Order Edits
+ * responses:
+ *   "200":
+ *     description: OK
+ *     content:
+ *       application/json:
+ *         schema:
+ *           $ref: "#/components/schemas/AdminOrderEditPreviewResponse"
+ *   "400":
+ *     $ref: "#/components/responses/400_error"
+ *   "401":
+ *     $ref: "#/components/responses/unauthorized"
+ *   "404":
+ *     $ref: "#/components/responses/not_found_error"
+ *   "409":
+ *     $ref: "#/components/responses/invalid_state_error"
+ *   "422":
+ *     $ref: "#/components/responses/invalid_request_error"
+ *   "500":
+ *     $ref: "#/components/responses/500_error"
+ * x-workflow: orderEditUpdateItemQuantityWorkflow
+ * 
+*/
+
--- a/www/utils/generated/oas-output/operations/admin/post_admin_payment-collections.ts
+++ b/www/utils/generated/oas-output/operations/admin/post_admin_payment-collections.ts
@@ -15,18 +15,18 @@
 *       description: Comma-separated relations that should be expanded in the returned data.
 *   - name: fields
 *     in: query
- *     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.
+ *     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.
 *     required: false
 *     schema:
 *       type: string
 *       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.
+ *       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.
 *   - name: offset
 *     in: query
 *     description: The number of items to skip when retrieving a list.
--- a/www/utils/generated/oas-output/schemas/AdminOrderEditResponse.ts
+++ b/www/utils/generated/oas-output/schemas/AdminOrderEditResponse.ts
@@ -0,0 +1,13 @@
+/**
+ * @schema AdminOrderEditResponse
+ * type: object
+ * description: SUMMARY
+ * x-schemaName: AdminOrderEditResponse
+ * required:
+ *   - order_change
+ * properties:
+ *   order_change:
+ *     $ref: "#/components/schemas/OrderChange"
+ * 
+*/
+
--- a/www/utils/generated/oas-output/schemas/AdminPostOrderEditsUpdateItemQuantityReqSchema.ts
+++ b/www/utils/generated/oas-output/schemas/AdminPostOrderEditsUpdateItemQuantityReqSchema.ts
@@ -0,0 +1,19 @@
+/**
+ * @schema AdminPostOrderEditsUpdateItemQuantityReqSchema
+ * type: object
+ * description: SUMMARY
+ * x-schemaName: AdminPostOrderEditsUpdateItemQuantityReqSchema
+ * required:
+ *   - quantity
+ * properties:
+ *   quantity:
+ *     type: number
+ *     title: quantity
+ *     description: The order edit's quantity.
+ *   internal_note:
+ *     type: string
+ *     title: internal_note
+ *     description: The order edit's internal note.
+ * 
+*/
+
--- a/www/utils/generated/oas-output/schemas/OrderPreview.ts
+++ b/www/utils/generated/oas-output/schemas/OrderPreview.ts
@@ -1,7 +1,7 @@
 /**
 * @schema OrderPreview
 * type: object
- * description: The exchange's order preview.
+ * description: The order edit's order preview.
 * x-schemaName: OrderPreview
 * required:
 *   - order_change