chore(docs): Updated API Reference (v2) (#8609)

Automated changes by [create-pull-request](https://github.com/peter-evans/create-pull-request) GitHub action

Co-authored-by: Shahed Nasser <27354907+shahednasser@users.noreply.github.com>
This commit is contained in:
github-actions[bot]andShahed Nasser authored and GitHub committed 2024-08-15 14:31:35 +00:00
1 parent 4bd0917aed
commit b23ddcdde8
1211 files changed
+92070 -5062

No files matched your search

@@ -9,6 +9,8 @@ tags:
- name: Api Keys
- name: Campaigns
- name: Claims
x-associatedSchema:
$ref: "#/components/schemas/AdminClaim"
- name: Collections
x-associatedSchema:
$ref: "#/components/schemas/AdminCollection"
@@ -21,6 +23,8 @@ tags:
externalDocs:
description: How to manage currencies
url: https://docs.medusajs.com/modules/regions-and-currencies/admin/manage-currencies
x-associatedSchema:
$ref: "#/components/schemas/AdminCurrency"
- name: Customer Groups
x-associatedSchema:
$ref: "#/components/schemas/AdminCustomerGroup"
@@ -34,6 +38,9 @@ tags:
x-associatedSchema:
$ref: "#/components/schemas/AdminCustomer"
- name: Draft Orders
- name: Exchanges
x-associatedSchema:
$ref: "#/components/schemas/AdminExchange"
- name: Fulfillment Providers
x-associatedSchema:
$ref: "#/components/schemas/AdminFulfillmentProvider"
@@ -41,7 +48,11 @@ tags:
x-associatedSchema:
$ref: "#/components/schemas/AdminFulfillmentSet"
- name: Fulfillments
x-associatedSchema:
$ref: "#/components/schemas/AdminFulfillment"
- name: Inventory Items
x-associatedSchema:
$ref: "#/components/schemas/AdminInventoryItem"
- name: Invites
description: >
An admin can invite new users to manage their team. This would allow new
@@ -49,11 +60,23 @@ tags:
externalDocs:
description: How to manage invites
url: https://docs.medusajs.com/modules/users/admin/manage-invites
x-associatedSchema:
$ref: "#/components/schemas/AdminInvite"
- name: Notifications
x-associatedSchema:
$ref: "#/components/schemas/AdminNotification"
- name: Orders
x-associatedSchema:
$ref: "#/components/schemas/AdminOrder"
- name: Payments
x-associatedSchema:
$ref: "#/components/schemas/AdminPayment"
- name: Price Lists
x-associatedSchema:
$ref: "#/components/schemas/AdminPriceList"
- name: Price Preferences
x-associatedSchema:
$ref: "#/components/schemas/AdminPricePreference"
- name: Product Categories
x-associatedSchema:
$ref: "#/components/schemas/AdminProductCategory"
@@ -61,10 +84,18 @@ tags:
x-associatedSchema:
$ref: "#/components/schemas/AdminProductTag"
- name: Product Types
- name: Product Variants
x-associatedSchema:
$ref: "#/components/schemas/AdminProductVariant"
- name: Products
x-associatedSchema:
$ref: "#/components/schemas/AdminProduct"
- name: Promotions
x-associatedSchema:
$ref: "#/components/schemas/AdminPromotion"
- name: Refund Reasons
x-associatedSchema:
$ref: "#/components/schemas/AdminRefundReason"
- name: Regions
description: >
Regions are different countries or geographical regions that the commerce
@@ -74,9 +105,15 @@ tags:
externalDocs:
description: How to manage regions
url: https://docs.medusajs.com/modules/regions-and-currencies/admin/manage-regions
x-associatedSchema:
$ref: "#/components/schemas/AdminRegion"
- name: Reservations
- name: Return Reasons
x-associatedSchema:
$ref: "#/components/schemas/AdminReturnReason"
- name: Returns
x-associatedSchema:
$ref: "#/components/schemas/AdminReturn"
- name: Sales Channels
description: >
A sales channel indicates a channel where products can be sold in. For
@@ -95,11 +132,21 @@ tags:
x-associatedSchema:
$ref: "#/components/schemas/AdminShippingProfile"
- name: Stock Locations
x-associatedSchema:
$ref: "#/components/schemas/AdminStockLocation"
- name: Stores
x-associatedSchema:
$ref: "#/components/schemas/AdminStore"
- name: Tax Rates
x-associatedSchema:
$ref: "#/components/schemas/AdminTaxRate"
- name: Tax Regions
x-associatedSchema:
$ref: "#/components/schemas/AdminTaxRegion"
- name: Uploads
- name: Users
x-associatedSchema:
$ref: "#/components/schemas/AdminUser"
- name: Workflows Executions
servers:
- url: http://localhost:9000
@@ -108,21 +155,39 @@ paths: {}
components:
schemas:
Error:
title: "Response Error"
title: Response Error
type: object
properties:
code:
type: string
description: A slug code to indicate the type of the error.
enum: [invalid_state_error, invalid_request_error, api_error, unknown_error]
enum:
- invalid_state_error
- invalid_request_error
- api_error
- unknown_error
message:
type: string
description: Description of the error that occurred.
example: "first_name must be a string"
example: first_name must be a string
type:
type: string
description: A slug indicating the type of the error.
enum: [QueryRunnerAlreadyReleasedError, TransactionAlreadyStartedError, TransactionNotStartedError, conflict, unauthorized, payment_authorization_error, duplicate_error, not_allowed, invalid_data, not_found, database_error, unexpected_state, invalid_argument, unknown_error]
enum:
- QueryRunnerAlreadyReleasedError
- TransactionAlreadyStartedError
- TransactionNotStartedError
- conflict
- unauthorized
- payment_authorization_error
- duplicate_error
- not_allowed
- invalid_data
- not_found
- database_error
- unexpected_state
- invalid_argument
- unknown_error
responses:
default_error:
description: Default Error
@@ -263,4 +328,4 @@ components:
type: apiKey
in: cookie
name: connect.sid
x-displayName: Cookie Session ID
x-displayName: Cookie Session ID
@@ -15,15 +15,29 @@ tags:
externalDocs:
description: How to implement cart functionality in your storefront
url: https://docs.medusajs.com/modules/carts-and-checkout/storefront/implement-cart
x-associatedSchema:
$ref: "#/components/schemas/StoreCart"
- name: Collections
x-associatedSchema:
$ref: "#/components/schemas/StoreCollection"
- name: Currencies
x-associatedSchema:
$ref: "#/components/schemas/StoreCurrency"
- name: Customers
x-associatedSchema:
$ref: "#/components/schemas/StoreCustomer"
- name: Orders
x-associatedSchema:
$ref: "#/components/schemas/StoreOrder"
- name: Payment Collections
description: >
A payment collection is useful for managing additional payments, such as
for Order Edits, or installment payments.
x-associatedSchema:
$ref: "#/components/schemas/StorePaymentCollection"
- name: Payment Providers
x-associatedSchema:
$ref: "#/components/schemas/StorePaymentProvider"
- name: Product Categories
x-associatedSchema:
$ref: "#/components/schemas/StoreProductCategory"
@@ -39,9 +53,17 @@ tags:
externalDocs:
description: How to use regions in a storefront
url: https://docs.medusajs.com/modules/regions-and-currencies/storefront/use-regions
x-associatedSchema:
$ref: "#/components/schemas/StoreRegion"
- name: Return
x-associatedSchema:
$ref: "#/components/schemas/StoreReturn"
- name: Return Reasons
x-associatedSchema:
$ref: "#/components/schemas/StoreReturnReason"
- name: Shipping Options
x-associatedSchema:
$ref: "#/components/schemas/StoreShippingOption"
servers:
- url: http://localhost:9000
- url: https://api.medusa-commerce.com
@@ -49,21 +71,39 @@ paths: {}
components:
schemas:
Error:
title: "Response Error"
title: Response Error
type: object
properties:
code:
type: string
description: A slug code to indicate the type of the error.
enum: [invalid_state_error, invalid_request_error, api_error, unknown_error]
enum:
- invalid_state_error
- invalid_request_error
- api_error
- unknown_error
message:
type: string
description: Description of the error that occurred.
example: "first_name must be a string"
example: first_name must be a string
type:
type: string
description: A slug indicating the type of the error.
enum: [QueryRunnerAlreadyReleasedError, TransactionAlreadyStartedError, TransactionNotStartedError, conflict, unauthorized, payment_authorization_error, duplicate_error, not_allowed, invalid_data, not_found, database_error, unexpected_state, invalid_argument, unknown_error]
enum:
- QueryRunnerAlreadyReleasedError
- TransactionAlreadyStartedError
- TransactionNotStartedError
- conflict
- unauthorized
- payment_authorization_error
- duplicate_error
- not_allowed
- invalid_data
- not_found
- database_error
- unexpected_state
- invalid_argument
- unknown_error
responses:
default_error:
description: Default Error
@@ -74,6 +74,33 @@
* tags:
* - Api Keys
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The api key's ID.
* object:
* type: string
* title: object
* description: The api key's object.
* deleted:
* type: boolean
* title: deleted
* description: The api key's deleted.
* parent:
* type: object
* description: The api key's parent.
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -74,6 +74,33 @@
* tags:
* - Campaigns
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The campaign's ID.
* object:
* type: string
* title: object
* description: The campaign's object.
* deleted:
* type: boolean
* title: deleted
* description: The campaign's deleted.
* parent:
* type: object
* description: The campaign's parent.
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -81,6 +81,12 @@
* tags:
* - Claims
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminClaimPreviewResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -93,6 +99,7 @@
* $ref: "#/components/responses/invalid_request_error"
* "500":
* $ref: "#/components/responses/500_error"
* x-workflow: removeItemClaimActionWorkflow
*
*/
@@ -83,6 +83,12 @@
* tags:
* - Claims
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminClaimReturnPreviewResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -95,6 +101,7 @@
* $ref: "#/components/responses/invalid_request_error"
* "500":
* $ref: "#/components/responses/500_error"
* x-workflow: removeItemReturnActionWorkflow
*
*/
@@ -84,6 +84,12 @@
* tags:
* - Claims
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminClaimReturnPreviewResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -96,6 +102,7 @@
* $ref: "#/components/responses/invalid_request_error"
* "500":
* $ref: "#/components/responses/500_error"
* x-workflow: removeClaimShippingMethodWorkflow
*
*/
@@ -83,6 +83,12 @@
* tags:
* - Claims
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminClaimPreviewResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -95,6 +101,7 @@
* $ref: "#/components/responses/invalid_request_error"
* "500":
* $ref: "#/components/responses/500_error"
* x-workflow: removeAddItemClaimActionWorkflow
*
*/
@@ -84,6 +84,12 @@
* tags:
* - Claims
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminClaimPreviewResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -96,6 +102,7 @@
* $ref: "#/components/responses/invalid_request_error"
* "500":
* $ref: "#/components/responses/500_error"
* x-workflow: removeClaimShippingMethodWorkflow
*
*/
@@ -75,6 +75,12 @@
* tags:
* - Claims
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminClaimDeleteResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -74,6 +74,12 @@
* tags:
* - Collections
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminCollectionDeleteResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -74,6 +74,33 @@
* tags:
* - Customer Groups
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The customer group's ID.
* object:
* type: string
* title: object
* description: The customer group's object.
* deleted:
* type: boolean
* title: deleted
* description: The customer group's deleted.
* parent:
* type: object
* description: The customer group's parent.
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -74,6 +74,33 @@
* tags:
* - Customers
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The customer's ID.
* object:
* type: string
* title: object
* description: The customer's object.
* deleted:
* type: boolean
* title: deleted
* description: The customer's deleted.
* parent:
* type: object
* description: The customer's parent.
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -83,6 +83,33 @@
* tags:
* - Customers
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The customer's ID.
* object:
* type: string
* title: object
* description: The customer's object.
* deleted:
* type: boolean
* title: deleted
* description: The customer's deleted.
* parent:
* type: object
* description: The customer's parent.
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -0,0 +1,107 @@
/**
* @oas [delete] /admin/exchanges/{id}/inbound/items/{action_id}
* operationId: DeleteExchangesIdInboundItemsAction_id
* summary: Remove Items from Exchange
* description: Remove a list of items from a exchange. This doesn't delete the
* Item, only the association between the Item and the exchange.
* x-authenticated: true
* parameters:
* - name: id
* in: path
* description: The exchange's ID.
* required: true
* schema:
* type: string
* - name: action_id
* in: path
* description: The exchange's action 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: []
* x-codeSamples:
* - lang: Shell
* label: cURL
* source: >-
* curl -X DELETE
* '{backend_url}/admin/exchanges/{id}/inbound/items/{action_id}' \
*
* -H 'x-medusa-access-token: {api_token}'
* tags:
* - Exchanges
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminExchangeReturnResponse"
* "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: removeItemReturnActionWorkflow
*
*/
@@ -0,0 +1,108 @@
/**
* @oas [delete] /admin/exchanges/{id}/inbound/shipping-method/{action_id}
* operationId: DeleteExchangesIdInboundShippingMethodAction_id
* summary: Remove Shipping Methods from Exchange
* description: Remove a list of shipping methods from a exchange. This doesn't
* delete the Shipping Method, only the association between the Shipping Method
* and the exchange.
* x-authenticated: true
* parameters:
* - name: id
* in: path
* description: The exchange's ID.
* required: true
* schema:
* type: string
* - name: action_id
* in: path
* description: The exchange's action 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: []
* x-codeSamples:
* - lang: Shell
* label: cURL
* source: >-
* curl -X DELETE
* '{backend_url}/admin/exchanges/{id}/inbound/shipping-method/{action_id}' \
*
* -H 'x-medusa-access-token: {api_token}'
* tags:
* - Exchanges
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminExchangeReturnResponse"
* "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: removeReturnShippingMethodWorkflow
*
*/
@@ -0,0 +1,107 @@
/**
* @oas [delete] /admin/exchanges/{id}/outbound/items/{action_id}
* operationId: DeleteExchangesIdOutboundItemsAction_id
* summary: Remove Items from Exchange
* description: Remove a list of items from a exchange. This doesn't delete the
* Item, only the association between the Item and the exchange.
* x-authenticated: true
* parameters:
* - name: id
* in: path
* description: The exchange's ID.
* required: true
* schema:
* type: string
* - name: action_id
* in: path
* description: The exchange's action 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: []
* x-codeSamples:
* - lang: Shell
* label: cURL
* source: >-
* curl -X DELETE
* '{backend_url}/admin/exchanges/{id}/outbound/items/{action_id}' \
*
* -H 'x-medusa-access-token: {api_token}'
* tags:
* - Exchanges
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminExchangePreviewResponse"
* "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: removeItemExchangeActionWorkflow
*
*/
@@ -0,0 +1,109 @@
/**
* @oas [delete] /admin/exchanges/{id}/outbound/shipping-method/{action_id}
* operationId: DeleteExchangesIdOutboundShippingMethodAction_id
* summary: Remove Shipping Methods from Exchange
* description: Remove a list of shipping methods from a exchange. This doesn't
* delete the Shipping Method, only the association between the Shipping Method
* and the exchange.
* x-authenticated: true
* parameters:
* - name: id
* in: path
* description: The exchange's ID.
* required: true
* schema:
* type: string
* - name: action_id
* in: path
* description: The exchange's action 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: []
* x-codeSamples:
* - lang: Shell
* label: cURL
* source: >-
* curl -X DELETE
* '{backend_url}/admin/exchanges/{id}/outbound/shipping-method/{action_id}'
* \
*
* -H 'x-medusa-access-token: {api_token}'
* tags:
* - Exchanges
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminExchangePreviewResponse"
* "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: removeExchangeShippingMethodWorkflow
*
*/
@@ -0,0 +1,119 @@
/**
* @oas [delete] /admin/exchanges/{id}/request
* operationId: DeleteExchangesIdRequest
* summary: Remove Requests from Exchange
* description: Remove a list of requests from a exchange. This doesn't delete the
* Request, only the association between the Request and the exchange.
* x-authenticated: true
* parameters:
* - name: id
* in: path
* description: The exchange's 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: []
* x-codeSamples:
* - lang: Shell
* label: cURL
* source: |-
* curl -X DELETE '{backend_url}/admin/exchanges/{id}/request' \
* -H 'x-medusa-access-token: {api_token}'
* tags:
* - Exchanges
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The exchange's ID.
* object:
* type: string
* title: object
* description: The exchange's object.
* deleted:
* type: boolean
* title: deleted
* description: The exchange's deleted.
* parent:
* type: object
* description: The exchange's parent.
* "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"
*
*/
@@ -84,6 +84,33 @@
* tags:
* - Fulfillment Sets
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The fulfillment set's ID.
* object:
* type: string
* title: object
* description: The fulfillment set's object.
* deleted:
* type: boolean
* title: deleted
* description: The fulfillment set's deleted.
* parent:
* type: object
* description: The fulfillment set's parent.
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -74,6 +74,33 @@
* tags:
* - Inventory Items
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The inventory item's ID.
* object:
* type: string
* title: object
* description: The inventory item's object.
* deleted:
* type: boolean
* title: deleted
* description: The inventory item's deleted.
* parent:
* type: object
* description: The inventory item's parent.
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -84,6 +84,33 @@
* tags:
* - Inventory Items
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The inventory item's ID.
* object:
* type: string
* title: object
* description: The inventory item's object.
* deleted:
* type: boolean
* title: deleted
* description: The inventory item's deleted.
* parent:
* type: object
* description: The inventory item's parent.
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -68,6 +68,33 @@
* tags:
* - Invites
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The invite's ID.
* object:
* type: string
* title: object
* description: The invite's object.
* deleted:
* type: boolean
* title: deleted
* description: The invite's deleted.
* parent:
* type: object
* description: The invite's parent.
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -74,6 +74,12 @@
* tags:
* - Price Lists
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminPriceListDeleteResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -74,6 +74,12 @@
* tags:
* - Price Preferences
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminPricePreferenceDeleteResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -74,6 +74,12 @@
* tags:
* - Product Categories
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminProductCategoryDeleteResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -74,6 +74,12 @@
* tags:
* - Product Tags
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminProductTagDeleteResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -74,6 +74,12 @@
* tags:
* - Product Types
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminProductTypeDeleteResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -91,6 +91,12 @@
* tags:
* - Products
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminProductVariantInventoryLinkDeleteResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -103,6 +109,7 @@
* $ref: "#/components/responses/invalid_request_error"
* "500":
* $ref: "#/components/responses/500_error"
* x-workflow: dismissLinksWorkflow
*
*/
@@ -74,6 +74,33 @@
* tags:
* - Promotions
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The promotion's ID.
* object:
* type: string
* title: object
* description: The promotion's object.
* deleted:
* type: boolean
* title: deleted
* description: The promotion's deleted.
* parent:
* type: object
* description: The promotion's parent.
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -0,0 +1,118 @@
/**
* @oas [delete] /admin/refund-reasons/{id}
* operationId: DeleteRefundReasonsId
* summary: Delete a Refund Reason
* description: Delete a refund reason.
* x-authenticated: true
* parameters:
* - name: id
* in: path
* description: The refund reason's 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: []
* x-codeSamples:
* - lang: Shell
* label: cURL
* source: |-
* curl -X DELETE '{backend_url}/admin/refund-reasons/{id}' \
* -H 'x-medusa-access-token: {api_token}'
* tags:
* - Refund Reasons
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The refund reason's ID.
* object:
* type: string
* title: object
* description: The refund reason's object.
* deleted:
* type: boolean
* title: deleted
* description: The refund reason's deleted.
* parent:
* type: object
* description: The refund reason's parent.
* "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"
*
*/
@@ -74,6 +74,33 @@
* tags:
* - Regions
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The region's ID.
* object:
* type: string
* title: object
* description: The region's object.
* deleted:
* type: boolean
* title: deleted
* description: The region's deleted.
* parent:
* type: object
* description: The region's parent.
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -74,6 +74,33 @@
* tags:
* - Reservations
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The reservation's ID.
* object:
* type: string
* title: object
* description: The reservation's object.
* deleted:
* type: boolean
* title: deleted
* description: The reservation's deleted.
* parent:
* type: object
* description: The reservation's parent.
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -74,6 +74,33 @@
* tags:
* - Return Reasons
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The return reason's ID.
* object:
* type: string
* title: object
* description: The return reason's object.
* deleted:
* type: boolean
* title: deleted
* description: The return reason's deleted.
* parent:
* type: object
* description: The return reason's parent.
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -84,6 +84,12 @@
* tags:
* - Returns
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminReturnPreviewResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -96,6 +102,7 @@
* $ref: "#/components/responses/invalid_request_error"
* "500":
* $ref: "#/components/responses/500_error"
* x-workflow: removeItemReturnActionWorkflow
*
*/
@@ -84,6 +84,12 @@
* tags:
* - Returns
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminReturnPreviewResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -96,6 +102,7 @@
* $ref: "#/components/responses/invalid_request_error"
* "500":
* $ref: "#/components/responses/500_error"
* x-workflow: removeItemReceiveReturnActionWorkflow
*
*/
@@ -75,6 +75,33 @@
* tags:
* - Returns
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The return's ID.
* object:
* type: string
* title: object
* description: The return's object.
* deleted:
* type: boolean
* title: deleted
* description: The return's deleted.
* parent:
* type: object
* description: The return's parent.
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -84,6 +84,12 @@
* tags:
* - Returns
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminReturnPreviewResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -96,6 +102,7 @@
* $ref: "#/components/responses/invalid_request_error"
* "500":
* $ref: "#/components/responses/500_error"
* x-workflow: removeItemReturnActionWorkflow
*
*/
@@ -75,6 +75,33 @@
* tags:
* - Returns
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The return's ID.
* object:
* type: string
* title: object
* description: The return's object.
* deleted:
* type: boolean
* title: deleted
* description: The return's deleted.
* parent:
* type: object
* description: The return's parent.
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -84,6 +84,12 @@
* tags:
* - Returns
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminReturnPreviewResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -96,6 +102,7 @@
* $ref: "#/components/responses/invalid_request_error"
* "500":
* $ref: "#/components/responses/500_error"
* x-workflow: removeReturnShippingMethodWorkflow
*
*/
@@ -74,6 +74,12 @@
* tags:
* - Sales Channels
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminSalesChannelDeleteResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -74,6 +74,12 @@
* tags:
* - Stock Locations
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminStockLocationDeleteResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -74,6 +74,12 @@
* tags:
* - Tax Rates
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminTaxRateDeleteResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -81,6 +81,33 @@
* tags:
* - Tax Rates
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The tax rate's ID.
* object:
* type: string
* title: object
* description: The tax rate's object.
* deleted:
* type: boolean
* title: deleted
* description: The tax rate's deleted.
* parent:
* type: object
* description: The tax rate's parent.
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -74,6 +74,12 @@
* tags:
* - Tax Regions
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminTaxRegionDeleteResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -74,6 +74,33 @@
* tags:
* - Uploads
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - id
* - object
* - deleted
* properties:
* id:
* type: string
* title: id
* description: The upload's ID.
* object:
* type: string
* title: object
* description: The upload's object.
* deleted:
* type: boolean
* title: deleted
* description: The upload's deleted.
* parent:
* type: object
* description: The upload's parent.
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -68,6 +68,12 @@
* tags:
* - Users
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminUserDeleteResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -69,6 +69,41 @@
* tags:
* - Api Keys
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* allOf:
* - type: object
* description: SUMMARY
* required:
* - limit
* - offset
* - count
* properties:
* limit:
* type: number
* title: limit
* description: The api key's limit.
* offset:
* type: number
* title: offset
* description: The api key's offset.
* count:
* type: number
* title: count
* description: The api key's count.
* - type: object
* description: SUMMARY
* required:
* - api_keys
* properties:
* api_keys:
* type: array
* description: The api key's api keys.
* items:
* $ref: "#/components/schemas/ApiKeyResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -75,6 +75,12 @@
* tags:
* - Api Keys
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminApiKeyResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -69,6 +69,41 @@
* tags:
* - Campaigns
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* allOf:
* - type: object
* description: SUMMARY
* required:
* - limit
* - offset
* - count
* properties:
* limit:
* type: number
* title: limit
* description: The campaign's limit.
* offset:
* type: number
* title: offset
* description: The campaign's offset.
* count:
* type: number
* title: count
* description: The campaign's count.
* - type: object
* description: SUMMARY
* required:
* - campaigns
* properties:
* campaigns:
* type: array
* description: The campaign's campaigns.
* items:
* $ref: "#/components/schemas/CampaignResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -75,6 +75,12 @@
* tags:
* - Campaigns
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminCampaignResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -69,6 +69,12 @@
* tags:
* - Claims
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminClaimListResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -0,0 +1,98 @@
/**
* @oas [get] /admin/claims/{id}
* operationId: GetClaimsId
* summary: Get a Claim
* description: Retrieve a claim by its ID. You can expand the claim's relations or
* select the fields that should be returned.
* x-authenticated: true
* parameters:
* - name: id
* in: path
* description: The claim's 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: []
* x-codeSamples:
* - lang: Shell
* label: cURL
* source: |-
* curl '{backend_url}/admin/claims/{id}' \
* -H 'x-medusa-access-token: {api_token}'
* tags:
* - Claims
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminClaimResponse"
* "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"
*
*/
@@ -69,6 +69,12 @@
* tags:
* - Collections
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminCollectionListResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -75,6 +75,12 @@
* tags:
* - Collections
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminCollectionResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -69,6 +69,12 @@
* tags:
* - Currencies
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminCurrencyListResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -75,6 +75,12 @@
* tags:
* - Currencies
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminCurrencyResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -70,6 +70,41 @@
* tags:
* - Customer Groups
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* allOf:
* - type: object
* description: SUMMARY
* required:
* - limit
* - offset
* - count
* properties:
* limit:
* type: number
* title: limit
* description: The customer group's limit.
* offset:
* type: number
* title: offset
* description: The customer group's offset.
* count:
* type: number
* title: count
* description: The customer group's count.
* - type: object
* description: SUMMARY
* required:
* - customer_groups
* properties:
* customer_groups:
* type: array
* description: The customer group's customer groups.
* items:
* $ref: "#/components/schemas/AdminCustomerGroup"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -75,6 +75,12 @@
* tags:
* - Customer Groups
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminCustomerGroupResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -80,13 +80,7 @@
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - customer
* properties:
* customer:
* $ref: "#/components/schemas/AdminCustomer"
* $ref: "#/components/schemas/AdminCustomerResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -75,6 +75,41 @@
* tags:
* - Customers
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* allOf:
* - type: object
* description: SUMMARY
* required:
* - limit
* - offset
* - count
* properties:
* limit:
* type: number
* title: limit
* description: The customer's limit.
* offset:
* type: number
* title: offset
* description: The customer's offset.
* count:
* type: number
* title: count
* description: The customer's count.
* - type: object
* description: SUMMARY
* required:
* - addresses
* properties:
* addresses:
* type: array
* description: The customer's addresses.
* items:
* $ref: "#/components/schemas/AdminCustomerAddress"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -81,6 +81,12 @@
* tags:
* - Customers
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminCustomerAddressResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -69,6 +69,38 @@
* tags:
* - Draft Orders
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* allOf:
* - type: object
* description: SUMMARY
* required:
* - limit
* - offset
* - count
* properties:
* limit:
* type: number
* title: limit
* description: The draft order's limit.
* offset:
* type: number
* title: offset
* description: The draft order's offset.
* count:
* type: number
* title: count
* description: The draft order's count.
* - type: object
* description: SUMMARY
* required:
* - draft_orders
* properties:
* draft_orders:
* $ref: "#/components/schemas/AdminOrder"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -75,6 +75,12 @@
* tags:
* - Draft Orders
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminDraftOrderResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -0,0 +1,118 @@
/**
* @oas [get] /admin/exchanges
* operationId: GetExchanges
* summary: List Exchanges
* description: Retrieve a list of exchanges. The exchanges can be filtered by
* fields such as `id`. The exchanges can also be sorted or paginated.
* x-authenticated: true
* parameters:
* - 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: []
* x-codeSamples:
* - lang: Shell
* label: cURL
* source: |-
* curl '{backend_url}/admin/exchanges' \
* -H 'x-medusa-access-token: {api_token}'
* tags:
* - Exchanges
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* allOf:
* - type: object
* description: SUMMARY
* required:
* - limit
* - offset
* - count
* properties:
* limit:
* type: number
* title: limit
* description: The exchange's limit.
* offset:
* type: number
* title: offset
* description: The exchange's offset.
* count:
* type: number
* title: count
* description: The exchange's count.
* - type: object
* description: SUMMARY
* required:
* - exchanges
* properties:
* exchanges:
* $ref: "#/components/schemas/AdminExchange"
* "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"
*
*/
@@ -114,6 +114,12 @@
* tags:
* - Fulfillment Providers
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminFulfillmentProviderListResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -307,11 +307,21 @@
* - name: $and
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The inventory item's $and.
* items:
* type: object
* title: $and
* - name: $or
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The inventory item's $or.
* items:
* type: object
* title: $or
* security:
* - api_token: []
* - cookie_auth: []
@@ -325,6 +335,41 @@
* tags:
* - Inventory Items
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* allOf:
* - type: object
* description: SUMMARY
* required:
* - limit
* - offset
* - count
* properties:
* limit:
* type: number
* title: limit
* description: The inventory item's limit.
* offset:
* type: number
* title: offset
* description: The inventory item's offset.
* count:
* type: number
* title: count
* description: The inventory item's count.
* - type: object
* description: SUMMARY
* required:
* - inventory_items
* properties:
* inventory_items:
* type: array
* description: The inventory item's inventory items.
* items:
* $ref: "#/components/schemas/AdminInventoryItem"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -75,6 +75,12 @@
* tags:
* - Inventory Items
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminInventoryItemResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -80,11 +80,21 @@
* - name: $and
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The inventory item's $and.
* items:
* type: object
* title: $and
* - name: $or
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The inventory item's $or.
* items:
* type: object
* title: $or
* security:
* - api_token: []
* - cookie_auth: []
@@ -98,6 +108,41 @@
* tags:
* - Inventory Items
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* allOf:
* - type: object
* description: SUMMARY
* required:
* - limit
* - offset
* - count
* properties:
* limit:
* type: number
* title: limit
* description: The inventory item's limit.
* offset:
* type: number
* title: offset
* description: The inventory item's offset.
* count:
* type: number
* title: count
* description: The inventory item's count.
* - type: object
* description: SUMMARY
* required:
* - inventory_levels
* properties:
* inventory_levels:
* type: array
* description: The inventory item's inventory levels.
* items:
* $ref: "#/components/schemas/InventoryLevel"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -199,11 +199,21 @@
* - name: $and
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The invite's $and.
* items:
* type: object
* title: $and
* - name: $or
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The invite's $or.
* items:
* type: object
* title: $or
* x-codeSamples:
* - lang: Shell
* label: cURL
@@ -211,6 +221,41 @@
* tags:
* - Invites
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* allOf:
* - type: object
* description: SUMMARY
* required:
* - limit
* - offset
* - count
* properties:
* limit:
* type: number
* title: limit
* description: The invite's limit.
* offset:
* type: number
* title: offset
* description: The invite's offset.
* count:
* type: number
* title: count
* description: The invite's count.
* - type: object
* description: SUMMARY
* required:
* - invites
* properties:
* invites:
* type: array
* description: The invite's invites.
* items:
* $ref: "#/components/schemas/AdminInvite"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -69,6 +69,12 @@
* tags:
* - Invites
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminInviteResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -95,11 +95,21 @@
* - name: $and
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The notification's $and.
* items:
* type: object
* title: $and
* - name: $or
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The notification's $or.
* items:
* type: object
* title: $or
* security:
* - api_token: []
* - cookie_auth: []
@@ -113,6 +123,12 @@
* tags:
* - Notifications
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminNotificationListResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -75,6 +75,12 @@
* tags:
* - Notifications
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminNotificationResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -69,6 +69,41 @@
* tags:
* - Orders
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* allOf:
* - type: object
* description: SUMMARY
* required:
* - limit
* - offset
* - count
* properties:
* limit:
* type: number
* title: limit
* description: The order's limit.
* offset:
* type: number
* title: offset
* description: The order's offset.
* count:
* type: number
* title: count
* description: The order's count.
* - type: object
* description: SUMMARY
* required:
* - orders
* properties:
* orders:
* type: array
* description: The order's orders.
* items:
* $ref: "#/components/schemas/AdminOrder"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -75,6 +75,12 @@
* tags:
* - Orders
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminOrderResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -75,6 +75,12 @@
* tags:
* - Orders
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminOrderPreviewResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -197,11 +197,21 @@
* - name: $and
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The payment's $and.
* items:
* type: object
* title: $and
* - name: $or
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The payment's $or.
* items:
* type: object
* title: $or
* security:
* - api_token: []
* - cookie_auth: []
@@ -215,6 +225,41 @@
* tags:
* - Payments
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* allOf:
* - type: object
* description: SUMMARY
* required:
* - limit
* - offset
* - count
* properties:
* limit:
* type: number
* title: limit
* description: The payment's limit.
* offset:
* type: number
* title: offset
* description: The payment's offset.
* count:
* type: number
* title: count
* description: The payment's count.
* - type: object
* description: SUMMARY
* required:
* - payments
* properties:
* payments:
* type: array
* description: The payment's payments.
* items:
* $ref: "#/components/schemas/AdminPayment"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -75,6 +75,12 @@
* tags:
* - Payments
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminPaymentResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -81,11 +81,21 @@
* - name: $and
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The payment's $and.
* items:
* type: object
* title: $and
* - name: $or
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The payment's $or.
* items:
* type: object
* title: $or
* security:
* - api_token: []
* - cookie_auth: []
@@ -99,6 +109,41 @@
* tags:
* - Payments
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* allOf:
* - type: object
* description: SUMMARY
* required:
* - limit
* - offset
* - count
* properties:
* limit:
* type: number
* title: limit
* description: The payment's limit.
* offset:
* type: number
* title: offset
* description: The payment's offset.
* count:
* type: number
* title: count
* description: The payment's count.
* - type: object
* description: SUMMARY
* required:
* - payment_providers
* properties:
* payment_providers:
* type: array
* description: The payment's payment providers.
* items:
* $ref: "#/components/schemas/AdminPaymentProvider"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -69,6 +69,12 @@
* tags:
* - Price Lists
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminPriceListListResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -75,6 +75,12 @@
* tags:
* - Price Lists
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminPriceListResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -70,6 +70,12 @@
* tags:
* - Price Preferences
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminPricePreferenceListResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -75,6 +75,12 @@
* tags:
* - Price Preferences
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminPricePreferenceResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -258,11 +258,21 @@
* - name: $and
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The product category's $and.
* items:
* type: object
* title: $and
* - name: $or
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The product category's $or.
* items:
* type: object
* title: $or
* security:
* - api_token: []
* - cookie_auth: []
@@ -197,11 +197,21 @@
* - name: $and
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The product tag's $and.
* items:
* type: object
* title: $and
* - name: $or
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The product tag's $or.
* items:
* type: object
* title: $or
* security:
* - api_token: []
* - cookie_auth: []
@@ -215,6 +225,12 @@
* tags:
* - Product Tags
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminProductTagListResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -75,6 +75,12 @@
* tags:
* - Product Tags
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminProductTagResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -197,11 +197,21 @@
* - name: $and
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The product type's $and.
* items:
* type: object
* title: $and
* - name: $or
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The product type's $or.
* items:
* type: object
* title: $or
* security:
* - api_token: []
* - cookie_auth: []
@@ -215,6 +225,12 @@
* tags:
* - Product Types
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminProductTypeListResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -75,6 +75,12 @@
* tags:
* - Product Types
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminProductTypeResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -0,0 +1,122 @@
/**
* @oas [get] /admin/product-variants
* operationId: GetProductVariants
* summary: List Product Variants
* description: Retrieve a list of product variants. The product variants can be
* filtered by fields such as `id`. The product variants can also be sorted or
* paginated.
* x-authenticated: true
* parameters:
* - 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: []
* x-codeSamples:
* - lang: Shell
* label: cURL
* source: |-
* curl '{backend_url}/admin/product-variants' \
* -H 'x-medusa-access-token: {api_token}'
* tags:
* - Product Variants
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* allOf:
* - type: object
* description: SUMMARY
* required:
* - limit
* - offset
* - count
* properties:
* limit:
* type: number
* title: limit
* description: The product variant's limit.
* offset:
* type: number
* title: offset
* description: The product variant's offset.
* count:
* type: number
* title: count
* description: The product variant's count.
* - type: object
* description: SUMMARY
* required:
* - variants
* properties:
* variants:
* type: array
* description: The product variant's variants.
* items:
* $ref: "#/components/schemas/AdminProductVariant"
* "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"
*
*/
@@ -12057,6 +12057,9 @@
* x-schemaName: BaseProductListParams
* - type: object
* description: The $or's details.
* type: array
* items:
* type: object
* - name: $or
* in: query
* description: The product's $or.
@@ -13971,6 +13974,9 @@
* x-schemaName: BaseProductListParams
* - type: object
* description: The $or's details.
* type: array
* items:
* type: object
* security:
* - api_token: []
* - cookie_auth: []
@@ -601,6 +601,9 @@
* x-schemaName: BaseProductOptionParams
* - type: object
* description: The $or's details.
* type: array
* items:
* type: object
* - name: $or
* in: query
* description: The product's $or.
@@ -1090,6 +1093,9 @@
* x-schemaName: BaseProductOptionParams
* - type: object
* description: The $or's details.
* type: array
* items:
* type: object
* security:
* - api_token: []
* - cookie_auth: []
@@ -216,11 +216,21 @@
* - name: $and
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The promotion's $and.
* items:
* type: object
* title: $and
* - name: $or
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The promotion's $or.
* items:
* type: object
* title: $or
* security:
* - api_token: []
* - cookie_auth: []
@@ -234,6 +244,41 @@
* tags:
* - Promotions
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* allOf:
* - type: object
* description: SUMMARY
* required:
* - limit
* - offset
* - count
* properties:
* limit:
* type: number
* title: limit
* description: The promotion's limit.
* offset:
* type: number
* title: offset
* description: The promotion's offset.
* count:
* type: number
* title: count
* description: The promotion's count.
* - type: object
* description: SUMMARY
* required:
* - promotions
* properties:
* promotions:
* type: array
* description: The promotion's promotions.
* items:
* $ref: "#/components/schemas/AdminPromotion"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -75,6 +75,12 @@
* tags:
* - Promotions
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminPromotionResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -81,6 +81,21 @@
* tags:
* - Promotions
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - rules
* properties:
* rules:
* type: array
* description: The promotion's rules.
* items:
* $ref: "#/components/schemas/AdminPromotionRule"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -92,6 +92,21 @@
* tags:
* - Promotions
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - attributes
* properties:
* attributes:
* type: array
* description: The promotion's attributes.
* items:
* $ref: "#/components/schemas/AdminRuleAttributeOption"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -100,6 +100,21 @@
* tags:
* - Promotions
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* type: object
* description: SUMMARY
* required:
* - values
* properties:
* values:
* type: array
* description: The promotion's values.
* items:
* $ref: "#/components/schemas/AdminRuleValueOption"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -0,0 +1,122 @@
/**
* @oas [get] /admin/refund-reasons
* operationId: GetRefundReasons
* summary: List Refund Reasons
* description: Retrieve a list of refund reasons. The refund reasons can be
* filtered by fields such as `id`. The refund reasons can also be sorted or
* paginated.
* x-authenticated: true
* parameters:
* - 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: []
* x-codeSamples:
* - lang: Shell
* label: cURL
* source: |-
* curl '{backend_url}/admin/refund-reasons' \
* -H 'x-medusa-access-token: {api_token}'
* tags:
* - Refund Reasons
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* allOf:
* - type: object
* description: SUMMARY
* required:
* - limit
* - offset
* - count
* properties:
* limit:
* type: number
* title: limit
* description: The refund reason's limit.
* offset:
* type: number
* title: offset
* description: The refund reason's offset.
* count:
* type: number
* title: count
* description: The refund reason's count.
* - type: object
* description: SUMMARY
* required:
* - refund_reasons
* properties:
* refund_reasons:
* type: array
* description: The refund reason's refund reasons.
* items:
* $ref: "#/components/schemas/AdminRefundReason"
* "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"
*
*/
@@ -0,0 +1,98 @@
/**
* @oas [get] /admin/refund-reasons/{id}
* operationId: GetRefundReasonsId
* summary: Get a Refund Reason
* description: Retrieve a refund reason by its ID. You can expand the refund
* reason's relations or select the fields that should be returned.
* x-authenticated: true
* parameters:
* - name: id
* in: path
* description: The refund reason's 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: []
* x-codeSamples:
* - lang: Shell
* label: cURL
* source: |-
* curl '{backend_url}/admin/refund-reasons/{id}' \
* -H 'x-medusa-access-token: {api_token}'
* tags:
* - Refund Reasons
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/RefundReasonResponse"
* "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"
*
*/
@@ -211,11 +211,21 @@
* - name: $and
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The region's $and.
* items:
* type: object
* title: $and
* - name: $or
* in: query
* required: false
* schema: {}
* schema:
* type: array
* description: The region's $or.
* items:
* type: object
* title: $or
* security:
* - api_token: []
* - cookie_auth: []
@@ -229,6 +239,41 @@
* tags:
* - Regions
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* allOf:
* - type: object
* description: SUMMARY
* required:
* - limit
* - offset
* - count
* properties:
* limit:
* type: number
* title: limit
* description: The region's limit.
* offset:
* type: number
* title: offset
* description: The region's offset.
* count:
* type: number
* title: count
* description: The region's count.
* - type: object
* description: SUMMARY
* required:
* - regions
* properties:
* regions:
* type: array
* description: The region's regions.
* items:
* $ref: "#/components/schemas/AdminRegion"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
@@ -75,6 +75,12 @@
* tags:
* - Regions
* responses:
* "200":
* description: OK
* content:
* application/json:
* schema:
* $ref: "#/components/schemas/AdminRegionResponse"
* "400":
* $ref: "#/components/responses/400_error"
* "401":
Loaded 100 of 1211 files, more files were not shown because too many files have changed in this diff. Show more