openapi: 3.0.0 info: version: 2.0.0 title: Medusa Admin API license: name: MIT url: https://github.com/medusajs/medusa/blob/master/LICENSE servers: - url: http://localhost:9000 - url: https://api.medusa-commerce.com tags: - name: Api Keys - name: Campaigns - name: Claims x-associatedSchema: $ref: '#/components/schemas/AdminClaim' - name: Collections x-associatedSchema: $ref: '#/components/schemas/AdminCollection' - name: Currencies description: | A store can use unlimited currencies, and each region must be associated with at least one currency. Currencies are defined within the Medusa backend. Currency API Routes allow admins to list and update currencies. 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' - name: Customers description: | Customers can either be created when they register through the Store APIs, or created by the admin using the Admin APIs. externalDocs: description: How to manage customers url: https://docs.medusajs.com/modules/customers/admin/manage-customers 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' - name: Fulfillment Sets 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 users to authenticate as admins and perform admin functionalities. 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: Order Edits - name: Orders x-associatedSchema: $ref: '#/components/schemas/AdminOrder' - name: Payment Collections x-associatedSchema: $ref: '#/components/schemas/AdminPaymentCollection' - 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' - name: Product 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 store serves customers in. Admins can manage these regions, their providers, and more. 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 example, a webshop or a mobile app. Admins can manage sales channels and the products available in them. externalDocs: description: How to manage sales channels url: https://docs.medusajs.com/modules/sales-channels/admin/manage x-associatedSchema: $ref: '#/components/schemas/AdminSalesChannel' - name: Shipping Options x-associatedSchema: $ref: '#/components/schemas/AdminShippingOption' - name: Shipping Profiles 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 paths: /admin/api-keys: get: operationId: GetApiKeys summary: List Api Keys description: Retrieve a list of api keys. The api keys can be filtered by fields such as `id`. The api keys 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/api-keys' \ -H 'x-medusa-access-token: {api_token}' 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': $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' post: operationId: PostApiKeys summary: Create Api Key description: Create a api key. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminCreateApiKey' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/api-keys' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "title": "{value}", "type": "{value}" }' tags: - Api Keys responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminApiKeyResponse' '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: createApiKeysWorkflow /admin/api-keys/{id}: get: operationId: GetApiKeysId summary: Get a Api Key description: Retrieve a api key by its ID. You can expand the api key's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The api key'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/api-keys/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Api Keys responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminApiKeyResponse' '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' post: operationId: PostApiKeysId summary: Update a Api Key description: Update a api key's details. x-authenticated: true parameters: - name: id in: path description: The api key'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminUpdateApiKey' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/api-keys/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "title": "{value}" }' tags: - Api Keys responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminApiKeyResponse' '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' delete: operationId: DeleteApiKeysId summary: Delete a Api Key description: Delete a api key. x-authenticated: true parameters: - name: id in: path description: The api key'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/api-keys/{id}' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/api-keys/{id}/revoke: post: operationId: PostApiKeysIdRevoke summary: Add Revokes to Api Key description: Add a list of revokes to a api key. x-authenticated: true parameters: - name: id in: path description: The api key'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminRevokeApiKey' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/api-keys/{id}/revoke' \ -H 'x-medusa-access-token: {api_token}' tags: - Api Keys responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminApiKeyResponse' '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' /admin/api-keys/{id}/sales-channels: post: operationId: PostApiKeysIdSalesChannels summary: Add Sales Channels to Api Key description: Add a list of sales channels to a api key. x-authenticated: true parameters: - name: id in: path description: The api key'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: add: type: array description: The api key's add. items: type: string title: add description: The add's details. remove: type: array description: The api key's remove. items: type: string title: remove description: The remove's details. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/api-keys/{id}/sales-channels' \ -H 'x-medusa-access-token: {api_token}' tags: - Api Keys responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminApiKeyResponse' '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' /admin/campaigns: get: operationId: GetCampaigns summary: List Campaigns description: Retrieve a list of campaigns. The campaigns can be filtered by fields such as `id`. The campaigns 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/campaigns' \ -H 'x-medusa-access-token: {api_token}' 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': $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' post: operationId: PostCampaigns summary: Create Campaign description: Create a campaign. 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: [] requestBody: content: application/json: schema: allOf: - type: object description: SUMMARY required: - name - campaign_identifier - description - budget - starts_at - ends_at properties: name: type: string title: name description: The campaign's name. campaign_identifier: type: string title: campaign_identifier description: The campaign's campaign identifier. description: type: string title: description description: The campaign's description. budget: type: object description: The campaign's budget. required: - type - limit - currency_code properties: type: type: string enum: - spend - usage limit: type: number title: limit description: The budget's limit. currency_code: type: string title: currency_code description: The budget's currency code. starts_at: type: string title: starts_at description: The campaign's starts at. format: date-time ends_at: type: string title: ends_at description: The campaign's ends at. format: date-time promotions: type: array description: The campaign's promotions. items: type: object description: The promotion's promotions. required: - id properties: id: type: string title: id description: The promotion's ID. - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/campaigns' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "name": "Gunner", "campaign_identifier": "{value}", "description": "{value}", "starts_at": "2024-08-24T00:19:14.144Z", "ends_at": "2024-10-01T06:47:50.133Z" }' tags: - Campaigns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCampaignResponse' '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' /admin/campaigns/{id}: get: operationId: GetCampaignsId summary: Get a Campaign description: Retrieve a campaign by its ID. You can expand the campaign's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The campaign'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/campaigns/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Campaigns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCampaignResponse' '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' post: operationId: PostCampaignsId summary: Update a Campaign description: Update a campaign's details. x-authenticated: true parameters: - name: id in: path description: The campaign'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: [] requestBody: content: application/json: schema: allOf: - type: object description: SUMMARY required: - description - starts_at - ends_at properties: name: type: string title: name description: The campaign's name. campaign_identifier: type: string title: campaign_identifier description: The campaign's campaign identifier. description: type: string title: description description: The campaign's description. budget: type: object description: The campaign's budget. required: - limit properties: limit: type: number title: limit description: The budget's limit. starts_at: type: string title: starts_at description: The campaign's starts at. format: date-time ends_at: type: string title: ends_at description: The campaign's ends at. format: date-time promotions: type: array description: The campaign's promotions. items: type: object description: The promotion's promotions. required: - id properties: id: type: string title: id description: The promotion's ID. - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/campaigns/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "description": "{value}", "starts_at": "2024-08-10T14:44:10.530Z", "ends_at": "2024-07-13T17:45:37.462Z" }' tags: - Campaigns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCampaignResponse' '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' delete: operationId: DeleteCampaignsId summary: Delete a Campaign description: Delete a campaign. x-authenticated: true parameters: - name: id in: path description: The campaign'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/campaigns/{id}' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/campaigns/{id}/promotions: post: operationId: PostCampaignsIdPromotions summary: Add Promotions to Campaign description: Add a list of promotions to a campaign. x-authenticated: true parameters: - name: id in: path description: The campaign'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: add: type: array description: The campaign's add. items: type: string title: add description: The add's details. remove: type: array description: The campaign's remove. items: type: string title: remove description: The remove's details. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/campaigns/{id}/promotions' \ -H 'x-medusa-access-token: {api_token}' tags: - Campaigns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCampaignResponse' '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' /admin/claims: get: operationId: GetClaims summary: List Claims description: Retrieve a list of claims. The claims can be filtered by fields such as `id`. The claims 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/claims' \ -H 'x-medusa-access-token: {api_token}' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimListResponse' '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' post: operationId: PostClaims summary: Create Claim description: Create a claim. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostOrderClaimsReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/claims' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "type": "{value}", "order_id": "{value}", "metadata": {} }' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimOrderResponse' '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' /admin/claims/{id}: get: 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' /admin/claims/{id}/cancel: post: operationId: PostClaimsIdCancel summary: Add Cancels to Claim description: Add a list of cancels to a claim. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostCancelClaimReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/claims/{id}/cancel' \ -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' /admin/claims/{id}/claim-items: post: operationId: PostClaimsIdClaimItems summary: Add Claim Items to Claim description: Add a list of claim items to a claim. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostClaimItemsReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/claims/{id}/claim-items' \ -H 'x-medusa-access-token: {api_token}' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimPreviewResponse' '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: orderClaimItemWorkflow /admin/claims/{id}/claim-items/{action_id}: post: operationId: PostClaimsIdClaimItemsAction_id summary: Add Claim Items to Claim description: Add a list of claim items to a claim. x-authenticated: true parameters: - name: id in: path description: The claim's ID. required: true schema: type: string - name: action_id in: path description: The claim'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostClaimsItemsActionReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/claims/{id}/claim-items/{action_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimPreviewResponse' '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: updateClaimItemWorkflow delete: operationId: DeleteClaimsIdClaimItemsAction_id summary: Remove Claim Items from Claim description: Remove a list of claim items from a claim. This doesn't delete the Claim Item, only the association between the Claim Item and the claim. x-authenticated: true parameters: - name: id in: path description: The claim's ID. required: true schema: type: string - name: action_id in: path description: The claim'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/claims/{id}/claim-items/{action_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimPreviewResponse' '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: removeItemClaimActionWorkflow /admin/claims/{id}/inbound/items: post: operationId: PostClaimsIdInboundItems summary: Add Items to Claim description: Add a list of items to a claim. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostReturnsRequestItemsReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/claims/{id}/inbound/items' \ -H 'x-medusa-access-token: {api_token}' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimReturnPreviewResponse' '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: orderClaimRequestItemReturnWorkflow /admin/claims/{id}/inbound/items/{action_id}: post: operationId: PostClaimsIdInboundItemsAction_id summary: Add Items to Claim description: Add a list of items to a claim. x-authenticated: true parameters: - name: id in: path description: The claim's ID. required: true schema: type: string - name: action_id in: path description: The claim'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostReturnsRequestItemsActionReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/claims/{id}/inbound/items/{action_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimReturnPreviewResponse' '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: updateRequestItemReturnWorkflow delete: operationId: DeleteClaimsIdInboundItemsAction_id summary: Remove Items from Claim description: Remove a list of items from a claim. This doesn't delete the Item, only the association between the Item and the claim. x-authenticated: true parameters: - name: id in: path description: The claim's ID. required: true schema: type: string - name: action_id in: path description: The claim'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/claims/{id}/inbound/items/{action_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimReturnPreviewResponse' '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 /admin/claims/{id}/inbound/shipping-method: post: operationId: PostClaimsIdInboundShippingMethod summary: Add Shipping Methods to Claim description: Add a list of shipping methods to a claim. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostReturnsShippingReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/claims/{id}/inbound/shipping-method' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "shipping_option_id": "{value}" }' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimReturnPreviewResponse' '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: createClaimShippingMethodWorkflow /admin/claims/{id}/inbound/shipping-method/{action_id}: post: operationId: PostClaimsIdInboundShippingMethodAction_id summary: Add Shipping Methods to Claim description: Add a list of shipping methods to a claim. x-authenticated: true parameters: - name: id in: path description: The claim's ID. required: true schema: type: string - name: action_id in: path description: The claim'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostClaimsShippingActionReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/claims/{id}/inbound/shipping-method/{action_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimPreviewResponse' '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: updateReturnShippingMethodWorkflow delete: operationId: DeleteClaimsIdInboundShippingMethodAction_id summary: Remove Shipping Methods from Claim description: Remove a list of shipping methods from a claim. This doesn't delete the Shipping Method, only the association between the Shipping Method and the claim. x-authenticated: true parameters: - name: id in: path description: The claim's ID. required: true schema: type: string - name: action_id in: path description: The claim'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/claims/{id}/inbound/shipping-method/{action_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimReturnPreviewResponse' '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: removeClaimShippingMethodWorkflow /admin/claims/{id}/outbound/items: post: operationId: PostClaimsIdOutboundItems summary: Add Items to Claim description: Add a list of items to a claim. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostClaimsAddItemsReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/claims/{id}/outbound/items' \ -H 'x-medusa-access-token: {api_token}' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimPreviewResponse' '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: orderClaimAddNewItemWorkflow /admin/claims/{id}/outbound/items/{action_id}: post: operationId: PostClaimsIdOutboundItemsAction_id summary: Add Items to Claim description: Add a list of items to a claim. x-authenticated: true parameters: - name: id in: path description: The claim's ID. required: true schema: type: string - name: action_id in: path description: The claim'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostClaimsItemsActionReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/claims/{id}/outbound/items/{action_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimPreviewResponse' '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: updateClaimAddItemWorkflow delete: operationId: DeleteClaimsIdOutboundItemsAction_id summary: Remove Items from Claim description: Remove a list of items from a claim. This doesn't delete the Item, only the association between the Item and the claim. x-authenticated: true parameters: - name: id in: path description: The claim's ID. required: true schema: type: string - name: action_id in: path description: The claim'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/claims/{id}/outbound/items/{action_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimPreviewResponse' '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: removeAddItemClaimActionWorkflow /admin/claims/{id}/outbound/shipping-method: post: operationId: PostClaimsIdOutboundShippingMethod summary: Add Shipping Methods to Claim description: Add a list of shipping methods to a claim. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostClaimsShippingReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/claims/{id}/outbound/shipping-method' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "shipping_option_id": "{value}" }' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimPreviewResponse' '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: createClaimShippingMethodWorkflow /admin/claims/{id}/outbound/shipping-method/{action_id}: post: operationId: PostClaimsIdOutboundShippingMethodAction_id summary: Add Shipping Methods to Claim description: Add a list of shipping methods to a claim. x-authenticated: true parameters: - name: id in: path description: The claim's ID. required: true schema: type: string - name: action_id in: path description: The claim'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostClaimsShippingActionReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/claims/{id}/outbound/shipping-method/{action_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimPreviewResponse' '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: updateClaimShippingMethodWorkflow delete: operationId: DeleteClaimsIdOutboundShippingMethodAction_id summary: Remove Shipping Methods from Claim description: Remove a list of shipping methods from a claim. This doesn't delete the Shipping Method, only the association between the Shipping Method and the claim. x-authenticated: true parameters: - name: id in: path description: The claim's ID. required: true schema: type: string - name: action_id in: path description: The claim'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/claims/{id}/outbound/shipping-method/{action_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimPreviewResponse' '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: removeClaimShippingMethodWorkflow /admin/claims/{id}/request: post: operationId: PostClaimsIdRequest summary: Add Requests to Claim description: Add a list of requests to a claim. 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 -X POST '{backend_url}/admin/claims/{id}/request' \ -H 'x-medusa-access-token: {api_token}' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimRequestResponse' '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' requestBody: content: application/json: schema: {} x-workflow: confirmClaimRequestWorkflow delete: operationId: DeleteClaimsIdRequest summary: Remove Requests from Claim description: Remove a list of requests from a claim. This doesn't delete the Request, only the association between the Request and the claim. 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 -X DELETE '{backend_url}/admin/claims/{id}/request' \ -H 'x-medusa-access-token: {api_token}' tags: - Claims responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminClaimDeleteResponse' '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' /admin/collections: get: operationId: GetCollections summary: List Collections description: Retrieve a list of collections. The collections can be filtered by fields such as `id`. The collections 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/collections' \ -H 'x-medusa-access-token: {api_token}' tags: - Collections responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCollectionListResponse' '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' post: operationId: PostCollections summary: Create Collection description: Create a collection. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminCreateCollection' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/collections' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "title": "{value}", "metadata": {} }' tags: - Collections responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCollectionResponse' '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: createCollectionsWorkflow /admin/collections/{id}: get: operationId: GetCollectionsId summary: Get a Collection description: Retrieve a collection by its ID. You can expand the collection's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The collection'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/collections/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Collections responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCollectionResponse' '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' post: operationId: PostCollectionsId summary: Update a Collection description: Update a collection's details. x-authenticated: true parameters: - name: id in: path description: The collection'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminUpdateCollection' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/collections/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "metadata": {} }' tags: - Collections responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCollectionResponse' '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' delete: operationId: DeleteCollectionsId summary: Delete a Collection description: Delete a collection. x-authenticated: true parameters: - name: id in: path description: The collection'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/collections/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Collections responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCollectionDeleteResponse' '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' /admin/collections/{id}/products: post: operationId: PostCollectionsIdProducts summary: Add Products to Collection description: Add a list of products to a collection. x-authenticated: true parameters: - name: id in: path description: The collection'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: add: type: array description: The collection's add. items: type: string title: add description: The add's details. remove: type: array description: The collection's remove. items: type: string title: remove description: The remove's details. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/collections/{id}/products' \ -H 'x-medusa-access-token: {api_token}' tags: - Collections responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCollectionResponse' '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' /admin/currencies: get: operationId: GetCurrencies summary: List Currencies description: Retrieve a list of currencies. The currencies can be filtered by fields such as `id`. The currencies 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/currencies' \ -H 'x-medusa-access-token: {api_token}' tags: - Currencies responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCurrencyListResponse' '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' /admin/currencies/{code}: get: operationId: GetCurrenciesCode summary: Get a Currency description: Retrieve a currency by its ID. You can expand the currency's relations or select the fields that should be returned. x-authenticated: true parameters: - name: code in: path description: The currency's code. 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/currencies/{code}' \ -H 'x-medusa-access-token: {api_token}' tags: - Currencies responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCurrencyResponse' '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' /admin/customer-groups: get: operationId: GetCustomerGroups summary: List Customer Groups description: Retrieve a list of customer groups. The customer groups can be filtered by fields such as `id`. The customer groups 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/customer-groups' \ -H 'x-medusa-access-token: {api_token}' 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': $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' post: operationId: PostCustomerGroups summary: Create Customer Group description: Create a customer group. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminCreateCustomerGroup' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/customer-groups' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "name": "Solon", "metadata": {} }' tags: - Customer Groups responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCustomerGroupResponse' '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' /admin/customer-groups/{id}: get: operationId: GetCustomerGroupsId summary: Get a Customer Group description: Retrieve a customer group by its ID. You can expand the customer group's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The customer group'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/customer-groups/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Customer Groups responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCustomerGroupResponse' '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' post: operationId: PostCustomerGroupsId summary: Update a Customer Group description: Update a customer group's details. x-authenticated: true parameters: - name: id in: path description: The customer group'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminUpdateCustomerGroup' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/customer-groups/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "name": "Corbin", "metadata": {} }' tags: - Customer Groups responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCustomerGroupResponse' '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' delete: operationId: DeleteCustomerGroupsId summary: Delete a Customer Group description: Delete a customer group. x-authenticated: true parameters: - name: id in: path description: The customer group'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/customer-groups/{id}' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/customer-groups/{id}/customers: post: operationId: PostCustomerGroupsIdCustomers summary: Add Customers to Customer Group description: Add a list of customers to a customer group. x-authenticated: true parameters: - name: id in: path description: The customer group'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: add: type: array description: The customer group's add. items: type: string title: add description: The add's details. remove: type: array description: The customer group's remove. items: type: string title: remove description: The remove's details. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/customer-groups/{id}/customers' \ -H 'x-medusa-access-token: {api_token}' tags: - Customer Groups responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCustomerGroupResponse' '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' /admin/customers: get: operationId: GetCustomers summary: List Customers description: Retrieve a list of customers. The customers can be filtered by fields such as `id`. The customers 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/customers' \ -H 'x-medusa-access-token: {api_token}' 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: - customers properties: customers: $ref: '#/components/schemas/AdminCustomer' '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' post: operationId: PostCustomers summary: Create Customer description: Create a customer. 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: [] requestBody: content: application/json: schema: allOf: - type: object description: SUMMARY required: - email - company_name - first_name - last_name - phone - metadata properties: email: type: string title: email description: The customer's email. format: email company_name: type: string title: company_name description: The customer's company name. first_name: type: string title: first_name description: The customer's first name. last_name: type: string title: last_name description: The customer's last name. phone: type: string title: phone description: The customer's phone. metadata: type: object description: The customer's metadata. - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/customers' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "email": "Tomas.Toy16@yahoo.com", "company_name": "{value}", "first_name": "{value}", "last_name": "{value}", "phone": "{value}", "metadata": {} }' tags: - Customers responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCustomerResponse' '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' /admin/customers/{id}: get: operationId: GetCustomersId summary: Get a Customer description: Retrieve a customer by its ID. You can expand the customer's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The customer'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/customers/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Customers responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCustomerResponse' '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' post: operationId: PostCustomersId summary: Update a Customer description: Update a customer's details. x-authenticated: true parameters: - name: id in: path description: The customer'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: [] requestBody: content: application/json: schema: allOf: - type: object description: SUMMARY required: - email - company_name - first_name - last_name - phone - metadata properties: email: type: string title: email description: The customer's email. format: email company_name: type: string title: company_name description: The customer's company name. first_name: type: string title: first_name description: The customer's first name. last_name: type: string title: last_name description: The customer's last name. phone: type: string title: phone description: The customer's phone. metadata: type: object description: The customer's metadata. - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/customers/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "email": "Daren_Rodriguez-Rutherford93@gmail.com", "company_name": "{value}", "first_name": "{value}", "last_name": "{value}", "phone": "{value}", "metadata": {} }' tags: - Customers responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCustomerResponse' '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' delete: operationId: DeleteCustomersId summary: Delete a Customer description: Delete a customer. x-authenticated: true parameters: - name: id in: path description: The customer'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/customers/{id}' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/customers/{id}/addresses: get: operationId: GetCustomersIdAddresses summary: List Addresses description: Retrieve a list of addresses in a customer. The addresses can be filtered by fields like FILTER FIELDS. The addresses can also be paginated. x-authenticated: true parameters: - name: id in: path description: The customer'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/customers/{id}/addresses' \ -H 'x-medusa-access-token: {api_token}' 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': $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' post: operationId: PostCustomersIdAddresses summary: Add Addresses to Customer description: Add a list of addresses to a customer. x-authenticated: true parameters: - name: id in: path description: The customer'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: [] requestBody: content: application/json: schema: allOf: - type: object description: SUMMARY required: - address_name - company - first_name - last_name - address_1 - address_2 - city - country_code - province - postal_code - phone - metadata properties: address_name: type: string title: address_name description: The customer's address name. is_default_shipping: type: boolean title: is_default_shipping description: The customer's is default shipping. is_default_billing: type: boolean title: is_default_billing description: The customer's is default billing. company: type: string title: company description: The customer's company. first_name: type: string title: first_name description: The customer's first name. last_name: type: string title: last_name description: The customer's last name. address_1: type: string title: address_1 description: The customer's address 1. address_2: type: string title: address_2 description: The customer's address 2. city: type: string title: city description: The customer's city. country_code: type: string title: country_code description: The customer's country code. province: type: string title: province description: The customer's province. postal_code: type: string title: postal_code description: The customer's postal code. phone: type: string title: phone description: The customer's phone. metadata: type: object description: The customer's metadata. - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/customers/{id}/addresses' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "address_name": "{value}", "company": "{value}", "first_name": "{value}", "last_name": "{value}", "address_1": "{value}", "address_2": "{value}", "city": "{value}", "country_code": "{value}", "province": "{value}", "postal_code": "{value}", "phone": "{value}", "metadata": {} }' tags: - Customers responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCustomerResponse' '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' /admin/customers/{id}/addresses/{address_id}: get: operationId: GetCustomersIdAddressesAddress_id summary: List Addresses description: Retrieve a list of addresses in a customer. The addresses can be filtered by fields like FILTER FIELDS. The addresses can also be paginated. x-authenticated: true parameters: - name: id in: path description: The customer's ID. required: true schema: type: string - name: address_id in: path description: The customer's address 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/customers/{id}/addresses/{address_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Customers responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCustomerAddressResponse' '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' post: operationId: PostCustomersIdAddressesAddress_id summary: Add Addresses to Customer description: Add a list of addresses to a customer. x-authenticated: true parameters: - name: id in: path description: The customer's ID. required: true schema: type: string - name: address_id in: path description: The customer's address 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: allOf: - type: object description: SUMMARY required: - address_name - company - first_name - last_name - address_1 - address_2 - city - country_code - province - postal_code - phone - metadata properties: address_name: type: string title: address_name description: The customer's address name. is_default_shipping: type: boolean title: is_default_shipping description: The customer's is default shipping. is_default_billing: type: boolean title: is_default_billing description: The customer's is default billing. company: type: string title: company description: The customer's company. first_name: type: string title: first_name description: The customer's first name. last_name: type: string title: last_name description: The customer's last name. address_1: type: string title: address_1 description: The customer's address 1. address_2: type: string title: address_2 description: The customer's address 2. city: type: string title: city description: The customer's city. country_code: type: string title: country_code description: The customer's country code. province: type: string title: province description: The customer's province. postal_code: type: string title: postal_code description: The customer's postal code. phone: type: string title: phone description: The customer's phone. metadata: type: object description: The customer's metadata. - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/customers/{id}/addresses/{address_id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "address_name": "{value}", "company": "{value}", "first_name": "{value}", "last_name": "{value}", "address_1": "{value}", "address_2": "{value}", "city": "{value}", "country_code": "{value}", "province": "{value}", "postal_code": "{value}", "phone": "{value}", "metadata": {} }' tags: - Customers responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminCustomerResponse' '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' delete: operationId: DeleteCustomersIdAddressesAddress_id summary: Remove Addresses from Customer description: Remove a list of addresses from a customer. This doesn't delete the Address, only the association between the Address and the customer. x-authenticated: true parameters: - name: id in: path description: The customer's ID. required: true schema: type: string - name: address_id in: path description: The customer's address 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/customers/{id}/addresses/{address_id}' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/draft-orders: get: operationId: GetDraftOrders summary: List Draft Orders description: Retrieve a list of draft orders. The draft orders can be filtered by fields such as `id`. The draft orders 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/draft-orders' \ -H 'x-medusa-access-token: {api_token}' 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': $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' post: operationId: PostDraftOrders summary: Create Draft Order description: Create a draft order. 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: [] requestBody: content: application/json: schema: allOf: - type: object description: SUMMARY required: - sales_channel_id - email - customer_id - region_id - currency_code - shipping_methods - metadata properties: status: type: boolean title: status description: The draft order's status. sales_channel_id: type: string title: sales_channel_id description: The draft order's sales channel id. email: type: string title: email description: The draft order's email. format: email customer_id: type: string title: customer_id description: The draft order's customer id. billing_address: type: object description: The draft order's billing address. required: - first_name - last_name - phone - company - address_1 - address_2 - city - country_code - province - postal_code - metadata properties: first_name: type: string title: first_name description: The billing address's first name. last_name: type: string title: last_name description: The billing address's last name. phone: type: string title: phone description: The billing address's phone. company: type: string title: company description: The billing address's company. address_1: type: string title: address_1 description: The billing address's address 1. address_2: type: string title: address_2 description: The billing address's address 2. city: type: string title: city description: The billing address's city. country_code: type: string title: country_code description: The billing address's country code. province: type: string title: province description: The billing address's province. postal_code: type: string title: postal_code description: The billing address's postal code. metadata: type: object description: The billing address's metadata. shipping_address: type: object description: The draft order's shipping address. required: - first_name - last_name - phone - company - address_1 - address_2 - city - country_code - province - postal_code - metadata properties: first_name: type: string title: first_name description: The shipping address's first name. last_name: type: string title: last_name description: The shipping address's last name. phone: type: string title: phone description: The shipping address's phone. company: type: string title: company description: The shipping address's company. address_1: type: string title: address_1 description: The shipping address's address 1. address_2: type: string title: address_2 description: The shipping address's address 2. city: type: string title: city description: The shipping address's city. country_code: type: string title: country_code description: The shipping address's country code. province: type: string title: province description: The shipping address's province. postal_code: type: string title: postal_code description: The shipping address's postal code. metadata: type: object description: The shipping address's metadata. items: type: array description: The draft order's items. items: type: object description: The item's items. required: - title - sku - barcode - variant_id - unit_price - quantity - metadata properties: title: type: string title: title description: The item's title. sku: type: string title: sku description: The item's sku. barcode: type: string title: barcode description: The item's barcode. variant_id: type: string title: variant_id description: The item's variant id. unit_price: oneOf: - type: string title: unit_price description: The item's unit price. - type: number title: unit_price description: The item's unit price. - type: object description: The item's unit price. required: - value - precision properties: value: type: string title: value description: The unit price's value. precision: type: number title: precision description: The unit price's precision. quantity: type: number title: quantity description: The item's quantity. metadata: type: object description: The item's metadata. region_id: type: string title: region_id description: The draft order's region id. promo_codes: type: array description: The draft order's promo codes. items: type: string title: promo_codes description: The promo code's promo codes. currency_code: type: string title: currency_code description: The draft order's currency code. no_notification_order: type: boolean title: no_notification_order description: The draft order's no notification order. shipping_methods: type: array description: The draft order's shipping methods. items: type: object description: The shipping method's shipping methods. required: - shipping_method_id - order_id - name - option_id - amount properties: shipping_method_id: type: string title: shipping_method_id description: The shipping method's shipping method id. order_id: type: string title: order_id description: The shipping method's order id. name: type: string title: name description: The shipping method's name. option_id: type: string title: option_id description: The shipping method's option id. data: type: object description: The shipping method's data. amount: oneOf: - type: string title: amount description: The shipping method's amount. - type: number title: amount description: The shipping method's amount. - type: object description: The shipping method's amount. required: - value - precision properties: value: type: string title: value description: The amount's value. precision: type: number title: precision description: The amount's precision. metadata: type: object description: The draft order's metadata. - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/draft-orders' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "sales_channel_id": "{value}", "email": "Bartholome.Goodwin90@yahoo.com", "customer_id": "{value}", "region_id": "{value}", "currency_code": "{value}", "shipping_methods": [ { "shipping_method_id": "{value}", "order_id": "{value}", "name": "Cheyanne", "option_id": "{value}" } ], "metadata": {} }' tags: - Draft Orders responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminDraftOrderResponse' '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: createOrdersWorkflow /admin/draft-orders/{id}: get: operationId: GetDraftOrdersId summary: Get a Draft Order description: Retrieve a draft order by its ID. You can expand the draft order's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The draft order'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/draft-orders/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Draft Orders responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminDraftOrderResponse' '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' /admin/exchanges: get: 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' post: operationId: PostExchanges summary: Create Exchange description: Create a exchange. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostOrderExchangesReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/exchanges' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "order_id": "{value}", "metadata": {} }' tags: - Exchanges responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminExchangeOrderResponse' '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' /admin/exchanges/{id}: get: operationId: GetExchangesId summary: Get a Exchange description: Retrieve a exchange by its ID. You can expand the exchange's relations or select the fields that should be returned. 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 '{backend_url}/admin/exchanges/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Exchanges responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminExchangeResponse' '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' /admin/exchanges/{id}/cancel: post: operationId: PostExchangesIdCancel summary: Add Cancels to Exchange description: Add a list of cancels to a 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostCancelExchangeReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/exchanges/{id}/cancel' \ -H 'x-medusa-access-token: {api_token}' tags: - Exchanges responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminExchangeResponse' '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' /admin/exchanges/{id}/inbound/items: post: operationId: PostExchangesIdInboundItems summary: Add Items to Exchange description: Add a list of items to a 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostExchangesReturnRequestItemsReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/exchanges/{id}/inbound/items' \ -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: orderExchangeRequestItemReturnWorkflow /admin/exchanges/{id}/inbound/items/{action_id}: post: operationId: PostExchangesIdInboundItemsAction_id summary: Add Items to Exchange description: Add a list of items to a 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostExchangesRequestItemsReturnActionReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{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: updateRequestItemReturnWorkflow delete: 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 /admin/exchanges/{id}/inbound/shipping-method: post: operationId: PostExchangesIdInboundShippingMethod summary: Add Shipping Methods to Exchange description: Add a list of shipping methods to a 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostReturnsShippingReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/exchanges/{id}/inbound/shipping-method' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "shipping_option_id": "{value}" }' 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: createExchangeShippingMethodWorkflow /admin/exchanges/{id}/inbound/shipping-method/{action_id}: post: operationId: PostExchangesIdInboundShippingMethodAction_id summary: Add Shipping Methods to Exchange description: Add a list of shipping methods to a 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostExchangesShippingActionReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{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/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: updateReturnShippingMethodWorkflow delete: 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 /admin/exchanges/{id}/outbound/items: post: operationId: PostExchangesIdOutboundItems summary: Add Items to Exchange description: Add a list of items to a 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostExchangesAddItemsReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/exchanges/{id}/outbound/items' \ -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: orderExchangeAddNewItemWorkflow /admin/exchanges/{id}/outbound/items/{action_id}: post: operationId: PostExchangesIdOutboundItemsAction_id summary: Add Items to Exchange description: Add a list of items to a 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostExchangesItemsActionReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{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: updateExchangeAddItemWorkflow delete: 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 /admin/exchanges/{id}/outbound/shipping-method: post: operationId: PostExchangesIdOutboundShippingMethod summary: Add Shipping Methods to Exchange description: Add a list of shipping methods to a 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostExchangesShippingReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/exchanges/{id}/outbound/shipping-method' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "shipping_option_id": "{value}" }' 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: createExchangeShippingMethodWorkflow /admin/exchanges/{id}/outbound/shipping-method/{action_id}: post: operationId: PostExchangesIdOutboundShippingMethodAction_id summary: Add Shipping Methods to Exchange description: Add a list of shipping methods to a 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostExchangesShippingActionReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{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: updateExchangeShippingMethodWorkflow delete: 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 /admin/exchanges/{id}/request: post: operationId: PostExchangesIdRequest summary: Add Requests to Exchange description: Add a list of requests to a 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 POST '{backend_url}/admin/exchanges/{id}/request' \ -H 'x-medusa-access-token: {api_token}' tags: - Exchanges responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminExchangeRequestResponse' '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: confirmExchangeRequestWorkflow requestBody: content: application/json: schema: {} delete: 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' /admin/fulfillment-providers: get: operationId: GetFulfillmentProviders summary: List Fulfillment Providers description: Retrieve a list of fulfillment providers. The fulfillment providers can be filtered by fields such as `id`. The fulfillment providers 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 `-`. - name: id in: query required: false schema: oneOf: - type: string title: id description: The fulfillment provider's ID. - type: array description: The fulfillment provider's ID. items: type: string title: id description: The id's ID. - name: is_enabled in: query description: The fulfillment provider's is enabled. required: true schema: type: boolean title: is_enabled description: The fulfillment provider's is enabled. - name: q in: query description: The fulfillment provider's q. required: false schema: type: string title: q description: The fulfillment provider's q. - name: stock_location_id in: query required: false schema: oneOf: - type: string title: stock_location_id description: The fulfillment provider's stock location id. - type: array description: The fulfillment provider's stock location id. items: type: string title: stock_location_id description: The stock location id's details. security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/fulfillment-providers' \ -H 'x-medusa-access-token: {api_token}' tags: - Fulfillment Providers responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminFulfillmentProviderListResponse' '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' /admin/fulfillment-sets/{id}: delete: operationId: DeleteFulfillmentSetsId summary: Delete a Fulfillment Set description: Delete a fulfillment set. x-authenticated: true parameters: - name: id in: path description: The fulfillment set'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/fulfillment-sets/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Fulfillment Sets responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminFulfillmentSetDeleteResponse' '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' /admin/fulfillment-sets/{id}/service-zones: post: operationId: PostFulfillmentSetsIdServiceZones summary: Add Service Zones to Fulfillment Set description: Add a list of service zones to a fulfillment set. x-authenticated: true parameters: - name: id in: path description: The fulfillment set'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - name properties: name: type: string title: name description: The fulfillment set's name. geo_zones: type: array description: The fulfillment set's geo zones. items: oneOf: - type: object description: The geo zone's geo zones. required: - metadata - country_code - type properties: metadata: type: object description: The geo zone's metadata. country_code: type: string title: country_code description: The geo zone's country code. type: type: string title: type description: The geo zone's type. - type: object description: The geo zone's geo zones. required: - metadata - country_code - type - province_code properties: metadata: type: object description: The geo zone's metadata. country_code: type: string title: country_code description: The geo zone's country code. type: type: string title: type description: The geo zone's type. province_code: type: string title: province_code description: The geo zone's province code. - type: object description: The geo zone's geo zones. required: - metadata - country_code - type - province_code - city properties: metadata: type: object description: The geo zone's metadata. country_code: type: string title: country_code description: The geo zone's country code. type: type: string title: type description: The geo zone's type. province_code: type: string title: province_code description: The geo zone's province code. city: type: string title: city description: The geo zone's city. - type: object description: The geo zone's geo zones. required: - metadata - country_code - type - province_code - city - postal_expression properties: metadata: type: object description: The geo zone's metadata. country_code: type: string title: country_code description: The geo zone's country code. type: type: string title: type description: The geo zone's type. province_code: type: string title: province_code description: The geo zone's province code. city: type: string title: city description: The geo zone's city. postal_expression: type: object description: The geo zone's postal expression. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/fulfillment-sets/{id}/service-zones' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "name": "Layla" }' tags: - Fulfillment Sets responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminFulfillmentSetResponse' '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' /admin/fulfillment-sets/{id}/service-zones/{zone_id}: get: operationId: GetFulfillmentSetsIdServiceZonesZone_id summary: List Service Zones description: Retrieve a list of service zones in a fulfillment set. The service zones can be filtered by fields like FILTER FIELDS. The service zones can also be paginated. x-authenticated: true parameters: - name: id in: path description: The fulfillment set's ID. required: true schema: type: string - name: zone_id in: path description: The fulfillment set's zone 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/fulfillment-sets/{id}/service-zones/{zone_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Fulfillment Sets responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminServiceZoneResponse' '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' post: operationId: PostFulfillmentSetsIdServiceZonesZone_id summary: Add Service Zones to Fulfillment Set description: Add a list of service zones to a fulfillment set. x-authenticated: true parameters: - name: id in: path description: The fulfillment set's ID. required: true schema: type: string - name: zone_id in: path description: The fulfillment set's zone 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: type: object description: SUMMARY required: - name properties: name: type: string title: name description: The fulfillment set's name. geo_zones: type: array description: The fulfillment set's geo zones. items: oneOf: - type: object description: The geo zone's geo zones. required: - type - metadata - country_code properties: type: type: string title: type description: The geo zone's type. metadata: type: object description: The geo zone's metadata. country_code: type: string title: country_code description: The geo zone's country code. id: type: string title: id description: The geo zone's ID. - type: object description: The geo zone's geo zones. required: - type - metadata - country_code - province_code properties: type: type: string title: type description: The geo zone's type. metadata: type: object description: The geo zone's metadata. country_code: type: string title: country_code description: The geo zone's country code. province_code: type: string title: province_code description: The geo zone's province code. id: type: string title: id description: The geo zone's ID. - type: object description: The geo zone's geo zones. required: - type - metadata - city - country_code - province_code properties: type: type: string title: type description: The geo zone's type. metadata: type: object description: The geo zone's metadata. city: type: string title: city description: The geo zone's city. country_code: type: string title: country_code description: The geo zone's country code. province_code: type: string title: province_code description: The geo zone's province code. id: type: string title: id description: The geo zone's ID. - type: object description: The geo zone's geo zones. required: - type - metadata - city - country_code - province_code - postal_expression properties: type: type: string title: type description: The geo zone's type. metadata: type: object description: The geo zone's metadata. city: type: string title: city description: The geo zone's city. country_code: type: string title: country_code description: The geo zone's country code. province_code: type: string title: province_code description: The geo zone's province code. postal_expression: type: object description: The geo zone's postal expression. id: type: string title: id description: The geo zone's ID. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/fulfillment-sets/{id}/service-zones/{zone_id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "name": "Elvis" }' tags: - Fulfillment Sets responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminFulfillmentSetResponse' '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' delete: operationId: DeleteFulfillmentSetsIdServiceZonesZone_id summary: Remove Service Zones from Fulfillment Set description: Remove a list of service zones from a fulfillment set. This doesn't delete the Service Zone, only the association between the Service Zone and the fulfillment set. x-authenticated: true parameters: - name: id in: path description: The fulfillment set's ID. required: true schema: type: string - name: zone_id in: path description: The fulfillment set's zone 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/fulfillment-sets/{id}/service-zones/{zone_id}' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/fulfillments: post: operationId: PostFulfillments summary: Create Fulfillment description: Create a fulfillment. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminCreateFulfillment' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/fulfillments' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "location_id": "{value}", "provider_id": "{value}", "delivery_address": { "first_name": "{value}", "last_name": "{value}", "phone": "{value}", "company": "{value}", "address_1": "{value}", "address_2": "{value}", "city": "{value}", "country_code": "{value}", "province": "{value}", "postal_code": "{value}", "metadata": {} }, "items": [ { "title": "{value}", "sku": "{value}", "quantity": 1667318922870784, "barcode": "{value}", "line_item_id": "{value}", "inventory_item_id": "{value}" } ], "labels": [ { "tracking_number": "{value}", "tracking_url": "{value}", "label_url": "{value}" } ], "order": {}, "order_id": "{value}", "shipping_option_id": "{value}", "data": {}, "packed_at": "2024-11-12T18:37:37.122Z", "shipped_at": "2025-04-13T12:39:42.432Z", "delivered_at": "2025-01-29T19:05:57.056Z", "canceled_at": "2025-02-16T02:12:11.763Z", "metadata": {} }' tags: - Fulfillments responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminFulfillmentResponse' '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: createFulfillmentWorkflow /admin/fulfillments/{id}/cancel: post: operationId: PostFulfillmentsIdCancel summary: Add Cancels to Fulfillment description: Add a list of cancels to a fulfillment. x-authenticated: true parameters: - name: id in: path description: The fulfillment'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminCancelFulfillment' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/fulfillments/{id}/cancel' \ -H 'x-medusa-access-token: {api_token}' tags: - Fulfillments responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminFulfillmentResponse' '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' /admin/fulfillments/{id}/shipment: post: operationId: PostFulfillmentsIdShipment summary: Add Shipments to Fulfillment description: Add a list of shipments to a fulfillment. x-authenticated: true parameters: - name: id in: path description: The fulfillment'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminCreateShipment' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/fulfillments/{id}/shipment' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "labels": [ { "tracking_number": "{value}", "tracking_url": "{value}", "label_url": "{value}" } ] }' tags: - Fulfillments responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminFulfillmentResponse' '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' /admin/inventory-items: get: operationId: GetInventoryItems summary: List Inventory Items description: Retrieve a list of inventory items. The inventory items can be filtered by fields such as `id`. The inventory items 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 `-`. - name: q in: query description: The inventory item's q. required: false schema: type: string title: q description: The inventory item's q. - name: id in: query required: false schema: oneOf: - type: string title: id description: The inventory item's ID. - type: array description: The inventory item's ID. items: type: string title: id description: The id's ID. - name: sku in: query required: false schema: oneOf: - type: string title: sku description: The inventory item's sku. - type: array description: The inventory item's sku. items: type: string title: sku description: The sku's details. - name: origin_country in: query required: false schema: oneOf: - type: string title: origin_country description: The inventory item's origin country. - type: array description: The inventory item's origin country. items: type: string title: origin_country description: The origin country's details. - name: mid_code in: query required: false schema: oneOf: - type: string title: mid_code description: The inventory item's mid code. - type: array description: The inventory item's mid code. items: type: string title: mid_code description: The mid code's details. - name: hs_code in: query required: false schema: oneOf: - type: string title: hs_code description: The inventory item's hs code. - type: array description: The inventory item's hs code. items: type: string title: hs_code description: The hs code's details. - name: material in: query required: false schema: oneOf: - type: string title: material description: The inventory item's material. - type: array description: The inventory item's material. items: type: string title: material description: The material's details. - name: requires_shipping in: query description: The inventory item's requires shipping. required: true schema: type: boolean title: requires_shipping description: The inventory item's requires shipping. - name: weight in: query description: The inventory item's weight. required: false schema: description: The inventory item's weight. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} - name: length in: query description: The inventory item's length. required: false schema: description: The inventory item's length. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} - name: height in: query description: The inventory item's height. required: false schema: description: The inventory item's height. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} - name: width in: query description: The inventory item's width. required: false schema: description: The inventory item's width. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} - name: location_levels in: query description: The inventory item's location levels. required: false schema: type: object description: The inventory item's location levels. properties: location_id: oneOf: - type: string title: location_id description: The location level's location id. - type: array description: The location level's location id. items: type: string title: location_id description: The location id's details. - name: $and in: query required: false schema: type: array description: The inventory item's $and. items: type: object title: $and - name: $or in: query required: false schema: type: array description: The inventory item's $or. items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/inventory-items' \ -H 'x-medusa-access-token: {api_token}' 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': $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' post: operationId: PostInventoryItems summary: Create Inventory Item description: Create a inventory item. 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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - sku - hs_code - weight - length - height - width - origin_country - mid_code - material - title - description - thumbnail - metadata properties: sku: type: string title: sku description: The inventory item's sku. hs_code: type: string title: hs_code description: The inventory item's hs code. weight: type: number title: weight description: The inventory item's weight. length: type: number title: length description: The inventory item's length. height: type: number title: height description: The inventory item's height. width: type: number title: width description: The inventory item's width. origin_country: type: string title: origin_country description: The inventory item's origin country. mid_code: type: string title: mid_code description: The inventory item's mid code. material: type: string title: material description: The inventory item's material. title: type: string title: title description: The inventory item's title. description: type: string title: description description: The inventory item's description. requires_shipping: type: boolean title: requires_shipping description: The inventory item's requires shipping. thumbnail: type: string title: thumbnail description: The inventory item's thumbnail. metadata: type: object description: The inventory item's metadata. location_levels: type: array description: The inventory item's location levels. items: type: object description: The location level's location levels. required: - location_id properties: location_id: type: string title: location_id description: The location level's location id. stocked_quantity: type: number title: stocked_quantity description: The location level's stocked quantity. incoming_quantity: type: number title: incoming_quantity description: The location level's incoming quantity. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/inventory-items' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "sku": "{value}", "hs_code": "{value}", "weight": 2857134683324416, "length": 2322256963305472, "height": 8391220613087232, "width": 1297863250280448, "origin_country": "{value}", "mid_code": "{value}", "material": "{value}", "title": "{value}", "description": "{value}", "thumbnail": "{value}", "metadata": {} }' tags: - Inventory Items responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminInventoryItemResponse' '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: createInventoryItemsWorkflow /admin/inventory-items/{id}: get: operationId: GetInventoryItemsId summary: Get a Inventory Item description: Retrieve a inventory item by its ID. You can expand the inventory item's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The inventory item'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/inventory-items/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Inventory Items responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminInventoryItemResponse' '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' post: operationId: PostInventoryItemsId summary: Update a Inventory Item description: Update a inventory item's details. x-authenticated: true parameters: - name: id in: path description: The inventory item'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - sku - hs_code - weight - length - height - width - origin_country - mid_code - material - title - description - thumbnail - metadata properties: sku: type: string title: sku description: The inventory item's sku. hs_code: type: string title: hs_code description: The inventory item's hs code. weight: type: number title: weight description: The inventory item's weight. length: type: number title: length description: The inventory item's length. height: type: number title: height description: The inventory item's height. width: type: number title: width description: The inventory item's width. origin_country: type: string title: origin_country description: The inventory item's origin country. mid_code: type: string title: mid_code description: The inventory item's mid code. material: type: string title: material description: The inventory item's material. title: type: string title: title description: The inventory item's title. description: type: string title: description description: The inventory item's description. requires_shipping: type: boolean title: requires_shipping description: The inventory item's requires shipping. thumbnail: type: string title: thumbnail description: The inventory item's thumbnail. metadata: type: object description: The inventory item's metadata. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/inventory-items/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "sku": "{value}", "hs_code": "{value}", "weight": 8979922215239680, "length": 667491233693696, "height": 6328111551479808, "width": 7175104570064896, "origin_country": "{value}", "mid_code": "{value}", "material": "{value}", "title": "{value}", "description": "{value}", "thumbnail": "{value}", "metadata": {} }' tags: - Inventory Items responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminInventoryItemResponse' '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' delete: operationId: DeleteInventoryItemsId summary: Delete a Inventory Item description: Delete a inventory item. x-authenticated: true parameters: - name: id in: path description: The inventory item'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/inventory-items/{id}' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/inventory-items/{id}/location-levels: get: operationId: GetInventoryItemsIdLocationLevels summary: List Location Levels description: Retrieve a list of location levels in a inventory item. The location levels can be filtered by fields like FILTER FIELDS. The location levels can also be paginated. x-authenticated: true parameters: - name: id in: path description: The inventory item'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 `-`. - name: location_id in: query required: false schema: oneOf: - type: string title: location_id description: The inventory item's location id. - type: array description: The inventory item's location id. items: type: string title: location_id description: The location id's details. - name: $and in: query required: false schema: type: array description: The inventory item's $and. items: type: object title: $and - name: $or in: query required: false schema: type: array description: The inventory item's $or. items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/inventory-items/{id}/location-levels' \ -H 'x-medusa-access-token: {api_token}' 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': $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' post: operationId: PostInventoryItemsIdLocationLevels summary: Add Location Levels to Inventory Item description: Add a list of location levels to a inventory item. x-authenticated: true parameters: - name: id in: path description: The inventory item'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - location_id properties: location_id: type: string title: location_id description: The inventory item's location id. stocked_quantity: type: number title: stocked_quantity description: The inventory item's stocked quantity. incoming_quantity: type: number title: incoming_quantity description: The inventory item's incoming quantity. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/inventory-items/{id}/location-levels' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "location_id": "{value}" }' tags: - Inventory Items responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminInventoryItemResponse' '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' /admin/inventory-items/{id}/location-levels/batch: post: operationId: PostInventoryItemsIdLocationLevelsBatch summary: Add Location Levels to Inventory Item description: Add a list of location levels to a inventory item. x-authenticated: true parameters: - name: id in: path description: The inventory item'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: create: type: array description: The inventory item's create. items: type: object description: The create's details. required: - location_id properties: location_id: type: string title: location_id description: The create's location id. stocked_quantity: type: number title: stocked_quantity description: The create's stocked quantity. incoming_quantity: type: number title: incoming_quantity description: The create's incoming quantity. update: type: array description: The inventory item's update. items: type: object description: The update's details. properties: stocked_quantity: type: number title: stocked_quantity description: The update's stocked quantity. incoming_quantity: type: number title: incoming_quantity description: The update's incoming quantity. delete: type: array description: The inventory item's delete. items: type: string title: delete description: The delete's details. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/inventory-items/{id}/location-levels/batch' \ -H 'x-medusa-access-token: {api_token}' tags: - Inventory Items responses: '200': description: OK content: application/json: schema: type: object description: SUMMARY required: - inventory_item properties: inventory_item: type: object description: The inventory item's details. '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' /admin/inventory-items/{id}/location-levels/{location_id}: post: operationId: PostInventoryItemsIdLocationLevelsLocation_id summary: Add Location Levels to Inventory Item description: Add a list of location levels to a inventory item. x-authenticated: true parameters: - name: id in: path description: The inventory item's ID. required: true schema: type: string - name: location_id in: path description: The inventory item's location 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: type: object description: SUMMARY properties: stocked_quantity: type: number title: stocked_quantity description: The inventory item's stocked quantity. incoming_quantity: type: number title: incoming_quantity description: The inventory item's incoming quantity. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/inventory-items/{id}/location-levels/{location_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Inventory Items responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminInventoryItemResponse' '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' delete: operationId: DeleteInventoryItemsIdLocationLevelsLocation_id summary: Remove Location Levels from Inventory Item description: Remove a list of location levels from a inventory item. This doesn't delete the Location Level, only the association between the Location Level and the inventory item. x-authenticated: true parameters: - name: id in: path description: The inventory item's ID. required: true schema: type: string - name: location_id in: path description: The inventory item's location 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/inventory-items/{id}/location-levels/{location_id}' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/invites: get: operationId: GetInvites summary: List Invites description: Retrieve a list of invites. The invites can be filtered by fields such as `id`. The invites can also be sorted or paginated. x-authenticated: false 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 `-`. - name: q in: query description: The invite's q. required: false schema: type: string title: q description: The invite's q. - name: id in: query required: false schema: oneOf: - type: string title: id description: The invite's ID. - type: array description: The invite's ID. items: type: string title: id description: The id's ID. - name: email in: query required: false schema: oneOf: - type: string title: email description: The invite's email. format: email - type: array description: The invite's email. items: type: string title: email description: The email's details. format: email - name: created_at in: query description: The invite's created at. required: false schema: type: string description: The invite's created at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: created_at - name: updated_at in: query description: The invite's updated at. required: false schema: type: string description: The invite's updated at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: updated_at - name: deleted_at in: query description: The invite's deleted at. required: false schema: type: string description: The invite's deleted at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: deleted_at - name: $and in: query required: false schema: type: array description: The invite's $and. items: type: object title: $and - name: $or in: query required: false schema: type: array description: The invite's $or. items: type: object title: $or x-codeSamples: - lang: Shell label: cURL source: curl '{backend_url}/admin/invites' 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': $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' post: operationId: PostInvites summary: Create Invite description: Create a invite. x-authenticated: false 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 `-`. requestBody: content: application/json: schema: type: object description: SUMMARY required: - email properties: email: type: string title: email description: The invite's email. format: email x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/invites' \ -H 'Content-Type: application/json' \ --data-raw '{ "email": "Whitney_Schultz@gmail.com" }' tags: - Invites responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminInviteResponse' '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' /admin/invites/accept: post: operationId: PostInvitesAccept summary: Create Invite description: Create a invite. x-authenticated: false 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 `-`. requestBody: content: application/json: schema: type: object description: SUMMARY required: - email - first_name - last_name properties: email: type: string title: email description: The invite's email. format: email first_name: type: string title: first_name description: The invite's first name. last_name: type: string title: last_name description: The invite's last name. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/invites/accept' \ -H 'Content-Type: application/json' \ --data-raw '{ "email": "Lila_Zemlak@hotmail.com", "first_name": "{value}", "last_name": "{value}" }' tags: - Invites responses: '200': description: OK content: application/json: schema: oneOf: - type: object description: SUMMARY required: - user properties: user: $ref: '#/components/schemas/AdminUser' - type: object description: SUMMARY required: - message properties: message: type: string title: message description: The invite's message. '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' /admin/invites/{id}: get: operationId: GetInvitesId summary: Get a Invite description: Retrieve a invite by its ID. You can expand the invite's relations or select the fields that should be returned. x-authenticated: false parameters: - name: id in: path description: The invite'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 `-`. x-codeSamples: - lang: Shell label: cURL source: curl '{backend_url}/admin/invites/{id}' tags: - Invites responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminInviteResponse' '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' delete: operationId: DeleteInvitesId summary: Delete a Invite description: Delete a invite. x-authenticated: false parameters: - name: id in: path description: The invite'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 `-`. x-codeSamples: - lang: Shell label: cURL source: curl -X DELETE '{backend_url}/admin/invites/{id}' 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': $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' /admin/invites/{id}/resend: post: operationId: PostInvitesIdResend summary: Add Resends to Invite description: Add a list of resends to a invite. x-authenticated: false parameters: - name: id in: path description: The invite'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 `-`. x-codeSamples: - lang: Shell label: cURL source: curl -X POST '{backend_url}/admin/invites/{id}/resend' tags: - Invites responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminInviteResponse' '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' requestBody: content: application/json: schema: {} /admin/notifications: get: operationId: GetNotifications summary: List Notifications description: Retrieve a list of notifications. The notifications can be filtered by fields such as `id`. The notifications 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 `-`. - name: q in: query description: The notification's q. required: false schema: type: string title: q description: The notification's q. - name: id in: query required: false schema: oneOf: - type: string title: id description: The notification's ID. - type: array description: The notification's ID. items: type: string title: id description: The id's ID. - name: channel in: query required: false schema: oneOf: - type: string title: channel description: The notification's channel. - type: array description: The notification's channel. items: type: string title: channel description: The channel's details. - name: $and in: query required: false schema: type: array description: The notification's $and. items: type: object title: $and - name: $or in: query required: false schema: type: array description: The notification's $or. items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/notifications' \ -H 'x-medusa-access-token: {api_token}' tags: - Notifications responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminNotificationListResponse' '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' /admin/notifications/{id}: get: operationId: GetNotificationsId summary: Get a Notification description: Retrieve a notification by its ID. You can expand the notification's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The notification'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/notifications/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Notifications responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminNotificationResponse' '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' /admin/order-edits: post: operationId: PostOrderEdits summary: Create Order Edit description: Create a order edit. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostOrderEditsReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/order-edits' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "order_id": "{value}", "metadata": {} }' tags: - Order Edits responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminOrderEditResponse' '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' /admin/order-edits/{id}: delete: operationId: DeleteOrderEditsId summary: Delete a Order Edit description: Delete a order edit. x-authenticated: true parameters: - name: id in: path description: The order edit'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/order-edits/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Order Edits responses: '200': description: OK content: application/json: schema: type: object description: SUMMARY required: - id - object - deleted properties: id: type: string title: id description: The order edit's ID. object: type: string title: object description: The order edit's object. deleted: type: boolean title: deleted description: The order edit's deleted. parent: type: object description: The order edit'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' /admin/order-edits/{id}/confirm: post: operationId: PostOrderEditsIdConfirm summary: Add Confirms to Order Edit description: Add a list of confirms to a order edit. x-authenticated: true parameters: - name: id in: path description: The order edit'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 POST '{backend_url}/admin/order-edits/{id}/confirm' \ -H 'x-medusa-access-token: {api_token}' 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: confirmOrderEditRequestWorkflow requestBody: content: application/json: schema: {} /admin/order-edits/{id}/items: post: operationId: PostOrderEditsIdItems 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: 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/AdminPostOrderEditsAddItemsReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/order-edits/{id}/items' \ -H 'x-medusa-access-token: {api_token}' 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: orderEditAddNewItemWorkflow /admin/order-edits/{id}/items/item/{item_id}: post: 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 /admin/order-edits/{id}/items/{action_id}: post: operationId: PostOrderEditsIdItemsAction_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: action_id in: path description: The order edit'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostOrderEditsItemsActionReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/order-edits/{id}/items/{action_id}' \ -H 'x-medusa-access-token: {api_token}' 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: updateOrderEditAddItemWorkflow delete: operationId: DeleteOrderEditsIdItemsAction_id summary: Remove Items from Order Edit description: Remove a list of items from a order edit. This doesn't delete the Item, only the association between the Item and the order edit. x-authenticated: true parameters: - name: id in: path description: The order edit's ID. required: true schema: type: string - name: action_id in: path description: The order edit'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/order-edits/{id}/items/{action_id}' \ -H 'x-medusa-access-token: {api_token}' 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: removeItemOrderEditActionWorkflow /admin/order-edits/{id}/shipping-method: post: operationId: PostOrderEditsIdShippingMethod summary: Add Shipping Methods to Order Edit description: Add a list of shipping methods to a order edit. x-authenticated: true parameters: - name: id in: path description: The order edit'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostOrderEditsShippingReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/order-edits/{id}/shipping-method' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "shipping_option_id": "{value}" }' 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: createOrderEditShippingMethodWorkflow /admin/order-edits/{id}/shipping-method/{action_id}: post: operationId: PostOrderEditsIdShippingMethodAction_id summary: Add Shipping Methods to Order Edit description: Add a list of shipping methods to a order edit. x-authenticated: true parameters: - name: id in: path description: The order edit's ID. required: true schema: type: string - name: action_id in: path description: The order edit'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostOrderEditsShippingActionReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/order-edits/{id}/shipping-method/{action_id}' \ -H 'x-medusa-access-token: {api_token}' 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: updateOrderEditShippingMethodWorkflow delete: operationId: DeleteOrderEditsIdShippingMethodAction_id summary: Remove Shipping Methods from Order Edit description: Remove a list of shipping methods from a order edit. This doesn't delete the Shipping Method, only the association between the Shipping Method and the order edit. x-authenticated: true parameters: - name: id in: path description: The order edit's ID. required: true schema: type: string - name: action_id in: path description: The order edit'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/order-edits/{id}/shipping-method/{action_id}' \ -H 'x-medusa-access-token: {api_token}' 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: removeOrderEditShippingMethodWorkflow /admin/orders: get: operationId: GetOrders summary: List Orders description: Retrieve a list of orders. The orders can be filtered by fields such as `id`. The orders 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/orders' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/orders/{id}: get: operationId: GetOrdersId summary: Get a Order description: Retrieve a order by its ID. You can expand the order's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The order'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/orders/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Orders responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminOrderResponse' '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' post: operationId: PostOrdersId summary: Update a Order description: Update a order's details. x-authenticated: true parameters: - name: id in: path description: The order'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 POST '{backend_url}/admin/orders/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Orders responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminOrderResponse' '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' requestBody: content: application/json: schema: {} /admin/orders/{id}/archive: post: operationId: PostOrdersIdArchive summary: Add Archives to Order description: Add a list of archives to a order. x-authenticated: true parameters: - name: id in: path description: The order'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminArchiveOrder' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/orders/{id}/archive' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "order_id": "{value}" }' tags: - Orders responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminOrderResponse' '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' /admin/orders/{id}/cancel: post: operationId: PostOrdersIdCancel summary: Add Cancels to Order description: Add a list of cancels to a order. x-authenticated: true parameters: - name: id in: path description: The order'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 POST '{backend_url}/admin/orders/{id}/cancel' \ -H 'x-medusa-access-token: {api_token}' tags: - Orders responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminOrderResponse' '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' requestBody: content: application/json: schema: {} /admin/orders/{id}/complete: post: operationId: PostOrdersIdComplete summary: Add Completes to Order description: Add a list of completes to a order. x-authenticated: true parameters: - name: id in: path description: The order'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: [] requestBody: content: application/json: schema: allOf: - type: object description: SUMMARY required: - order_id properties: order_id: type: string title: order_id description: The order's order id. - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/orders/{id}/complete' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "order_id": "{value}" }' tags: - Orders responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminOrderResponse' '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' /admin/orders/{id}/fulfillments: post: operationId: PostOrdersIdFulfillments summary: Add Fulfillments to Order description: Add a list of fulfillments to a order. x-authenticated: true parameters: - name: id in: path description: The order'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: [] requestBody: content: application/json: schema: allOf: - type: object description: SUMMARY required: - items - location_id - metadata properties: items: type: array description: The order's items. items: type: object description: The item's items. required: - id - quantity properties: id: type: string title: id description: The item's ID. quantity: type: number title: quantity description: The item's quantity. location_id: type: string title: location_id description: The order's location id. no_notification: type: boolean title: no_notification description: The order's no notification. metadata: type: object description: The order's metadata. - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/orders/{id}/fulfillments' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "items": [ { "id": "id_YePfQ6PBCBKvmYyreUt2", "quantity": 6623610359775232 } ], "location_id": "{value}", "metadata": {} }' tags: - Orders responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminOrderResponse' '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' /admin/orders/{id}/fulfillments/{fulfillment_id}/cancel: post: operationId: PostOrdersIdFulfillmentsFulfillment_idCancel summary: Add Cancels to Order description: Add a list of cancels to a order. x-authenticated: true parameters: - name: id in: path description: The order's ID. required: true schema: type: string - name: fulfillment_id in: path description: The order's fulfillment 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: allOf: - type: object description: SUMMARY properties: no_notification: type: boolean title: no_notification description: The order's no notification. - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/orders/{id}/fulfillments/{fulfillment_id}/cancel' \ -H 'x-medusa-access-token: {api_token}' tags: - Orders responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminOrderResponse' '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' /admin/orders/{id}/fulfillments/{fulfillment_id}/shipments: post: operationId: PostOrdersIdFulfillmentsFulfillment_idShipments summary: Add Shipments to Order description: Add a list of shipments to a order. x-authenticated: true parameters: - name: id in: path description: The order's ID. required: true schema: type: string - name: fulfillment_id in: path description: The order's fulfillment 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: allOf: - type: object description: SUMMARY required: - items - metadata properties: items: type: array description: The order's items. items: type: object description: The item's items. required: - id - quantity properties: id: type: string title: id description: The item's ID. quantity: type: number title: quantity description: The item's quantity. labels: type: array description: The order's labels. items: type: object description: The label's labels. required: - tracking_number - tracking_url - label_url properties: tracking_number: type: string title: tracking_number description: The label's tracking number. tracking_url: type: string title: tracking_url description: The label's tracking url. label_url: type: string title: label_url description: The label's label url. no_notification: type: boolean title: no_notification description: The order's no notification. metadata: type: object description: The order's metadata. - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/orders/{id}/fulfillments/{fulfillment_id}/shipments' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "items": [ { "id": "id_3QQtl2VvE73c", "quantity": 6772917941567488 } ], "metadata": {} }' tags: - Orders responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminOrderResponse' '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' /admin/orders/{id}/preview: get: operationId: GetOrdersIdPreview summary: List Previews description: Retrieve a list of previews in a order. The previews can be filtered by fields like FILTER FIELDS. The previews can also be paginated. x-authenticated: true parameters: - name: id in: path description: The order'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/orders/{id}/preview' \ -H 'x-medusa-access-token: {api_token}' tags: - Orders responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminOrderPreviewResponse' '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' /admin/payment-collections: post: operationId: PostPaymentCollections summary: Create Payment Collection description: Create a payment collection. 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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - order_id properties: order_id: type: string title: order_id description: The payment collection's order id. amount: type: number title: amount description: The payment collection's amount. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/payment-collections' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "order_id": "{value}" }' tags: - Payment Collections responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPaymentCollectionResponse' '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: createOrderPaymentCollectionWorkflow /admin/payments: get: operationId: GetPayments summary: List Payments description: Retrieve a list of payments. The payments can be filtered by fields such as `id`. The payments 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 `-`. - name: q in: query description: The payment's q. required: false schema: type: string title: q description: The payment's q. - name: id in: query required: false schema: oneOf: - type: string title: id description: The payment's ID. - type: array description: The payment's ID. items: type: string title: id description: The id's ID. - name: payment_session_id in: query required: false schema: oneOf: - type: string title: payment_session_id description: The payment's payment session id. - type: array description: The payment's payment session id. items: type: string title: payment_session_id description: The payment session id's details. - name: created_at in: query description: The payment's created at. required: false schema: type: string description: The payment's created at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: created_at - name: updated_at in: query description: The payment's updated at. required: false schema: type: string description: The payment's updated at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: updated_at - name: deleted_at in: query description: The payment's deleted at. required: false schema: type: string description: The payment's deleted at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: deleted_at - name: $and in: query required: false schema: type: array description: The payment's $and. items: type: object title: $and - name: $or in: query required: false schema: type: array description: The payment's $or. items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/payments' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/payments/payment-providers: get: operationId: GetPaymentsPaymentProviders summary: List Payments description: Retrieve a list of payments. The payments can be filtered by fields such as `id`. The payments 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 `-`. - name: id in: query required: false schema: oneOf: - type: string title: id description: The payment's ID. - type: array description: The payment's ID. items: type: string title: id description: The id's ID. - name: is_enabled in: query description: The payment's is enabled. required: false schema: type: boolean title: is_enabled description: The payment's is enabled. - name: $and in: query required: false schema: type: array description: The payment's $and. items: type: object title: $and - name: $or in: query required: false schema: type: array description: The payment's $or. items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/payments/payment-providers' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/payments/{id}: get: operationId: GetPaymentsId summary: Get a Payment description: Retrieve a payment by its ID. You can expand the payment's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The payment'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/payments/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Payments responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPaymentResponse' '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' /admin/payments/{id}/capture: post: operationId: PostPaymentsIdCapture summary: Add Captures to Payment description: Add a list of captures to a payment. x-authenticated: true parameters: - name: id in: path description: The payment'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: amount: type: number title: amount description: The payment's amount. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/payments/{id}/capture' \ -H 'x-medusa-access-token: {api_token}' tags: - Payments responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPaymentResponse' '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' /admin/payments/{id}/refund: post: operationId: PostPaymentsIdRefund summary: Add Refunds to Payment description: Add a list of refunds to a payment. x-authenticated: true parameters: - name: id in: path description: The payment'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: amount: type: number title: amount description: The payment's amount. refund_reason_id: type: string title: refund_reason_id description: The payment's refund reason id. note: type: string title: note description: The payment's note. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/payments/{id}/refund' \ -H 'x-medusa-access-token: {api_token}' tags: - Payments responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPaymentResponse' '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' /admin/price-lists: get: operationId: GetPriceLists summary: List Price Lists description: Retrieve a list of price lists. The price lists can be filtered by fields such as `id`. The price lists 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/price-lists' \ -H 'x-medusa-access-token: {api_token}' tags: - Price Lists responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPriceListListResponse' '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' post: operationId: PostPriceLists summary: Create Price List description: Create a price list. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminCreatePriceList' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/price-lists' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "title": "{value}", "description": "{value}", "starts_at": "{value}", "ends_at": "{value}" }' tags: - Price Lists responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPriceListResponse' '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' /admin/price-lists/{id}: get: operationId: GetPriceListsId summary: Get a Price List description: Retrieve a price list by its ID. You can expand the price list's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The price list'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/price-lists/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Price Lists responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPriceListResponse' '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' post: operationId: PostPriceListsId summary: Update a Price List description: Update a price list's details. x-authenticated: true parameters: - name: id in: path description: The price list'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminUpdatePriceList' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/price-lists/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "description": "{value}", "starts_at": "{value}", "ends_at": "{value}" }' tags: - Price Lists responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPriceListResponse' '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' delete: operationId: DeletePriceListsId summary: Delete a Price List description: Delete a price list. x-authenticated: true parameters: - name: id in: path description: The price list'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/price-lists/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Price Lists responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPriceListDeleteResponse' '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' /admin/price-lists/{id}/prices/batch: post: operationId: PostPriceListsIdPricesBatch summary: Add Prices to Price List description: Add a list of prices to a price list. x-authenticated: true parameters: - name: id in: path description: The price list'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: create: type: array description: The price list's create. items: type: object description: The create's details. required: - currency_code - amount - variant_id - min_quantity - max_quantity properties: currency_code: type: string title: currency_code description: The create's currency code. amount: type: number title: amount description: The create's amount. variant_id: type: string title: variant_id description: The create's variant id. min_quantity: type: number title: min_quantity description: The create's min quantity. max_quantity: type: number title: max_quantity description: The create's max quantity. rules: type: object description: The create's rules. update: type: array description: The price list's update. items: type: object description: The update's details. required: - id - variant_id - min_quantity - max_quantity properties: id: type: string title: id description: The update's ID. currency_code: type: string title: currency_code description: The update's currency code. amount: type: number title: amount description: The update's amount. variant_id: type: string title: variant_id description: The update's variant id. min_quantity: type: number title: min_quantity description: The update's min quantity. max_quantity: type: number title: max_quantity description: The update's max quantity. rules: type: object description: The update's rules. delete: type: array description: The price list's delete. items: type: string title: delete description: The delete's details. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/price-lists/{id}/prices/batch' \ -H 'x-medusa-access-token: {api_token}' tags: - Price Lists responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPriceListBatchResponse' '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' /admin/price-lists/{id}/products: post: operationId: PostPriceListsIdProducts summary: Add Products to Price List description: Add a list of products to a price list. x-authenticated: true parameters: - name: id in: path description: The price list'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: add: type: array description: The price list's add. items: type: string title: add description: The add's details. remove: type: array description: The price list's remove. items: type: string title: remove description: The remove's details. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/price-lists/{id}/products' \ -H 'x-medusa-access-token: {api_token}' tags: - Price Lists responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPriceListResponse' '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' /admin/price-preferences: get: operationId: GetPricePreferences summary: List Price Preferences description: Retrieve a list of price preferences. The price preferences can be filtered by fields such as `id`. The price preferences 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/price-preferences' \ -H 'x-medusa-access-token: {api_token}' tags: - Price Preferences responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPricePreferenceListResponse' '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' post: operationId: PostPricePreferences summary: Create Price Preference description: Create a price preference. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminCreatePricePreference' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/price-preferences' \ -H 'x-medusa-access-token: {api_token}' tags: - Price Preferences responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPricePreferenceResponse' '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' /admin/price-preferences/{id}: get: operationId: GetPricePreferencesId summary: Get a Price Preference description: Retrieve a price preference by its ID. You can expand the price preference's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The price preference'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/price-preferences/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Price Preferences responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPricePreferenceResponse' '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' post: operationId: PostPricePreferencesId summary: Update a Price Preference description: Update a price preference's details. x-authenticated: true parameters: - name: id in: path description: The price preference'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminUpdatePricePreference' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/price-preferences/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Price Preferences responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPricePreferenceResponse' '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' delete: operationId: DeletePricePreferencesId summary: Delete a Price Preference description: Delete a price preference. x-authenticated: true parameters: - name: id in: path description: The price preference'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/price-preferences/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Price Preferences responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPricePreferenceDeleteResponse' '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' /admin/product-categories: get: operationId: GetProductCategories summary: List Product Categories description: Retrieve a list of product categories. The product categories can be filtered by fields such as `id`. The product categories 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 `-`. - name: q in: query description: The product category's q. required: false schema: type: string title: q description: The product category's q. - name: id in: query required: false schema: oneOf: - type: string title: id description: The product category's ID. - type: array description: The product category's ID. items: type: string title: id description: The id's ID. - name: description in: query required: false schema: oneOf: - type: string title: description description: The product category's description. - type: array description: The product category's description. items: type: string title: description description: The description's details. - name: handle in: query required: false schema: oneOf: - type: string title: handle description: The product category's handle. - type: array description: The product category's handle. items: type: string title: handle description: The handle's details. - name: parent_category_id in: query required: false schema: oneOf: - type: string title: parent_category_id description: The product category's parent category id. - type: array description: The product category's parent category id. items: type: string title: parent_category_id description: The parent category id's details. - name: include_ancestors_tree in: query description: The product category's include ancestors tree. required: true schema: type: boolean title: include_ancestors_tree description: The product category's include ancestors tree. - name: include_descendants_tree in: query description: The product category's include descendants tree. required: true schema: type: boolean title: include_descendants_tree description: The product category's include descendants tree. - name: is_internal in: query description: The product category's is internal. required: true schema: type: boolean title: is_internal description: The product category's is internal. - name: is_active in: query description: The product category's is active. required: true schema: type: boolean title: is_active description: The product category's is active. - name: created_at in: query description: The product category's created at. required: false schema: type: string description: The product category's created at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: created_at - name: updated_at in: query description: The product category's updated at. required: false schema: type: string description: The product category's updated at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: updated_at - name: deleted_at in: query description: The product category's deleted at. required: false schema: type: string description: The product category's deleted at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: deleted_at - name: $and in: query required: false schema: type: array description: The product category's $and. items: type: object title: $and - name: $or in: query required: false schema: type: array description: The product category's $or. items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/product-categories' \ -H 'x-medusa-access-token: {api_token}' tags: - Product Categories responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductCategoryListResponse' '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' post: operationId: PostProductCategories summary: Create Product Category description: Create a product category. 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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - name - parent_category_id - metadata properties: name: type: string title: name description: The product category's name. description: type: string title: description description: The product category's description. handle: type: string title: handle description: The product category's handle. is_internal: type: boolean title: is_internal description: The product category's is internal. is_active: type: boolean title: is_active description: The product category's is active. parent_category_id: type: string title: parent_category_id description: The product category's parent category id. metadata: type: object description: The product category's metadata. rank: type: number title: rank description: The product category's rank. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/product-categories' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "name": "Vesta", "parent_category_id": "{value}", "metadata": {} }' tags: - Product Categories responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductCategoryResponse' '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: createProductCategoriesWorkflow /admin/product-categories/{id}: get: operationId: GetProductCategoriesId summary: Get a Product Category description: Retrieve a product category by its ID. You can expand the product category's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The product category'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 `-`. - name: include_ancestors_tree in: query description: The product category's include ancestors tree. required: true schema: type: boolean title: include_ancestors_tree description: The product category's include ancestors tree. - name: include_descendants_tree in: query description: The product category's include descendants tree. required: true schema: type: boolean title: include_descendants_tree description: The product category's include descendants tree. security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/product-categories/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Product Categories responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductCategoryResponse' '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' post: operationId: PostProductCategoriesId summary: Update a Product Category description: Update a product category's details. x-authenticated: true parameters: - name: id in: path description: The product category'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - parent_category_id - metadata properties: name: type: string title: name description: The product category's name. description: type: string title: description description: The product category's description. handle: type: string title: handle description: The product category's handle. is_internal: type: boolean title: is_internal description: The product category's is internal. is_active: type: boolean title: is_active description: The product category's is active. parent_category_id: type: string title: parent_category_id description: The product category's parent category id. metadata: type: object description: The product category's metadata. rank: type: number title: rank description: The product category's rank. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/product-categories/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "parent_category_id": "{value}", "metadata": {} }' tags: - Product Categories responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductCategoryResponse' '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' delete: operationId: DeleteProductCategoriesId summary: Delete a Product Category description: Delete a product category. x-authenticated: true parameters: - name: id in: path description: The product category'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/product-categories/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Product Categories responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductCategoryDeleteResponse' '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' /admin/product-categories/{id}/products: post: operationId: PostProductCategoriesIdProducts summary: Add Products to Product Category description: Add a list of products to a product category. x-authenticated: true parameters: - name: id in: path description: The product category'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: add: type: array description: The product category's add. items: type: string title: add description: The add's details. remove: type: array description: The product category's remove. items: type: string title: remove description: The remove's details. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/product-categories/{id}/products' \ -H 'x-medusa-access-token: {api_token}' tags: - Product Categories responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductCategoryResponse' '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' /admin/product-tags: get: operationId: GetProductTags summary: List Product Tags description: Retrieve a list of product tags. The product tags can be filtered by fields such as `id`. The product tags 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 `-`. - name: q in: query description: The product tag's q. required: false schema: type: string title: q description: The product tag's q. - name: id in: query required: false schema: oneOf: - type: string title: id description: The product tag's ID. - type: array description: The product tag's ID. items: type: string title: id description: The id's ID. - name: value in: query required: false schema: oneOf: - type: string title: value description: The product tag's value. - type: array description: The product tag's value. items: type: string title: value description: The value's details. - name: created_at in: query description: The product tag's created at. required: false schema: type: string description: The product tag's created at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: created_at - name: updated_at in: query description: The product tag's updated at. required: false schema: type: string description: The product tag's updated at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: updated_at - name: deleted_at in: query description: The product tag's deleted at. required: false schema: type: string description: The product tag's deleted at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: deleted_at - name: $and in: query required: false schema: type: array description: The product tag's $and. items: type: object title: $and - name: $or in: query required: false schema: type: array description: The product tag's $or. items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/product-tags' \ -H 'x-medusa-access-token: {api_token}' tags: - Product Tags responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductTagListResponse' '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' post: operationId: PostProductTags summary: Create Product Tag description: Create a product tag. 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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - value - metadata properties: value: type: string title: value description: The product tag's value. metadata: type: object description: The product tag's metadata. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/product-tags' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "value": "{value}", "metadata": {} }' tags: - Product Tags responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductTagResponse' '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: createProductTagsWorkflow /admin/product-tags/{id}: get: operationId: GetProductTagsId summary: Get a Product Tag description: Retrieve a product tag by its ID. You can expand the product tag's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The product tag'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/product-tags/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Product Tags responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductTagResponse' '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' post: operationId: PostProductTagsId summary: Update a Product Tag description: Update a product tag's details. x-authenticated: true parameters: - name: id in: path description: The product tag'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - metadata properties: value: type: string title: value description: The product tag's value. metadata: type: object description: The product tag's metadata. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/product-tags/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "metadata": {} }' tags: - Product Tags responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductTagResponse' '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: updateProductTagsWorkflow delete: operationId: DeleteProductTagsId summary: Delete a Product Tag description: Delete a product tag. x-authenticated: true parameters: - name: id in: path description: The product tag'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/product-tags/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Product Tags responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductTagDeleteResponse' '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' /admin/product-types: get: operationId: GetProductTypes summary: List Product Types description: Retrieve a list of product types. The product types can be filtered by fields such as `id`. The product types 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 `-`. - name: q in: query description: The product type's q. required: false schema: type: string title: q description: The product type's q. - name: id in: query required: false schema: oneOf: - type: string title: id description: The product type's ID. - type: array description: The product type's ID. items: type: string title: id description: The id's ID. - name: value in: query required: false schema: oneOf: - type: string title: value description: The product type's value. - type: array description: The product type's value. items: type: string title: value description: The value's details. - name: created_at in: query description: The product type's created at. required: false schema: type: string description: The product type's created at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: created_at - name: updated_at in: query description: The product type's updated at. required: false schema: type: string description: The product type's updated at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: updated_at - name: deleted_at in: query description: The product type's deleted at. required: false schema: type: string description: The product type's deleted at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: deleted_at - name: $and in: query required: false schema: type: array description: The product type's $and. items: type: object title: $and - name: $or in: query required: false schema: type: array description: The product type's $or. items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/product-types' \ -H 'x-medusa-access-token: {api_token}' tags: - Product Types responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductTypeListResponse' '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' post: operationId: PostProductTypes summary: Create Product Type description: Create a product type. 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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - value - metadata properties: value: type: string title: value description: The product type's value. metadata: type: object description: The product type's metadata. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/product-types' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "value": "{value}", "metadata": {} }' tags: - Product Types responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductTypeResponse' '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: createProductTypesWorkflow /admin/product-types/{id}: get: operationId: GetProductTypesId summary: Get a Product Type description: Retrieve a product type by its ID. You can expand the product type's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The product type'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/product-types/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Product Types responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductTypeResponse' '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' post: operationId: PostProductTypesId summary: Update a Product Type description: Update a product type's details. x-authenticated: true parameters: - name: id in: path description: The product type'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - metadata properties: value: type: string title: value description: The product type's value. metadata: type: object description: The product type's metadata. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/product-types/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "metadata": {} }' tags: - Product Types responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductTypeResponse' '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: updateProductTypesWorkflow delete: operationId: DeleteProductTypesId summary: Delete a Product Type description: Delete a product type. x-authenticated: true parameters: - name: id in: path description: The product type'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/product-types/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Product Types responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductTypeDeleteResponse' '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' /admin/product-variants: get: 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' /admin/products: get: operationId: GetProducts summary: List Products description: Retrieve a list of products. The products can be filtered by fields such as `id`. The products 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 `-`. - name: price_list_id in: query required: false schema: oneOf: - type: string title: price_list_id description: The product's price list id. - type: array description: The product's price list id. items: type: string title: price_list_id description: The price list id's details. - name: q in: query description: The product's q. required: false schema: type: string title: q description: The product's q. - name: status in: query required: false schema: oneOf: - type: string title: status description: The product's status. - type: string title: status description: The product's status. - type: string title: status description: The product's status. - type: string title: status description: The product's status. - type: array description: The product's status. items: type: string enum: - draft - proposed - published - rejected - name: sales_channel_id in: query required: false schema: oneOf: - type: string title: sales_channel_id description: The product's sales channel id. - type: array description: The product's sales channel id. items: type: string title: sales_channel_id description: The sales channel id's details. - name: title in: query required: false schema: oneOf: - type: string title: title description: The product's title. - type: array description: The product's title. items: type: string title: title description: The title's details. - name: handle in: query required: false schema: oneOf: - type: string title: handle description: The product's handle. - type: array description: The product's handle. items: type: string title: handle description: The handle's details. - name: id in: query required: false schema: oneOf: - type: string title: id description: The product's ID. - type: array description: The product's ID. items: type: string title: id description: The id's ID. - name: is_giftcard in: query description: The product's is giftcard. required: false schema: type: boolean title: is_giftcard description: The product's is giftcard. - name: tags in: query description: The product's tags. required: false schema: description: The product's tags. properties: value: type: array description: The tag's value. items: type: string title: value description: The value's details. - name: type_id in: query required: false schema: oneOf: - type: string title: type_id description: The product's type id. - type: array description: The product's type id. items: type: string title: type_id description: The type id's details. - name: category_id in: query required: false schema: oneOf: - type: string title: category_id description: The product's category id. - type: array description: The product's category id. items: type: string title: category_id description: The category id's details. - type: object description: The product's category id. properties: $and: type: array description: The category id's $and. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $and's exec. test: type: object description: The $and's test. source: type: string title: source description: The $and's source. global: type: boolean title: global description: The $and's global. ignoreCase: type: boolean title: ignoreCase description: The $and's ignorecase. multiline: type: boolean title: multiline description: The $and's multiline. lastIndex: type: number title: lastIndex description: The $and's lastindex. compile: type: object description: The $and's compile. flags: type: string title: flags description: The $and's flags. sticky: type: boolean title: sticky description: The $and's sticky. unicode: type: boolean title: unicode description: The $and's unicode. dotAll: type: boolean title: dotAll description: The $and's dotall. __@match@1128: type: object description: The $and's @match@1128. __@replace@1130: type: object description: The $and's @replace@1130. __@search@1133: type: object description: The $and's @search@1133. __@split@1135: type: object description: The $and's @split@1135. __@matchAll@1137: type: object description: The $and's @matchall@1137. - type: object description: The $and's details. properties: $and: type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp - type: object description: The $and's details. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp $or: type: array description: The $and's $or. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp - type: object description: The $or's details. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp $eq: oneOf: - type: string title: $eq description: The $and's $eq. - type: object description: The $and's $eq. x-schemaName: RegExp - type: array description: The $and's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp $ne: oneOf: - type: string title: $ne description: The $and's $ne. - type: object description: The $and's $ne. x-schemaName: RegExp $in: type: array description: The $and's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp $nin: type: array description: The $and's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp $not: oneOf: - type: string title: $not description: The $and's $not. - type: object description: The $and's $not. x-schemaName: RegExp - type: object description: The $and's $not. - type: array description: The $and's $not. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp $gt: oneOf: - type: string title: $gt description: The $and's $gt. - type: object description: The $and's $gt. x-schemaName: RegExp $gte: oneOf: - type: string title: $gte description: The $and's $gte. - type: object description: The $and's $gte. x-schemaName: RegExp $lt: oneOf: - type: string title: $lt description: The $and's $lt. - type: object description: The $and's $lt. x-schemaName: RegExp $lte: oneOf: - type: string title: $lte description: The $and's $lte. - type: object description: The $and's $lte. x-schemaName: RegExp $like: type: string title: $like description: The $and's $like. $re: type: string title: $re description: The $and's $re. $ilike: type: string title: $ilike description: The $and's $ilike. $fulltext: type: string title: $fulltext description: The $and's $fulltext. $overlap: type: array description: The $and's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The $and's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The $and's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The $and's $exists. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $and's exec. test: type: object description: The $and's test. source: type: string title: source description: The $and's source. global: type: boolean title: global description: The $and's global. ignoreCase: type: boolean title: ignoreCase description: The $and's ignorecase. multiline: type: boolean title: multiline description: The $and's multiline. lastIndex: type: number title: lastIndex description: The $and's lastindex. compile: type: object description: The $and's compile. flags: type: string title: flags description: The $and's flags. sticky: type: boolean title: sticky description: The $and's sticky. unicode: type: boolean title: unicode description: The $and's unicode. dotAll: type: boolean title: dotAll description: The $and's dotall. __@match@1128: type: object description: The $and's @match@1128. __@replace@1130: type: object description: The $and's @replace@1130. __@search@1133: type: object description: The $and's @search@1133. __@split@1135: type: object description: The $and's @split@1135. __@matchAll@1137: type: object description: The $and's @matchall@1137. $or: type: array description: The category id's $or. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $or's exec. test: type: object description: The $or's test. source: type: string title: source description: The $or's source. global: type: boolean title: global description: The $or's global. ignoreCase: type: boolean title: ignoreCase description: The $or's ignorecase. multiline: type: boolean title: multiline description: The $or's multiline. lastIndex: type: number title: lastIndex description: The $or's lastindex. compile: type: object description: The $or's compile. flags: type: string title: flags description: The $or's flags. sticky: type: boolean title: sticky description: The $or's sticky. unicode: type: boolean title: unicode description: The $or's unicode. dotAll: type: boolean title: dotAll description: The $or's dotall. __@match@1128: type: object description: The $or's @match@1128. __@replace@1130: type: object description: The $or's @replace@1130. __@search@1133: type: object description: The $or's @search@1133. __@split@1135: type: object description: The $or's @split@1135. __@matchAll@1137: type: object description: The $or's @matchall@1137. - type: object description: The $or's details. properties: $and: type: array description: The $or's $and. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp - type: object description: The $and's details. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp $or: type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp - type: object description: The $or's details. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp $eq: oneOf: - type: string title: $eq description: The $or's $eq. - type: object description: The $or's $eq. x-schemaName: RegExp - type: array description: The $or's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp $ne: oneOf: - type: string title: $ne description: The $or's $ne. - type: object description: The $or's $ne. x-schemaName: RegExp $in: type: array description: The $or's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp $nin: type: array description: The $or's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp $not: oneOf: - type: string title: $not description: The $or's $not. - type: object description: The $or's $not. x-schemaName: RegExp - type: object description: The $or's $not. - type: array description: The $or's $not. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp $gt: oneOf: - type: string title: $gt description: The $or's $gt. - type: object description: The $or's $gt. x-schemaName: RegExp $gte: oneOf: - type: string title: $gte description: The $or's $gte. - type: object description: The $or's $gte. x-schemaName: RegExp $lt: oneOf: - type: string title: $lt description: The $or's $lt. - type: object description: The $or's $lt. x-schemaName: RegExp $lte: oneOf: - type: string title: $lte description: The $or's $lte. - type: object description: The $or's $lte. x-schemaName: RegExp $like: type: string title: $like description: The $or's $like. $re: type: string title: $re description: The $or's $re. $ilike: type: string title: $ilike description: The $or's $ilike. $fulltext: type: string title: $fulltext description: The $or's $fulltext. $overlap: type: array description: The $or's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The $or's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The $or's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The $or's $exists. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $or's exec. test: type: object description: The $or's test. source: type: string title: source description: The $or's source. global: type: boolean title: global description: The $or's global. ignoreCase: type: boolean title: ignoreCase description: The $or's ignorecase. multiline: type: boolean title: multiline description: The $or's multiline. lastIndex: type: number title: lastIndex description: The $or's lastindex. compile: type: object description: The $or's compile. flags: type: string title: flags description: The $or's flags. sticky: type: boolean title: sticky description: The $or's sticky. unicode: type: boolean title: unicode description: The $or's unicode. dotAll: type: boolean title: dotAll description: The $or's dotall. __@match@1128: type: object description: The $or's @match@1128. __@replace@1130: type: object description: The $or's @replace@1130. __@search@1133: type: object description: The $or's @search@1133. __@split@1135: type: object description: The $or's @split@1135. __@matchAll@1137: type: object description: The $or's @matchall@1137. $eq: oneOf: - type: string title: $eq description: The category id's $eq. - type: object description: The category id's $eq. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $eq's exec. test: type: object description: The $eq's test. source: type: string title: source description: The $eq's source. global: type: boolean title: global description: The $eq's global. ignoreCase: type: boolean title: ignoreCase description: The $eq's ignorecase. multiline: type: boolean title: multiline description: The $eq's multiline. lastIndex: type: number title: lastIndex description: The $eq's lastindex. compile: type: object description: The $eq's compile. flags: type: string title: flags description: The $eq's flags. sticky: type: boolean title: sticky description: The $eq's sticky. unicode: type: boolean title: unicode description: The $eq's unicode. dotAll: type: boolean title: dotAll description: The $eq's dotall. __@match@1128: type: object description: The $eq's @match@1128. __@replace@1130: type: object description: The $eq's @replace@1130. __@search@1133: type: object description: The $eq's @search@1133. __@split@1135: type: object description: The $eq's @split@1135. __@matchAll@1137: type: object description: The $eq's @matchall@1137. - type: array description: The category id's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $eq's exec. test: type: object description: The $eq's test. source: type: string title: source description: The $eq's source. global: type: boolean title: global description: The $eq's global. ignoreCase: type: boolean title: ignoreCase description: The $eq's ignorecase. multiline: type: boolean title: multiline description: The $eq's multiline. lastIndex: type: number title: lastIndex description: The $eq's lastindex. compile: type: object description: The $eq's compile. flags: type: string title: flags description: The $eq's flags. sticky: type: boolean title: sticky description: The $eq's sticky. unicode: type: boolean title: unicode description: The $eq's unicode. dotAll: type: boolean title: dotAll description: The $eq's dotall. __@match@1128: type: object description: The $eq's @match@1128. __@replace@1130: type: object description: The $eq's @replace@1130. __@search@1133: type: object description: The $eq's @search@1133. __@split@1135: type: object description: The $eq's @split@1135. __@matchAll@1137: type: object description: The $eq's @matchall@1137. $ne: oneOf: - type: string title: $ne description: The category id's $ne. - type: object description: The category id's $ne. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $ne's exec. test: type: object description: The $ne's test. source: type: string title: source description: The $ne's source. global: type: boolean title: global description: The $ne's global. ignoreCase: type: boolean title: ignoreCase description: The $ne's ignorecase. multiline: type: boolean title: multiline description: The $ne's multiline. lastIndex: type: number title: lastIndex description: The $ne's lastindex. compile: type: object description: The $ne's compile. flags: type: string title: flags description: The $ne's flags. sticky: type: boolean title: sticky description: The $ne's sticky. unicode: type: boolean title: unicode description: The $ne's unicode. dotAll: type: boolean title: dotAll description: The $ne's dotall. __@match@1128: type: object description: The $ne's @match@1128. __@replace@1130: type: object description: The $ne's @replace@1130. __@search@1133: type: object description: The $ne's @search@1133. __@split@1135: type: object description: The $ne's @split@1135. __@matchAll@1137: type: object description: The $ne's @matchall@1137. $in: type: array description: The category id's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $in's exec. test: type: object description: The $in's test. source: type: string title: source description: The $in's source. global: type: boolean title: global description: The $in's global. ignoreCase: type: boolean title: ignoreCase description: The $in's ignorecase. multiline: type: boolean title: multiline description: The $in's multiline. lastIndex: type: number title: lastIndex description: The $in's lastindex. compile: type: object description: The $in's compile. flags: type: string title: flags description: The $in's flags. sticky: type: boolean title: sticky description: The $in's sticky. unicode: type: boolean title: unicode description: The $in's unicode. dotAll: type: boolean title: dotAll description: The $in's dotall. __@match@1128: type: object description: The $in's @match@1128. __@replace@1130: type: object description: The $in's @replace@1130. __@search@1133: type: object description: The $in's @search@1133. __@split@1135: type: object description: The $in's @split@1135. __@matchAll@1137: type: object description: The $in's @matchall@1137. $nin: type: array description: The category id's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $nin's exec. test: type: object description: The $nin's test. source: type: string title: source description: The $nin's source. global: type: boolean title: global description: The $nin's global. ignoreCase: type: boolean title: ignoreCase description: The $nin's ignorecase. multiline: type: boolean title: multiline description: The $nin's multiline. lastIndex: type: number title: lastIndex description: The $nin's lastindex. compile: type: object description: The $nin's compile. flags: type: string title: flags description: The $nin's flags. sticky: type: boolean title: sticky description: The $nin's sticky. unicode: type: boolean title: unicode description: The $nin's unicode. dotAll: type: boolean title: dotAll description: The $nin's dotall. __@match@1128: type: object description: The $nin's @match@1128. __@replace@1130: type: object description: The $nin's @replace@1130. __@search@1133: type: object description: The $nin's @search@1133. __@split@1135: type: object description: The $nin's @split@1135. __@matchAll@1137: type: object description: The $nin's @matchall@1137. $not: oneOf: - type: string title: $not description: The category id's $not. - type: object description: The category id's $not. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $not's exec. test: type: object description: The $not's test. source: type: string title: source description: The $not's source. global: type: boolean title: global description: The $not's global. ignoreCase: type: boolean title: ignoreCase description: The $not's ignorecase. multiline: type: boolean title: multiline description: The $not's multiline. lastIndex: type: number title: lastIndex description: The $not's lastindex. compile: type: object description: The $not's compile. flags: type: string title: flags description: The $not's flags. sticky: type: boolean title: sticky description: The $not's sticky. unicode: type: boolean title: unicode description: The $not's unicode. dotAll: type: boolean title: dotAll description: The $not's dotall. __@match@1128: type: object description: The $not's @match@1128. __@replace@1130: type: object description: The $not's @replace@1130. __@search@1133: type: object description: The $not's @search@1133. __@split@1135: type: object description: The $not's @split@1135. __@matchAll@1137: type: object description: The $not's @matchall@1137. - type: object description: The category id's $not. properties: $and: type: array description: The $not's $and. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp - type: object description: The $and's details. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp $or: type: array description: The $not's $or. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp - type: object description: The $or's details. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp $eq: oneOf: - type: string title: $eq description: The $not's $eq. - type: object description: The $not's $eq. x-schemaName: RegExp - type: array description: The $not's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp $ne: oneOf: - type: string title: $ne description: The $not's $ne. - type: object description: The $not's $ne. x-schemaName: RegExp $in: type: array description: The $not's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp $nin: type: array description: The $not's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp $not: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp - type: object description: The $not's details. - type: array description: The $not's details. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp $gt: oneOf: - type: string title: $gt description: The $not's $gt. - type: object description: The $not's $gt. x-schemaName: RegExp $gte: oneOf: - type: string title: $gte description: The $not's $gte. - type: object description: The $not's $gte. x-schemaName: RegExp $lt: oneOf: - type: string title: $lt description: The $not's $lt. - type: object description: The $not's $lt. x-schemaName: RegExp $lte: oneOf: - type: string title: $lte description: The $not's $lte. - type: object description: The $not's $lte. x-schemaName: RegExp $like: type: string title: $like description: The $not's $like. $re: type: string title: $re description: The $not's $re. $ilike: type: string title: $ilike description: The $not's $ilike. $fulltext: type: string title: $fulltext description: The $not's $fulltext. $overlap: type: array description: The $not's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The $not's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The $not's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The $not's $exists. - type: array description: The category id's $not. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $not's exec. test: type: object description: The $not's test. source: type: string title: source description: The $not's source. global: type: boolean title: global description: The $not's global. ignoreCase: type: boolean title: ignoreCase description: The $not's ignorecase. multiline: type: boolean title: multiline description: The $not's multiline. lastIndex: type: number title: lastIndex description: The $not's lastindex. compile: type: object description: The $not's compile. flags: type: string title: flags description: The $not's flags. sticky: type: boolean title: sticky description: The $not's sticky. unicode: type: boolean title: unicode description: The $not's unicode. dotAll: type: boolean title: dotAll description: The $not's dotall. __@match@1128: type: object description: The $not's @match@1128. __@replace@1130: type: object description: The $not's @replace@1130. __@search@1133: type: object description: The $not's @search@1133. __@split@1135: type: object description: The $not's @split@1135. __@matchAll@1137: type: object description: The $not's @matchall@1137. $gt: oneOf: - type: string title: $gt description: The category id's $gt. - type: object description: The category id's $gt. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $gt's exec. test: type: object description: The $gt's test. source: type: string title: source description: The $gt's source. global: type: boolean title: global description: The $gt's global. ignoreCase: type: boolean title: ignoreCase description: The $gt's ignorecase. multiline: type: boolean title: multiline description: The $gt's multiline. lastIndex: type: number title: lastIndex description: The $gt's lastindex. compile: type: object description: The $gt's compile. flags: type: string title: flags description: The $gt's flags. sticky: type: boolean title: sticky description: The $gt's sticky. unicode: type: boolean title: unicode description: The $gt's unicode. dotAll: type: boolean title: dotAll description: The $gt's dotall. __@match@1128: type: object description: The $gt's @match@1128. __@replace@1130: type: object description: The $gt's @replace@1130. __@search@1133: type: object description: The $gt's @search@1133. __@split@1135: type: object description: The $gt's @split@1135. __@matchAll@1137: type: object description: The $gt's @matchall@1137. $gte: oneOf: - type: string title: $gte description: The category id's $gte. - type: object description: The category id's $gte. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $gte's exec. test: type: object description: The $gte's test. source: type: string title: source description: The $gte's source. global: type: boolean title: global description: The $gte's global. ignoreCase: type: boolean title: ignoreCase description: The $gte's ignorecase. multiline: type: boolean title: multiline description: The $gte's multiline. lastIndex: type: number title: lastIndex description: The $gte's lastindex. compile: type: object description: The $gte's compile. flags: type: string title: flags description: The $gte's flags. sticky: type: boolean title: sticky description: The $gte's sticky. unicode: type: boolean title: unicode description: The $gte's unicode. dotAll: type: boolean title: dotAll description: The $gte's dotall. __@match@1128: type: object description: The $gte's @match@1128. __@replace@1130: type: object description: The $gte's @replace@1130. __@search@1133: type: object description: The $gte's @search@1133. __@split@1135: type: object description: The $gte's @split@1135. __@matchAll@1137: type: object description: The $gte's @matchall@1137. $lt: oneOf: - type: string title: $lt description: The category id's $lt. - type: object description: The category id's $lt. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $lt's exec. test: type: object description: The $lt's test. source: type: string title: source description: The $lt's source. global: type: boolean title: global description: The $lt's global. ignoreCase: type: boolean title: ignoreCase description: The $lt's ignorecase. multiline: type: boolean title: multiline description: The $lt's multiline. lastIndex: type: number title: lastIndex description: The $lt's lastindex. compile: type: object description: The $lt's compile. flags: type: string title: flags description: The $lt's flags. sticky: type: boolean title: sticky description: The $lt's sticky. unicode: type: boolean title: unicode description: The $lt's unicode. dotAll: type: boolean title: dotAll description: The $lt's dotall. __@match@1128: type: object description: The $lt's @match@1128. __@replace@1130: type: object description: The $lt's @replace@1130. __@search@1133: type: object description: The $lt's @search@1133. __@split@1135: type: object description: The $lt's @split@1135. __@matchAll@1137: type: object description: The $lt's @matchall@1137. $lte: oneOf: - type: string title: $lte description: The category id's $lte. - type: object description: The category id's $lte. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $lte's exec. test: type: object description: The $lte's test. source: type: string title: source description: The $lte's source. global: type: boolean title: global description: The $lte's global. ignoreCase: type: boolean title: ignoreCase description: The $lte's ignorecase. multiline: type: boolean title: multiline description: The $lte's multiline. lastIndex: type: number title: lastIndex description: The $lte's lastindex. compile: type: object description: The $lte's compile. flags: type: string title: flags description: The $lte's flags. sticky: type: boolean title: sticky description: The $lte's sticky. unicode: type: boolean title: unicode description: The $lte's unicode. dotAll: type: boolean title: dotAll description: The $lte's dotall. __@match@1128: type: object description: The $lte's @match@1128. __@replace@1130: type: object description: The $lte's @replace@1130. __@search@1133: type: object description: The $lte's @search@1133. __@split@1135: type: object description: The $lte's @split@1135. __@matchAll@1137: type: object description: The $lte's @matchall@1137. $like: type: string title: $like description: The category id's $like. $re: type: string title: $re description: The category id's $re. $ilike: type: string title: $ilike description: The category id's $ilike. $fulltext: type: string title: $fulltext description: The category id's $fulltext. $overlap: type: array description: The category id's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The category id's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The category id's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The category id's $exists. - name: categories in: query required: false schema: oneOf: - type: object description: The product's categories. required: - id properties: id: type: object description: The category's ID. properties: $and: type: array description: The id's $and. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp - type: object description: The $and's details. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp $or: type: array description: The id's $or. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp - type: object description: The $or's details. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp $eq: oneOf: - type: string title: $eq description: The id's $eq. - type: object description: The id's $eq. x-schemaName: RegExp - type: array description: The id's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp $ne: oneOf: - type: string title: $ne description: The id's $ne. - type: object description: The id's $ne. x-schemaName: RegExp $in: type: array description: The id's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp $nin: type: array description: The id's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp $not: oneOf: - type: string title: $not description: The id's $not. - type: object description: The id's $not. x-schemaName: RegExp - type: object description: The id's $not. - type: array description: The id's $not. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp $gt: oneOf: - type: string title: $gt description: The id's $gt. - type: object description: The id's $gt. x-schemaName: RegExp $gte: oneOf: - type: string title: $gte description: The id's $gte. - type: object description: The id's $gte. x-schemaName: RegExp $lt: oneOf: - type: string title: $lt description: The id's $lt. - type: object description: The id's $lt. x-schemaName: RegExp $lte: oneOf: - type: string title: $lte description: The id's $lte. - type: object description: The id's $lte. x-schemaName: RegExp $like: type: string title: $like description: The id's $like. $re: type: string title: $re description: The id's $re. $ilike: type: string title: $ilike description: The id's $ilike. $fulltext: type: string title: $fulltext description: The id's $fulltext. $overlap: type: array description: The id's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The id's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The id's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The id's $exists. - type: object description: The product's categories. required: - id properties: id: type: object description: The category's ID. properties: $and: type: array description: The id's $and. items: type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. $or: type: array description: The id's $or. items: type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. $eq: oneOf: - type: array description: The id's $eq. items: type: string title: $eq description: The $eq's details. - type: array description: The id's $eq. items: type: array description: The $eq's details. items: type: string title: $eq description: The $eq's details. $ne: type: array description: The id's $ne. items: type: string title: $ne description: The $ne's details. $in: type: array description: The id's $in. items: type: array description: The $in's details. items: type: string title: $in description: The $in's details. $nin: type: array description: The id's $nin. items: type: array description: The $nin's details. items: type: string title: $nin description: The $nin's details. $not: type: array description: The id's $not. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. $gt: type: array description: The id's $gt. items: type: string title: $gt description: The $gt's details. $gte: type: array description: The id's $gte. items: type: string title: $gte description: The $gte's details. $lt: type: array description: The id's $lt. items: type: string title: $lt description: The $lt's details. $lte: type: array description: The id's $lte. items: type: string title: $lte description: The $lte's details. $like: type: string title: $like description: The id's $like. $re: type: string title: $re description: The id's $re. $ilike: type: string title: $ilike description: The id's $ilike. $fulltext: type: string title: $fulltext description: The id's $fulltext. $overlap: type: array description: The id's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The id's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The id's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The id's $exists. - name: collection_id in: query required: false schema: oneOf: - type: string title: collection_id description: The product's collection id. - type: array description: The product's collection id. items: type: string title: collection_id description: The collection id's details. - type: object description: The product's collection id. properties: $and: type: array description: The collection id's $and. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $and's exec. test: type: object description: The $and's test. source: type: string title: source description: The $and's source. global: type: boolean title: global description: The $and's global. ignoreCase: type: boolean title: ignoreCase description: The $and's ignorecase. multiline: type: boolean title: multiline description: The $and's multiline. lastIndex: type: number title: lastIndex description: The $and's lastindex. compile: type: object description: The $and's compile. flags: type: string title: flags description: The $and's flags. sticky: type: boolean title: sticky description: The $and's sticky. unicode: type: boolean title: unicode description: The $and's unicode. dotAll: type: boolean title: dotAll description: The $and's dotall. __@match@1128: type: object description: The $and's @match@1128. __@replace@1130: type: object description: The $and's @replace@1130. __@search@1133: type: object description: The $and's @search@1133. __@split@1135: type: object description: The $and's @split@1135. __@matchAll@1137: type: object description: The $and's @matchall@1137. - type: object description: The $and's details. properties: $and: type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp - type: object description: The $and's details. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp $or: type: array description: The $and's $or. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp - type: object description: The $or's details. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp $eq: oneOf: - type: string title: $eq description: The $and's $eq. - type: object description: The $and's $eq. x-schemaName: RegExp - type: array description: The $and's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp $ne: oneOf: - type: string title: $ne description: The $and's $ne. - type: object description: The $and's $ne. x-schemaName: RegExp $in: type: array description: The $and's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp $nin: type: array description: The $and's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp $not: oneOf: - type: string title: $not description: The $and's $not. - type: object description: The $and's $not. x-schemaName: RegExp - type: object description: The $and's $not. - type: array description: The $and's $not. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp $gt: oneOf: - type: string title: $gt description: The $and's $gt. - type: object description: The $and's $gt. x-schemaName: RegExp $gte: oneOf: - type: string title: $gte description: The $and's $gte. - type: object description: The $and's $gte. x-schemaName: RegExp $lt: oneOf: - type: string title: $lt description: The $and's $lt. - type: object description: The $and's $lt. x-schemaName: RegExp $lte: oneOf: - type: string title: $lte description: The $and's $lte. - type: object description: The $and's $lte. x-schemaName: RegExp $like: type: string title: $like description: The $and's $like. $re: type: string title: $re description: The $and's $re. $ilike: type: string title: $ilike description: The $and's $ilike. $fulltext: type: string title: $fulltext description: The $and's $fulltext. $overlap: type: array description: The $and's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The $and's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The $and's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The $and's $exists. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $and's exec. test: type: object description: The $and's test. source: type: string title: source description: The $and's source. global: type: boolean title: global description: The $and's global. ignoreCase: type: boolean title: ignoreCase description: The $and's ignorecase. multiline: type: boolean title: multiline description: The $and's multiline. lastIndex: type: number title: lastIndex description: The $and's lastindex. compile: type: object description: The $and's compile. flags: type: string title: flags description: The $and's flags. sticky: type: boolean title: sticky description: The $and's sticky. unicode: type: boolean title: unicode description: The $and's unicode. dotAll: type: boolean title: dotAll description: The $and's dotall. __@match@1128: type: object description: The $and's @match@1128. __@replace@1130: type: object description: The $and's @replace@1130. __@search@1133: type: object description: The $and's @search@1133. __@split@1135: type: object description: The $and's @split@1135. __@matchAll@1137: type: object description: The $and's @matchall@1137. $or: type: array description: The collection id's $or. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $or's exec. test: type: object description: The $or's test. source: type: string title: source description: The $or's source. global: type: boolean title: global description: The $or's global. ignoreCase: type: boolean title: ignoreCase description: The $or's ignorecase. multiline: type: boolean title: multiline description: The $or's multiline. lastIndex: type: number title: lastIndex description: The $or's lastindex. compile: type: object description: The $or's compile. flags: type: string title: flags description: The $or's flags. sticky: type: boolean title: sticky description: The $or's sticky. unicode: type: boolean title: unicode description: The $or's unicode. dotAll: type: boolean title: dotAll description: The $or's dotall. __@match@1128: type: object description: The $or's @match@1128. __@replace@1130: type: object description: The $or's @replace@1130. __@search@1133: type: object description: The $or's @search@1133. __@split@1135: type: object description: The $or's @split@1135. __@matchAll@1137: type: object description: The $or's @matchall@1137. - type: object description: The $or's details. properties: $and: type: array description: The $or's $and. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp - type: object description: The $and's details. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp $or: type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp - type: object description: The $or's details. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp $eq: oneOf: - type: string title: $eq description: The $or's $eq. - type: object description: The $or's $eq. x-schemaName: RegExp - type: array description: The $or's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp $ne: oneOf: - type: string title: $ne description: The $or's $ne. - type: object description: The $or's $ne. x-schemaName: RegExp $in: type: array description: The $or's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp $nin: type: array description: The $or's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp $not: oneOf: - type: string title: $not description: The $or's $not. - type: object description: The $or's $not. x-schemaName: RegExp - type: object description: The $or's $not. - type: array description: The $or's $not. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp $gt: oneOf: - type: string title: $gt description: The $or's $gt. - type: object description: The $or's $gt. x-schemaName: RegExp $gte: oneOf: - type: string title: $gte description: The $or's $gte. - type: object description: The $or's $gte. x-schemaName: RegExp $lt: oneOf: - type: string title: $lt description: The $or's $lt. - type: object description: The $or's $lt. x-schemaName: RegExp $lte: oneOf: - type: string title: $lte description: The $or's $lte. - type: object description: The $or's $lte. x-schemaName: RegExp $like: type: string title: $like description: The $or's $like. $re: type: string title: $re description: The $or's $re. $ilike: type: string title: $ilike description: The $or's $ilike. $fulltext: type: string title: $fulltext description: The $or's $fulltext. $overlap: type: array description: The $or's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The $or's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The $or's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The $or's $exists. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $or's exec. test: type: object description: The $or's test. source: type: string title: source description: The $or's source. global: type: boolean title: global description: The $or's global. ignoreCase: type: boolean title: ignoreCase description: The $or's ignorecase. multiline: type: boolean title: multiline description: The $or's multiline. lastIndex: type: number title: lastIndex description: The $or's lastindex. compile: type: object description: The $or's compile. flags: type: string title: flags description: The $or's flags. sticky: type: boolean title: sticky description: The $or's sticky. unicode: type: boolean title: unicode description: The $or's unicode. dotAll: type: boolean title: dotAll description: The $or's dotall. __@match@1128: type: object description: The $or's @match@1128. __@replace@1130: type: object description: The $or's @replace@1130. __@search@1133: type: object description: The $or's @search@1133. __@split@1135: type: object description: The $or's @split@1135. __@matchAll@1137: type: object description: The $or's @matchall@1137. $eq: oneOf: - type: string title: $eq description: The collection id's $eq. - type: object description: The collection id's $eq. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $eq's exec. test: type: object description: The $eq's test. source: type: string title: source description: The $eq's source. global: type: boolean title: global description: The $eq's global. ignoreCase: type: boolean title: ignoreCase description: The $eq's ignorecase. multiline: type: boolean title: multiline description: The $eq's multiline. lastIndex: type: number title: lastIndex description: The $eq's lastindex. compile: type: object description: The $eq's compile. flags: type: string title: flags description: The $eq's flags. sticky: type: boolean title: sticky description: The $eq's sticky. unicode: type: boolean title: unicode description: The $eq's unicode. dotAll: type: boolean title: dotAll description: The $eq's dotall. __@match@1128: type: object description: The $eq's @match@1128. __@replace@1130: type: object description: The $eq's @replace@1130. __@search@1133: type: object description: The $eq's @search@1133. __@split@1135: type: object description: The $eq's @split@1135. __@matchAll@1137: type: object description: The $eq's @matchall@1137. - type: array description: The collection id's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $eq's exec. test: type: object description: The $eq's test. source: type: string title: source description: The $eq's source. global: type: boolean title: global description: The $eq's global. ignoreCase: type: boolean title: ignoreCase description: The $eq's ignorecase. multiline: type: boolean title: multiline description: The $eq's multiline. lastIndex: type: number title: lastIndex description: The $eq's lastindex. compile: type: object description: The $eq's compile. flags: type: string title: flags description: The $eq's flags. sticky: type: boolean title: sticky description: The $eq's sticky. unicode: type: boolean title: unicode description: The $eq's unicode. dotAll: type: boolean title: dotAll description: The $eq's dotall. __@match@1128: type: object description: The $eq's @match@1128. __@replace@1130: type: object description: The $eq's @replace@1130. __@search@1133: type: object description: The $eq's @search@1133. __@split@1135: type: object description: The $eq's @split@1135. __@matchAll@1137: type: object description: The $eq's @matchall@1137. $ne: oneOf: - type: string title: $ne description: The collection id's $ne. - type: object description: The collection id's $ne. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $ne's exec. test: type: object description: The $ne's test. source: type: string title: source description: The $ne's source. global: type: boolean title: global description: The $ne's global. ignoreCase: type: boolean title: ignoreCase description: The $ne's ignorecase. multiline: type: boolean title: multiline description: The $ne's multiline. lastIndex: type: number title: lastIndex description: The $ne's lastindex. compile: type: object description: The $ne's compile. flags: type: string title: flags description: The $ne's flags. sticky: type: boolean title: sticky description: The $ne's sticky. unicode: type: boolean title: unicode description: The $ne's unicode. dotAll: type: boolean title: dotAll description: The $ne's dotall. __@match@1128: type: object description: The $ne's @match@1128. __@replace@1130: type: object description: The $ne's @replace@1130. __@search@1133: type: object description: The $ne's @search@1133. __@split@1135: type: object description: The $ne's @split@1135. __@matchAll@1137: type: object description: The $ne's @matchall@1137. $in: type: array description: The collection id's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $in's exec. test: type: object description: The $in's test. source: type: string title: source description: The $in's source. global: type: boolean title: global description: The $in's global. ignoreCase: type: boolean title: ignoreCase description: The $in's ignorecase. multiline: type: boolean title: multiline description: The $in's multiline. lastIndex: type: number title: lastIndex description: The $in's lastindex. compile: type: object description: The $in's compile. flags: type: string title: flags description: The $in's flags. sticky: type: boolean title: sticky description: The $in's sticky. unicode: type: boolean title: unicode description: The $in's unicode. dotAll: type: boolean title: dotAll description: The $in's dotall. __@match@1128: type: object description: The $in's @match@1128. __@replace@1130: type: object description: The $in's @replace@1130. __@search@1133: type: object description: The $in's @search@1133. __@split@1135: type: object description: The $in's @split@1135. __@matchAll@1137: type: object description: The $in's @matchall@1137. $nin: type: array description: The collection id's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $nin's exec. test: type: object description: The $nin's test. source: type: string title: source description: The $nin's source. global: type: boolean title: global description: The $nin's global. ignoreCase: type: boolean title: ignoreCase description: The $nin's ignorecase. multiline: type: boolean title: multiline description: The $nin's multiline. lastIndex: type: number title: lastIndex description: The $nin's lastindex. compile: type: object description: The $nin's compile. flags: type: string title: flags description: The $nin's flags. sticky: type: boolean title: sticky description: The $nin's sticky. unicode: type: boolean title: unicode description: The $nin's unicode. dotAll: type: boolean title: dotAll description: The $nin's dotall. __@match@1128: type: object description: The $nin's @match@1128. __@replace@1130: type: object description: The $nin's @replace@1130. __@search@1133: type: object description: The $nin's @search@1133. __@split@1135: type: object description: The $nin's @split@1135. __@matchAll@1137: type: object description: The $nin's @matchall@1137. $not: oneOf: - type: string title: $not description: The collection id's $not. - type: object description: The collection id's $not. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $not's exec. test: type: object description: The $not's test. source: type: string title: source description: The $not's source. global: type: boolean title: global description: The $not's global. ignoreCase: type: boolean title: ignoreCase description: The $not's ignorecase. multiline: type: boolean title: multiline description: The $not's multiline. lastIndex: type: number title: lastIndex description: The $not's lastindex. compile: type: object description: The $not's compile. flags: type: string title: flags description: The $not's flags. sticky: type: boolean title: sticky description: The $not's sticky. unicode: type: boolean title: unicode description: The $not's unicode. dotAll: type: boolean title: dotAll description: The $not's dotall. __@match@1128: type: object description: The $not's @match@1128. __@replace@1130: type: object description: The $not's @replace@1130. __@search@1133: type: object description: The $not's @search@1133. __@split@1135: type: object description: The $not's @split@1135. __@matchAll@1137: type: object description: The $not's @matchall@1137. - type: object description: The collection id's $not. properties: $and: type: array description: The $not's $and. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp - type: object description: The $and's details. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp $or: type: array description: The $not's $or. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp - type: object description: The $or's details. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp $eq: oneOf: - type: string title: $eq description: The $not's $eq. - type: object description: The $not's $eq. x-schemaName: RegExp - type: array description: The $not's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp $ne: oneOf: - type: string title: $ne description: The $not's $ne. - type: object description: The $not's $ne. x-schemaName: RegExp $in: type: array description: The $not's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp $nin: type: array description: The $not's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp $not: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp - type: object description: The $not's details. - type: array description: The $not's details. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp $gt: oneOf: - type: string title: $gt description: The $not's $gt. - type: object description: The $not's $gt. x-schemaName: RegExp $gte: oneOf: - type: string title: $gte description: The $not's $gte. - type: object description: The $not's $gte. x-schemaName: RegExp $lt: oneOf: - type: string title: $lt description: The $not's $lt. - type: object description: The $not's $lt. x-schemaName: RegExp $lte: oneOf: - type: string title: $lte description: The $not's $lte. - type: object description: The $not's $lte. x-schemaName: RegExp $like: type: string title: $like description: The $not's $like. $re: type: string title: $re description: The $not's $re. $ilike: type: string title: $ilike description: The $not's $ilike. $fulltext: type: string title: $fulltext description: The $not's $fulltext. $overlap: type: array description: The $not's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The $not's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The $not's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The $not's $exists. - type: array description: The collection id's $not. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $not's exec. test: type: object description: The $not's test. source: type: string title: source description: The $not's source. global: type: boolean title: global description: The $not's global. ignoreCase: type: boolean title: ignoreCase description: The $not's ignorecase. multiline: type: boolean title: multiline description: The $not's multiline. lastIndex: type: number title: lastIndex description: The $not's lastindex. compile: type: object description: The $not's compile. flags: type: string title: flags description: The $not's flags. sticky: type: boolean title: sticky description: The $not's sticky. unicode: type: boolean title: unicode description: The $not's unicode. dotAll: type: boolean title: dotAll description: The $not's dotall. __@match@1128: type: object description: The $not's @match@1128. __@replace@1130: type: object description: The $not's @replace@1130. __@search@1133: type: object description: The $not's @search@1133. __@split@1135: type: object description: The $not's @split@1135. __@matchAll@1137: type: object description: The $not's @matchall@1137. $gt: oneOf: - type: string title: $gt description: The collection id's $gt. - type: object description: The collection id's $gt. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $gt's exec. test: type: object description: The $gt's test. source: type: string title: source description: The $gt's source. global: type: boolean title: global description: The $gt's global. ignoreCase: type: boolean title: ignoreCase description: The $gt's ignorecase. multiline: type: boolean title: multiline description: The $gt's multiline. lastIndex: type: number title: lastIndex description: The $gt's lastindex. compile: type: object description: The $gt's compile. flags: type: string title: flags description: The $gt's flags. sticky: type: boolean title: sticky description: The $gt's sticky. unicode: type: boolean title: unicode description: The $gt's unicode. dotAll: type: boolean title: dotAll description: The $gt's dotall. __@match@1128: type: object description: The $gt's @match@1128. __@replace@1130: type: object description: The $gt's @replace@1130. __@search@1133: type: object description: The $gt's @search@1133. __@split@1135: type: object description: The $gt's @split@1135. __@matchAll@1137: type: object description: The $gt's @matchall@1137. $gte: oneOf: - type: string title: $gte description: The collection id's $gte. - type: object description: The collection id's $gte. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $gte's exec. test: type: object description: The $gte's test. source: type: string title: source description: The $gte's source. global: type: boolean title: global description: The $gte's global. ignoreCase: type: boolean title: ignoreCase description: The $gte's ignorecase. multiline: type: boolean title: multiline description: The $gte's multiline. lastIndex: type: number title: lastIndex description: The $gte's lastindex. compile: type: object description: The $gte's compile. flags: type: string title: flags description: The $gte's flags. sticky: type: boolean title: sticky description: The $gte's sticky. unicode: type: boolean title: unicode description: The $gte's unicode. dotAll: type: boolean title: dotAll description: The $gte's dotall. __@match@1128: type: object description: The $gte's @match@1128. __@replace@1130: type: object description: The $gte's @replace@1130. __@search@1133: type: object description: The $gte's @search@1133. __@split@1135: type: object description: The $gte's @split@1135. __@matchAll@1137: type: object description: The $gte's @matchall@1137. $lt: oneOf: - type: string title: $lt description: The collection id's $lt. - type: object description: The collection id's $lt. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $lt's exec. test: type: object description: The $lt's test. source: type: string title: source description: The $lt's source. global: type: boolean title: global description: The $lt's global. ignoreCase: type: boolean title: ignoreCase description: The $lt's ignorecase. multiline: type: boolean title: multiline description: The $lt's multiline. lastIndex: type: number title: lastIndex description: The $lt's lastindex. compile: type: object description: The $lt's compile. flags: type: string title: flags description: The $lt's flags. sticky: type: boolean title: sticky description: The $lt's sticky. unicode: type: boolean title: unicode description: The $lt's unicode. dotAll: type: boolean title: dotAll description: The $lt's dotall. __@match@1128: type: object description: The $lt's @match@1128. __@replace@1130: type: object description: The $lt's @replace@1130. __@search@1133: type: object description: The $lt's @search@1133. __@split@1135: type: object description: The $lt's @split@1135. __@matchAll@1137: type: object description: The $lt's @matchall@1137. $lte: oneOf: - type: string title: $lte description: The collection id's $lte. - type: object description: The collection id's $lte. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $lte's exec. test: type: object description: The $lte's test. source: type: string title: source description: The $lte's source. global: type: boolean title: global description: The $lte's global. ignoreCase: type: boolean title: ignoreCase description: The $lte's ignorecase. multiline: type: boolean title: multiline description: The $lte's multiline. lastIndex: type: number title: lastIndex description: The $lte's lastindex. compile: type: object description: The $lte's compile. flags: type: string title: flags description: The $lte's flags. sticky: type: boolean title: sticky description: The $lte's sticky. unicode: type: boolean title: unicode description: The $lte's unicode. dotAll: type: boolean title: dotAll description: The $lte's dotall. __@match@1128: type: object description: The $lte's @match@1128. __@replace@1130: type: object description: The $lte's @replace@1130. __@search@1133: type: object description: The $lte's @search@1133. __@split@1135: type: object description: The $lte's @split@1135. __@matchAll@1137: type: object description: The $lte's @matchall@1137. $like: type: string title: $like description: The collection id's $like. $re: type: string title: $re description: The collection id's $re. $ilike: type: string title: $ilike description: The collection id's $ilike. $fulltext: type: string title: $fulltext description: The collection id's $fulltext. $overlap: type: array description: The collection id's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The collection id's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The collection id's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The collection id's $exists. - name: created_at in: query description: The product's created at. required: false schema: type: object description: The product's created at. properties: $and: type: array description: The created at's $and. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $and's exec. test: type: object description: The $and's test. source: type: string title: source description: The $and's source. global: type: boolean title: global description: The $and's global. ignoreCase: type: boolean title: ignoreCase description: The $and's ignorecase. multiline: type: boolean title: multiline description: The $and's multiline. lastIndex: type: number title: lastIndex description: The $and's lastindex. compile: type: object description: The $and's compile. flags: type: string title: flags description: The $and's flags. sticky: type: boolean title: sticky description: The $and's sticky. unicode: type: boolean title: unicode description: The $and's unicode. dotAll: type: boolean title: dotAll description: The $and's dotall. __@match@1128: type: object description: The $and's @match@1128. __@replace@1130: type: object description: The $and's @replace@1130. __@search@1133: type: object description: The $and's @search@1133. __@split@1135: type: object description: The $and's @split@1135. __@matchAll@1137: type: object description: The $and's @matchall@1137. - type: object description: The $and's details. properties: $and: type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp - type: object description: The $and's details. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp $or: type: array description: The $and's $or. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp - type: object description: The $or's details. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp $eq: oneOf: - type: string title: $eq description: The $and's $eq. - type: object description: The $and's $eq. x-schemaName: RegExp - type: array description: The $and's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp $ne: oneOf: - type: string title: $ne description: The $and's $ne. - type: object description: The $and's $ne. x-schemaName: RegExp $in: type: array description: The $and's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp $nin: type: array description: The $and's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp $not: oneOf: - type: string title: $not description: The $and's $not. - type: object description: The $and's $not. x-schemaName: RegExp - type: object description: The $and's $not. - type: array description: The $and's $not. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp $gt: oneOf: - type: string title: $gt description: The $and's $gt. - type: object description: The $and's $gt. x-schemaName: RegExp $gte: oneOf: - type: string title: $gte description: The $and's $gte. - type: object description: The $and's $gte. x-schemaName: RegExp $lt: oneOf: - type: string title: $lt description: The $and's $lt. - type: object description: The $and's $lt. x-schemaName: RegExp $lte: oneOf: - type: string title: $lte description: The $and's $lte. - type: object description: The $and's $lte. x-schemaName: RegExp $like: type: string title: $like description: The $and's $like. $re: type: string title: $re description: The $and's $re. $ilike: type: string title: $ilike description: The $and's $ilike. $fulltext: type: string title: $fulltext description: The $and's $fulltext. $overlap: type: array description: The $and's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The $and's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The $and's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The $and's $exists. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $and's exec. test: type: object description: The $and's test. source: type: string title: source description: The $and's source. global: type: boolean title: global description: The $and's global. ignoreCase: type: boolean title: ignoreCase description: The $and's ignorecase. multiline: type: boolean title: multiline description: The $and's multiline. lastIndex: type: number title: lastIndex description: The $and's lastindex. compile: type: object description: The $and's compile. flags: type: string title: flags description: The $and's flags. sticky: type: boolean title: sticky description: The $and's sticky. unicode: type: boolean title: unicode description: The $and's unicode. dotAll: type: boolean title: dotAll description: The $and's dotall. __@match@1128: type: object description: The $and's @match@1128. __@replace@1130: type: object description: The $and's @replace@1130. __@search@1133: type: object description: The $and's @search@1133. __@split@1135: type: object description: The $and's @split@1135. __@matchAll@1137: type: object description: The $and's @matchall@1137. $or: type: array description: The created at's $or. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $or's exec. test: type: object description: The $or's test. source: type: string title: source description: The $or's source. global: type: boolean title: global description: The $or's global. ignoreCase: type: boolean title: ignoreCase description: The $or's ignorecase. multiline: type: boolean title: multiline description: The $or's multiline. lastIndex: type: number title: lastIndex description: The $or's lastindex. compile: type: object description: The $or's compile. flags: type: string title: flags description: The $or's flags. sticky: type: boolean title: sticky description: The $or's sticky. unicode: type: boolean title: unicode description: The $or's unicode. dotAll: type: boolean title: dotAll description: The $or's dotall. __@match@1128: type: object description: The $or's @match@1128. __@replace@1130: type: object description: The $or's @replace@1130. __@search@1133: type: object description: The $or's @search@1133. __@split@1135: type: object description: The $or's @split@1135. __@matchAll@1137: type: object description: The $or's @matchall@1137. - type: object description: The $or's details. properties: $and: type: array description: The $or's $and. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp - type: object description: The $and's details. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp $or: type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp - type: object description: The $or's details. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp $eq: oneOf: - type: string title: $eq description: The $or's $eq. - type: object description: The $or's $eq. x-schemaName: RegExp - type: array description: The $or's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp $ne: oneOf: - type: string title: $ne description: The $or's $ne. - type: object description: The $or's $ne. x-schemaName: RegExp $in: type: array description: The $or's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp $nin: type: array description: The $or's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp $not: oneOf: - type: string title: $not description: The $or's $not. - type: object description: The $or's $not. x-schemaName: RegExp - type: object description: The $or's $not. - type: array description: The $or's $not. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp $gt: oneOf: - type: string title: $gt description: The $or's $gt. - type: object description: The $or's $gt. x-schemaName: RegExp $gte: oneOf: - type: string title: $gte description: The $or's $gte. - type: object description: The $or's $gte. x-schemaName: RegExp $lt: oneOf: - type: string title: $lt description: The $or's $lt. - type: object description: The $or's $lt. x-schemaName: RegExp $lte: oneOf: - type: string title: $lte description: The $or's $lte. - type: object description: The $or's $lte. x-schemaName: RegExp $like: type: string title: $like description: The $or's $like. $re: type: string title: $re description: The $or's $re. $ilike: type: string title: $ilike description: The $or's $ilike. $fulltext: type: string title: $fulltext description: The $or's $fulltext. $overlap: type: array description: The $or's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The $or's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The $or's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The $or's $exists. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $or's exec. test: type: object description: The $or's test. source: type: string title: source description: The $or's source. global: type: boolean title: global description: The $or's global. ignoreCase: type: boolean title: ignoreCase description: The $or's ignorecase. multiline: type: boolean title: multiline description: The $or's multiline. lastIndex: type: number title: lastIndex description: The $or's lastindex. compile: type: object description: The $or's compile. flags: type: string title: flags description: The $or's flags. sticky: type: boolean title: sticky description: The $or's sticky. unicode: type: boolean title: unicode description: The $or's unicode. dotAll: type: boolean title: dotAll description: The $or's dotall. __@match@1128: type: object description: The $or's @match@1128. __@replace@1130: type: object description: The $or's @replace@1130. __@search@1133: type: object description: The $or's @search@1133. __@split@1135: type: object description: The $or's @split@1135. __@matchAll@1137: type: object description: The $or's @matchall@1137. $eq: oneOf: - type: string title: $eq description: The created at's $eq. - type: object description: The created at's $eq. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $eq's exec. test: type: object description: The $eq's test. source: type: string title: source description: The $eq's source. global: type: boolean title: global description: The $eq's global. ignoreCase: type: boolean title: ignoreCase description: The $eq's ignorecase. multiline: type: boolean title: multiline description: The $eq's multiline. lastIndex: type: number title: lastIndex description: The $eq's lastindex. compile: type: object description: The $eq's compile. flags: type: string title: flags description: The $eq's flags. sticky: type: boolean title: sticky description: The $eq's sticky. unicode: type: boolean title: unicode description: The $eq's unicode. dotAll: type: boolean title: dotAll description: The $eq's dotall. __@match@1128: type: object description: The $eq's @match@1128. __@replace@1130: type: object description: The $eq's @replace@1130. __@search@1133: type: object description: The $eq's @search@1133. __@split@1135: type: object description: The $eq's @split@1135. __@matchAll@1137: type: object description: The $eq's @matchall@1137. - type: array description: The created at's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $eq's exec. test: type: object description: The $eq's test. source: type: string title: source description: The $eq's source. global: type: boolean title: global description: The $eq's global. ignoreCase: type: boolean title: ignoreCase description: The $eq's ignorecase. multiline: type: boolean title: multiline description: The $eq's multiline. lastIndex: type: number title: lastIndex description: The $eq's lastindex. compile: type: object description: The $eq's compile. flags: type: string title: flags description: The $eq's flags. sticky: type: boolean title: sticky description: The $eq's sticky. unicode: type: boolean title: unicode description: The $eq's unicode. dotAll: type: boolean title: dotAll description: The $eq's dotall. __@match@1128: type: object description: The $eq's @match@1128. __@replace@1130: type: object description: The $eq's @replace@1130. __@search@1133: type: object description: The $eq's @search@1133. __@split@1135: type: object description: The $eq's @split@1135. __@matchAll@1137: type: object description: The $eq's @matchall@1137. $ne: oneOf: - type: string title: $ne description: The created at's $ne. - type: object description: The created at's $ne. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $ne's exec. test: type: object description: The $ne's test. source: type: string title: source description: The $ne's source. global: type: boolean title: global description: The $ne's global. ignoreCase: type: boolean title: ignoreCase description: The $ne's ignorecase. multiline: type: boolean title: multiline description: The $ne's multiline. lastIndex: type: number title: lastIndex description: The $ne's lastindex. compile: type: object description: The $ne's compile. flags: type: string title: flags description: The $ne's flags. sticky: type: boolean title: sticky description: The $ne's sticky. unicode: type: boolean title: unicode description: The $ne's unicode. dotAll: type: boolean title: dotAll description: The $ne's dotall. __@match@1128: type: object description: The $ne's @match@1128. __@replace@1130: type: object description: The $ne's @replace@1130. __@search@1133: type: object description: The $ne's @search@1133. __@split@1135: type: object description: The $ne's @split@1135. __@matchAll@1137: type: object description: The $ne's @matchall@1137. $in: type: array description: The created at's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $in's exec. test: type: object description: The $in's test. source: type: string title: source description: The $in's source. global: type: boolean title: global description: The $in's global. ignoreCase: type: boolean title: ignoreCase description: The $in's ignorecase. multiline: type: boolean title: multiline description: The $in's multiline. lastIndex: type: number title: lastIndex description: The $in's lastindex. compile: type: object description: The $in's compile. flags: type: string title: flags description: The $in's flags. sticky: type: boolean title: sticky description: The $in's sticky. unicode: type: boolean title: unicode description: The $in's unicode. dotAll: type: boolean title: dotAll description: The $in's dotall. __@match@1128: type: object description: The $in's @match@1128. __@replace@1130: type: object description: The $in's @replace@1130. __@search@1133: type: object description: The $in's @search@1133. __@split@1135: type: object description: The $in's @split@1135. __@matchAll@1137: type: object description: The $in's @matchall@1137. $nin: type: array description: The created at's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $nin's exec. test: type: object description: The $nin's test. source: type: string title: source description: The $nin's source. global: type: boolean title: global description: The $nin's global. ignoreCase: type: boolean title: ignoreCase description: The $nin's ignorecase. multiline: type: boolean title: multiline description: The $nin's multiline. lastIndex: type: number title: lastIndex description: The $nin's lastindex. compile: type: object description: The $nin's compile. flags: type: string title: flags description: The $nin's flags. sticky: type: boolean title: sticky description: The $nin's sticky. unicode: type: boolean title: unicode description: The $nin's unicode. dotAll: type: boolean title: dotAll description: The $nin's dotall. __@match@1128: type: object description: The $nin's @match@1128. __@replace@1130: type: object description: The $nin's @replace@1130. __@search@1133: type: object description: The $nin's @search@1133. __@split@1135: type: object description: The $nin's @split@1135. __@matchAll@1137: type: object description: The $nin's @matchall@1137. $not: oneOf: - type: string title: $not description: The created at's $not. - type: object description: The created at's $not. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $not's exec. test: type: object description: The $not's test. source: type: string title: source description: The $not's source. global: type: boolean title: global description: The $not's global. ignoreCase: type: boolean title: ignoreCase description: The $not's ignorecase. multiline: type: boolean title: multiline description: The $not's multiline. lastIndex: type: number title: lastIndex description: The $not's lastindex. compile: type: object description: The $not's compile. flags: type: string title: flags description: The $not's flags. sticky: type: boolean title: sticky description: The $not's sticky. unicode: type: boolean title: unicode description: The $not's unicode. dotAll: type: boolean title: dotAll description: The $not's dotall. __@match@1128: type: object description: The $not's @match@1128. __@replace@1130: type: object description: The $not's @replace@1130. __@search@1133: type: object description: The $not's @search@1133. __@split@1135: type: object description: The $not's @split@1135. __@matchAll@1137: type: object description: The $not's @matchall@1137. - type: object description: The created at's $not. properties: $and: type: array description: The $not's $and. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp - type: object description: The $and's details. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp $or: type: array description: The $not's $or. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp - type: object description: The $or's details. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp $eq: oneOf: - type: string title: $eq description: The $not's $eq. - type: object description: The $not's $eq. x-schemaName: RegExp - type: array description: The $not's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp $ne: oneOf: - type: string title: $ne description: The $not's $ne. - type: object description: The $not's $ne. x-schemaName: RegExp $in: type: array description: The $not's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp $nin: type: array description: The $not's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp $not: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp - type: object description: The $not's details. - type: array description: The $not's details. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp $gt: oneOf: - type: string title: $gt description: The $not's $gt. - type: object description: The $not's $gt. x-schemaName: RegExp $gte: oneOf: - type: string title: $gte description: The $not's $gte. - type: object description: The $not's $gte. x-schemaName: RegExp $lt: oneOf: - type: string title: $lt description: The $not's $lt. - type: object description: The $not's $lt. x-schemaName: RegExp $lte: oneOf: - type: string title: $lte description: The $not's $lte. - type: object description: The $not's $lte. x-schemaName: RegExp $like: type: string title: $like description: The $not's $like. $re: type: string title: $re description: The $not's $re. $ilike: type: string title: $ilike description: The $not's $ilike. $fulltext: type: string title: $fulltext description: The $not's $fulltext. $overlap: type: array description: The $not's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The $not's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The $not's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The $not's $exists. - type: array description: The created at's $not. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $not's exec. test: type: object description: The $not's test. source: type: string title: source description: The $not's source. global: type: boolean title: global description: The $not's global. ignoreCase: type: boolean title: ignoreCase description: The $not's ignorecase. multiline: type: boolean title: multiline description: The $not's multiline. lastIndex: type: number title: lastIndex description: The $not's lastindex. compile: type: object description: The $not's compile. flags: type: string title: flags description: The $not's flags. sticky: type: boolean title: sticky description: The $not's sticky. unicode: type: boolean title: unicode description: The $not's unicode. dotAll: type: boolean title: dotAll description: The $not's dotall. __@match@1128: type: object description: The $not's @match@1128. __@replace@1130: type: object description: The $not's @replace@1130. __@search@1133: type: object description: The $not's @search@1133. __@split@1135: type: object description: The $not's @split@1135. __@matchAll@1137: type: object description: The $not's @matchall@1137. $gt: oneOf: - type: string title: $gt description: The created at's $gt. - type: object description: The created at's $gt. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $gt's exec. test: type: object description: The $gt's test. source: type: string title: source description: The $gt's source. global: type: boolean title: global description: The $gt's global. ignoreCase: type: boolean title: ignoreCase description: The $gt's ignorecase. multiline: type: boolean title: multiline description: The $gt's multiline. lastIndex: type: number title: lastIndex description: The $gt's lastindex. compile: type: object description: The $gt's compile. flags: type: string title: flags description: The $gt's flags. sticky: type: boolean title: sticky description: The $gt's sticky. unicode: type: boolean title: unicode description: The $gt's unicode. dotAll: type: boolean title: dotAll description: The $gt's dotall. __@match@1128: type: object description: The $gt's @match@1128. __@replace@1130: type: object description: The $gt's @replace@1130. __@search@1133: type: object description: The $gt's @search@1133. __@split@1135: type: object description: The $gt's @split@1135. __@matchAll@1137: type: object description: The $gt's @matchall@1137. $gte: oneOf: - type: string title: $gte description: The created at's $gte. - type: object description: The created at's $gte. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $gte's exec. test: type: object description: The $gte's test. source: type: string title: source description: The $gte's source. global: type: boolean title: global description: The $gte's global. ignoreCase: type: boolean title: ignoreCase description: The $gte's ignorecase. multiline: type: boolean title: multiline description: The $gte's multiline. lastIndex: type: number title: lastIndex description: The $gte's lastindex. compile: type: object description: The $gte's compile. flags: type: string title: flags description: The $gte's flags. sticky: type: boolean title: sticky description: The $gte's sticky. unicode: type: boolean title: unicode description: The $gte's unicode. dotAll: type: boolean title: dotAll description: The $gte's dotall. __@match@1128: type: object description: The $gte's @match@1128. __@replace@1130: type: object description: The $gte's @replace@1130. __@search@1133: type: object description: The $gte's @search@1133. __@split@1135: type: object description: The $gte's @split@1135. __@matchAll@1137: type: object description: The $gte's @matchall@1137. $lt: oneOf: - type: string title: $lt description: The created at's $lt. - type: object description: The created at's $lt. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $lt's exec. test: type: object description: The $lt's test. source: type: string title: source description: The $lt's source. global: type: boolean title: global description: The $lt's global. ignoreCase: type: boolean title: ignoreCase description: The $lt's ignorecase. multiline: type: boolean title: multiline description: The $lt's multiline. lastIndex: type: number title: lastIndex description: The $lt's lastindex. compile: type: object description: The $lt's compile. flags: type: string title: flags description: The $lt's flags. sticky: type: boolean title: sticky description: The $lt's sticky. unicode: type: boolean title: unicode description: The $lt's unicode. dotAll: type: boolean title: dotAll description: The $lt's dotall. __@match@1128: type: object description: The $lt's @match@1128. __@replace@1130: type: object description: The $lt's @replace@1130. __@search@1133: type: object description: The $lt's @search@1133. __@split@1135: type: object description: The $lt's @split@1135. __@matchAll@1137: type: object description: The $lt's @matchall@1137. $lte: oneOf: - type: string title: $lte description: The created at's $lte. - type: object description: The created at's $lte. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $lte's exec. test: type: object description: The $lte's test. source: type: string title: source description: The $lte's source. global: type: boolean title: global description: The $lte's global. ignoreCase: type: boolean title: ignoreCase description: The $lte's ignorecase. multiline: type: boolean title: multiline description: The $lte's multiline. lastIndex: type: number title: lastIndex description: The $lte's lastindex. compile: type: object description: The $lte's compile. flags: type: string title: flags description: The $lte's flags. sticky: type: boolean title: sticky description: The $lte's sticky. unicode: type: boolean title: unicode description: The $lte's unicode. dotAll: type: boolean title: dotAll description: The $lte's dotall. __@match@1128: type: object description: The $lte's @match@1128. __@replace@1130: type: object description: The $lte's @replace@1130. __@search@1133: type: object description: The $lte's @search@1133. __@split@1135: type: object description: The $lte's @split@1135. __@matchAll@1137: type: object description: The $lte's @matchall@1137. $like: type: string title: $like description: The created at's $like. $re: type: string title: $re description: The created at's $re. $ilike: type: string title: $ilike description: The created at's $ilike. $fulltext: type: string title: $fulltext description: The created at's $fulltext. $overlap: type: array description: The created at's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The created at's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The created at's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The created at's $exists. - name: updated_at in: query description: The product's updated at. required: false schema: type: object description: The product's updated at. properties: $and: type: array description: The updated at's $and. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $and's exec. test: type: object description: The $and's test. source: type: string title: source description: The $and's source. global: type: boolean title: global description: The $and's global. ignoreCase: type: boolean title: ignoreCase description: The $and's ignorecase. multiline: type: boolean title: multiline description: The $and's multiline. lastIndex: type: number title: lastIndex description: The $and's lastindex. compile: type: object description: The $and's compile. flags: type: string title: flags description: The $and's flags. sticky: type: boolean title: sticky description: The $and's sticky. unicode: type: boolean title: unicode description: The $and's unicode. dotAll: type: boolean title: dotAll description: The $and's dotall. __@match@1128: type: object description: The $and's @match@1128. __@replace@1130: type: object description: The $and's @replace@1130. __@search@1133: type: object description: The $and's @search@1133. __@split@1135: type: object description: The $and's @split@1135. __@matchAll@1137: type: object description: The $and's @matchall@1137. - type: object description: The $and's details. properties: $and: type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp - type: object description: The $and's details. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp $or: type: array description: The $and's $or. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp - type: object description: The $or's details. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp $eq: oneOf: - type: string title: $eq description: The $and's $eq. - type: object description: The $and's $eq. x-schemaName: RegExp - type: array description: The $and's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp $ne: oneOf: - type: string title: $ne description: The $and's $ne. - type: object description: The $and's $ne. x-schemaName: RegExp $in: type: array description: The $and's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp $nin: type: array description: The $and's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp $not: oneOf: - type: string title: $not description: The $and's $not. - type: object description: The $and's $not. x-schemaName: RegExp - type: object description: The $and's $not. - type: array description: The $and's $not. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp $gt: oneOf: - type: string title: $gt description: The $and's $gt. - type: object description: The $and's $gt. x-schemaName: RegExp $gte: oneOf: - type: string title: $gte description: The $and's $gte. - type: object description: The $and's $gte. x-schemaName: RegExp $lt: oneOf: - type: string title: $lt description: The $and's $lt. - type: object description: The $and's $lt. x-schemaName: RegExp $lte: oneOf: - type: string title: $lte description: The $and's $lte. - type: object description: The $and's $lte. x-schemaName: RegExp $like: type: string title: $like description: The $and's $like. $re: type: string title: $re description: The $and's $re. $ilike: type: string title: $ilike description: The $and's $ilike. $fulltext: type: string title: $fulltext description: The $and's $fulltext. $overlap: type: array description: The $and's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The $and's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The $and's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The $and's $exists. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $and's exec. test: type: object description: The $and's test. source: type: string title: source description: The $and's source. global: type: boolean title: global description: The $and's global. ignoreCase: type: boolean title: ignoreCase description: The $and's ignorecase. multiline: type: boolean title: multiline description: The $and's multiline. lastIndex: type: number title: lastIndex description: The $and's lastindex. compile: type: object description: The $and's compile. flags: type: string title: flags description: The $and's flags. sticky: type: boolean title: sticky description: The $and's sticky. unicode: type: boolean title: unicode description: The $and's unicode. dotAll: type: boolean title: dotAll description: The $and's dotall. __@match@1128: type: object description: The $and's @match@1128. __@replace@1130: type: object description: The $and's @replace@1130. __@search@1133: type: object description: The $and's @search@1133. __@split@1135: type: object description: The $and's @split@1135. __@matchAll@1137: type: object description: The $and's @matchall@1137. $or: type: array description: The updated at's $or. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $or's exec. test: type: object description: The $or's test. source: type: string title: source description: The $or's source. global: type: boolean title: global description: The $or's global. ignoreCase: type: boolean title: ignoreCase description: The $or's ignorecase. multiline: type: boolean title: multiline description: The $or's multiline. lastIndex: type: number title: lastIndex description: The $or's lastindex. compile: type: object description: The $or's compile. flags: type: string title: flags description: The $or's flags. sticky: type: boolean title: sticky description: The $or's sticky. unicode: type: boolean title: unicode description: The $or's unicode. dotAll: type: boolean title: dotAll description: The $or's dotall. __@match@1128: type: object description: The $or's @match@1128. __@replace@1130: type: object description: The $or's @replace@1130. __@search@1133: type: object description: The $or's @search@1133. __@split@1135: type: object description: The $or's @split@1135. __@matchAll@1137: type: object description: The $or's @matchall@1137. - type: object description: The $or's details. properties: $and: type: array description: The $or's $and. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp - type: object description: The $and's details. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp $or: type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp - type: object description: The $or's details. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp $eq: oneOf: - type: string title: $eq description: The $or's $eq. - type: object description: The $or's $eq. x-schemaName: RegExp - type: array description: The $or's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp $ne: oneOf: - type: string title: $ne description: The $or's $ne. - type: object description: The $or's $ne. x-schemaName: RegExp $in: type: array description: The $or's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp $nin: type: array description: The $or's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp $not: oneOf: - type: string title: $not description: The $or's $not. - type: object description: The $or's $not. x-schemaName: RegExp - type: object description: The $or's $not. - type: array description: The $or's $not. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp $gt: oneOf: - type: string title: $gt description: The $or's $gt. - type: object description: The $or's $gt. x-schemaName: RegExp $gte: oneOf: - type: string title: $gte description: The $or's $gte. - type: object description: The $or's $gte. x-schemaName: RegExp $lt: oneOf: - type: string title: $lt description: The $or's $lt. - type: object description: The $or's $lt. x-schemaName: RegExp $lte: oneOf: - type: string title: $lte description: The $or's $lte. - type: object description: The $or's $lte. x-schemaName: RegExp $like: type: string title: $like description: The $or's $like. $re: type: string title: $re description: The $or's $re. $ilike: type: string title: $ilike description: The $or's $ilike. $fulltext: type: string title: $fulltext description: The $or's $fulltext. $overlap: type: array description: The $or's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The $or's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The $or's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The $or's $exists. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $or's exec. test: type: object description: The $or's test. source: type: string title: source description: The $or's source. global: type: boolean title: global description: The $or's global. ignoreCase: type: boolean title: ignoreCase description: The $or's ignorecase. multiline: type: boolean title: multiline description: The $or's multiline. lastIndex: type: number title: lastIndex description: The $or's lastindex. compile: type: object description: The $or's compile. flags: type: string title: flags description: The $or's flags. sticky: type: boolean title: sticky description: The $or's sticky. unicode: type: boolean title: unicode description: The $or's unicode. dotAll: type: boolean title: dotAll description: The $or's dotall. __@match@1128: type: object description: The $or's @match@1128. __@replace@1130: type: object description: The $or's @replace@1130. __@search@1133: type: object description: The $or's @search@1133. __@split@1135: type: object description: The $or's @split@1135. __@matchAll@1137: type: object description: The $or's @matchall@1137. $eq: oneOf: - type: string title: $eq description: The updated at's $eq. - type: object description: The updated at's $eq. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $eq's exec. test: type: object description: The $eq's test. source: type: string title: source description: The $eq's source. global: type: boolean title: global description: The $eq's global. ignoreCase: type: boolean title: ignoreCase description: The $eq's ignorecase. multiline: type: boolean title: multiline description: The $eq's multiline. lastIndex: type: number title: lastIndex description: The $eq's lastindex. compile: type: object description: The $eq's compile. flags: type: string title: flags description: The $eq's flags. sticky: type: boolean title: sticky description: The $eq's sticky. unicode: type: boolean title: unicode description: The $eq's unicode. dotAll: type: boolean title: dotAll description: The $eq's dotall. __@match@1128: type: object description: The $eq's @match@1128. __@replace@1130: type: object description: The $eq's @replace@1130. __@search@1133: type: object description: The $eq's @search@1133. __@split@1135: type: object description: The $eq's @split@1135. __@matchAll@1137: type: object description: The $eq's @matchall@1137. - type: array description: The updated at's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $eq's exec. test: type: object description: The $eq's test. source: type: string title: source description: The $eq's source. global: type: boolean title: global description: The $eq's global. ignoreCase: type: boolean title: ignoreCase description: The $eq's ignorecase. multiline: type: boolean title: multiline description: The $eq's multiline. lastIndex: type: number title: lastIndex description: The $eq's lastindex. compile: type: object description: The $eq's compile. flags: type: string title: flags description: The $eq's flags. sticky: type: boolean title: sticky description: The $eq's sticky. unicode: type: boolean title: unicode description: The $eq's unicode. dotAll: type: boolean title: dotAll description: The $eq's dotall. __@match@1128: type: object description: The $eq's @match@1128. __@replace@1130: type: object description: The $eq's @replace@1130. __@search@1133: type: object description: The $eq's @search@1133. __@split@1135: type: object description: The $eq's @split@1135. __@matchAll@1137: type: object description: The $eq's @matchall@1137. $ne: oneOf: - type: string title: $ne description: The updated at's $ne. - type: object description: The updated at's $ne. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $ne's exec. test: type: object description: The $ne's test. source: type: string title: source description: The $ne's source. global: type: boolean title: global description: The $ne's global. ignoreCase: type: boolean title: ignoreCase description: The $ne's ignorecase. multiline: type: boolean title: multiline description: The $ne's multiline. lastIndex: type: number title: lastIndex description: The $ne's lastindex. compile: type: object description: The $ne's compile. flags: type: string title: flags description: The $ne's flags. sticky: type: boolean title: sticky description: The $ne's sticky. unicode: type: boolean title: unicode description: The $ne's unicode. dotAll: type: boolean title: dotAll description: The $ne's dotall. __@match@1128: type: object description: The $ne's @match@1128. __@replace@1130: type: object description: The $ne's @replace@1130. __@search@1133: type: object description: The $ne's @search@1133. __@split@1135: type: object description: The $ne's @split@1135. __@matchAll@1137: type: object description: The $ne's @matchall@1137. $in: type: array description: The updated at's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $in's exec. test: type: object description: The $in's test. source: type: string title: source description: The $in's source. global: type: boolean title: global description: The $in's global. ignoreCase: type: boolean title: ignoreCase description: The $in's ignorecase. multiline: type: boolean title: multiline description: The $in's multiline. lastIndex: type: number title: lastIndex description: The $in's lastindex. compile: type: object description: The $in's compile. flags: type: string title: flags description: The $in's flags. sticky: type: boolean title: sticky description: The $in's sticky. unicode: type: boolean title: unicode description: The $in's unicode. dotAll: type: boolean title: dotAll description: The $in's dotall. __@match@1128: type: object description: The $in's @match@1128. __@replace@1130: type: object description: The $in's @replace@1130. __@search@1133: type: object description: The $in's @search@1133. __@split@1135: type: object description: The $in's @split@1135. __@matchAll@1137: type: object description: The $in's @matchall@1137. $nin: type: array description: The updated at's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $nin's exec. test: type: object description: The $nin's test. source: type: string title: source description: The $nin's source. global: type: boolean title: global description: The $nin's global. ignoreCase: type: boolean title: ignoreCase description: The $nin's ignorecase. multiline: type: boolean title: multiline description: The $nin's multiline. lastIndex: type: number title: lastIndex description: The $nin's lastindex. compile: type: object description: The $nin's compile. flags: type: string title: flags description: The $nin's flags. sticky: type: boolean title: sticky description: The $nin's sticky. unicode: type: boolean title: unicode description: The $nin's unicode. dotAll: type: boolean title: dotAll description: The $nin's dotall. __@match@1128: type: object description: The $nin's @match@1128. __@replace@1130: type: object description: The $nin's @replace@1130. __@search@1133: type: object description: The $nin's @search@1133. __@split@1135: type: object description: The $nin's @split@1135. __@matchAll@1137: type: object description: The $nin's @matchall@1137. $not: oneOf: - type: string title: $not description: The updated at's $not. - type: object description: The updated at's $not. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $not's exec. test: type: object description: The $not's test. source: type: string title: source description: The $not's source. global: type: boolean title: global description: The $not's global. ignoreCase: type: boolean title: ignoreCase description: The $not's ignorecase. multiline: type: boolean title: multiline description: The $not's multiline. lastIndex: type: number title: lastIndex description: The $not's lastindex. compile: type: object description: The $not's compile. flags: type: string title: flags description: The $not's flags. sticky: type: boolean title: sticky description: The $not's sticky. unicode: type: boolean title: unicode description: The $not's unicode. dotAll: type: boolean title: dotAll description: The $not's dotall. __@match@1128: type: object description: The $not's @match@1128. __@replace@1130: type: object description: The $not's @replace@1130. __@search@1133: type: object description: The $not's @search@1133. __@split@1135: type: object description: The $not's @split@1135. __@matchAll@1137: type: object description: The $not's @matchall@1137. - type: object description: The updated at's $not. properties: $and: type: array description: The $not's $and. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp - type: object description: The $and's details. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp $or: type: array description: The $not's $or. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp - type: object description: The $or's details. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp $eq: oneOf: - type: string title: $eq description: The $not's $eq. - type: object description: The $not's $eq. x-schemaName: RegExp - type: array description: The $not's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp $ne: oneOf: - type: string title: $ne description: The $not's $ne. - type: object description: The $not's $ne. x-schemaName: RegExp $in: type: array description: The $not's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp $nin: type: array description: The $not's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp $not: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp - type: object description: The $not's details. - type: array description: The $not's details. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp $gt: oneOf: - type: string title: $gt description: The $not's $gt. - type: object description: The $not's $gt. x-schemaName: RegExp $gte: oneOf: - type: string title: $gte description: The $not's $gte. - type: object description: The $not's $gte. x-schemaName: RegExp $lt: oneOf: - type: string title: $lt description: The $not's $lt. - type: object description: The $not's $lt. x-schemaName: RegExp $lte: oneOf: - type: string title: $lte description: The $not's $lte. - type: object description: The $not's $lte. x-schemaName: RegExp $like: type: string title: $like description: The $not's $like. $re: type: string title: $re description: The $not's $re. $ilike: type: string title: $ilike description: The $not's $ilike. $fulltext: type: string title: $fulltext description: The $not's $fulltext. $overlap: type: array description: The $not's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The $not's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The $not's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The $not's $exists. - type: array description: The updated at's $not. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $not's exec. test: type: object description: The $not's test. source: type: string title: source description: The $not's source. global: type: boolean title: global description: The $not's global. ignoreCase: type: boolean title: ignoreCase description: The $not's ignorecase. multiline: type: boolean title: multiline description: The $not's multiline. lastIndex: type: number title: lastIndex description: The $not's lastindex. compile: type: object description: The $not's compile. flags: type: string title: flags description: The $not's flags. sticky: type: boolean title: sticky description: The $not's sticky. unicode: type: boolean title: unicode description: The $not's unicode. dotAll: type: boolean title: dotAll description: The $not's dotall. __@match@1128: type: object description: The $not's @match@1128. __@replace@1130: type: object description: The $not's @replace@1130. __@search@1133: type: object description: The $not's @search@1133. __@split@1135: type: object description: The $not's @split@1135. __@matchAll@1137: type: object description: The $not's @matchall@1137. $gt: oneOf: - type: string title: $gt description: The updated at's $gt. - type: object description: The updated at's $gt. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $gt's exec. test: type: object description: The $gt's test. source: type: string title: source description: The $gt's source. global: type: boolean title: global description: The $gt's global. ignoreCase: type: boolean title: ignoreCase description: The $gt's ignorecase. multiline: type: boolean title: multiline description: The $gt's multiline. lastIndex: type: number title: lastIndex description: The $gt's lastindex. compile: type: object description: The $gt's compile. flags: type: string title: flags description: The $gt's flags. sticky: type: boolean title: sticky description: The $gt's sticky. unicode: type: boolean title: unicode description: The $gt's unicode. dotAll: type: boolean title: dotAll description: The $gt's dotall. __@match@1128: type: object description: The $gt's @match@1128. __@replace@1130: type: object description: The $gt's @replace@1130. __@search@1133: type: object description: The $gt's @search@1133. __@split@1135: type: object description: The $gt's @split@1135. __@matchAll@1137: type: object description: The $gt's @matchall@1137. $gte: oneOf: - type: string title: $gte description: The updated at's $gte. - type: object description: The updated at's $gte. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $gte's exec. test: type: object description: The $gte's test. source: type: string title: source description: The $gte's source. global: type: boolean title: global description: The $gte's global. ignoreCase: type: boolean title: ignoreCase description: The $gte's ignorecase. multiline: type: boolean title: multiline description: The $gte's multiline. lastIndex: type: number title: lastIndex description: The $gte's lastindex. compile: type: object description: The $gte's compile. flags: type: string title: flags description: The $gte's flags. sticky: type: boolean title: sticky description: The $gte's sticky. unicode: type: boolean title: unicode description: The $gte's unicode. dotAll: type: boolean title: dotAll description: The $gte's dotall. __@match@1128: type: object description: The $gte's @match@1128. __@replace@1130: type: object description: The $gte's @replace@1130. __@search@1133: type: object description: The $gte's @search@1133. __@split@1135: type: object description: The $gte's @split@1135. __@matchAll@1137: type: object description: The $gte's @matchall@1137. $lt: oneOf: - type: string title: $lt description: The updated at's $lt. - type: object description: The updated at's $lt. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $lt's exec. test: type: object description: The $lt's test. source: type: string title: source description: The $lt's source. global: type: boolean title: global description: The $lt's global. ignoreCase: type: boolean title: ignoreCase description: The $lt's ignorecase. multiline: type: boolean title: multiline description: The $lt's multiline. lastIndex: type: number title: lastIndex description: The $lt's lastindex. compile: type: object description: The $lt's compile. flags: type: string title: flags description: The $lt's flags. sticky: type: boolean title: sticky description: The $lt's sticky. unicode: type: boolean title: unicode description: The $lt's unicode. dotAll: type: boolean title: dotAll description: The $lt's dotall. __@match@1128: type: object description: The $lt's @match@1128. __@replace@1130: type: object description: The $lt's @replace@1130. __@search@1133: type: object description: The $lt's @search@1133. __@split@1135: type: object description: The $lt's @split@1135. __@matchAll@1137: type: object description: The $lt's @matchall@1137. $lte: oneOf: - type: string title: $lte description: The updated at's $lte. - type: object description: The updated at's $lte. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $lte's exec. test: type: object description: The $lte's test. source: type: string title: source description: The $lte's source. global: type: boolean title: global description: The $lte's global. ignoreCase: type: boolean title: ignoreCase description: The $lte's ignorecase. multiline: type: boolean title: multiline description: The $lte's multiline. lastIndex: type: number title: lastIndex description: The $lte's lastindex. compile: type: object description: The $lte's compile. flags: type: string title: flags description: The $lte's flags. sticky: type: boolean title: sticky description: The $lte's sticky. unicode: type: boolean title: unicode description: The $lte's unicode. dotAll: type: boolean title: dotAll description: The $lte's dotall. __@match@1128: type: object description: The $lte's @match@1128. __@replace@1130: type: object description: The $lte's @replace@1130. __@search@1133: type: object description: The $lte's @search@1133. __@split@1135: type: object description: The $lte's @split@1135. __@matchAll@1137: type: object description: The $lte's @matchall@1137. $like: type: string title: $like description: The updated at's $like. $re: type: string title: $re description: The updated at's $re. $ilike: type: string title: $ilike description: The updated at's $ilike. $fulltext: type: string title: $fulltext description: The updated at's $fulltext. $overlap: type: array description: The updated at's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The updated at's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The updated at's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The updated at's $exists. - name: deleted_at in: query description: The product's deleted at. required: false schema: type: object description: The product's deleted at. properties: $and: type: array description: The deleted at's $and. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $and's exec. test: type: object description: The $and's test. source: type: string title: source description: The $and's source. global: type: boolean title: global description: The $and's global. ignoreCase: type: boolean title: ignoreCase description: The $and's ignorecase. multiline: type: boolean title: multiline description: The $and's multiline. lastIndex: type: number title: lastIndex description: The $and's lastindex. compile: type: object description: The $and's compile. flags: type: string title: flags description: The $and's flags. sticky: type: boolean title: sticky description: The $and's sticky. unicode: type: boolean title: unicode description: The $and's unicode. dotAll: type: boolean title: dotAll description: The $and's dotall. __@match@1128: type: object description: The $and's @match@1128. __@replace@1130: type: object description: The $and's @replace@1130. __@search@1133: type: object description: The $and's @search@1133. __@split@1135: type: object description: The $and's @split@1135. __@matchAll@1137: type: object description: The $and's @matchall@1137. - type: object description: The $and's details. properties: $and: type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp - type: object description: The $and's details. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp $or: type: array description: The $and's $or. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp - type: object description: The $or's details. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp $eq: oneOf: - type: string title: $eq description: The $and's $eq. - type: object description: The $and's $eq. x-schemaName: RegExp - type: array description: The $and's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp $ne: oneOf: - type: string title: $ne description: The $and's $ne. - type: object description: The $and's $ne. x-schemaName: RegExp $in: type: array description: The $and's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp $nin: type: array description: The $and's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp $not: oneOf: - type: string title: $not description: The $and's $not. - type: object description: The $and's $not. x-schemaName: RegExp - type: object description: The $and's $not. - type: array description: The $and's $not. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp $gt: oneOf: - type: string title: $gt description: The $and's $gt. - type: object description: The $and's $gt. x-schemaName: RegExp $gte: oneOf: - type: string title: $gte description: The $and's $gte. - type: object description: The $and's $gte. x-schemaName: RegExp $lt: oneOf: - type: string title: $lt description: The $and's $lt. - type: object description: The $and's $lt. x-schemaName: RegExp $lte: oneOf: - type: string title: $lte description: The $and's $lte. - type: object description: The $and's $lte. x-schemaName: RegExp $like: type: string title: $like description: The $and's $like. $re: type: string title: $re description: The $and's $re. $ilike: type: string title: $ilike description: The $and's $ilike. $fulltext: type: string title: $fulltext description: The $and's $fulltext. $overlap: type: array description: The $and's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The $and's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The $and's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The $and's $exists. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $and's exec. test: type: object description: The $and's test. source: type: string title: source description: The $and's source. global: type: boolean title: global description: The $and's global. ignoreCase: type: boolean title: ignoreCase description: The $and's ignorecase. multiline: type: boolean title: multiline description: The $and's multiline. lastIndex: type: number title: lastIndex description: The $and's lastindex. compile: type: object description: The $and's compile. flags: type: string title: flags description: The $and's flags. sticky: type: boolean title: sticky description: The $and's sticky. unicode: type: boolean title: unicode description: The $and's unicode. dotAll: type: boolean title: dotAll description: The $and's dotall. __@match@1128: type: object description: The $and's @match@1128. __@replace@1130: type: object description: The $and's @replace@1130. __@search@1133: type: object description: The $and's @search@1133. __@split@1135: type: object description: The $and's @split@1135. __@matchAll@1137: type: object description: The $and's @matchall@1137. $or: type: array description: The deleted at's $or. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $or's exec. test: type: object description: The $or's test. source: type: string title: source description: The $or's source. global: type: boolean title: global description: The $or's global. ignoreCase: type: boolean title: ignoreCase description: The $or's ignorecase. multiline: type: boolean title: multiline description: The $or's multiline. lastIndex: type: number title: lastIndex description: The $or's lastindex. compile: type: object description: The $or's compile. flags: type: string title: flags description: The $or's flags. sticky: type: boolean title: sticky description: The $or's sticky. unicode: type: boolean title: unicode description: The $or's unicode. dotAll: type: boolean title: dotAll description: The $or's dotall. __@match@1128: type: object description: The $or's @match@1128. __@replace@1130: type: object description: The $or's @replace@1130. __@search@1133: type: object description: The $or's @search@1133. __@split@1135: type: object description: The $or's @split@1135. __@matchAll@1137: type: object description: The $or's @matchall@1137. - type: object description: The $or's details. properties: $and: type: array description: The $or's $and. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp - type: object description: The $and's details. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp $or: type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp - type: object description: The $or's details. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp $eq: oneOf: - type: string title: $eq description: The $or's $eq. - type: object description: The $or's $eq. x-schemaName: RegExp - type: array description: The $or's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp $ne: oneOf: - type: string title: $ne description: The $or's $ne. - type: object description: The $or's $ne. x-schemaName: RegExp $in: type: array description: The $or's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp $nin: type: array description: The $or's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp $not: oneOf: - type: string title: $not description: The $or's $not. - type: object description: The $or's $not. x-schemaName: RegExp - type: object description: The $or's $not. - type: array description: The $or's $not. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp $gt: oneOf: - type: string title: $gt description: The $or's $gt. - type: object description: The $or's $gt. x-schemaName: RegExp $gte: oneOf: - type: string title: $gte description: The $or's $gte. - type: object description: The $or's $gte. x-schemaName: RegExp $lt: oneOf: - type: string title: $lt description: The $or's $lt. - type: object description: The $or's $lt. x-schemaName: RegExp $lte: oneOf: - type: string title: $lte description: The $or's $lte. - type: object description: The $or's $lte. x-schemaName: RegExp $like: type: string title: $like description: The $or's $like. $re: type: string title: $re description: The $or's $re. $ilike: type: string title: $ilike description: The $or's $ilike. $fulltext: type: string title: $fulltext description: The $or's $fulltext. $overlap: type: array description: The $or's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The $or's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The $or's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The $or's $exists. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $or's exec. test: type: object description: The $or's test. source: type: string title: source description: The $or's source. global: type: boolean title: global description: The $or's global. ignoreCase: type: boolean title: ignoreCase description: The $or's ignorecase. multiline: type: boolean title: multiline description: The $or's multiline. lastIndex: type: number title: lastIndex description: The $or's lastindex. compile: type: object description: The $or's compile. flags: type: string title: flags description: The $or's flags. sticky: type: boolean title: sticky description: The $or's sticky. unicode: type: boolean title: unicode description: The $or's unicode. dotAll: type: boolean title: dotAll description: The $or's dotall. __@match@1128: type: object description: The $or's @match@1128. __@replace@1130: type: object description: The $or's @replace@1130. __@search@1133: type: object description: The $or's @search@1133. __@split@1135: type: object description: The $or's @split@1135. __@matchAll@1137: type: object description: The $or's @matchall@1137. $eq: oneOf: - type: string title: $eq description: The deleted at's $eq. - type: object description: The deleted at's $eq. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $eq's exec. test: type: object description: The $eq's test. source: type: string title: source description: The $eq's source. global: type: boolean title: global description: The $eq's global. ignoreCase: type: boolean title: ignoreCase description: The $eq's ignorecase. multiline: type: boolean title: multiline description: The $eq's multiline. lastIndex: type: number title: lastIndex description: The $eq's lastindex. compile: type: object description: The $eq's compile. flags: type: string title: flags description: The $eq's flags. sticky: type: boolean title: sticky description: The $eq's sticky. unicode: type: boolean title: unicode description: The $eq's unicode. dotAll: type: boolean title: dotAll description: The $eq's dotall. __@match@1128: type: object description: The $eq's @match@1128. __@replace@1130: type: object description: The $eq's @replace@1130. __@search@1133: type: object description: The $eq's @search@1133. __@split@1135: type: object description: The $eq's @split@1135. __@matchAll@1137: type: object description: The $eq's @matchall@1137. - type: array description: The deleted at's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $eq's exec. test: type: object description: The $eq's test. source: type: string title: source description: The $eq's source. global: type: boolean title: global description: The $eq's global. ignoreCase: type: boolean title: ignoreCase description: The $eq's ignorecase. multiline: type: boolean title: multiline description: The $eq's multiline. lastIndex: type: number title: lastIndex description: The $eq's lastindex. compile: type: object description: The $eq's compile. flags: type: string title: flags description: The $eq's flags. sticky: type: boolean title: sticky description: The $eq's sticky. unicode: type: boolean title: unicode description: The $eq's unicode. dotAll: type: boolean title: dotAll description: The $eq's dotall. __@match@1128: type: object description: The $eq's @match@1128. __@replace@1130: type: object description: The $eq's @replace@1130. __@search@1133: type: object description: The $eq's @search@1133. __@split@1135: type: object description: The $eq's @split@1135. __@matchAll@1137: type: object description: The $eq's @matchall@1137. $ne: oneOf: - type: string title: $ne description: The deleted at's $ne. - type: object description: The deleted at's $ne. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $ne's exec. test: type: object description: The $ne's test. source: type: string title: source description: The $ne's source. global: type: boolean title: global description: The $ne's global. ignoreCase: type: boolean title: ignoreCase description: The $ne's ignorecase. multiline: type: boolean title: multiline description: The $ne's multiline. lastIndex: type: number title: lastIndex description: The $ne's lastindex. compile: type: object description: The $ne's compile. flags: type: string title: flags description: The $ne's flags. sticky: type: boolean title: sticky description: The $ne's sticky. unicode: type: boolean title: unicode description: The $ne's unicode. dotAll: type: boolean title: dotAll description: The $ne's dotall. __@match@1128: type: object description: The $ne's @match@1128. __@replace@1130: type: object description: The $ne's @replace@1130. __@search@1133: type: object description: The $ne's @search@1133. __@split@1135: type: object description: The $ne's @split@1135. __@matchAll@1137: type: object description: The $ne's @matchall@1137. $in: type: array description: The deleted at's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $in's exec. test: type: object description: The $in's test. source: type: string title: source description: The $in's source. global: type: boolean title: global description: The $in's global. ignoreCase: type: boolean title: ignoreCase description: The $in's ignorecase. multiline: type: boolean title: multiline description: The $in's multiline. lastIndex: type: number title: lastIndex description: The $in's lastindex. compile: type: object description: The $in's compile. flags: type: string title: flags description: The $in's flags. sticky: type: boolean title: sticky description: The $in's sticky. unicode: type: boolean title: unicode description: The $in's unicode. dotAll: type: boolean title: dotAll description: The $in's dotall. __@match@1128: type: object description: The $in's @match@1128. __@replace@1130: type: object description: The $in's @replace@1130. __@search@1133: type: object description: The $in's @search@1133. __@split@1135: type: object description: The $in's @split@1135. __@matchAll@1137: type: object description: The $in's @matchall@1137. $nin: type: array description: The deleted at's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $nin's exec. test: type: object description: The $nin's test. source: type: string title: source description: The $nin's source. global: type: boolean title: global description: The $nin's global. ignoreCase: type: boolean title: ignoreCase description: The $nin's ignorecase. multiline: type: boolean title: multiline description: The $nin's multiline. lastIndex: type: number title: lastIndex description: The $nin's lastindex. compile: type: object description: The $nin's compile. flags: type: string title: flags description: The $nin's flags. sticky: type: boolean title: sticky description: The $nin's sticky. unicode: type: boolean title: unicode description: The $nin's unicode. dotAll: type: boolean title: dotAll description: The $nin's dotall. __@match@1128: type: object description: The $nin's @match@1128. __@replace@1130: type: object description: The $nin's @replace@1130. __@search@1133: type: object description: The $nin's @search@1133. __@split@1135: type: object description: The $nin's @split@1135. __@matchAll@1137: type: object description: The $nin's @matchall@1137. $not: oneOf: - type: string title: $not description: The deleted at's $not. - type: object description: The deleted at's $not. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $not's exec. test: type: object description: The $not's test. source: type: string title: source description: The $not's source. global: type: boolean title: global description: The $not's global. ignoreCase: type: boolean title: ignoreCase description: The $not's ignorecase. multiline: type: boolean title: multiline description: The $not's multiline. lastIndex: type: number title: lastIndex description: The $not's lastindex. compile: type: object description: The $not's compile. flags: type: string title: flags description: The $not's flags. sticky: type: boolean title: sticky description: The $not's sticky. unicode: type: boolean title: unicode description: The $not's unicode. dotAll: type: boolean title: dotAll description: The $not's dotall. __@match@1128: type: object description: The $not's @match@1128. __@replace@1130: type: object description: The $not's @replace@1130. __@search@1133: type: object description: The $not's @search@1133. __@split@1135: type: object description: The $not's @split@1135. __@matchAll@1137: type: object description: The $not's @matchall@1137. - type: object description: The deleted at's $not. properties: $and: type: array description: The $not's $and. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp - type: object description: The $and's details. - type: array description: The $and's details. items: oneOf: - type: string title: $and description: The $and's details. - type: object description: The $and's details. x-schemaName: RegExp $or: type: array description: The $not's $or. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp - type: object description: The $or's details. - type: array description: The $or's details. items: oneOf: - type: string title: $or description: The $or's details. - type: object description: The $or's details. x-schemaName: RegExp $eq: oneOf: - type: string title: $eq description: The $not's $eq. - type: object description: The $not's $eq. x-schemaName: RegExp - type: array description: The $not's $eq. items: oneOf: - type: string title: $eq description: The $eq's details. - type: object description: The $eq's details. x-schemaName: RegExp $ne: oneOf: - type: string title: $ne description: The $not's $ne. - type: object description: The $not's $ne. x-schemaName: RegExp $in: type: array description: The $not's $in. items: oneOf: - type: string title: $in description: The $in's details. - type: object description: The $in's details. x-schemaName: RegExp $nin: type: array description: The $not's $nin. items: oneOf: - type: string title: $nin description: The $nin's details. - type: object description: The $nin's details. x-schemaName: RegExp $not: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp - type: object description: The $not's details. - type: array description: The $not's details. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp $gt: oneOf: - type: string title: $gt description: The $not's $gt. - type: object description: The $not's $gt. x-schemaName: RegExp $gte: oneOf: - type: string title: $gte description: The $not's $gte. - type: object description: The $not's $gte. x-schemaName: RegExp $lt: oneOf: - type: string title: $lt description: The $not's $lt. - type: object description: The $not's $lt. x-schemaName: RegExp $lte: oneOf: - type: string title: $lte description: The $not's $lte. - type: object description: The $not's $lte. x-schemaName: RegExp $like: type: string title: $like description: The $not's $like. $re: type: string title: $re description: The $not's $re. $ilike: type: string title: $ilike description: The $not's $ilike. $fulltext: type: string title: $fulltext description: The $not's $fulltext. $overlap: type: array description: The $not's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The $not's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The $not's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The $not's $exists. - type: array description: The deleted at's $not. items: oneOf: - type: string title: $not description: The $not's details. - type: object description: The $not's details. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $not's exec. test: type: object description: The $not's test. source: type: string title: source description: The $not's source. global: type: boolean title: global description: The $not's global. ignoreCase: type: boolean title: ignoreCase description: The $not's ignorecase. multiline: type: boolean title: multiline description: The $not's multiline. lastIndex: type: number title: lastIndex description: The $not's lastindex. compile: type: object description: The $not's compile. flags: type: string title: flags description: The $not's flags. sticky: type: boolean title: sticky description: The $not's sticky. unicode: type: boolean title: unicode description: The $not's unicode. dotAll: type: boolean title: dotAll description: The $not's dotall. __@match@1128: type: object description: The $not's @match@1128. __@replace@1130: type: object description: The $not's @replace@1130. __@search@1133: type: object description: The $not's @search@1133. __@split@1135: type: object description: The $not's @split@1135. __@matchAll@1137: type: object description: The $not's @matchall@1137. $gt: oneOf: - type: string title: $gt description: The deleted at's $gt. - type: object description: The deleted at's $gt. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $gt's exec. test: type: object description: The $gt's test. source: type: string title: source description: The $gt's source. global: type: boolean title: global description: The $gt's global. ignoreCase: type: boolean title: ignoreCase description: The $gt's ignorecase. multiline: type: boolean title: multiline description: The $gt's multiline. lastIndex: type: number title: lastIndex description: The $gt's lastindex. compile: type: object description: The $gt's compile. flags: type: string title: flags description: The $gt's flags. sticky: type: boolean title: sticky description: The $gt's sticky. unicode: type: boolean title: unicode description: The $gt's unicode. dotAll: type: boolean title: dotAll description: The $gt's dotall. __@match@1128: type: object description: The $gt's @match@1128. __@replace@1130: type: object description: The $gt's @replace@1130. __@search@1133: type: object description: The $gt's @search@1133. __@split@1135: type: object description: The $gt's @split@1135. __@matchAll@1137: type: object description: The $gt's @matchall@1137. $gte: oneOf: - type: string title: $gte description: The deleted at's $gte. - type: object description: The deleted at's $gte. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $gte's exec. test: type: object description: The $gte's test. source: type: string title: source description: The $gte's source. global: type: boolean title: global description: The $gte's global. ignoreCase: type: boolean title: ignoreCase description: The $gte's ignorecase. multiline: type: boolean title: multiline description: The $gte's multiline. lastIndex: type: number title: lastIndex description: The $gte's lastindex. compile: type: object description: The $gte's compile. flags: type: string title: flags description: The $gte's flags. sticky: type: boolean title: sticky description: The $gte's sticky. unicode: type: boolean title: unicode description: The $gte's unicode. dotAll: type: boolean title: dotAll description: The $gte's dotall. __@match@1128: type: object description: The $gte's @match@1128. __@replace@1130: type: object description: The $gte's @replace@1130. __@search@1133: type: object description: The $gte's @search@1133. __@split@1135: type: object description: The $gte's @split@1135. __@matchAll@1137: type: object description: The $gte's @matchall@1137. $lt: oneOf: - type: string title: $lt description: The deleted at's $lt. - type: object description: The deleted at's $lt. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $lt's exec. test: type: object description: The $lt's test. source: type: string title: source description: The $lt's source. global: type: boolean title: global description: The $lt's global. ignoreCase: type: boolean title: ignoreCase description: The $lt's ignorecase. multiline: type: boolean title: multiline description: The $lt's multiline. lastIndex: type: number title: lastIndex description: The $lt's lastindex. compile: type: object description: The $lt's compile. flags: type: string title: flags description: The $lt's flags. sticky: type: boolean title: sticky description: The $lt's sticky. unicode: type: boolean title: unicode description: The $lt's unicode. dotAll: type: boolean title: dotAll description: The $lt's dotall. __@match@1128: type: object description: The $lt's @match@1128. __@replace@1130: type: object description: The $lt's @replace@1130. __@search@1133: type: object description: The $lt's @search@1133. __@split@1135: type: object description: The $lt's @split@1135. __@matchAll@1137: type: object description: The $lt's @matchall@1137. $lte: oneOf: - type: string title: $lte description: The deleted at's $lte. - type: object description: The deleted at's $lte. x-schemaName: RegExp required: - exec - test - source - global - ignoreCase - multiline - lastIndex - flags - sticky - unicode - dotAll - __@match@1128 - __@replace@1130 - __@search@1133 - __@matchAll@1137 properties: exec: type: object description: The $lte's exec. test: type: object description: The $lte's test. source: type: string title: source description: The $lte's source. global: type: boolean title: global description: The $lte's global. ignoreCase: type: boolean title: ignoreCase description: The $lte's ignorecase. multiline: type: boolean title: multiline description: The $lte's multiline. lastIndex: type: number title: lastIndex description: The $lte's lastindex. compile: type: object description: The $lte's compile. flags: type: string title: flags description: The $lte's flags. sticky: type: boolean title: sticky description: The $lte's sticky. unicode: type: boolean title: unicode description: The $lte's unicode. dotAll: type: boolean title: dotAll description: The $lte's dotall. __@match@1128: type: object description: The $lte's @match@1128. __@replace@1130: type: object description: The $lte's @replace@1130. __@search@1133: type: object description: The $lte's @search@1133. __@split@1135: type: object description: The $lte's @split@1135. __@matchAll@1137: type: object description: The $lte's @matchall@1137. $like: type: string title: $like description: The deleted at's $like. $re: type: string title: $re description: The deleted at's $re. $ilike: type: string title: $ilike description: The deleted at's $ilike. $fulltext: type: string title: $fulltext description: The deleted at's $fulltext. $overlap: type: array description: The deleted at's $overlap. items: type: string title: $overlap description: The $overlap's details. $contains: type: array description: The deleted at's $contains. items: type: string title: $contains description: The $contain's $contains. $contained: type: array description: The deleted at's $contained. items: type: string title: $contained description: The $contained's details. $exists: type: boolean title: $exists description: The deleted at's $exists. - name: $and in: query description: The product's $and. required: false schema: type: array description: The product's $and. items: type: array items: type: object title: $and - name: $or in: query description: The product's $or. required: false schema: type: array description: The product's $or. items: type: array items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/products' \ -H 'x-medusa-access-token: {api_token}' tags: - Products 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's limit. offset: type: number title: offset description: The product's offset. count: type: number title: count description: The product's count. - type: object description: SUMMARY required: - products properties: products: type: array description: The product's products. items: type: object '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' post: operationId: PostProducts summary: Create Product description: Create a product. 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: [] requestBody: content: application/json: schema: allOf: - $ref: '#/components/schemas/AdminCreateProduct' - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/products' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "title": "{value}" }' tags: - Products responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductResponse' '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: createProductsWorkflow /admin/products/batch: post: operationId: PostProductsBatch summary: Create Product description: Create a product. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminBatchProductRequest' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/products/batch' \ -H 'x-medusa-access-token: {api_token}' tags: - Products responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminBatchProductResponse' '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: batchProductsWorkflow /admin/products/export: post: operationId: PostProductsExport summary: Create Product description: Create a product. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminExportProductRequest' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/products/export' \ -H 'x-medusa-access-token: {api_token}' tags: - Products responses: '202': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminExportProductResponse' '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: exportProductsWorkflow /admin/products/import: post: operationId: PostProductsImport summary: Create Product description: Create a product. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminImportProductRequest' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/products/import' \ -H 'x-medusa-access-token: {api_token}' tags: - Products responses: '202': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminImportProductResponse' '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: importProductsWorkflow /admin/products/import/{transaction_id}/confirm: post: operationId: PostProductsImportTransaction_idConfirm summary: Add Confirms to Product description: Add a list of confirms to a product. x-authenticated: true parameters: - name: transaction_id in: path description: The product's transaction 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 POST '{backend_url}/admin/products/import/{transaction_id}/confirm' \ -H 'x-medusa-access-token: {api_token}' tags: - Products responses: '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' requestBody: content: application/json: schema: {} /admin/products/{id}: get: operationId: GetProductsId summary: Get a Product description: Retrieve a product by its ID. You can expand the product's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The product'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/products/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Products responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductResponse' '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' post: operationId: PostProductsId summary: Update a Product description: Update a product's details. x-authenticated: true parameters: - name: id in: path description: The product'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: [] requestBody: content: application/json: schema: allOf: - $ref: '#/components/schemas/AdminUpdateProduct' - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/products/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Products responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductResponse' '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: updateProductsWorkflow delete: operationId: DeleteProductsId summary: Delete a Product description: Delete a product. x-authenticated: true parameters: - name: id in: path description: The product'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/products/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Products responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductDeleteResponse' '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' /admin/products/{id}/options: get: operationId: GetProductsIdOptions summary: List Options description: Retrieve a list of options in a product. The options can be filtered by fields like FILTER FIELDS. The options can also be paginated. x-authenticated: true parameters: - name: id in: path description: The product'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 `-`. - name: q in: query description: The product's q. required: false schema: type: string title: q description: The product's q. - name: id in: query required: false schema: oneOf: - type: string title: id description: The product's ID. - type: array description: The product's ID. items: type: string title: id description: The id's ID. - name: title in: query required: false schema: oneOf: - type: string title: title description: The product's title. - type: array description: The product's title. items: type: string title: title description: The title's details. - name: product_id in: query required: false schema: oneOf: - type: string title: product_id description: The product's product id. - type: array description: The product's product id. items: type: string title: product_id description: The product id's details. - name: $and in: query description: The product's $and. required: false schema: type: array description: The product's $and. items: type: array items: type: object title: $and - name: $or in: query description: The product's $or. required: false schema: type: array description: The product's $or. items: type: array items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/products/{id}/options' \ -H 'x-medusa-access-token: {api_token}' tags: - Products 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's limit. offset: type: number title: offset description: The product's offset. count: type: number title: count description: The product's count. - type: object description: SUMMARY required: - product_options properties: product_options: type: array description: The product's product options. items: $ref: '#/components/schemas/AdminProductOption' '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' post: operationId: PostProductsIdOptions summary: Add Options to Product description: Add a list of options to a product. x-authenticated: true parameters: - name: id in: path description: The product'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: [] requestBody: content: application/json: schema: allOf: - $ref: '#/components/schemas/AdminCreateProductOption' - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/products/{id}/options' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "title": "{value}", "values": [ "{value}" ] }' tags: - Products responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductResponse' '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' /admin/products/{id}/options/{option_id}: get: operationId: GetProductsIdOptionsOption_id summary: List Options description: Retrieve a list of options in a product. The options can be filtered by fields like FILTER FIELDS. The options can also be paginated. x-authenticated: true parameters: - name: id in: path description: The product's ID. required: true schema: type: string - name: option_id in: path description: The product's option 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/products/{id}/options/{option_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Products responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductOptionResponse' '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' post: operationId: PostProductsIdOptionsOption_id summary: Add Options to Product description: Add a list of options to a product. x-authenticated: true parameters: - name: id in: path description: The product's ID. required: true schema: type: string - name: option_id in: path description: The product's option 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: allOf: - $ref: '#/components/schemas/AdminUpdateProductOption' - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/products/{id}/options/{option_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Products responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductResponse' '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' delete: operationId: DeleteProductsIdOptionsOption_id summary: Remove Options from Product description: Remove a list of options from a product. This doesn't delete the Option, only the association between the Option and the product. x-authenticated: true parameters: - name: id in: path description: The product's ID. required: true schema: type: string - name: option_id in: path description: The product's option 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/products/{id}/options/{option_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Products responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductOptionDeleteResponse' '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' /admin/products/{id}/variants: get: operationId: GetProductsIdVariants summary: List Variants description: Retrieve a list of variants in a product. The variants can be filtered by fields like FILTER FIELDS. The variants can also be paginated. x-authenticated: true parameters: - name: id in: path description: The product'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/products/{id}/variants' \ -H 'x-medusa-access-token: {api_token}' tags: - Products 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's limit. offset: type: number title: offset description: The product's offset. count: type: number title: count description: The product's count. - type: object description: SUMMARY required: - variants properties: variants: type: array description: The product'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' post: operationId: PostProductsIdVariants summary: Add Variants to Product description: Add a list of variants to a product. x-authenticated: true parameters: - name: id in: path description: The product'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: [] requestBody: content: application/json: schema: allOf: - $ref: '#/components/schemas/AdminCreateProductVariant' - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/products/{id}/variants' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "title": "{value}", "prices": [] }' tags: - Products responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductResponse' '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' /admin/products/{id}/variants/batch: post: operationId: PostProductsIdVariantsBatch summary: Add Variants to Product description: Add a list of variants to a product. x-authenticated: true parameters: - name: id in: path description: The product'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminBatchProductVariantRequest' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/products/{id}/variants/batch' \ -H 'x-medusa-access-token: {api_token}' tags: - Products responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminBatchProductVariantResponse' '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: batchProductVariantsWorkflow /admin/products/{id}/variants/inventory-items/batch: post: operationId: PostProductsIdVariantsInventoryItemsBatch summary: Add Inventory Items to Product description: Add a list of inventory items to a product. x-authenticated: true parameters: - name: id in: path description: The product'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: create: type: array description: The product's create. items: type: object description: The create's details. required: - required_quantity - inventory_item_id - variant_id properties: required_quantity: type: number title: required_quantity description: The create's required quantity. inventory_item_id: type: string title: inventory_item_id description: The create's inventory item id. variant_id: type: string title: variant_id description: The create's variant id. update: type: array description: The product's update. items: type: object description: The update's details. required: - required_quantity - inventory_item_id - variant_id properties: required_quantity: type: number title: required_quantity description: The update's required quantity. inventory_item_id: type: string title: inventory_item_id description: The update's inventory item id. variant_id: type: string title: variant_id description: The update's variant id. delete: type: array description: The product's delete. items: type: object description: The delete's details. required: - inventory_item_id - variant_id properties: inventory_item_id: type: string title: inventory_item_id description: The delete's inventory item id. variant_id: type: string title: variant_id description: The delete's variant id. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/products/{id}/variants/inventory-items/batch' \ -H 'x-medusa-access-token: {api_token}' tags: - Products responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductVariantInventoryBatchResponse' '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: batchLinksWorkflow /admin/products/{id}/variants/{variant_id}: get: operationId: GetProductsIdVariantsVariant_id summary: List Variants description: Retrieve a list of variants in a product. The variants can be filtered by fields like FILTER FIELDS. The variants can also be paginated. x-authenticated: true parameters: - name: id in: path description: The product's ID. required: true schema: type: string - name: variant_id in: path description: The product's variant 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/products/{id}/variants/{variant_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Products responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductVariantResponse' '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' post: operationId: PostProductsIdVariantsVariant_id summary: Add Variants to Product description: Add a list of variants to a product. x-authenticated: true parameters: - name: id in: path description: The product's ID. required: true schema: type: string - name: variant_id in: path description: The product's variant 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: allOf: - $ref: '#/components/schemas/AdminUpdateProductVariant' - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/products/{id}/variants/{variant_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Products responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductResponse' '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' delete: operationId: DeleteProductsIdVariantsVariant_id summary: Remove Variants from Product description: Remove a list of variants from a product. This doesn't delete the Variant, only the association between the Variant and the product. x-authenticated: true parameters: - name: id in: path description: The product's ID. required: true schema: type: string - name: variant_id in: path description: The product's variant 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/products/{id}/variants/{variant_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Products responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductVariantDeleteResponse' '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' /admin/products/{id}/variants/{variant_id}/inventory-items: post: operationId: PostProductsIdVariantsVariant_idInventoryItems summary: Add Inventory Items to Product description: Add a list of inventory items to a product. x-authenticated: true parameters: - name: id in: path description: The product's ID. required: true schema: type: string - name: variant_id in: path description: The product's variant 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/AdminCreateVariantInventoryItem' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/products/{id}/variants/{variant_id}/inventory-items' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "required_quantity": 7390879820021760, "inventory_item_id": "{value}" }' tags: - Products responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductVariantResponse' '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' /admin/products/{id}/variants/{variant_id}/inventory-items/{inventory_item_id}: post: operationId: PostProductsIdVariantsVariant_idInventoryItemsInventory_item_id summary: Add Inventory Items to Product description: Add a list of inventory items to a product. x-authenticated: true parameters: - name: id in: path description: The product's ID. required: true schema: type: string - name: variant_id in: path description: The product's variant id. required: true schema: type: string - name: inventory_item_id in: path description: The product's inventory 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/AdminUpdateVariantInventoryItem' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/products/{id}/variants/{variant_id}/inventory-items/{inventory_item_id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "required_quantity": 5324804697620480 }' tags: - Products responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductVariantResponse' '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' delete: operationId: DeleteProductsIdVariantsVariant_idInventoryItemsInventory_item_id summary: Remove Inventory Items from Product description: Remove a list of inventory items from a product. This doesn't delete the Inventory Item, only the association between the Inventory Item and the product. x-authenticated: true parameters: - name: id in: path description: The product's ID. required: true schema: type: string - name: variant_id in: path description: The product's variant id. required: true schema: type: string - name: inventory_item_id in: path description: The product's inventory 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: [] x-codeSamples: - lang: Shell label: cURL source: |- curl -X DELETE '{backend_url}/admin/products/{id}/variants/{variant_id}/inventory-items/{inventory_item_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Products responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminProductVariantInventoryLinkDeleteResponse' '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: dismissLinksWorkflow /admin/promotions: get: operationId: GetPromotions summary: List Promotions description: Retrieve a list of promotions. The promotions can be filtered by fields such as `id`. The promotions 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 `-`. - name: q in: query description: The promotion's q. required: false schema: type: string title: q description: The promotion's q. - name: code in: query required: false schema: oneOf: - type: string title: code description: The promotion's code. - type: array description: The promotion's code. items: type: string title: code description: The code's details. - name: campaign_id in: query required: false schema: oneOf: - type: string title: campaign_id description: The promotion's campaign id. - type: array description: The promotion's campaign id. items: type: string title: campaign_id description: The campaign id's details. - name: application_method in: query description: The promotion's application method. required: false schema: type: object description: The promotion's application method. properties: currency_code: oneOf: - type: string title: currency_code description: The application method's currency code. - type: array description: The application method's currency code. items: type: string title: currency_code description: The currency code's details. - name: created_at in: query description: The promotion's created at. required: false schema: type: string description: The promotion's created at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: created_at - name: updated_at in: query description: The promotion's updated at. required: false schema: type: string description: The promotion's updated at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: updated_at - name: deleted_at in: query description: The promotion's deleted at. required: false schema: type: string description: The promotion's deleted at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: deleted_at - name: $and in: query required: false schema: type: array description: The promotion's $and. items: type: object title: $and - name: $or in: query required: false schema: type: array description: The promotion's $or. items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/promotions' \ -H 'x-medusa-access-token: {api_token}' 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': $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' post: operationId: PostPromotions summary: Create Promotion description: Create a promotion. 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: [] requestBody: content: application/json: schema: allOf: - type: object description: SUMMARY required: - code - type - campaign_id - application_method properties: code: type: string title: code description: The promotion's code. is_automatic: type: boolean title: is_automatic description: The promotion's is automatic. type: type: string enum: - standard - buyget campaign_id: type: string title: campaign_id description: The promotion's campaign id. campaign: type: object description: The promotion's campaign. required: - name - campaign_identifier - description - budget - starts_at - ends_at properties: name: type: string title: name description: The campaign's name. campaign_identifier: type: string title: campaign_identifier description: The campaign's campaign identifier. description: type: string title: description description: The campaign's description. budget: type: object description: The campaign's budget. required: - type - limit - currency_code properties: type: type: string enum: - spend - usage limit: type: number title: limit description: The budget's limit. currency_code: type: string title: currency_code description: The budget's currency code. starts_at: type: string title: starts_at description: The campaign's starts at. format: date-time ends_at: type: string title: ends_at description: The campaign's ends at. format: date-time promotions: type: array description: The campaign's promotions. items: type: object description: The promotion's promotions. required: - id properties: id: type: string title: id description: The promotion's ID. application_method: type: object description: The promotion's application method. required: - description - value - currency_code - max_quantity - type - target_type - apply_to_quantity - buy_rules_min_quantity properties: description: type: string title: description description: The application method's description. value: type: number title: value description: The application method's value. currency_code: type: string title: currency_code description: The application method's currency code. max_quantity: type: number title: max_quantity description: The application method's max quantity. type: type: string enum: - fixed - percentage target_type: type: string enum: - order - shipping_methods - items allocation: type: string enum: - each - across target_rules: type: array description: The application method's target rules. items: type: object description: The target rule's target rules. required: - operator - description - attribute - values properties: operator: type: string enum: - gte - lte - gt - lt - eq - ne - in description: type: string title: description description: The target rule's description. attribute: type: string title: attribute description: The target rule's attribute. values: oneOf: - type: string title: values description: The target rule's values. - type: array description: The target rule's values. items: type: string title: values description: The value's values. buy_rules: type: array description: The application method's buy rules. items: type: object description: The buy rule's buy rules. required: - operator - description - attribute - values properties: operator: type: string enum: - gte - lte - gt - lt - eq - ne - in description: type: string title: description description: The buy rule's description. attribute: type: string title: attribute description: The buy rule's attribute. values: oneOf: - type: string title: values description: The buy rule's values. - type: array description: The buy rule's values. items: type: string title: values description: The value's values. apply_to_quantity: type: number title: apply_to_quantity description: The application method's apply to quantity. buy_rules_min_quantity: type: number title: buy_rules_min_quantity description: The application method's buy rules min quantity. rules: type: array description: The promotion's rules. items: type: object description: The rule's rules. required: - operator - description - attribute - values properties: operator: type: string enum: - gte - lte - gt - lt - eq - ne - in description: type: string title: description description: The rule's description. attribute: type: string title: attribute description: The rule's attribute. values: oneOf: - type: string title: values description: The rule's values. - type: array description: The rule's values. items: type: string title: values description: The value's values. - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/promotions' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "code": "{value}", "type": "{value}", "campaign_id": "{value}", "application_method": { "description": "{value}", "value": 1841223411171328, "currency_code": "{value}", "max_quantity": 2960098049654784, "type": "{value}", "target_type": "{value}", "allocation": "{value}", "target_rules": [], "buy_rules": [], "apply_to_quantity": 708643867590656, "buy_rules_min_quantity": 3167972149428224 } }' tags: - Promotions responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPromotionResponse' '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' /admin/promotions/rule-attribute-options/{rule_type}: get: operationId: GetPromotionsRuleAttributeOptionsRule_type summary: List Rule Attribute Options description: Retrieve a list of rule attribute options in a promotion. The rule attribute options can be filtered by fields like FILTER FIELDS. The rule attribute options can also be paginated. x-authenticated: true parameters: - name: rule_type in: path description: The promotion's rule type. 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 `-`. - name: promotion_type in: query description: The promotion's promotion type. required: false schema: type: string title: promotion_type description: The promotion's promotion type. - name: application_method_type in: query description: The promotion's application method type. required: false schema: type: string title: application_method_type description: The promotion's application method type. security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/promotions/rule-attribute-options/{rule_type}' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/promotions/rule-value-options/{rule_type}/{rule_attribute_id}: get: operationId: GetPromotionsRuleValueOptionsRule_typeRule_attribute_id summary: 'List ' description: Retrieve a list of in a promotion. The can be filtered by fields like FILTER FIELDS. The can also be paginated. x-authenticated: true parameters: - name: rule_type in: path description: The promotion's rule type. required: true schema: type: string - name: rule_attribute_id in: path description: The promotion's rule attribute 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 `-`. - name: promotion_type in: query description: The promotion's promotion type. required: false schema: type: string title: promotion_type description: The promotion's promotion type. - name: application_method_type in: query description: The promotion's application method type. required: false schema: type: string title: application_method_type description: The promotion's application method type. security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/promotions/rule-value-options/{rule_type}/{rule_attribute_id}' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/promotions/{id}: get: operationId: GetPromotionsId summary: Get a Promotion description: Retrieve a promotion by its ID. You can expand the promotion's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The promotion'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/promotions/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Promotions responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPromotionResponse' '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' post: operationId: PostPromotionsId summary: Update a Promotion description: Update a promotion's details. x-authenticated: true parameters: - name: id in: path description: The promotion'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: [] requestBody: content: application/json: schema: allOf: - type: object description: SUMMARY required: - campaign_id properties: code: type: string title: code description: The promotion's code. is_automatic: type: boolean title: is_automatic description: The promotion's is automatic. type: type: string enum: - standard - buyget campaign_id: type: string title: campaign_id description: The promotion's campaign id. campaign: type: object description: The promotion's campaign. required: - name - campaign_identifier - description - budget - starts_at - ends_at properties: name: type: string title: name description: The campaign's name. campaign_identifier: type: string title: campaign_identifier description: The campaign's campaign identifier. description: type: string title: description description: The campaign's description. budget: type: object description: The campaign's budget. required: - type - limit - currency_code properties: type: type: string enum: - spend - usage limit: type: number title: limit description: The budget's limit. currency_code: type: string title: currency_code description: The budget's currency code. starts_at: type: string title: starts_at description: The campaign's starts at. format: date-time ends_at: type: string title: ends_at description: The campaign's ends at. format: date-time promotions: type: array description: The campaign's promotions. items: type: object description: The promotion's promotions. required: - id properties: id: type: string title: id description: The promotion's ID. application_method: type: object description: The promotion's application method. required: - description - max_quantity - currency_code - apply_to_quantity - buy_rules_min_quantity properties: description: type: string title: description description: The application method's description. value: type: number title: value description: The application method's value. max_quantity: type: number title: max_quantity description: The application method's max quantity. currency_code: type: string title: currency_code description: The application method's currency code. type: type: string enum: - fixed - percentage target_type: type: string enum: - order - shipping_methods - items allocation: type: string enum: - each - across target_rules: type: array description: The application method's target rules. items: type: object description: The target rule's target rules. required: - operator - description - attribute - values properties: operator: type: string enum: - gte - lte - gt - lt - eq - ne - in description: type: string title: description description: The target rule's description. attribute: type: string title: attribute description: The target rule's attribute. values: oneOf: - type: string title: values description: The target rule's values. - type: array description: The target rule's values. items: type: string title: values description: The value's values. buy_rules: type: array description: The application method's buy rules. items: type: object description: The buy rule's buy rules. required: - operator - description - attribute - values properties: operator: type: string enum: - gte - lte - gt - lt - eq - ne - in description: type: string title: description description: The buy rule's description. attribute: type: string title: attribute description: The buy rule's attribute. values: oneOf: - type: string title: values description: The buy rule's values. - type: array description: The buy rule's values. items: type: string title: values description: The value's values. apply_to_quantity: type: number title: apply_to_quantity description: The application method's apply to quantity. buy_rules_min_quantity: type: number title: buy_rules_min_quantity description: The application method's buy rules min quantity. rules: type: array description: The promotion's rules. items: type: object description: The rule's rules. required: - operator - description - attribute - values properties: operator: type: string enum: - gte - lte - gt - lt - eq - ne - in description: type: string title: description description: The rule's description. attribute: type: string title: attribute description: The rule's attribute. values: oneOf: - type: string title: values description: The rule's values. - type: array description: The rule's values. items: type: string title: values description: The value's values. - type: object description: SUMMARY properties: additional_data: type: object description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. description: SUMMARY x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/promotions/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "campaign_id": "{value}" }' tags: - Promotions responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminPromotionResponse' '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' delete: operationId: DeletePromotionsId summary: Delete a Promotion description: Delete a promotion. x-authenticated: true parameters: - name: id in: path description: The promotion'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/promotions/{id}' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/promotions/{id}/buy-rules/batch: post: operationId: PostPromotionsIdBuyRulesBatch summary: Add Buy Rules to Promotion description: Add a list of buy rules to a promotion. x-authenticated: true parameters: - name: id in: path description: The promotion'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: create: type: array description: The promotion's create. items: type: object description: The create's details. required: - operator - description - attribute - values properties: operator: type: string enum: - gte - lte - gt - lt - eq - ne - in description: type: string title: description description: The create's description. attribute: type: string title: attribute description: The create's attribute. values: oneOf: - type: string title: values description: The create's values. - type: array description: The create's values. items: type: string title: values description: The value's values. update: type: array description: The promotion's update. items: type: object description: The update's details. required: - id - description - values properties: id: type: string title: id description: The update's ID. operator: type: string enum: - gte - lte - gt - lt - eq - ne - in description: type: string title: description description: The update's description. attribute: type: string title: attribute description: The update's attribute. values: oneOf: - type: string title: values description: The update's values. - type: array description: The update's values. items: type: string title: values description: The value's values. delete: type: array description: The promotion's delete. items: type: string title: delete description: The delete's details. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/promotions/{id}/buy-rules/batch' \ -H 'x-medusa-access-token: {api_token}' tags: - Promotions responses: '200': description: OK content: application/json: schema: type: object description: SUMMARY required: - created - updated - deleted properties: created: type: array description: The promotion's created. items: $ref: '#/components/schemas/AdminPromotionRule' updated: type: array description: The promotion's updated. items: $ref: '#/components/schemas/AdminPromotionRule' deleted: type: object description: The promotion's deleted. required: - ids - object - deleted properties: ids: type: array description: The deleted's ids. items: type: string title: ids description: The id's ids. object: type: string title: object description: The deleted's object. deleted: type: boolean title: deleted description: The deleted's details. '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: batchPromotionRulesWorkflow /admin/promotions/{id}/rules/batch: post: operationId: PostPromotionsIdRulesBatch summary: Add Rules to Promotion description: Add a list of rules to a promotion. x-authenticated: true parameters: - name: id in: path description: The promotion'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: create: type: array description: The promotion's create. items: type: object description: The create's details. required: - operator - description - attribute - values properties: operator: type: string enum: - gte - lte - gt - lt - eq - ne - in description: type: string title: description description: The create's description. attribute: type: string title: attribute description: The create's attribute. values: oneOf: - type: string title: values description: The create's values. - type: array description: The create's values. items: type: string title: values description: The value's values. update: type: array description: The promotion's update. items: type: object description: The update's details. required: - id - description - values properties: id: type: string title: id description: The update's ID. operator: type: string enum: - gte - lte - gt - lt - eq - ne - in description: type: string title: description description: The update's description. attribute: type: string title: attribute description: The update's attribute. values: oneOf: - type: string title: values description: The update's values. - type: array description: The update's values. items: type: string title: values description: The value's values. delete: type: array description: The promotion's delete. items: type: string title: delete description: The delete's details. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/promotions/{id}/rules/batch' \ -H 'x-medusa-access-token: {api_token}' tags: - Promotions responses: '200': description: OK content: application/json: schema: type: object description: SUMMARY required: - created - updated - deleted properties: created: type: array description: The promotion's created. items: $ref: '#/components/schemas/AdminPromotionRule' updated: type: array description: The promotion's updated. items: $ref: '#/components/schemas/AdminPromotionRule' deleted: type: object description: The promotion's deleted. required: - ids - object - deleted properties: ids: type: array description: The deleted's ids. items: type: string title: ids description: The id's ids. object: type: string title: object description: The deleted's object. deleted: type: boolean title: deleted description: The deleted's details. '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: batchPromotionRulesWorkflow /admin/promotions/{id}/target-rules/batch: post: operationId: PostPromotionsIdTargetRulesBatch summary: Add Target Rules to Promotion description: Add a list of target rules to a promotion. x-authenticated: true parameters: - name: id in: path description: The promotion'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: create: type: array description: The promotion's create. items: type: object description: The create's details. required: - operator - description - attribute - values properties: operator: type: string enum: - gte - lte - gt - lt - eq - ne - in description: type: string title: description description: The create's description. attribute: type: string title: attribute description: The create's attribute. values: oneOf: - type: string title: values description: The create's values. - type: array description: The create's values. items: type: string title: values description: The value's values. update: type: array description: The promotion's update. items: type: object description: The update's details. required: - id - description - values properties: id: type: string title: id description: The update's ID. operator: type: string enum: - gte - lte - gt - lt - eq - ne - in description: type: string title: description description: The update's description. attribute: type: string title: attribute description: The update's attribute. values: oneOf: - type: string title: values description: The update's values. - type: array description: The update's values. items: type: string title: values description: The value's values. delete: type: array description: The promotion's delete. items: type: string title: delete description: The delete's details. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/promotions/{id}/target-rules/batch' \ -H 'x-medusa-access-token: {api_token}' tags: - Promotions responses: '200': description: OK content: application/json: schema: type: object description: SUMMARY required: - created - updated - deleted properties: created: type: array description: The promotion's created. items: $ref: '#/components/schemas/AdminPromotionRule' updated: type: array description: The promotion's updated. items: $ref: '#/components/schemas/AdminPromotionRule' deleted: type: object description: The promotion's deleted. required: - ids - object - deleted properties: ids: type: array description: The deleted's ids. items: type: string title: ids description: The id's ids. object: type: string title: object description: The deleted's object. deleted: type: boolean title: deleted description: The deleted's details. '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: batchPromotionRulesWorkflow /admin/promotions/{id}/{rule_type}: get: operationId: GetPromotionsIdRule_type summary: 'List ' description: Retrieve a list of in a promotion. The can be filtered by fields like FILTER FIELDS. The can also be paginated. x-authenticated: true parameters: - name: id in: path description: The promotion's ID. required: true schema: type: string - name: rule_type in: path description: The promotion's rule type. 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/promotions/{id}/{rule_type}' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/refund-reasons: get: 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' post: operationId: PostRefundReasons summary: Create Refund Reason description: Create a refund reason. 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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - label - description properties: label: type: string title: label description: The refund reason's label. description: type: string title: description description: The refund reason's description. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/refund-reasons' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "label": "{value}", "description": "{value}" }' 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' x-workflow: createRefundReasonsWorkflow /admin/refund-reasons/{id}: get: 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' post: operationId: PostRefundReasonsId summary: Update a Refund Reason description: Update a refund reason's details. 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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - description properties: label: type: string title: label description: The refund reason's label. description: type: string title: description description: The refund reason's description. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/refund-reasons/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "description": "{value}" }' 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' delete: 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' /admin/regions: get: operationId: GetRegions summary: List Regions description: Retrieve a list of regions. The regions can be filtered by fields such as `id`. The regions 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 `-`. - name: q in: query description: The region's q. required: false schema: type: string title: q description: The region's q. - name: id in: query required: false schema: oneOf: - type: string title: id description: The region's ID. - type: array description: The region's ID. items: type: string title: id description: The id's ID. - name: code in: query required: false schema: oneOf: - type: string title: code description: The region's code. - type: array description: The region's code. items: type: string title: code description: The code's details. - name: name in: query required: false schema: oneOf: - type: string title: name description: The region's name. - type: array description: The region's name. items: type: string title: name description: The name's details. - name: created_at in: query description: The region's created at. required: false schema: type: string description: The region's created at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: created_at - name: updated_at in: query description: The region's updated at. required: false schema: type: string description: The region's updated at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: updated_at - name: deleted_at in: query description: The region's deleted at. required: false schema: type: string description: The region's deleted at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: deleted_at - name: $and in: query required: false schema: type: array description: The region's $and. items: type: object title: $and - name: $or in: query required: false schema: type: array description: The region's $or. items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/regions' \ -H 'x-medusa-access-token: {api_token}' 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': $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' post: operationId: PostRegions summary: Create Region description: Create a region. 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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - name - currency_code - metadata properties: name: type: string title: name description: The region's name. currency_code: type: string title: currency_code description: The region's currency code. countries: type: array description: The region's countries. items: type: string title: countries description: The country's countries. automatic_taxes: type: boolean title: automatic_taxes description: The region's automatic taxes. payment_providers: type: array description: The region's payment providers. items: type: string title: payment_providers description: The payment provider's payment providers. metadata: type: object description: The region's metadata. is_tax_inclusive: type: boolean title: is_tax_inclusive description: The region's is tax inclusive. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/regions' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "name": "Heloise", "currency_code": "{value}", "metadata": {} }' tags: - Regions responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminRegionResponse' '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: createRegionsWorkflow /admin/regions/{id}: get: operationId: GetRegionsId summary: Get a Region description: Retrieve a region by its ID. You can expand the region's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The region'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/regions/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Regions responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminRegionResponse' '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' post: operationId: PostRegionsId summary: Update a Region description: Update a region's details. x-authenticated: true parameters: - name: id in: path description: The region'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - metadata properties: name: type: string title: name description: The region's name. currency_code: type: string title: currency_code description: The region's currency code. countries: type: array description: The region's countries. items: type: string title: countries description: The country's countries. automatic_taxes: type: boolean title: automatic_taxes description: The region's automatic taxes. payment_providers: type: array description: The region's payment providers. items: type: string title: payment_providers description: The payment provider's payment providers. metadata: type: object description: The region's metadata. is_tax_inclusive: type: boolean title: is_tax_inclusive description: The region's is tax inclusive. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/regions/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "metadata": {} }' tags: - Regions responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminRegionResponse' '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: updateRegionsWorkflow delete: operationId: DeleteRegionsId summary: Delete a Region description: Delete a region. x-authenticated: true parameters: - name: id in: path description: The region'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/regions/{id}' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/reservations: get: operationId: GetReservations summary: List Reservations description: Retrieve a list of reservations. The reservations can be filtered by fields such as `id`. The reservations 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 `-`. - name: location_id in: query required: false schema: oneOf: - type: string title: location_id description: The reservation's location id. - type: array description: The reservation's location id. items: type: string title: location_id description: The location id's details. - name: inventory_item_id in: query required: false schema: oneOf: - type: string title: inventory_item_id description: The reservation's inventory item id. - type: array description: The reservation's inventory item id. items: type: string title: inventory_item_id description: The inventory item id's details. - name: line_item_id in: query required: false schema: oneOf: - type: string title: line_item_id description: The reservation's line item id. - type: array description: The reservation's line item id. items: type: string title: line_item_id description: The line item id's details. - name: created_by in: query required: false schema: oneOf: - type: string title: created_by description: The reservation's created by. - type: array description: The reservation's created by. items: type: string title: created_by description: The created by's details. - name: description in: query required: false schema: oneOf: - type: string title: description description: The reservation's description. - type: object description: The reservation's description. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} - name: quantity in: query description: The reservation's quantity. required: false schema: description: The reservation's quantity. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} - name: created_at in: query description: The reservation's created at. required: false schema: type: string description: The reservation's created at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: created_at - name: updated_at in: query description: The reservation's updated at. required: false schema: type: string description: The reservation's updated at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: updated_at - name: deleted_at in: query description: The reservation's deleted at. required: false schema: type: string description: The reservation's deleted at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: deleted_at security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/reservations' \ -H 'x-medusa-access-token: {api_token}' tags: - Reservations 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 reservation's limit. offset: type: number title: offset description: The reservation's offset. count: type: number title: count description: The reservation's count. - type: object description: SUMMARY required: - reservations properties: reservations: type: array description: The reservation's reservations. items: $ref: '#/components/schemas/ReservationResponse' '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' post: operationId: PostReservations summary: Create Reservation description: Create a reservation. 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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - line_item_id - location_id - inventory_item_id - quantity - description - metadata properties: line_item_id: type: string title: line_item_id description: The reservation's line item id. location_id: type: string title: location_id description: The reservation's location id. inventory_item_id: type: string title: inventory_item_id description: The reservation's inventory item id. quantity: type: number title: quantity description: The reservation's quantity. description: type: string title: description description: The reservation's description. metadata: type: object description: The reservation's metadata. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/reservations' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "line_item_id": "{value}", "location_id": "{value}", "inventory_item_id": "{value}", "quantity": 3268935814217728, "description": "{value}", "metadata": {} }' tags: - Reservations responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReservationResponse' '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: createReservationsWorkflow /admin/reservations/{id}: get: operationId: GetReservationsId summary: Get a Reservation description: Retrieve a reservation by its ID. You can expand the reservation's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The reservation'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/reservations/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Reservations responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReservationResponse' '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' post: operationId: PostReservationsId summary: Update a Reservation description: Update a reservation's details. x-authenticated: true parameters: - name: id in: path description: The reservation'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - description - metadata properties: location_id: type: string title: location_id description: The reservation's location id. quantity: type: number title: quantity description: The reservation's quantity. description: type: string title: description description: The reservation's description. metadata: type: object description: The reservation's metadata. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/reservations/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "description": "{value}", "metadata": {} }' tags: - Reservations responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReservationResponse' '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' delete: operationId: DeleteReservationsId summary: Delete a Reservation description: Delete a reservation. x-authenticated: true parameters: - name: id in: path description: The reservation'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/reservations/{id}' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/return-reasons: get: operationId: GetReturnReasons summary: List Return Reasons description: Retrieve a list of return reasons. The return reasons can be filtered by fields such as `id`. The return 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 `-`. - name: q in: query description: The return reason's q. required: false schema: type: string title: q description: The return reason's q. - name: id in: query required: false schema: oneOf: - type: string title: id description: The return reason's ID. - type: array description: The return reason's ID. items: type: string title: id description: The id's ID. - name: value in: query required: false schema: oneOf: - type: string title: value description: The return reason's value. - type: array description: The return reason's value. items: type: string title: value description: The value's details. - name: label in: query required: false schema: oneOf: - type: string title: label description: The return reason's label. - type: array description: The return reason's label. items: type: string title: label description: The label's details. - name: description in: query required: false schema: oneOf: - type: string title: description description: The return reason's description. - type: array description: The return reason's description. items: type: string title: description description: The description's details. - name: parent_return_reason_id in: query required: false schema: oneOf: - type: string title: parent_return_reason_id description: The return reason's parent return reason id. - type: array description: The return reason's parent return reason id. items: type: string title: parent_return_reason_id description: The parent return reason id's details. - name: created_at in: query description: The return reason's created at. required: false schema: type: string format: date-time title: created_at description: The return reason's created at. - name: updated_at in: query description: The return reason's updated at. required: false schema: type: string format: date-time title: updated_at description: The return reason's updated at. - name: deleted_at in: query description: The return reason's deleted at. required: false schema: type: string format: date-time title: deleted_at description: The return reason's deleted at. - name: $and in: query description: The return reason's $and. required: false schema: type: array description: The return reason's $and. items: type: object title: $and - name: $or in: query description: The return reason's $or. required: false schema: type: array description: The return reason's $or. items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/return-reasons' \ -H 'x-medusa-access-token: {api_token}' tags: - Return Reasons responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnReasonListResponse' '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' post: operationId: PostReturnReasons summary: Create Return Reason description: Create a return reason. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateOrderReturnReason' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/return-reasons' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "value": "{value}", "label": "{value}" }' tags: - Return Reasons responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnReasonResponse' '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' /admin/return-reasons/{id}: get: operationId: GetReturnReasonsId summary: Get a Return Reason description: Retrieve a return reason by its ID. You can expand the return reason's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The return 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/return-reasons/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Return Reasons responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnReasonResponse' '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' post: operationId: PostReturnReasonsId summary: Update a Return Reason description: Update a return reason's details. x-authenticated: true parameters: - name: id in: path description: The return 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateOrderReturnReason' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/return-reasons/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Return Reasons responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnReasonResponse' '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' delete: operationId: DeleteReturnReasonsId summary: Delete a Return Reason description: Delete a return reason. x-authenticated: true parameters: - name: id in: path description: The return 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/return-reasons/{id}' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/returns: get: operationId: GetReturns summary: List Returns description: Retrieve a list of returns. The returns can be filtered by fields such as `id`. The returns 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/returns' \ -H 'x-medusa-access-token: {api_token}' tags: - Returns 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 return's limit. offset: type: number title: offset description: The return's offset. count: type: number title: count description: The return's count. - type: object description: SUMMARY required: - returns properties: returns: type: array description: The return's returns. items: $ref: '#/components/schemas/AdminReturn' '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' post: operationId: PostReturns summary: Create Return description: Create a return. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostReturnsReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/returns' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "order_id": "{value}", "items": [ { "id": "id_7DO5H2LbSN3p7IzB", "quantity": 1357590174892032, "reason_id": "{value}", "note": "{value}" } ], "return_shipping": { "option_id": "{value}", "price": 5112171463704576 }, "internal_note": "{value}", "location_id": "{value}" }' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminOrderReturnResponse' '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' /admin/returns/{id}: get: operationId: GetReturnsId summary: Get a Return description: Retrieve a return by its ID. You can expand the return's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The return'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/returns/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnResponse' '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' post: operationId: PostReturnsId summary: Update a Return description: Update a return's details. x-authenticated: true parameters: - name: id in: path description: The return'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostReturnsReturnReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/returns/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "metadata": {} }' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnPreviewResponse' '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: updateReturnWorkflow /admin/returns/{id}/cancel: post: operationId: PostReturnsIdCancel summary: Add Cancels to Return description: Add a list of cancels to a return. x-authenticated: true parameters: - name: id in: path description: The return'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 POST '{backend_url}/admin/returns/{id}/cancel' \ -H 'x-medusa-access-token: {api_token}' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnResponse' '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' requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostCancelReturnReqSchema' /admin/returns/{id}/dismiss-items: post: operationId: PostReturnsIdDismissItems summary: Add Dismiss Items to Return description: Add a list of dismiss items to a return. x-authenticated: true parameters: - name: id in: path description: The return'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostReturnsReceiveItemsReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/returns/{id}/dismiss-items' \ -H 'x-medusa-access-token: {api_token}' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnPreviewResponse' '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: dismissItemReturnRequestWorkflow /admin/returns/{id}/dismiss-items/{action_id}: post: operationId: PostReturnsIdDismissItemsAction_id summary: Add Dismiss Items to Return description: Add a list of dismiss items to a return. x-authenticated: true parameters: - name: id in: path description: The return's ID. required: true schema: type: string - name: action_id in: path description: The return'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostReturnsDismissItemsActionReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/returns/{id}/dismiss-items/{action_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnPreviewResponse' '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: updateReceiveItemReturnRequestWorkflow delete: operationId: DeleteReturnsIdDismissItemsAction_id summary: Remove Dismiss Items from Return description: Remove a list of dismiss items from a return. This doesn't delete the Dismiss Item, only the association between the Dismiss Item and the return. x-authenticated: true parameters: - name: id in: path description: The return's ID. required: true schema: type: string - name: action_id in: path description: The return'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/returns/{id}/dismiss-items/{action_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnPreviewResponse' '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 /admin/returns/{id}/receive: post: operationId: PostReturnsIdReceive summary: Add Receives to Return description: Add a list of receives to a return. x-authenticated: true parameters: - name: id in: path description: The return'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostReceiveReturnsReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/returns/{id}/receive' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "return_id": "{value}", "items": [ { "id": "id_qfy3t6cU7m8O5cJ5zs", "quantity": 6429460591017984, "reason_id": "{value}", "note": "{value}" } ], "internal_note": "{value}" }' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminOrderReturnResponse' '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' delete: operationId: DeleteReturnsIdReceive summary: Remove Receives from Return description: Remove a list of receives from a return. This doesn't delete the Receive, only the association between the Receive and the return. x-authenticated: true parameters: - name: id in: path description: The return'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/returns/{id}/receive' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/returns/{id}/receive-items: post: operationId: PostReturnsIdReceiveItems summary: Add Receive Items to Return description: Add a list of receive items to a return. x-authenticated: true parameters: - name: id in: path description: The return'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostReturnsReceiveItemsReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/returns/{id}/receive-items' \ -H 'x-medusa-access-token: {api_token}' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnPreviewResponse' '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: receiveItemReturnRequestWorkflow /admin/returns/{id}/receive-items/{action_id}: post: operationId: PostReturnsIdReceiveItemsAction_id summary: Add Receive Items to Return description: Add a list of receive items to a return. x-authenticated: true parameters: - name: id in: path description: The return's ID. required: true schema: type: string - name: action_id in: path description: The return'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostReturnsReceiveItemsActionReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/returns/{id}/receive-items/{action_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnPreviewResponse' '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: updateReceiveItemReturnRequestWorkflow delete: operationId: DeleteReturnsIdReceiveItemsAction_id summary: Remove Receive Items from Return description: Remove a list of receive items from a return. This doesn't delete the Receive Item, only the association between the Receive Item and the return. x-authenticated: true parameters: - name: id in: path description: The return's ID. required: true schema: type: string - name: action_id in: path description: The return'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/returns/{id}/receive-items/{action_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnPreviewResponse' '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: removeItemReceiveReturnActionWorkflow /admin/returns/{id}/receive/confirm: post: operationId: PostReturnsIdReceiveConfirm summary: Add Confirms to Return description: Add a list of confirms to a return. x-authenticated: true parameters: - name: id in: path description: The return'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostReturnsConfirmRequestReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/returns/{id}/receive/confirm' \ -H 'x-medusa-access-token: {api_token}' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnPreviewResponse' '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: confirmReturnReceiveWorkflow /admin/returns/{id}/request: post: operationId: PostReturnsIdRequest summary: Add Requests to Return description: Add a list of requests to a return. x-authenticated: true parameters: - name: id in: path description: The return'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostReturnsConfirmRequestReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/returns/{id}/request' \ -H 'x-medusa-access-token: {api_token}' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnPreviewResponse' '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: confirmReturnRequestWorkflow delete: operationId: DeleteReturnsIdRequest summary: Remove Requests from Return description: Remove a list of requests from a return. This doesn't delete the Request, only the association between the Request and the return. x-authenticated: true parameters: - name: id in: path description: The return'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/returns/{id}/request' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/returns/{id}/request-items: post: operationId: PostReturnsIdRequestItems summary: Add Request Items to Return description: Add a list of request items to a return. x-authenticated: true parameters: - name: id in: path description: The return'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostReturnsRequestItemsReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/returns/{id}/request-items' \ -H 'x-medusa-access-token: {api_token}' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnPreviewResponse' '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: requestItemReturnWorkflow /admin/returns/{id}/request-items/{action_id}: post: operationId: PostReturnsIdRequestItemsAction_id summary: Add Request Items to Return description: Add a list of request items to a return. x-authenticated: true parameters: - name: id in: path description: The return's ID. required: true schema: type: string - name: action_id in: path description: The return'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostReturnsRequestItemsActionReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/returns/{id}/request-items/{action_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnPreviewResponse' '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: updateRequestItemReturnWorkflow delete: operationId: DeleteReturnsIdRequestItemsAction_id summary: Remove Request Items from Return description: Remove a list of request items from a return. This doesn't delete the Request Item, only the association between the Request Item and the return. x-authenticated: true parameters: - name: id in: path description: The return's ID. required: true schema: type: string - name: action_id in: path description: The return'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/returns/{id}/request-items/{action_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnPreviewResponse' '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 /admin/returns/{id}/shipping-method: post: operationId: PostReturnsIdShippingMethod summary: Add Shipping Methods to Return description: Add a list of shipping methods to a return. x-authenticated: true parameters: - name: id in: path description: The return'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostReturnsShippingReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/returns/{id}/shipping-method' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "shipping_option_id": "{value}" }' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnPreviewResponse' '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: createReturnShippingMethodWorkflow /admin/returns/{id}/shipping-method/{action_id}: post: operationId: PostReturnsIdShippingMethodAction_id summary: Add Shipping Methods to Return description: Add a list of shipping methods to a return. x-authenticated: true parameters: - name: id in: path description: The return's ID. required: true schema: type: string - name: action_id in: path description: The return'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminPostReturnsShippingActionReqSchema' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/returns/{id}/shipping-method/{action_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnPreviewResponse' '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: updateReturnShippingMethodWorkflow delete: operationId: DeleteReturnsIdShippingMethodAction_id summary: Remove Shipping Methods from Return description: Remove a list of shipping methods from a return. This doesn't delete the Shipping Method, only the association between the Shipping Method and the return. x-authenticated: true parameters: - name: id in: path description: The return's ID. required: true schema: type: string - name: action_id in: path description: The return'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/returns/{id}/shipping-method/{action_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Returns responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminReturnPreviewResponse' '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 /admin/sales-channels: get: operationId: GetSalesChannels summary: List Sales Channels description: Retrieve a list of sales channels. The sales channels can be filtered by fields such as `id`. The sales channels 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 `-`. - name: q in: query description: The sales channel's q. required: false schema: type: string title: q description: The sales channel's q. - name: id in: query required: false schema: oneOf: - type: string title: id description: The sales channel's ID. - type: array description: The sales channel's ID. items: type: string title: id description: The id's ID. - name: name in: query required: false schema: oneOf: - type: string title: name description: The sales channel's name. - type: array description: The sales channel's name. items: type: string title: name description: The name's details. - name: description in: query description: The sales channel's description. required: false schema: type: string title: description description: The sales channel's description. - name: is_disabled in: query description: The sales channel's is disabled. required: true schema: type: boolean title: is_disabled description: The sales channel's is disabled. - name: created_at in: query description: The sales channel's created at. required: false schema: type: string description: The sales channel's created at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: created_at - name: updated_at in: query description: The sales channel's updated at. required: false schema: type: string description: The sales channel's updated at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: updated_at - name: deleted_at in: query description: The sales channel's deleted at. required: false schema: type: string description: The sales channel's deleted at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: deleted_at - name: location_id in: query required: false schema: oneOf: - type: string title: location_id description: The sales channel's location id. - type: array description: The sales channel's location id. items: type: string title: location_id description: The location id's details. - name: publishable_key_id in: query required: false schema: oneOf: - type: string title: publishable_key_id description: The sales channel's publishable key id. - type: array description: The sales channel's publishable key id. items: type: string title: publishable_key_id description: The publishable key id's details. - name: $and in: query required: false schema: type: array description: The sales channel's $and. items: type: object title: $and - name: $or in: query required: false schema: type: array description: The sales channel's $or. items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/sales-channels' \ -H 'x-medusa-access-token: {api_token}' tags: - Sales Channels 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 sales channel's limit. offset: type: number title: offset description: The sales channel's offset. count: type: number title: count description: The sales channel's count. - type: object description: SUMMARY required: - sales_channels properties: sales_channels: type: array description: The sales channel's sales channels. items: $ref: '#/components/schemas/AdminSalesChannel' '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' post: operationId: PostSalesChannels summary: Create Sales Channel description: Create a sales channel. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminCreateSalesChannel' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/sales-channels' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "name": "Linnea", "description": "{value}", "metadata": {} }' tags: - Sales Channels responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminSalesChannelResponse' '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: createSalesChannelsWorkflow /admin/sales-channels/{id}: get: operationId: GetSalesChannelsId summary: Get a Sales Channel description: Retrieve a sales channel by its ID. You can expand the sales channel's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The sales channel'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/sales-channels/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Sales Channels responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminSalesChannelResponse' '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' post: operationId: PostSalesChannelsId summary: Update a Sales Channel description: Update a sales channel's details. x-authenticated: true parameters: - name: id in: path description: The sales channel'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminUpdateSalesChannel' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/sales-channels/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "description": "{value}", "metadata": {} }' tags: - Sales Channels responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminSalesChannelResponse' '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' delete: operationId: DeleteSalesChannelsId summary: Delete a Sales Channel description: Delete a sales channel. x-authenticated: true parameters: - name: id in: path description: The sales channel'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/sales-channels/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Sales Channels responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminSalesChannelDeleteResponse' '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' /admin/sales-channels/{id}/products: post: operationId: PostSalesChannelsIdProducts summary: Add Products to Sales Channel description: Add a list of products to a sales channel. x-authenticated: true parameters: - name: id in: path description: The sales channel'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: add: type: array description: The sales channel's add. items: type: string title: add description: The add's details. remove: type: array description: The sales channel's remove. items: type: string title: remove description: The remove's details. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/sales-channels/{id}/products' \ -H 'x-medusa-access-token: {api_token}' tags: - Sales Channels responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminSalesChannelResponse' '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' /admin/shipping-options: get: operationId: GetShippingOptions summary: List Shipping Options description: Retrieve a list of shipping options. The shipping options can be filtered by fields such as `id`. The shipping options 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 `-`. - name: id in: query required: false schema: oneOf: - type: string title: id description: The shipping option's ID. - type: array description: The shipping option's ID. items: type: string title: id description: The id's ID. - name: q in: query description: The shipping option's q. required: false schema: type: string title: q description: The shipping option's q. - name: service_zone_id in: query required: false schema: oneOf: - type: string title: service_zone_id description: The shipping option's service zone id. - type: array description: The shipping option's service zone id. items: type: string title: service_zone_id description: The service zone id's details. - name: shipping_profile_id in: query required: false schema: oneOf: - type: string title: shipping_profile_id description: The shipping option's shipping profile id. - type: array description: The shipping option's shipping profile id. items: type: string title: shipping_profile_id description: The shipping profile id's details. - name: provider_id in: query required: false schema: oneOf: - type: string title: provider_id description: The shipping option's provider id. - type: array description: The shipping option's provider id. items: type: string title: provider_id description: The provider id's details. - name: shipping_option_type_id in: query required: false schema: oneOf: - type: string title: shipping_option_type_id description: The shipping option's shipping option type id. - type: array description: The shipping option's shipping option type id. items: type: string title: shipping_option_type_id description: The shipping option type id's details. - name: created_at in: query description: The shipping option's created at. required: false schema: type: string description: The shipping option's created at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: created_at - name: updated_at in: query description: The shipping option's updated at. required: false schema: type: string description: The shipping option's updated at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: updated_at - name: deleted_at in: query description: The shipping option's deleted at. required: false schema: type: string description: The shipping option's deleted at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: deleted_at - name: stock_location_id in: query required: false schema: oneOf: - type: string title: stock_location_id description: The shipping option's stock location id. - type: array description: The shipping option's stock location id. items: type: string title: stock_location_id description: The stock location id's details. security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/shipping-options' \ -H 'x-medusa-access-token: {api_token}' tags: - Shipping Options 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 shipping option's limit. offset: type: number title: offset description: The shipping option's offset. count: type: number title: count description: The shipping option's count. - type: object description: SUMMARY required: - shipping_options properties: shipping_options: type: array description: The shipping option's shipping options. items: type: object '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' post: operationId: PostShippingOptions summary: Create Shipping Option description: Create a shipping option. 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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - name - service_zone_id - shipping_profile_id - price_type - provider_id - type - prices properties: name: type: string title: name description: The shipping option's name. service_zone_id: type: string title: service_zone_id description: The shipping option's service zone id. shipping_profile_id: type: string title: shipping_profile_id description: The shipping option's shipping profile id. data: type: object description: The shipping option's data. price_type: type: string enum: - calculated - flat provider_id: type: string title: provider_id description: The shipping option's provider id. type: type: object description: The shipping option's type. required: - label - description - code properties: label: type: string title: label description: The type's label. description: type: string title: description description: The type's description. code: type: string title: code description: The type's code. prices: type: array description: The shipping option's prices. items: oneOf: - type: object description: The price's prices. required: - currency_code - amount properties: currency_code: type: string title: currency_code description: The price's currency code. amount: type: number title: amount description: The price's amount. - type: object description: The price's prices. required: - region_id - amount properties: region_id: type: string title: region_id description: The price's region id. amount: type: number title: amount description: The price's amount. rules: type: array description: The shipping option's rules. items: type: object description: The rule's rules. required: - operator - attribute - value properties: operator: type: string enum: - in - eq - ne - gt - gte - lt - lte - nin attribute: type: string title: attribute description: The rule's attribute. value: oneOf: - type: string title: value description: The rule's value. - type: array description: The rule's value. items: type: string title: value description: The value's details. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/shipping-options' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "name": "Julie", "service_zone_id": "{value}", "shipping_profile_id": "{value}", "price_type": "{value}", "provider_id": "{value}", "type": { "label": "{value}", "description": "{value}", "code": "{value}" }, "prices": [] }' tags: - Shipping Options responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminShippingOptionResponse' '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' /admin/shipping-options/{id}: post: operationId: PostShippingOptionsId summary: Update a Shipping Option description: Update a shipping option's details. x-authenticated: true parameters: - name: id in: path description: The shipping option'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: name: type: string title: name description: The shipping option's name. data: type: object description: The shipping option's data. price_type: type: string enum: - calculated - flat provider_id: type: string title: provider_id description: The shipping option's provider id. shipping_profile_id: type: string title: shipping_profile_id description: The shipping option's shipping profile id. type: type: object description: The shipping option's type. required: - label - description - code properties: label: type: string title: label description: The type's label. description: type: string title: description description: The type's description. code: type: string title: code description: The type's code. prices: type: array description: The shipping option's prices. items: oneOf: - type: object description: The price's prices. properties: id: type: string title: id description: The price's ID. currency_code: type: string title: currency_code description: The price's currency code. amount: type: number title: amount description: The price's amount. - type: object description: The price's prices. properties: id: type: string title: id description: The price's ID. region_id: type: string title: region_id description: The price's region id. amount: type: number title: amount description: The price's amount. rules: type: array description: The shipping option's rules. items: oneOf: - type: object description: The rule's rules. required: - operator - attribute - value properties: operator: type: string enum: - in - eq - ne - gt - gte - lt - lte - nin attribute: type: string title: attribute description: The rule's attribute. value: oneOf: - type: string title: value description: The rule's value. - type: array description: The rule's value. items: type: string title: value description: The value's details. - type: object description: The rule's rules. required: - id - operator - attribute - value properties: id: type: string title: id description: The rule's ID. operator: type: string enum: - in - eq - ne - gt - gte - lt - lte - nin attribute: type: string title: attribute description: The rule's attribute. value: oneOf: - type: string title: value description: The rule's value. - type: array description: The rule's value. items: type: string title: value description: The value's details. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/shipping-options/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Shipping Options responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminShippingOptionResponse' '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' delete: operationId: DeleteShippingOptionsId summary: Delete a Shipping Option description: Delete a shipping option. x-authenticated: true parameters: - name: id in: path description: The shipping option'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/shipping-options/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Shipping Options responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminShippingOptionDeleteResponse' '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' /admin/shipping-options/{id}/rules/batch: post: operationId: PostShippingOptionsIdRulesBatch summary: Add Rules to Shipping Option description: Add a list of rules to a shipping option. x-authenticated: true parameters: - name: id in: path description: The shipping option'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: create: type: array description: The shipping option's create. items: type: object description: The create's details. required: - operator - attribute - value properties: operator: type: string enum: - in - eq - ne - gt - gte - lt - lte - nin attribute: type: string title: attribute description: The create's attribute. value: oneOf: - type: string title: value description: The create's value. - type: array description: The create's value. items: type: string title: value description: The value's details. update: type: array description: The shipping option's update. items: type: object description: The update's details. required: - id - operator - attribute - value properties: id: type: string title: id description: The update's ID. operator: type: string enum: - in - eq - ne - gt - gte - lt - lte - nin attribute: type: string title: attribute description: The update's attribute. value: oneOf: - type: string title: value description: The update's value. - type: array description: The update's value. items: type: string title: value description: The value's details. delete: type: array description: The shipping option's delete. items: type: string title: delete description: The delete's details. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/shipping-options/{id}/rules/batch' \ -H 'x-medusa-access-token: {api_token}' tags: - Shipping Options responses: '200': description: OK content: application/json: schema: type: object description: SUMMARY required: - created - updated - deleted properties: created: type: array description: The shipping option's created. items: $ref: '#/components/schemas/AdminShippingOptionRule' updated: type: array description: The shipping option's updated. items: $ref: '#/components/schemas/AdminShippingOptionRule' deleted: type: object description: The shipping option's deleted. required: - ids - object - deleted properties: ids: type: array description: The deleted's ids. items: type: string title: ids description: The id's ids. object: type: string title: object description: The deleted's object. deleted: type: boolean title: deleted description: The deleted's details. '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: batchShippingOptionRulesWorkflow /admin/shipping-profiles: get: operationId: GetShippingProfiles summary: List Shipping Profiles description: Retrieve a list of shipping profiles. The shipping profiles can be filtered by fields such as `id`. The shipping profiles 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 `-`. - name: id in: query required: false schema: oneOf: - type: string title: id description: The shipping profile's ID. - type: array description: The shipping profile's ID. items: type: string title: id description: The id's ID. - name: q in: query description: The shipping profile's q. required: false schema: type: string title: q description: The shipping profile's q. - name: type in: query description: The shipping profile's type. required: false schema: type: string title: type description: The shipping profile's type. - name: name in: query description: The shipping profile's name. required: false schema: type: string title: name description: The shipping profile's name. - name: created_at in: query description: The shipping profile's created at. required: false schema: type: string description: The shipping profile's created at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: created_at - name: updated_at in: query description: The shipping profile's updated at. required: false schema: type: string description: The shipping profile's updated at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: updated_at - name: deleted_at in: query description: The shipping profile's deleted at. required: false schema: type: string description: The shipping profile's deleted at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: deleted_at - name: $and in: query required: false schema: type: array description: The shipping profile's $and. items: type: object title: $and - name: $or in: query required: false schema: type: array description: The shipping profile's $or. items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/shipping-profiles' \ -H 'x-medusa-access-token: {api_token}' tags: - Shipping Profiles 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 shipping profile's limit. offset: type: number title: offset description: The shipping profile's offset. count: type: number title: count description: The shipping profile's count. - type: object description: SUMMARY required: - shipping_profiles properties: shipping_profiles: type: array description: The shipping profile's shipping profiles. items: $ref: '#/components/schemas/AdminShippingProfile' '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' post: operationId: PostShippingProfiles summary: Create Shipping Profile description: Create a shipping profile. 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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - name - type - metadata properties: name: type: string title: name description: The shipping profile's name. type: type: string title: type description: The shipping profile's type. metadata: type: object description: The shipping profile's metadata. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/shipping-profiles' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "name": "Percy", "type": "{value}", "metadata": {} }' tags: - Shipping Profiles responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminShippingProfileResponse' '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: createShippingProfilesWorkflow /admin/shipping-profiles/{id}: get: operationId: GetShippingProfilesId summary: Get a Shipping Profile description: Retrieve a shipping profile by its ID. You can expand the shipping profile's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The shipping profile'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/shipping-profiles/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Shipping Profiles responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminShippingProfileResponse' '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' post: operationId: PostShippingProfilesId summary: Update a Shipping Profile description: Update a shipping profile's details. x-authenticated: true parameters: - name: id in: path description: The shipping profile'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - metadata properties: name: type: string title: name description: The shipping profile's name. type: type: string title: type description: The shipping profile's type. metadata: type: object description: The shipping profile's metadata. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/shipping-profiles/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "metadata": {} }' tags: - Shipping Profiles responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminShippingProfileResponse' '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' delete: operationId: DeleteShippingProfilesId summary: Delete a Shipping Profile description: Delete a shipping profile. x-authenticated: true parameters: - name: id in: path description: The shipping profile'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/shipping-profiles/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Shipping Profiles responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminShippingProfileDeleteResponse' '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' /admin/stock-locations: get: operationId: GetStockLocations summary: List Stock Locations description: Retrieve a list of stock locations. The stock locations can be filtered by fields such as `id`. The stock locations 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 `-`. - name: q in: query description: The stock location's q. required: false schema: type: string title: q description: The stock location's q. - name: id in: query required: false schema: oneOf: - type: string title: id description: The stock location's ID. - type: array description: The stock location's ID. items: type: string title: id description: The id's ID. - name: name in: query required: false schema: oneOf: - type: string title: name description: The stock location's name. - type: array description: The stock location's name. items: type: string title: name description: The name's details. - name: address_id in: query required: false schema: oneOf: - type: string title: address_id description: The stock location's address id. - type: array description: The stock location's address id. items: type: string title: address_id description: The address id's details. - name: sales_channel_id in: query required: false schema: oneOf: - type: string title: sales_channel_id description: The stock location's sales channel id. - type: array description: The stock location's sales channel id. items: type: string title: sales_channel_id description: The sales channel id's details. - name: created_at in: query description: The stock location's created at. required: false schema: type: string description: The stock location's created at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: created_at - name: updated_at in: query description: The stock location's updated at. required: false schema: type: string description: The stock location's updated at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: updated_at - name: deleted_at in: query description: The stock location's deleted at. required: false schema: type: string description: The stock location's deleted at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: deleted_at - name: $and in: query required: false schema: type: array description: The stock location's $and. items: type: object title: $and - name: $or in: query required: false schema: type: array description: The stock location's $or. items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/stock-locations' \ -H 'x-medusa-access-token: {api_token}' tags: - Stock Locations responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminStockLocationListResponse' '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' post: operationId: PostStockLocations summary: Create Stock Location description: Create a stock location. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminCreateStockLocation' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/stock-locations' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "name": "Maryam", "address_id": "{value}", "metadata": {} }' tags: - Stock Locations responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminStockLocationResponse' '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: createStockLocationsWorkflow /admin/stock-locations/{id}: get: operationId: GetStockLocationsId summary: Get a Stock Location description: Retrieve a stock location by its ID. You can expand the stock location's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The stock location'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/stock-locations/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Stock Locations responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminStockLocationResponse' '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' post: operationId: PostStockLocationsId summary: Update a Stock Location description: Update a stock location's details. x-authenticated: true parameters: - name: id in: path description: The stock location'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminUpdateStockLocation' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/stock-locations/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "address_id": "{value}", "metadata": {} }' tags: - Stock Locations responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminStockLocationResponse' '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' delete: operationId: DeleteStockLocationsId summary: Delete a Stock Location description: Delete a stock location. x-authenticated: true parameters: - name: id in: path description: The stock location'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/stock-locations/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Stock Locations responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminStockLocationDeleteResponse' '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' /admin/stock-locations/{id}/fulfillment-providers: post: operationId: PostStockLocationsIdFulfillmentProviders summary: Add Fulfillment Providers to Stock Location description: Add a list of fulfillment providers to a stock location. x-authenticated: true parameters: - name: id in: path description: The stock location'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: add: type: array description: The stock location's add. items: type: string title: add description: The add's details. remove: type: array description: The stock location's remove. items: type: string title: remove description: The remove's details. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/stock-locations/{id}/fulfillment-providers' \ -H 'x-medusa-access-token: {api_token}' tags: - Stock Locations responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminStockLocationResponse' '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' /admin/stock-locations/{id}/fulfillment-sets: post: operationId: PostStockLocationsIdFulfillmentSets summary: Add Fulfillment Sets to Stock Location description: Add a list of fulfillment sets to a stock location. x-authenticated: true parameters: - name: id in: path description: The stock location'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY required: - name - type properties: name: type: string title: name description: The stock location's name. type: type: string title: type description: The stock location's type. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/stock-locations/{id}/fulfillment-sets' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "name": "Helene", "type": "{value}" }' tags: - Stock Locations responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminStockLocationResponse' '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' /admin/stock-locations/{id}/sales-channels: post: operationId: PostStockLocationsIdSalesChannels summary: Add Sales Channels to Stock Location description: Add a list of sales channels to a stock location. x-authenticated: true parameters: - name: id in: path description: The stock location'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: [] requestBody: content: application/json: schema: type: object description: SUMMARY properties: add: type: array description: The stock location's add. items: type: string title: add description: The add's details. remove: type: array description: The stock location's remove. items: type: string title: remove description: The remove's details. x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/stock-locations/{id}/sales-channels' \ -H 'x-medusa-access-token: {api_token}' tags: - Stock Locations responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminStockLocationResponse' '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' /admin/stores: get: operationId: GetStores summary: List Stores description: Retrieve a list of stores. The stores can be filtered by fields such as `id`. The stores 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 `-`. - name: q in: query description: The store's q. required: false schema: type: string title: q description: The store's q. - name: id in: query required: false schema: oneOf: - type: string title: id description: The store's ID. - type: array description: The store's ID. items: type: string title: id description: The id's ID. - name: name in: query required: false schema: oneOf: - type: string title: name description: The store's name. - type: array description: The store's name. items: type: string title: name description: The name's details. - name: $and in: query required: false schema: type: array description: The store's $and. items: type: object title: $and - name: $or in: query required: false schema: type: array description: The store's $or. items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/stores' \ -H 'x-medusa-access-token: {api_token}' tags: - Stores responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminStoreListResponse' '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' /admin/stores/{id}: get: operationId: GetStoresId summary: Get a Store description: Retrieve a store by its ID. You can expand the store's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The store'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/stores/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Stores responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminStoreResponse' '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' post: operationId: PostStoresId summary: Update a Store description: Update a store's details. x-authenticated: true parameters: - name: id in: path description: The store'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminUpdateStore' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/stores/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "name": "Melvina", "default_sales_channel_id": "{value}", "default_region_id": "{value}", "default_location_id": "{value}", "metadata": {} }' tags: - Stores responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminStoreResponse' '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: updateStoresWorkflow /admin/tax-rates: get: operationId: GetTaxRates summary: List Tax Rates description: Retrieve a list of tax rates. The tax rates can be filtered by fields such as `id`. The tax rates 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 `-`. - name: q in: query description: The tax rate's q. required: false schema: type: string title: q description: The tax rate's q. - name: tax_region_id in: query required: false schema: oneOf: - type: string title: tax_region_id description: The tax rate's tax region id. - type: array description: The tax rate's tax region id. items: type: string title: tax_region_id description: The tax region id's details. - type: object description: The tax rate's tax region id. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} - name: is_default in: query required: false schema: type: string enum: - 'true' - 'false' - name: created_at in: query description: The tax rate's created at. required: false schema: type: string description: The tax rate's created at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: created_at - name: updated_at in: query description: The tax rate's updated at. required: false schema: type: string description: The tax rate's updated at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: updated_at - name: deleted_at in: query description: The tax rate's deleted at. required: false schema: type: string description: The tax rate's deleted at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: deleted_at - name: $and in: query required: false schema: type: array description: The tax rate's $and. items: type: object title: $and - name: $or in: query required: false schema: type: array description: The tax rate's $or. items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/tax-rates' \ -H 'x-medusa-access-token: {api_token}' tags: - Tax Rates 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 tax rate's limit. offset: type: number title: offset description: The tax rate's offset. count: type: number title: count description: The tax rate's count. - type: object description: SUMMARY required: - tax_rates properties: tax_rates: type: array description: The tax rate's tax rates. items: $ref: '#/components/schemas/AdminTaxRate' '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' post: operationId: PostTaxRates summary: Create Tax Rate description: Create a tax rate. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminCreateTaxRate' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/tax-rates' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "name": "Kaylin", "tax_region_id": "{value}", "metadata": {} }' tags: - Tax Rates responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminTaxRateResponse' '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: createTaxRatesWorkflow /admin/tax-rates/{id}: get: operationId: GetTaxRatesId summary: Get a Tax Rate description: Retrieve a tax rate by its ID. You can expand the tax rate's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The tax rate'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/tax-rates/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Tax Rates responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminTaxRateResponse' '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' post: operationId: PostTaxRatesId summary: Update a Tax Rate description: Update a tax rate's details. x-authenticated: true parameters: - name: id in: path description: The tax rate'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminUpdateTaxRate' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/tax-rates/{id}' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "metadata": {} }' tags: - Tax Rates responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminTaxRateResponse' '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' delete: operationId: DeleteTaxRatesId summary: Delete a Tax Rate description: Delete a tax rate. x-authenticated: true parameters: - name: id in: path description: The tax rate'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/tax-rates/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Tax Rates responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminTaxRateDeleteResponse' '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' /admin/tax-rates/{id}/rules: post: operationId: PostTaxRatesIdRules summary: Add Rules to Tax Rate description: Add a list of rules to a tax rate. x-authenticated: true parameters: - name: id in: path description: The tax rate'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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminCreateTaxRateRule' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/tax-rates/{id}/rules' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "reference": "{value}", "reference_id": "{value}" }' tags: - Tax Rates responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminTaxRateResponse' '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' /admin/tax-rates/{id}/rules/{rule_id}: delete: operationId: DeleteTaxRatesIdRulesRule_id summary: Remove Rules from Tax Rate description: Remove a list of rules from a tax rate. This doesn't delete the Rule, only the association between the Rule and the tax rate. x-authenticated: true parameters: - name: id in: path description: The tax rate's ID. required: true schema: type: string - name: rule_id in: path description: The tax rate's rule 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/tax-rates/{id}/rules/{rule_id}' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/tax-regions: get: operationId: GetTaxRegions summary: List Tax Regions description: Retrieve a list of tax regions. The tax regions can be filtered by fields such as `id`. The tax regions 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 `-`. - name: q in: query description: The tax region's q. required: false schema: type: string title: q description: The tax region's q. - name: id in: query required: false schema: oneOf: - type: string title: id description: The tax region's ID. - type: array description: The tax region's ID. items: type: string title: id description: The id's ID. - name: country_code in: query required: false schema: oneOf: - type: string title: country_code description: The tax region's country code. - type: array description: The tax region's country code. items: type: string title: country_code description: The country code's details. - type: object description: The tax region's country code. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} - name: province_code in: query required: false schema: oneOf: - type: string title: province_code description: The tax region's province code. - type: array description: The tax region's province code. items: type: string title: province_code description: The province code's details. - type: object description: The tax region's province code. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} - name: parent_id in: query required: false schema: oneOf: - type: string title: parent_id description: The tax region's parent id. - type: array description: The tax region's parent id. items: type: string title: parent_id description: The parent id's details. - type: object description: The tax region's parent id. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} - name: created_by in: query required: false schema: oneOf: - type: string title: created_by description: The tax region's created by. - type: array description: The tax region's created by. items: type: string title: created_by description: The created by's details. - name: created_at in: query description: The tax region's created at. required: false schema: type: string description: The tax region's created at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: created_at - name: updated_at in: query description: The tax region's updated at. required: false schema: type: string description: The tax region's updated at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: updated_at - name: deleted_at in: query description: The tax region's deleted at. required: false schema: type: string description: The tax region's deleted at. required: - $eq - $ne - $in - $nin - $like - $ilike - $re - $contains - $gt - $gte - $lt - $lte properties: $eq: {} $ne: {} $in: {} $nin: {} $like: {} $ilike: {} $re: {} $contains: {} $gt: {} $gte: {} $lt: {} $lte: {} title: deleted_at - name: $and in: query required: false schema: type: array description: The tax region's $and. items: type: object title: $and - name: $or in: query required: false schema: type: array description: The tax region's $or. items: type: object title: $or security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/tax-regions' \ -H 'x-medusa-access-token: {api_token}' tags: - Tax 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 tax region's limit. offset: type: number title: offset description: The tax region's offset. count: type: number title: count description: The tax region's count. - type: object description: SUMMARY required: - tax_regions properties: tax_regions: type: array description: The tax region's tax regions. items: type: object '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' post: operationId: PostTaxRegions summary: Create Tax Region description: Create a tax region. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminCreateTaxRegion' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/tax-regions' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "country_code": "{value}", "province_code": "{value}", "parent_id": "{value}", "metadata": {} }' tags: - Tax Regions responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminTaxRegionResponse' '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: createTaxRegionsWorkflow /admin/tax-regions/{id}: get: operationId: GetTaxRegionsId summary: Get a Tax Region description: Retrieve a tax region by its ID. You can expand the tax region's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The tax region'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/tax-regions/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Tax Regions responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminTaxRegionResponse' '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' delete: operationId: DeleteTaxRegionsId summary: Delete a Tax Region description: Delete a tax region. x-authenticated: true parameters: - name: id in: path description: The tax region'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/tax-regions/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Tax Regions responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminTaxRegionDeleteResponse' '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' /admin/uploads: post: operationId: PostUploads summary: Create Upload description: Create a upload. 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: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminGetUploadParams' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/uploads' \ -H 'x-medusa-access-token: {api_token}' tags: - Uploads responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminFileListResponse' '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: uploadFilesWorkflow /admin/uploads/{id}: get: operationId: GetUploadsId summary: Get a Upload description: Retrieve a upload by its ID. You can expand the upload's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The upload'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/uploads/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Uploads responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminFileResponse' '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' delete: operationId: DeleteUploadsId summary: Delete a Upload description: Delete a upload. x-authenticated: true parameters: - name: id in: path description: The upload'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/uploads/{id}' \ -H 'x-medusa-access-token: {api_token}' 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': $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' /admin/users: get: operationId: GetUsers summary: List Users description: Retrieve a list of users. The users can be filtered by fields such as `id`. The users can also be sorted or paginated. x-authenticated: false 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 `-`. x-codeSamples: - lang: Shell label: cURL source: curl '{backend_url}/admin/users' tags: - Users responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminUserListResponse' '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' /admin/users/me: get: operationId: GetUsersMe summary: List Users description: Retrieve a list of users. The users can be filtered by fields such as `id`. The users can also be sorted or paginated. x-authenticated: false 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 `-`. x-codeSamples: - lang: Shell label: cURL source: curl '{backend_url}/admin/users/me' tags: - Users responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminUserResponse' '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' /admin/users/{id}: get: operationId: GetUsersId summary: Get a User description: Retrieve a user by its ID. You can expand the user's relations or select the fields that should be returned. x-authenticated: false parameters: - name: id in: path description: The user'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 `-`. x-codeSamples: - lang: Shell label: cURL source: curl '{backend_url}/admin/users/{id}' tags: - Users responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminUserResponse' '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' post: operationId: PostUsersId summary: Update a User description: Update a user's details. x-authenticated: false parameters: - name: id in: path description: The user'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 `-`. requestBody: content: application/json: schema: $ref: '#/components/schemas/AdminUpdateUser' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/users/{id}' \ -H 'Content-Type: application/json' \ --data-raw '{ "first_name": "{value}", "last_name": "{value}", "avatar_url": "{value}" }' tags: - Users responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminUserResponse' '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' delete: operationId: DeleteUsersId summary: Delete a User description: Delete a user. x-authenticated: false parameters: - name: id in: path description: The user'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 `-`. x-codeSamples: - lang: Shell label: cURL source: curl -X DELETE '{backend_url}/admin/users/{id}' tags: - Users responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminUserDeleteResponse' '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' /admin/workflows-executions: get: operationId: GetWorkflowsExecutions summary: List Workflows Executions description: Retrieve a list of workflows executions. The workflows executions can be filtered by fields such as `id`. The workflows executions 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 `-`. - name: transaction_id in: query required: false schema: oneOf: - type: string title: transaction_id description: The workflows execution's transaction id. - type: array description: The workflows execution's transaction id. items: type: string title: transaction_id description: The transaction id's details. - name: workflow_id in: query required: false schema: oneOf: - type: string title: workflow_id description: The workflows execution's workflow id. - type: array description: The workflows execution's workflow id. items: type: string title: workflow_id description: The workflow id's details. security: - api_token: [] - cookie_auth: [] - jwt_token: [] x-codeSamples: - lang: Shell label: cURL source: |- curl '{backend_url}/admin/workflows-executions' \ -H 'x-medusa-access-token: {api_token}' tags: - Workflows Executions 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 workflows execution's limit. offset: type: number title: offset description: The workflows execution's offset. count: type: number title: count description: The workflows execution's count. - type: object description: SUMMARY required: - workflow_executions properties: workflow_executions: type: array description: The workflows execution's workflow executions. items: $ref: '#/components/schemas/AdminWorkflowExecution' '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' /admin/workflows-executions/{id}: get: operationId: GetWorkflowsExecutionsId summary: Get a Workflows Execution description: Retrieve a workflows execution by its ID. You can expand the workflows execution's relations or select the fields that should be returned. x-authenticated: true parameters: - name: id in: path description: The workflows execution'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/workflows-executions/{id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Workflows Executions responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminWorkflowExecutionResponse' '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' /admin/workflows-executions/{workflow_id}/run: post: operationId: PostWorkflowsExecutionsWorkflow_idRun summary: Add Runs to Workflows Execution description: Add a list of runs to a workflows execution. x-authenticated: true parameters: - name: workflow_id in: path description: The workflows execution's workflow 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/AdminCreateWorkflowsRun' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/workflows-executions/{workflow_id}/run' \ -H 'x-medusa-access-token: {api_token}' tags: - Workflows Executions responses: '200': description: OK content: application/json: schema: type: object description: SUMMARY required: - acknowledgement properties: acknowledgement: {} '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' /admin/workflows-executions/{workflow_id}/steps/failure: post: operationId: PostWorkflowsExecutionsWorkflow_idStepsFailure summary: Add Failures to Workflows Execution description: Add a list of failures to a workflows execution. x-authenticated: true parameters: - name: workflow_id in: path description: The workflows execution's workflow 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/AdminCreateWorkflowsAsyncResponse' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/workflows-executions/{workflow_id}/steps/failure' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "transaction_id": "{value}", "step_id": "{value}" }' tags: - Workflows Executions responses: '200': description: OK content: application/json: schema: type: object description: SUMMARY required: - success properties: success: type: boolean title: success description: The workflows execution's success. '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' /admin/workflows-executions/{workflow_id}/steps/success: post: operationId: PostWorkflowsExecutionsWorkflow_idStepsSuccess summary: Add Successes to Workflows Execution description: Add a list of successes to a workflows execution. x-authenticated: true parameters: - name: workflow_id in: path description: The workflows execution's workflow 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/AdminCreateWorkflowsAsyncResponse' x-codeSamples: - lang: Shell label: cURL source: |- curl -X POST '{backend_url}/admin/workflows-executions/{workflow_id}/steps/success' \ -H 'x-medusa-access-token: {api_token}' \ -H 'Content-Type: application/json' \ --data-raw '{ "transaction_id": "{value}", "step_id": "{value}" }' tags: - Workflows Executions responses: '200': description: OK content: application/json: schema: type: object description: SUMMARY required: - success properties: success: type: boolean title: success description: The workflows execution's success. '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' /admin/workflows-executions/{workflow_id}/subscribe: get: operationId: GetWorkflowsExecutionsWorkflow_idSubscribe summary: List Subscribes description: Retrieve a list of subscribes in a workflows execution. The subscribes can be filtered by fields like FILTER FIELDS. The subscribes can also be paginated. x-authenticated: true parameters: - name: workflow_id in: path description: The workflows execution's workflow 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/workflows-executions/{workflow_id}/subscribe' \ -H 'x-medusa-access-token: {api_token}' tags: - Workflows Executions responses: '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' /admin/workflows-executions/{workflow_id}/{transaction_id}: get: operationId: GetWorkflowsExecutionsWorkflow_idTransaction_id summary: 'List ' description: Retrieve a list of in a workflows execution. The can be filtered by fields like FILTER FIELDS. The can also be paginated. x-authenticated: true parameters: - name: workflow_id in: path description: The workflows execution's workflow id. required: true schema: type: string - name: transaction_id in: path description: The workflows execution's transaction 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/workflows-executions/{workflow_id}/{transaction_id}' \ -H 'x-medusa-access-token: {api_token}' tags: - Workflows Executions responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminWorkflowExecutionResponse' '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' /admin/workflows-executions/{workflow_id}/{transaction_id}/{step_id}/subscribe: get: operationId: GetWorkflowsExecutionsWorkflow_idTransaction_idStep_idSubscribe summary: List Subscribes description: Retrieve a list of subscribes in a workflows execution. The subscribes can be filtered by fields like FILTER FIELDS. The subscribes can also be paginated. x-authenticated: true parameters: - name: workflow_id in: path description: The workflows execution's workflow id. required: true schema: type: string - name: transaction_id in: path description: The workflows execution's transaction id. required: true schema: type: string - name: step_id in: path description: The workflows execution's step 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/workflows-executions/{workflow_id}/{transaction_id}/{step_id}/subscribe' \ -H 'x-medusa-access-token: {api_token}' tags: - Workflows Executions responses: '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' components: schemas: AdminApiKeyResponse: type: object description: SUMMARY x-schemaName: AdminApiKeyResponse required: - api_key properties: api_key: $ref: '#/components/schemas/ApiKeyResponse' AdminArchiveOrder: type: object description: SUMMARY x-schemaName: AdminArchiveOrder required: - order_id properties: order_id: type: string title: order_id description: The order's order id. AdminBatchProductRequest: type: object description: SUMMARY x-schemaName: AdminBatchProductRequest properties: create: type: array description: The product's create. items: $ref: '#/components/schemas/AdminCreateProduct' update: type: array description: The product's update. items: $ref: '#/components/schemas/AdminUpdateProduct' delete: type: array description: The product's delete. items: type: string title: delete description: The delete's details. AdminBatchProductResponse: type: object description: SUMMARY x-schemaName: AdminBatchProductResponse required: - created - updated - deleted properties: created: type: array description: The product's created. items: $ref: '#/components/schemas/AdminProduct' updated: type: array description: The product's updated. items: $ref: '#/components/schemas/AdminProduct' deleted: type: object description: The product's deleted. required: - ids - object - deleted properties: ids: type: array description: The deleted's ids. items: type: string title: ids description: The id's ids. object: type: string title: object description: The deleted's object. deleted: type: boolean title: deleted description: The deleted's details. AdminBatchProductVariantRequest: type: object description: SUMMARY x-schemaName: AdminBatchProductVariantRequest properties: create: type: array description: The product's create. items: $ref: '#/components/schemas/AdminCreateProductVariant' update: type: array description: The product's update. items: $ref: '#/components/schemas/AdminUpdateProductVariant' delete: type: array description: The product's delete. items: type: string title: delete description: The delete's details. AdminBatchProductVariantResponse: type: object description: SUMMARY x-schemaName: AdminBatchProductVariantResponse required: - created - updated - deleted properties: created: type: array description: The product's created. items: $ref: '#/components/schemas/AdminProductVariant' updated: type: array description: The product's updated. items: $ref: '#/components/schemas/AdminProductVariant' deleted: type: object description: The product's deleted. required: - ids - object - deleted properties: ids: type: array description: The deleted's ids. items: type: string title: ids description: The id's ids. object: type: string title: object description: The deleted's object. deleted: type: boolean title: deleted description: The deleted's details. AdminCampaignResponse: type: object description: SUMMARY x-schemaName: AdminCampaignResponse required: - campaign properties: campaign: $ref: '#/components/schemas/CampaignResponse' AdminCancelFulfillment: type: object description: SUMMARY x-schemaName: AdminCancelFulfillment AdminClaim: type: object description: The claim's details. x-schemaName: AdminClaim required: - order_id - claim_items - additional_items - currency_code - id - region_id - customer_id - sales_channel_id - email - shipping_methods - payment_status - fulfillment_status - summary - metadata - created_at - updated_at - original_item_total - original_item_subtotal - original_item_tax_total - item_total - item_subtotal - item_tax_total - original_total - original_subtotal - original_tax_total - total - subtotal - tax_total - discount_total - discount_tax_total - gift_card_total - gift_card_tax_total - shipping_total - shipping_subtotal - shipping_tax_total - original_shipping_total - original_shipping_subtotal - original_shipping_tax_total properties: order_id: type: string title: order_id description: The claim's order id. claim_items: type: array description: The claim's claim items. items: $ref: '#/components/schemas/BaseClaimItem' additional_items: type: array description: The claim's additional items. items: {} return: $ref: '#/components/schemas/Return' return_id: type: string title: return_id description: The claim's return id. no_notification: type: boolean title: no_notification description: The claim's no notification. refund_amount: type: number title: refund_amount description: The claim's refund amount. currency_code: type: string title: currency_code description: The claim's currency code. id: type: string title: id description: The claim's ID. region_id: type: string title: region_id description: The claim's region id. customer_id: type: string title: customer_id description: The claim's customer id. sales_channel_id: type: string title: sales_channel_id description: The claim's sales channel id. email: type: string title: email description: The claim's email. format: email display_id: type: string title: display_id description: The claim's display id. shipping_address: $ref: '#/components/schemas/BaseOrderAddress' billing_address: $ref: '#/components/schemas/BaseOrderAddress' shipping_methods: type: array description: The claim's shipping methods. items: $ref: '#/components/schemas/BaseOrderShippingMethod' payment_collections: type: array description: The claim's payment collections. items: $ref: '#/components/schemas/BasePaymentCollection' payment_status: type: string enum: - canceled - not_paid - awaiting - authorized - partially_authorized - captured - partially_captured - partially_refunded - refunded - requires_action fulfillments: type: array description: The claim's fulfillments. items: $ref: '#/components/schemas/BaseOrderFulfillment' fulfillment_status: type: string enum: - canceled - not_fulfilled - partially_fulfilled - fulfilled - partially_shipped - shipped - partially_delivered - delivered transactions: type: array description: The claim's transactions. items: $ref: '#/components/schemas/BaseOrderTransaction' summary: $ref: '#/components/schemas/BaseOrderSummary' metadata: type: object description: The claim's metadata. created_at: type: string format: date-time title: created_at description: The claim's created at. updated_at: type: string format: date-time title: updated_at description: The claim's updated at. original_item_total: type: number title: original_item_total description: The claim's original item total. original_item_subtotal: type: number title: original_item_subtotal description: The claim's original item subtotal. original_item_tax_total: type: number title: original_item_tax_total description: The claim's original item tax total. item_total: type: number title: item_total description: The claim's item total. item_subtotal: type: number title: item_subtotal description: The claim's item subtotal. item_tax_total: type: number title: item_tax_total description: The claim's item tax total. original_total: type: number title: original_total description: The claim's original total. original_subtotal: type: number title: original_subtotal description: The claim's original subtotal. original_tax_total: type: number title: original_tax_total description: The claim's original tax total. total: type: number title: total description: The claim's total. subtotal: type: number title: subtotal description: The claim's subtotal. tax_total: type: number title: tax_total description: The claim's tax total. discount_total: type: number title: discount_total description: The claim's discount total. discount_tax_total: type: number title: discount_tax_total description: The claim's discount tax total. gift_card_total: type: number title: gift_card_total description: The claim's gift card total. gift_card_tax_total: type: number title: gift_card_tax_total description: The claim's gift card tax total. shipping_total: type: number title: shipping_total description: The claim's shipping total. shipping_subtotal: type: number title: shipping_subtotal description: The claim's shipping subtotal. shipping_tax_total: type: number title: shipping_tax_total description: The claim's shipping tax total. original_shipping_total: type: number title: original_shipping_total description: The claim's original shipping total. original_shipping_subtotal: type: number title: original_shipping_subtotal description: The claim's original shipping subtotal. original_shipping_tax_total: type: number title: original_shipping_tax_total description: The claim's original shipping tax total. AdminClaimDeleteResponse: type: object description: SUMMARY x-schemaName: AdminClaimDeleteResponse required: - id - object - deleted properties: id: type: string title: id description: The claim's ID. object: type: string title: object description: The claim's object. default: claim deleted: type: boolean title: deleted description: The claim's deleted. parent: type: object description: The claim's parent. AdminClaimListResponse: type: object description: SUMMARY x-schemaName: AdminClaimListResponse required: - limit - offset - count - claims properties: limit: type: number title: limit description: The claim's limit. offset: type: number title: offset description: The claim's offset. count: type: number title: count description: The claim's count. claims: type: array description: The claim's claims. items: $ref: '#/components/schemas/AdminClaim' AdminClaimOrderResponse: type: object description: SUMMARY x-schemaName: AdminClaimOrderResponse required: - order - claim properties: order: $ref: '#/components/schemas/Order' claim: $ref: '#/components/schemas/AdminClaim' AdminClaimPreviewResponse: type: object description: SUMMARY x-schemaName: AdminClaimPreviewResponse required: - order_preview - claim properties: order_preview: $ref: '#/components/schemas/OrderPreview' claim: $ref: '#/components/schemas/AdminClaim' AdminClaimRequestResponse: type: object description: SUMMARY x-schemaName: AdminClaimRequestResponse required: - return - order_preview - claim properties: return: $ref: '#/components/schemas/AdminReturn' order_preview: $ref: '#/components/schemas/OrderPreview' claim: $ref: '#/components/schemas/AdminClaim' AdminClaimResponse: type: object description: SUMMARY x-schemaName: AdminClaimResponse required: - claim properties: claim: $ref: '#/components/schemas/AdminClaim' AdminClaimReturnPreviewResponse: type: object description: SUMMARY x-schemaName: AdminClaimReturnPreviewResponse required: - order_preview - return properties: order_preview: $ref: '#/components/schemas/OrderPreview' return: $ref: '#/components/schemas/AdminReturn' AdminCollection: type: object description: The parent's collection. x-schemaName: AdminCollection required: - id - title - handle - created_at - updated_at - deleted_at - metadata properties: id: type: string title: id description: The collection's ID. title: type: string title: title description: The collection's title. handle: type: string title: handle description: The collection's handle. created_at: type: string format: date-time title: created_at description: The collection's created at. updated_at: type: string format: date-time title: updated_at description: The collection's updated at. deleted_at: type: string format: date-time title: deleted_at description: The collection's deleted at. products: type: array description: The collection's products. items: type: object metadata: type: object description: The collection's metadata. AdminCollectionDeleteResponse: type: object description: SUMMARY x-schemaName: AdminCollectionDeleteResponse required: - id - object - deleted properties: id: type: string title: id description: The collection's ID. object: type: string title: object description: The collection's object. default: collection deleted: type: boolean title: deleted description: The collection's deleted. parent: type: object description: The collection's parent. AdminCollectionListResponse: type: object description: SUMMARY x-schemaName: AdminCollectionListResponse required: - limit - offset - count - collections properties: limit: type: number title: limit description: The collection's limit. offset: type: number title: offset description: The collection's offset. count: type: number title: count description: The collection's count. collections: type: array description: The collection's collections. items: $ref: '#/components/schemas/AdminCollection' AdminCollectionResponse: type: object description: SUMMARY x-schemaName: AdminCollectionResponse required: - collection properties: collection: $ref: '#/components/schemas/AdminCollection' AdminCreateApiKey: type: object description: SUMMARY x-schemaName: AdminCreateApiKey required: - title - type properties: title: type: string title: title description: The api key's title. type: type: string enum: - publishable - secret AdminCreateCollection: type: object description: SUMMARY x-schemaName: AdminCreateCollection required: - title - metadata properties: title: type: string title: title description: The collection's title. handle: type: string title: handle description: The collection's handle. metadata: type: object description: The collection's metadata. AdminCreateCustomerGroup: type: object description: SUMMARY x-schemaName: AdminCreateCustomerGroup required: - name - metadata properties: name: type: string title: name description: The customer group's name. metadata: type: object description: The customer group's metadata. AdminCreateFulfillment: type: object description: SUMMARY x-schemaName: AdminCreateFulfillment required: - location_id - provider_id - delivery_address - items - labels - order - order_id - shipping_option_id - data - packed_at - shipped_at - delivered_at - canceled_at - metadata properties: location_id: type: string title: location_id description: The fulfillment's location id. provider_id: type: string title: provider_id description: The fulfillment's provider id. delivery_address: type: object description: The fulfillment's delivery address. required: - first_name - last_name - phone - company - address_1 - address_2 - city - country_code - province - postal_code - metadata properties: first_name: type: string title: first_name description: The delivery address's first name. last_name: type: string title: last_name description: The delivery address's last name. phone: type: string title: phone description: The delivery address's phone. company: type: string title: company description: The delivery address's company. address_1: type: string title: address_1 description: The delivery address's address 1. address_2: type: string title: address_2 description: The delivery address's address 2. city: type: string title: city description: The delivery address's city. country_code: type: string title: country_code description: The delivery address's country code. province: type: string title: province description: The delivery address's province. postal_code: type: string title: postal_code description: The delivery address's postal code. metadata: type: object description: The delivery address's metadata. items: type: array description: The fulfillment's items. items: type: object description: The item's items. required: - title - sku - quantity - barcode - line_item_id - inventory_item_id properties: title: type: string title: title description: The item's title. sku: type: string title: sku description: The item's sku. quantity: type: number title: quantity description: The item's quantity. barcode: type: string title: barcode description: The item's barcode. line_item_id: type: string title: line_item_id description: The item's line item id. inventory_item_id: type: string title: inventory_item_id description: The item's inventory item id. labels: type: array description: The fulfillment's labels. items: type: object description: The label's labels. required: - tracking_number - tracking_url - label_url properties: tracking_number: type: string title: tracking_number description: The label's tracking number. tracking_url: type: string title: tracking_url description: The label's tracking url. label_url: type: string title: label_url description: The label's label url. order: type: object description: The fulfillment's order. order_id: type: string title: order_id description: The fulfillment's order id. shipping_option_id: type: string title: shipping_option_id description: The fulfillment's shipping option id. data: type: object description: The fulfillment's data. packed_at: type: string title: packed_at description: The fulfillment's packed at. format: date-time shipped_at: type: string title: shipped_at description: The fulfillment's shipped at. format: date-time delivered_at: type: string title: delivered_at description: The fulfillment's delivered at. format: date-time canceled_at: type: string title: canceled_at description: The fulfillment's canceled at. format: date-time metadata: type: object description: The fulfillment's metadata. AdminCreatePriceList: type: object description: SUMMARY x-schemaName: AdminCreatePriceList required: - title - description - starts_at - ends_at properties: title: type: string title: title description: The price list's title. description: type: string title: description description: The price list's description. starts_at: type: string title: starts_at description: The price list's starts at. ends_at: type: string title: ends_at description: The price list's ends at. status: type: string enum: - active - draft type: type: string enum: - sale - override rules: type: object description: The price list's rules. prices: type: array description: The price list's prices. items: type: object description: The price's prices. required: - currency_code - amount - variant_id - min_quantity - max_quantity properties: currency_code: type: string title: currency_code description: The price's currency code. amount: type: number title: amount description: The price's amount. variant_id: type: string title: variant_id description: The price's variant id. min_quantity: type: number title: min_quantity description: The price's min quantity. max_quantity: type: number title: max_quantity description: The price's max quantity. rules: type: object description: The price's rules. AdminCreatePricePreference: type: object description: SUMMARY x-schemaName: AdminCreatePricePreference properties: attribute: type: string title: attribute description: The price preference's attribute. value: type: string title: value description: The price preference's value. is_tax_inclusive: type: boolean title: is_tax_inclusive description: The price preference's is tax inclusive. AdminCreateProduct: type: object description: The create's details. x-schemaName: AdminCreateProduct required: - title properties: title: type: string title: title description: The create's title. subtitle: type: string title: subtitle description: The create's subtitle. description: type: string title: description description: The create's description. is_giftcard: type: boolean title: is_giftcard description: The create's is giftcard. discountable: type: boolean title: discountable description: The create's discountable. images: type: array description: The create's images. items: type: object description: The image's images. required: - url properties: url: type: string title: url description: The image's url. thumbnail: type: string title: thumbnail description: The create's thumbnail. handle: type: string title: handle description: The create's handle. status: type: string enum: - draft - proposed - published - rejected type_id: type: string title: type_id description: The create's type id. collection_id: type: string title: collection_id description: The create's collection id. categories: type: array description: The create's categories. items: type: object description: The category's categories. required: - id properties: id: type: string title: id description: The category's ID. tags: type: array description: The create's tags. items: type: object description: The tag's tags. required: - id properties: id: type: string title: id description: The tag's ID. options: type: array description: The create's options. items: $ref: '#/components/schemas/AdminCreateProductOption' variants: type: array description: The create's variants. items: $ref: '#/components/schemas/AdminCreateProductVariant' sales_channels: type: array description: The create's sales channels. items: type: object description: The sales channel's sales channels. required: - id properties: id: type: string title: id description: The sales channel's ID. weight: type: number title: weight description: The create's weight. length: type: number title: length description: The create's length. height: type: number title: height description: The create's height. width: type: number title: width description: The create's width. hs_code: type: string title: hs_code description: The create's hs code. mid_code: type: string title: mid_code description: The create's mid code. origin_country: type: string title: origin_country description: The create's origin country. material: type: string title: material description: The create's material. metadata: type: object description: The create's metadata. AdminCreateProductOption: type: object description: SUMMARY x-schemaName: AdminCreateProductOption required: - title - values properties: title: type: string title: title description: The product's title. values: type: array description: The product's values. items: type: string title: values description: The value's values. AdminCreateProductVariant: type: object description: The create's details. x-schemaName: AdminCreateProductVariant required: - title - prices properties: title: type: string title: title description: The create's title. sku: type: string title: sku description: The create's sku. ean: type: string title: ean description: The create's ean. upc: type: string title: upc description: The create's upc. barcode: type: string title: barcode description: The create's barcode. hs_code: type: string title: hs_code description: The create's hs code. mid_code: type: string title: mid_code description: The create's mid code. allow_backorder: type: boolean title: allow_backorder description: The create's allow backorder. manage_inventory: type: boolean title: manage_inventory description: The create's manage inventory. variant_rank: type: number title: variant_rank description: The create's variant rank. weight: type: number title: weight description: The create's weight. length: type: number title: length description: The create's length. height: type: number title: height description: The create's height. width: type: number title: width description: The create's width. origin_country: type: string title: origin_country description: The create's origin country. material: type: string title: material description: The create's material. metadata: type: object description: The create's metadata. prices: type: array description: The create's prices. items: $ref: '#/components/schemas/AdminCreateProductVariantPrice' options: type: object description: The create's options. AdminCreateProductVariantPrice: type: object description: The price's prices. x-schemaName: AdminCreateProductVariantPrice required: - currency_code - amount properties: currency_code: type: string title: currency_code description: The price's currency code. amount: type: number title: amount description: The price's amount. min_quantity: type: number title: min_quantity description: The price's min quantity. max_quantity: type: number title: max_quantity description: The price's max quantity. rules: type: object description: The price's rules. AdminCreateSalesChannel: type: object description: SUMMARY x-schemaName: AdminCreateSalesChannel required: - name - description - metadata properties: name: type: string title: name description: The sales channel's name. description: type: string title: description description: The sales channel's description. is_disabled: type: boolean title: is_disabled description: The sales channel's is disabled. metadata: type: object description: The sales channel's metadata. AdminCreateShipment: type: object description: SUMMARY x-schemaName: AdminCreateShipment required: - labels properties: labels: type: array description: The fulfillment's labels. items: type: object description: The label's labels. required: - tracking_number - tracking_url - label_url properties: tracking_number: type: string title: tracking_number description: The label's tracking number. tracking_url: type: string title: tracking_url description: The label's tracking url. label_url: type: string title: label_url description: The label's label url. AdminCreateStockLocation: type: object description: SUMMARY x-schemaName: AdminCreateStockLocation required: - name - address_id - metadata properties: name: type: string title: name description: The stock location's name. address: type: object description: The stock location's address. required: - address_1 - address_2 - company - city - country_code - phone - postal_code - province properties: address_1: type: string title: address_1 description: The address's address 1. address_2: type: string title: address_2 description: The address's address 2. company: type: string title: company description: The address's company. city: type: string title: city description: The address's city. country_code: type: string title: country_code description: The address's country code. phone: type: string title: phone description: The address's phone. postal_code: type: string title: postal_code description: The address's postal code. province: type: string title: province description: The address's province. address_id: type: string title: address_id description: The stock location's address id. metadata: type: object description: The stock location's metadata. AdminCreateTaxRate: type: object description: SUMMARY x-schemaName: AdminCreateTaxRate required: - name - tax_region_id - metadata properties: rate: type: number title: rate description: The tax rate's rate. code: type: string title: code description: The tax rate's code. rules: type: array description: The tax rate's rules. items: type: object description: The rule's rules. required: - reference - reference_id properties: reference: type: string title: reference description: The rule's reference. reference_id: type: string title: reference_id description: The rule's reference id. name: type: string title: name description: The tax rate's name. is_default: type: boolean title: is_default description: The tax rate's is default. is_combinable: type: boolean title: is_combinable description: The tax rate's is combinable. tax_region_id: type: string title: tax_region_id description: The tax rate's tax region id. metadata: type: object description: The tax rate's metadata. AdminCreateTaxRateRule: type: object description: SUMMARY x-schemaName: AdminCreateTaxRateRule required: - reference - reference_id properties: reference: type: string title: reference description: The tax rate's reference. reference_id: type: string title: reference_id description: The tax rate's reference id. AdminCreateTaxRegion: type: object description: SUMMARY x-schemaName: AdminCreateTaxRegion required: - country_code - province_code - parent_id - metadata properties: country_code: type: string title: country_code description: The tax region's country code. province_code: type: string title: province_code description: The tax region's province code. parent_id: type: string title: parent_id description: The tax region's parent id. default_tax_rate: type: object description: The tax region's default tax rate. required: - name - metadata properties: rate: type: number title: rate description: The default tax rate's rate. code: type: string title: code description: The default tax rate's code. name: type: string title: name description: The default tax rate's name. is_combinable: type: boolean title: is_combinable description: The default tax rate's is combinable. metadata: type: object description: The default tax rate's metadata. metadata: type: object description: The tax region's metadata. AdminCreateVariantInventoryItem: type: object description: SUMMARY x-schemaName: AdminCreateVariantInventoryItem required: - required_quantity - inventory_item_id properties: required_quantity: type: number title: required_quantity description: The product's required quantity. inventory_item_id: type: string title: inventory_item_id description: The product's inventory item id. AdminCreateWorkflowsAsyncResponse: type: object description: SUMMARY x-schemaName: AdminCreateWorkflowsAsyncResponse required: - transaction_id - step_id properties: transaction_id: type: string title: transaction_id description: The workflows execution's transaction id. step_id: type: string title: step_id description: The workflows execution's step id. response: {} compensate_input: {} action: type: string enum: - invoke - compensate AdminCreateWorkflowsRun: type: object description: SUMMARY x-schemaName: AdminCreateWorkflowsRun properties: input: {} transaction_id: type: string title: transaction_id description: The workflows execution's transaction id. AdminCurrency: type: object description: The supported currency's currency. x-schemaName: AdminCurrency AdminCurrencyListResponse: type: object description: SUMMARY x-schemaName: AdminCurrencyListResponse required: - limit - offset - count - currencies properties: limit: type: number title: limit description: The currency's limit. offset: type: number title: offset description: The currency's offset. count: type: number title: count description: The currency's count. currencies: type: array description: The currency's currencies. items: $ref: '#/components/schemas/AdminCurrency' AdminCurrencyResponse: type: object description: SUMMARY x-schemaName: AdminCurrencyResponse required: - currency properties: currency: $ref: '#/components/schemas/AdminCurrency' AdminCustomer: type: object description: The customer's details. x-schemaName: AdminCustomer required: - has_account - id - email - default_billing_address_id - default_shipping_address_id - company_name - first_name - last_name - addresses properties: has_account: type: boolean title: has_account description: The customer's has account. groups: type: array description: The customer's groups. items: $ref: '#/components/schemas/AdminCustomerGroup' id: type: string title: id description: The customer's ID. email: type: string title: email description: The customer's email. format: email default_billing_address_id: type: string title: default_billing_address_id description: The customer's default billing address id. default_shipping_address_id: type: string title: default_shipping_address_id description: The customer's default shipping address id. company_name: type: string title: company_name description: The customer's company name. first_name: type: string title: first_name description: The customer's first name. last_name: type: string title: last_name description: The customer's last name. addresses: type: array description: The customer's addresses. items: $ref: '#/components/schemas/BaseCustomerAddress' phone: type: string title: phone description: The customer's phone. metadata: type: object description: The customer's metadata. created_by: type: string title: created_by description: The customer's created by. deleted_at: type: string format: date-time title: deleted_at description: The customer's deleted at. created_at: type: string format: date-time title: created_at description: The customer's created at. updated_at: type: string format: date-time title: updated_at description: The customer's updated at. AdminCustomerAddress: type: object description: The customer's address. x-schemaName: AdminCustomerAddress required: - id - address_name - is_default_shipping - is_default_billing - customer_id - company - first_name - last_name - address_1 - address_2 - city - country_code - province - postal_code - phone - metadata - created_at - updated_at properties: id: type: string title: id description: The address's ID. address_name: type: string title: address_name description: The address's address name. is_default_shipping: type: boolean title: is_default_shipping description: The address's is default shipping. is_default_billing: type: boolean title: is_default_billing description: The address's is default billing. customer_id: type: string title: customer_id description: The address's customer id. company: type: string title: company description: The address's company. first_name: type: string title: first_name description: The address's first name. last_name: type: string title: last_name description: The address's last name. address_1: type: string title: address_1 description: The address's address 1. address_2: type: string title: address_2 description: The address's address 2. city: type: string title: city description: The address's city. country_code: type: string title: country_code description: The address's country code. province: type: string title: province description: The address's province. postal_code: type: string title: postal_code description: The address's postal code. phone: type: string title: phone description: The address's phone. metadata: type: object description: The address's metadata. created_at: type: string format: date-time title: created_at description: The address's created at. updated_at: type: string format: date-time title: updated_at description: The address's updated at. AdminCustomerAddressResponse: type: object description: SUMMARY x-schemaName: AdminCustomerAddressResponse required: - address properties: address: $ref: '#/components/schemas/AdminCustomerAddress' AdminCustomerGroup: type: object description: The group's groups. x-schemaName: AdminCustomerGroup required: - id - name - customers - metadata - created_at - updated_at properties: id: type: string title: id description: The group's ID. name: type: string title: name description: The group's name. customers: type: array description: The group's customers. items: $ref: '#/components/schemas/BaseCustomer' metadata: type: object description: The group's metadata. created_at: type: string format: date-time title: created_at description: The group's created at. updated_at: type: string format: date-time title: updated_at description: The group's updated at. AdminCustomerGroupResponse: type: object description: SUMMARY x-schemaName: AdminCustomerGroupResponse required: - customer_group properties: customer_group: $ref: '#/components/schemas/AdminCustomerGroup' AdminCustomerResponse: type: object description: SUMMARY x-schemaName: AdminCustomerResponse required: - customer properties: customer: $ref: '#/components/schemas/AdminCustomer' AdminDraftOrderResponse: type: object description: SUMMARY x-schemaName: AdminDraftOrderResponse required: - draft_order properties: draft_order: $ref: '#/components/schemas/AdminOrder' AdminExchange: type: object description: The exchange's details. x-schemaName: AdminExchange required: - order_id - return_items - additional_items - currency_code - id - region_id - customer_id - sales_channel_id - email - shipping_methods - payment_status - fulfillment_status - summary - metadata - created_at - updated_at - original_item_total - original_item_subtotal - original_item_tax_total - item_total - item_subtotal - item_tax_total - original_total - original_subtotal - original_tax_total - total - subtotal - tax_total - discount_total - discount_tax_total - gift_card_total - gift_card_tax_total - shipping_total - shipping_subtotal - shipping_tax_total - original_shipping_total - original_shipping_subtotal - original_shipping_tax_total properties: order_id: type: string title: order_id description: The exchange's order id. return_items: type: array description: The exchange's return items. items: $ref: '#/components/schemas/AdminReturnItem' additional_items: type: array description: The exchange's additional items. items: $ref: '#/components/schemas/BaseExchangeItem' no_notification: type: boolean title: no_notification description: The exchange's no notification. difference_due: type: number title: difference_due description: The exchange's difference due. return: $ref: '#/components/schemas/AdminReturn' return_id: type: string title: return_id description: The exchange's return id. currency_code: type: string title: currency_code description: The exchange's currency code. id: type: string title: id description: The exchange's ID. region_id: type: string title: region_id description: The exchange's region id. customer_id: type: string title: customer_id description: The exchange's customer id. sales_channel_id: type: string title: sales_channel_id description: The exchange's sales channel id. email: type: string title: email description: The exchange's email. format: email display_id: type: string title: display_id description: The exchange's display id. shipping_address: $ref: '#/components/schemas/BaseOrderAddress' billing_address: $ref: '#/components/schemas/BaseOrderAddress' shipping_methods: type: array description: The exchange's shipping methods. items: $ref: '#/components/schemas/BaseOrderShippingMethod' payment_collections: type: array description: The exchange's payment collections. items: $ref: '#/components/schemas/BasePaymentCollection' payment_status: type: string enum: - canceled - not_paid - awaiting - authorized - partially_authorized - captured - partially_captured - partially_refunded - refunded - requires_action fulfillments: type: array description: The exchange's fulfillments. items: $ref: '#/components/schemas/BaseOrderFulfillment' fulfillment_status: type: string enum: - canceled - not_fulfilled - partially_fulfilled - fulfilled - partially_shipped - shipped - partially_delivered - delivered transactions: type: array description: The exchange's transactions. items: $ref: '#/components/schemas/BaseOrderTransaction' summary: $ref: '#/components/schemas/BaseOrderSummary' metadata: type: object description: The exchange's metadata. created_at: type: string format: date-time title: created_at description: The exchange's created at. updated_at: type: string format: date-time title: updated_at description: The exchange's updated at. original_item_total: type: number title: original_item_total description: The exchange's original item total. original_item_subtotal: type: number title: original_item_subtotal description: The exchange's original item subtotal. original_item_tax_total: type: number title: original_item_tax_total description: The exchange's original item tax total. item_total: type: number title: item_total description: The exchange's item total. item_subtotal: type: number title: item_subtotal description: The exchange's item subtotal. item_tax_total: type: number title: item_tax_total description: The exchange's item tax total. original_total: type: number title: original_total description: The exchange's original total. original_subtotal: type: number title: original_subtotal description: The exchange's original subtotal. original_tax_total: type: number title: original_tax_total description: The exchange's original tax total. total: type: number title: total description: The exchange's total. subtotal: type: number title: subtotal description: The exchange's subtotal. tax_total: type: number title: tax_total description: The exchange's tax total. discount_total: type: number title: discount_total description: The exchange's discount total. discount_tax_total: type: number title: discount_tax_total description: The exchange's discount tax total. gift_card_total: type: number title: gift_card_total description: The exchange's gift card total. gift_card_tax_total: type: number title: gift_card_tax_total description: The exchange's gift card tax total. shipping_total: type: number title: shipping_total description: The exchange's shipping total. shipping_subtotal: type: number title: shipping_subtotal description: The exchange's shipping subtotal. shipping_tax_total: type: number title: shipping_tax_total description: The exchange's shipping tax total. original_shipping_total: type: number title: original_shipping_total description: The exchange's original shipping total. original_shipping_subtotal: type: number title: original_shipping_subtotal description: The exchange's original shipping subtotal. original_shipping_tax_total: type: number title: original_shipping_tax_total description: The exchange's original shipping tax total. AdminExchangeOrderResponse: type: object description: SUMMARY x-schemaName: AdminExchangeOrderResponse required: - order - exchange properties: order: $ref: '#/components/schemas/Order' exchange: $ref: '#/components/schemas/AdminExchange' AdminExchangePreviewResponse: type: object description: SUMMARY x-schemaName: AdminExchangePreviewResponse required: - order_preview - exchange properties: order_preview: $ref: '#/components/schemas/OrderPreview' exchange: $ref: '#/components/schemas/AdminExchange' AdminExchangeRequestResponse: type: object description: SUMMARY x-schemaName: AdminExchangeRequestResponse required: - return - order_preview - exchange properties: return: $ref: '#/components/schemas/AdminReturn' order_preview: $ref: '#/components/schemas/OrderPreview' exchange: $ref: '#/components/schemas/AdminExchange' AdminExchangeResponse: type: object description: SUMMARY x-schemaName: AdminExchangeResponse required: - exchange properties: exchange: $ref: '#/components/schemas/AdminExchange' AdminExchangeReturnResponse: type: object description: SUMMARY x-schemaName: AdminExchangeReturnResponse required: - order_preview - return properties: order_preview: $ref: '#/components/schemas/OrderPreview' return: $ref: '#/components/schemas/AdminReturn' AdminExportProductRequest: type: object description: SUMMARY x-schemaName: AdminExportProductRequest AdminExportProductResponse: type: object description: SUMMARY x-schemaName: AdminExportProductResponse required: - transaction_id properties: transaction_id: type: string title: transaction_id description: The product's transaction id. AdminFile: type: object description: The upload's file. x-schemaName: AdminFile required: - id - url properties: id: type: string title: id description: The file's ID. url: type: string title: url description: The file's url. AdminFileListResponse: type: object description: SUMMARY x-schemaName: AdminFileListResponse required: - files properties: files: type: array description: The upload's files. items: $ref: '#/components/schemas/AdminFile' AdminFileResponse: type: object description: SUMMARY x-schemaName: AdminFileResponse required: - file properties: file: $ref: '#/components/schemas/AdminFile' AdminFulfillment: type: object description: The fulfillment's details. x-schemaName: AdminFulfillment required: - id - location_id - provider_id - shipping_option_id - provider - delivery_address - items - labels - packed_at - shipped_at - delivered_at - canceled_at - data - metadata - created_at - updated_at - deleted_at properties: id: type: string title: id description: The fulfillment's ID. location_id: type: string title: location_id description: The fulfillment's location id. provider_id: type: string title: provider_id description: The fulfillment's provider id. shipping_option_id: type: string title: shipping_option_id description: The fulfillment's shipping option id. provider: $ref: '#/components/schemas/AdminFulfillmentProvider' delivery_address: $ref: '#/components/schemas/AdminFulfillmentAddress' items: type: array description: The fulfillment's items. items: $ref: '#/components/schemas/AdminFulfillmentItem' labels: type: array description: The fulfillment's labels. items: $ref: '#/components/schemas/AdminFulfillmentLabel' packed_at: type: string title: packed_at description: The fulfillment's packed at. shipped_at: type: string title: shipped_at description: The fulfillment's shipped at. delivered_at: type: string title: delivered_at description: The fulfillment's delivered at. canceled_at: type: string title: canceled_at description: The fulfillment's canceled at. data: type: object description: The fulfillment's data. metadata: type: object description: The fulfillment's metadata. created_at: type: string format: date-time title: created_at description: The fulfillment's created at. updated_at: type: string format: date-time title: updated_at description: The fulfillment's updated at. deleted_at: type: string format: date-time title: deleted_at description: The fulfillment's deleted at. AdminFulfillmentAddress: type: object description: The fulfillment's delivery address. x-schemaName: AdminFulfillmentAddress required: - id - fulfillment_id - company - first_name - last_name - address_1 - address_2 - city - country_code - province - postal_code - phone - metadata - created_at - updated_at - deleted_at properties: id: type: string title: id description: The delivery address's ID. fulfillment_id: type: string title: fulfillment_id description: The delivery address's fulfillment id. company: type: string title: company description: The delivery address's company. first_name: type: string title: first_name description: The delivery address's first name. last_name: type: string title: last_name description: The delivery address's last name. address_1: type: string title: address_1 description: The delivery address's address 1. address_2: type: string title: address_2 description: The delivery address's address 2. city: type: string title: city description: The delivery address's city. country_code: type: string title: country_code description: The delivery address's country code. province: type: string title: province description: The delivery address's province. postal_code: type: string title: postal_code description: The delivery address's postal code. phone: type: string title: phone description: The delivery address's phone. metadata: type: object description: The delivery address's metadata. created_at: type: string format: date-time title: created_at description: The delivery address's created at. updated_at: type: string format: date-time title: updated_at description: The delivery address's updated at. deleted_at: type: string format: date-time title: deleted_at description: The delivery address's deleted at. AdminFulfillmentItem: type: object description: The item's items. x-schemaName: AdminFulfillmentItem required: - id - title - quantity - sku - barcode - line_item_id - inventory_item_id - fulfillment_id - created_at - updated_at - deleted_at properties: id: type: string title: id description: The item's ID. title: type: string title: title description: The item's title. quantity: type: number title: quantity description: The item's quantity. sku: type: string title: sku description: The item's sku. barcode: type: string title: barcode description: The item's barcode. line_item_id: type: string title: line_item_id description: The item's line item id. inventory_item_id: type: string title: inventory_item_id description: The item's inventory item id. fulfillment_id: type: string title: fulfillment_id description: The item's fulfillment id. created_at: type: string format: date-time title: created_at description: The item's created at. updated_at: type: string format: date-time title: updated_at description: The item's updated at. deleted_at: type: string format: date-time title: deleted_at description: The item's deleted at. AdminFulfillmentLabel: type: object description: The label's labels. x-schemaName: AdminFulfillmentLabel required: - id - tracking_number - tracking_url - label_url - fulfillment_id - created_at - updated_at - deleted_at properties: id: type: string title: id description: The label's ID. tracking_number: type: string title: tracking_number description: The label's tracking number. tracking_url: type: string title: tracking_url description: The label's tracking url. label_url: type: string title: label_url description: The label's label url. fulfillment_id: type: string title: fulfillment_id description: The label's fulfillment id. created_at: type: string format: date-time title: created_at description: The label's created at. updated_at: type: string format: date-time title: updated_at description: The label's updated at. deleted_at: type: string format: date-time title: deleted_at description: The label's deleted at. AdminFulfillmentProvider: type: object description: The fulfillment provider's fulfillment providers. x-schemaName: AdminFulfillmentProvider AdminFulfillmentProviderListResponse: type: object description: SUMMARY x-schemaName: AdminFulfillmentProviderListResponse required: - limit - offset - count - fulfillment_providers properties: limit: type: number title: limit description: The fulfillment provider's limit. offset: type: number title: offset description: The fulfillment provider's offset. count: type: number title: count description: The fulfillment provider's count. fulfillment_providers: type: array description: The fulfillment provider's fulfillment providers. items: $ref: '#/components/schemas/AdminFulfillmentProvider' AdminFulfillmentResponse: type: object description: SUMMARY x-schemaName: AdminFulfillmentResponse required: - fulfillment properties: fulfillment: $ref: '#/components/schemas/AdminFulfillment' AdminFulfillmentSet: type: object description: The fulfillment set's details. x-schemaName: AdminFulfillmentSet required: - id - name - type - location - service_zones - created_at - updated_at - deleted_at properties: id: type: string title: id description: The fulfillment set's ID. name: type: string title: name description: The fulfillment set's name. type: type: string title: type description: The fulfillment set's type. location: $ref: '#/components/schemas/AdminStockLocation' service_zones: type: array description: The fulfillment set's service zones. items: $ref: '#/components/schemas/AdminServiceZone' created_at: type: string format: date-time title: created_at description: The fulfillment set's created at. updated_at: type: string format: date-time title: updated_at description: The fulfillment set's updated at. deleted_at: type: string format: date-time title: deleted_at description: The fulfillment set's deleted at. AdminFulfillmentSetDeleteResponse: type: object description: SUMMARY x-schemaName: AdminFulfillmentSetDeleteResponse 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. default: fulfillment_set deleted: type: boolean title: deleted description: The fulfillment set's deleted. parent: type: object description: The fulfillment set's parent. AdminFulfillmentSetResponse: type: object description: SUMMARY x-schemaName: AdminFulfillmentSetResponse required: - fulfillment_set properties: fulfillment_set: $ref: '#/components/schemas/AdminFulfillmentSet' AdminGeoZone: type: object description: The geo zone's geo zones. x-schemaName: AdminGeoZone AdminGetUploadParams: type: object description: SUMMARY x-schemaName: AdminGetUploadParams properties: fields: type: string title: fields description: The upload's fields. AdminImportProductRequest: type: object description: SUMMARY x-schemaName: AdminImportProductRequest required: - file properties: file: $ref: '#/components/schemas/File' AdminImportProductResponse: type: object description: SUMMARY x-schemaName: AdminImportProductResponse required: - transaction_id - summary properties: transaction_id: type: string title: transaction_id description: The product's transaction id. summary: type: object description: The product's summary. required: - toCreate - toUpdate properties: toCreate: type: number title: toCreate description: The summary's tocreate. toUpdate: type: number title: toUpdate description: The summary's toupdate. AdminInventoryItem: type: object description: The inventory item's details. x-schemaName: AdminInventoryItem required: - id - requires_shipping properties: id: type: string title: id description: The inventory item's ID. sku: type: string title: sku description: The inventory item's sku. origin_country: type: string title: origin_country description: The inventory item's origin country. hs_code: type: string title: hs_code description: The inventory item's hs code. requires_shipping: type: boolean title: requires_shipping description: The inventory item's requires shipping. mid_code: type: string title: mid_code description: The inventory item's mid code. material: type: string title: material description: The inventory item's material. weight: type: number title: weight description: The inventory item's weight. length: type: number title: length description: The inventory item's length. height: type: number title: height description: The inventory item's height. width: type: number title: width description: The inventory item's width. title: type: string title: title description: The inventory item's title. description: type: string title: description description: The inventory item's description. thumbnail: type: string title: thumbnail description: The inventory item's thumbnail. metadata: type: object description: The inventory item's metadata. AdminInventoryItemResponse: type: object description: SUMMARY x-schemaName: AdminInventoryItemResponse required: - inventory_item properties: inventory_item: $ref: '#/components/schemas/AdminInventoryItem' AdminInvite: type: object description: The invite's details. x-schemaName: AdminInvite required: - id - email - accepted - token properties: id: type: string title: id description: The invite's ID. email: type: string title: email description: The invite's email. format: email accepted: type: boolean title: accepted description: The invite's accepted. token: type: string title: token description: The invite's token. expires_at: type: string title: expires_at description: The invite's expires at. format: date-time metadata: type: object description: The invite's metadata. created_at: type: string title: created_at description: The invite's created at. format: date-time updated_at: type: string title: updated_at description: The invite's updated at. format: date-time AdminInviteResponse: type: object description: SUMMARY x-schemaName: AdminInviteResponse required: - invite properties: invite: $ref: '#/components/schemas/AdminInvite' AdminNotification: type: object description: The notification's details. x-schemaName: AdminNotification required: - id - to - channel - template - provider_id - created_at properties: id: type: string title: id description: The notification's ID. to: type: string title: to description: The notification's to. channel: type: string title: channel description: The notification's channel. template: type: string title: template description: The notification's template. data: type: object description: The notification's data. trigger_type: type: string title: trigger_type description: The notification's trigger type. resource_id: type: string title: resource_id description: The notification's resource id. resource_type: type: string title: resource_type description: The notification's resource type. receiver_id: type: string title: receiver_id description: The notification's receiver id. original_notification_id: type: string title: original_notification_id description: The notification's original notification id. external_id: type: string title: external_id description: The notification's external id. provider_id: type: string title: provider_id description: The notification's provider id. created_at: type: string format: date-time title: created_at description: The notification's created at. AdminNotificationListResponse: type: object description: SUMMARY x-schemaName: AdminNotificationListResponse required: - limit - offset - count - notifications properties: limit: type: number title: limit description: The notification's limit. offset: type: number title: offset description: The notification's offset. count: type: number title: count description: The notification's count. notifications: type: array description: The notification's notifications. items: $ref: '#/components/schemas/AdminNotification' AdminNotificationResponse: type: object description: SUMMARY x-schemaName: AdminNotificationResponse required: - notification properties: notification: $ref: '#/components/schemas/AdminNotification' AdminOrder: type: object description: The order's details. x-schemaName: AdminOrder required: - payment_collections - id - version - region_id - customer_id - sales_channel_id - email - currency_code - items - shipping_methods - payment_status - fulfillment_status - summary - metadata - created_at - updated_at - original_item_total - original_item_subtotal - original_item_tax_total - item_total - item_subtotal - item_tax_total - original_total - original_subtotal - original_tax_total - total - subtotal - tax_total - discount_total - discount_tax_total - gift_card_total - gift_card_tax_total - shipping_total - shipping_subtotal - shipping_tax_total - original_shipping_total - original_shipping_subtotal - original_shipping_tax_total properties: payment_collections: type: array description: The order's payment collections. items: $ref: '#/components/schemas/AdminPaymentCollection' id: type: string title: id description: The order's ID. version: type: number title: version description: The order's version. region_id: type: string title: region_id description: The order's region id. customer_id: type: string title: customer_id description: The order's customer id. sales_channel_id: type: string title: sales_channel_id description: The order's sales channel id. email: type: string title: email description: The order's email. format: email currency_code: type: string title: currency_code description: The order's currency code. display_id: type: string title: display_id description: The order's display id. shipping_address: $ref: '#/components/schemas/BaseOrderAddress' billing_address: $ref: '#/components/schemas/BaseOrderAddress' items: type: array description: The order's items. items: $ref: '#/components/schemas/BaseOrderLineItem' shipping_methods: type: array description: The order's shipping methods. items: $ref: '#/components/schemas/BaseOrderShippingMethod' payment_status: type: string enum: - canceled - not_paid - awaiting - authorized - partially_authorized - captured - partially_captured - partially_refunded - refunded - requires_action fulfillments: type: array description: The order's fulfillments. items: $ref: '#/components/schemas/BaseOrderFulfillment' fulfillment_status: type: string enum: - canceled - not_fulfilled - partially_fulfilled - fulfilled - partially_shipped - shipped - partially_delivered - delivered transactions: type: array description: The order's transactions. items: $ref: '#/components/schemas/BaseOrderTransaction' summary: $ref: '#/components/schemas/BaseOrderSummary' metadata: type: object description: The order's metadata. created_at: type: string format: date-time title: created_at description: The order's created at. updated_at: type: string format: date-time title: updated_at description: The order's updated at. original_item_total: type: number title: original_item_total description: The order's original item total. original_item_subtotal: type: number title: original_item_subtotal description: The order's original item subtotal. original_item_tax_total: type: number title: original_item_tax_total description: The order's original item tax total. item_total: type: number title: item_total description: The order's item total. item_subtotal: type: number title: item_subtotal description: The order's item subtotal. item_tax_total: type: number title: item_tax_total description: The order's item tax total. original_total: type: number title: original_total description: The order's original total. original_subtotal: type: number title: original_subtotal description: The order's original subtotal. original_tax_total: type: number title: original_tax_total description: The order's original tax total. total: type: number title: total description: The order's total. subtotal: type: number title: subtotal description: The order's subtotal. tax_total: type: number title: tax_total description: The order's tax total. discount_total: type: number title: discount_total description: The order's discount total. discount_tax_total: type: number title: discount_tax_total description: The order's discount tax total. gift_card_total: type: number title: gift_card_total description: The order's gift card total. gift_card_tax_total: type: number title: gift_card_tax_total description: The order's gift card tax total. shipping_total: type: number title: shipping_total description: The order's shipping total. shipping_subtotal: type: number title: shipping_subtotal description: The order's shipping subtotal. shipping_tax_total: type: number title: shipping_tax_total description: The order's shipping tax total. original_shipping_total: type: number title: original_shipping_total description: The order's original shipping total. original_shipping_subtotal: type: number title: original_shipping_subtotal description: The order's original shipping subtotal. original_shipping_tax_total: type: number title: original_shipping_tax_total description: The order's original shipping tax total. AdminOrderEditPreviewResponse: type: object description: SUMMARY x-schemaName: AdminOrderEditPreviewResponse required: - order_preview properties: order_preview: $ref: '#/components/schemas/OrderPreview' AdminOrderEditResponse: type: object description: SUMMARY x-schemaName: AdminOrderEditResponse required: - order_change properties: order_change: $ref: '#/components/schemas/OrderChange' AdminOrderPreview: type: object description: The return's order preview. x-schemaName: AdminOrderPreview required: - return_requested_total - order_change - currency_code - id - version - region_id - customer_id - sales_channel_id - email - payment_collections - payment_status - fulfillment_status - summary - metadata - created_at - updated_at - original_item_total - original_item_subtotal - original_item_tax_total - item_total - item_subtotal - item_tax_total - original_total - original_subtotal - original_tax_total - total - subtotal - tax_total - discount_total - discount_tax_total - gift_card_total - gift_card_tax_total - shipping_total - shipping_subtotal - shipping_tax_total - original_shipping_total - original_shipping_subtotal - original_shipping_tax_total properties: return_requested_total: type: number title: return_requested_total description: The order preview's return requested total. order_change: $ref: '#/components/schemas/BaseOrderChange' items: type: array description: The order preview's items. items: allOf: - type: object description: The item's items. x-schemaName: BaseOrderLineItem required: - id - title - subtitle - thumbnail - variant_id - product_id - product_title - product_description - product_subtitle - product_type - product_collection - product_handle - variant_sku - variant_barcode - variant_title - variant_option_values - requires_shipping - is_discountable - is_tax_inclusive - unit_price - quantity - detail - created_at - updated_at - metadata - original_total - original_subtotal - original_tax_total - item_total - item_subtotal - item_tax_total - total - subtotal - tax_total - discount_total - discount_tax_total - refundable_total - refundable_total_per_unit properties: id: type: string title: id description: The item's ID. title: type: string title: title description: The item's title. subtitle: type: string title: subtitle description: The item's subtitle. thumbnail: type: string title: thumbnail description: The item's thumbnail. variant: $ref: '#/components/schemas/BaseProductVariant' variant_id: type: string title: variant_id description: The item's variant id. product: $ref: '#/components/schemas/BaseProduct' product_id: type: string title: product_id description: The item's product id. product_title: type: string title: product_title description: The item's product title. product_description: type: string title: product_description description: The item's product description. product_subtitle: type: string title: product_subtitle description: The item's product subtitle. product_type: type: string title: product_type description: The item's product type. product_collection: type: string title: product_collection description: The item's product collection. product_handle: type: string title: product_handle description: The item's product handle. variant_sku: type: string title: variant_sku description: The item's variant sku. variant_barcode: type: string title: variant_barcode description: The item's variant barcode. variant_title: type: string title: variant_title description: The item's variant title. variant_option_values: type: object description: The item's variant option values. requires_shipping: type: boolean title: requires_shipping description: The item's requires shipping. is_discountable: type: boolean title: is_discountable description: The item's is discountable. is_tax_inclusive: type: boolean title: is_tax_inclusive description: The item's is tax inclusive. compare_at_unit_price: type: number title: compare_at_unit_price description: The item's compare at unit price. unit_price: type: number title: unit_price description: The item's unit price. quantity: type: number title: quantity description: The item's quantity. tax_lines: type: array description: The item's tax lines. items: $ref: '#/components/schemas/BaseOrderLineItemTaxLine' adjustments: type: array description: The item's adjustments. items: $ref: '#/components/schemas/BaseOrderLineItemAdjustment' detail: $ref: '#/components/schemas/BaseOrderItemDetail' created_at: type: string title: created_at description: The item's created at. format: date-time updated_at: type: string title: updated_at description: The item's updated at. format: date-time metadata: type: object description: The item's metadata. original_total: type: number title: original_total description: The item's original total. original_subtotal: type: number title: original_subtotal description: The item's original subtotal. original_tax_total: type: number title: original_tax_total description: The item's original tax total. item_total: type: number title: item_total description: The item's item total. item_subtotal: type: number title: item_subtotal description: The item's item subtotal. item_tax_total: type: number title: item_tax_total description: The item's item tax total. total: type: number title: total description: The item's total. subtotal: type: number title: subtotal description: The item's subtotal. tax_total: type: number title: tax_total description: The item's tax total. discount_total: type: number title: discount_total description: The item's discount total. discount_tax_total: type: number title: discount_tax_total description: The item's discount tax total. refundable_total: type: number title: refundable_total description: The item's refundable total. refundable_total_per_unit: type: number title: refundable_total_per_unit description: The item's refundable total per unit. - type: object description: The item's items. properties: actions: type: array description: The item's actions. items: type: object description: The action's actions. x-schemaName: BaseOrderChangeAction shipping_methods: type: array description: The order preview's shipping methods. items: allOf: - type: object description: The shipping method's shipping methods. x-schemaName: BaseOrderShippingMethod required: - id - order_id - name - amount - is_tax_inclusive - shipping_option_id - data - metadata - original_total - original_subtotal - original_tax_total - total - subtotal - tax_total - discount_total - discount_tax_total - created_at - updated_at properties: id: type: string title: id description: The shipping method's ID. order_id: type: string title: order_id description: The shipping method's order id. name: type: string title: name description: The shipping method's name. description: type: string title: description description: The shipping method's description. amount: type: number title: amount description: The shipping method's amount. is_tax_inclusive: type: boolean title: is_tax_inclusive description: The shipping method's is tax inclusive. shipping_option_id: type: string title: shipping_option_id description: The shipping method's shipping option id. data: type: object description: The shipping method's data. metadata: type: object description: The shipping method's metadata. tax_lines: type: array description: The shipping method's tax lines. items: $ref: '#/components/schemas/BaseOrderShippingMethodTaxLine' adjustments: type: array description: The shipping method's adjustments. items: $ref: '#/components/schemas/BaseOrderShippingMethodAdjustment' original_total: oneOf: - type: string title: original_total description: The shipping method's original total. - type: number title: original_total description: The shipping method's original total. - type: string title: original_total description: The shipping method's original total. - $ref: '#/components/schemas/IBigNumber' original_subtotal: oneOf: - type: string title: original_subtotal description: The shipping method's original subtotal. - type: number title: original_subtotal description: The shipping method's original subtotal. - type: string title: original_subtotal description: The shipping method's original subtotal. - $ref: '#/components/schemas/IBigNumber' original_tax_total: oneOf: - type: string title: original_tax_total description: The shipping method's original tax total. - type: number title: original_tax_total description: The shipping method's original tax total. - type: string title: original_tax_total description: The shipping method's original tax total. - $ref: '#/components/schemas/IBigNumber' total: oneOf: - type: string title: total description: The shipping method's total. - type: number title: total description: The shipping method's total. - type: string title: total description: The shipping method's total. - $ref: '#/components/schemas/IBigNumber' subtotal: oneOf: - type: string title: subtotal description: The shipping method's subtotal. - type: number title: subtotal description: The shipping method's subtotal. - type: string title: subtotal description: The shipping method's subtotal. - $ref: '#/components/schemas/IBigNumber' tax_total: oneOf: - type: string title: tax_total description: The shipping method's tax total. - type: number title: tax_total description: The shipping method's tax total. - type: string title: tax_total description: The shipping method's tax total. - $ref: '#/components/schemas/IBigNumber' discount_total: oneOf: - type: string title: discount_total description: The shipping method's discount total. - type: number title: discount_total description: The shipping method's discount total. - type: string title: discount_total description: The shipping method's discount total. - $ref: '#/components/schemas/IBigNumber' discount_tax_total: oneOf: - type: string title: discount_tax_total description: The shipping method's discount tax total. - type: number title: discount_tax_total description: The shipping method's discount tax total. - type: string title: discount_tax_total description: The shipping method's discount tax total. - $ref: '#/components/schemas/IBigNumber' created_at: type: string format: date-time title: created_at description: The shipping method's created at. updated_at: type: string format: date-time title: updated_at description: The shipping method's updated at. - type: object description: The shipping method's shipping methods. properties: actions: type: array description: The shipping method's actions. items: type: object description: The action's actions. x-schemaName: BaseOrderChangeAction currency_code: type: string title: currency_code description: The order preview's currency code. id: type: string title: id description: The order preview's ID. version: type: number title: version description: The order preview's version. region_id: type: string title: region_id description: The order preview's region id. customer_id: type: string title: customer_id description: The order preview's customer id. sales_channel_id: type: string title: sales_channel_id description: The order preview's sales channel id. email: type: string title: email description: The order preview's email. format: email display_id: type: string title: display_id description: The order preview's display id. shipping_address: $ref: '#/components/schemas/BaseOrderAddress' billing_address: $ref: '#/components/schemas/BaseOrderAddress' payment_collections: type: array description: The order preview's payment collections. items: $ref: '#/components/schemas/AdminPaymentCollection' payment_status: type: string enum: - canceled - not_paid - awaiting - authorized - partially_authorized - captured - partially_captured - partially_refunded - refunded - requires_action fulfillments: type: array description: The order preview's fulfillments. items: $ref: '#/components/schemas/BaseOrderFulfillment' fulfillment_status: type: string enum: - canceled - not_fulfilled - partially_fulfilled - fulfilled - partially_shipped - shipped - partially_delivered - delivered transactions: type: array description: The order preview's transactions. items: $ref: '#/components/schemas/BaseOrderTransaction' summary: $ref: '#/components/schemas/BaseOrderSummary' metadata: type: object description: The order preview's metadata. created_at: type: string format: date-time title: created_at description: The order preview's created at. updated_at: type: string format: date-time title: updated_at description: The order preview's updated at. original_item_total: type: number title: original_item_total description: The order preview's original item total. original_item_subtotal: type: number title: original_item_subtotal description: The order preview's original item subtotal. original_item_tax_total: type: number title: original_item_tax_total description: The order preview's original item tax total. item_total: type: number title: item_total description: The order preview's item total. item_subtotal: type: number title: item_subtotal description: The order preview's item subtotal. item_tax_total: type: number title: item_tax_total description: The order preview's item tax total. original_total: type: number title: original_total description: The order preview's original total. original_subtotal: type: number title: original_subtotal description: The order preview's original subtotal. original_tax_total: type: number title: original_tax_total description: The order preview's original tax total. total: type: number title: total description: The order preview's total. subtotal: type: number title: subtotal description: The order preview's subtotal. tax_total: type: number title: tax_total description: The order preview's tax total. discount_total: type: number title: discount_total description: The order preview's discount total. discount_tax_total: type: number title: discount_tax_total description: The order preview's discount tax total. gift_card_total: type: number title: gift_card_total description: The order preview's gift card total. gift_card_tax_total: type: number title: gift_card_tax_total description: The order preview's gift card tax total. shipping_total: type: number title: shipping_total description: The order preview's shipping total. shipping_subtotal: type: number title: shipping_subtotal description: The order preview's shipping subtotal. shipping_tax_total: type: number title: shipping_tax_total description: The order preview's shipping tax total. original_shipping_total: type: number title: original_shipping_total description: The order preview's original shipping total. original_shipping_subtotal: type: number title: original_shipping_subtotal description: The order preview's original shipping subtotal. original_shipping_tax_total: type: number title: original_shipping_tax_total description: The order preview's original shipping tax total. AdminOrderPreviewResponse: type: object description: SUMMARY x-schemaName: AdminOrderPreviewResponse required: - order properties: order: $ref: '#/components/schemas/AdminOrderPreview' AdminOrderResponse: type: object description: SUMMARY x-schemaName: AdminOrderResponse required: - order properties: order: $ref: '#/components/schemas/AdminOrder' AdminOrderReturnResponse: type: object description: SUMMARY x-schemaName: AdminOrderReturnResponse required: - order - return properties: order: $ref: '#/components/schemas/Order' return: $ref: '#/components/schemas/AdminReturn' AdminPayment: type: object description: The payment's details. x-schemaName: AdminPayment required: - id - amount - currency_code - provider_id properties: id: type: string title: id description: The payment's ID. amount: oneOf: - type: string title: amount description: The payment's amount. - type: number title: amount description: The payment's amount. - type: string title: amount description: The payment's amount. - $ref: '#/components/schemas/IBigNumber' authorized_amount: oneOf: - type: string title: authorized_amount description: The payment's authorized amount. - type: number title: authorized_amount description: The payment's authorized amount. - type: string title: authorized_amount description: The payment's authorized amount. - $ref: '#/components/schemas/IBigNumber' currency_code: type: string title: currency_code description: The payment's currency code. provider_id: type: string title: provider_id description: The payment's provider id. cart_id: type: string title: cart_id description: The payment's cart id. order_id: type: string title: order_id description: The payment's order id. order_edit_id: type: string title: order_edit_id description: The payment's order edit id. customer_id: type: string title: customer_id description: The payment's customer id. data: type: object description: The payment's data. created_at: type: string format: date-time title: created_at description: The payment's created at. updated_at: type: string format: date-time title: updated_at description: The payment's updated at. captured_at: oneOf: - type: string title: captured_at description: The payment's captured at. - type: string title: captured_at description: The payment's captured at. format: date-time canceled_at: oneOf: - type: string title: canceled_at description: The payment's canceled at. - type: string title: canceled_at description: The payment's canceled at. format: date-time captured_amount: oneOf: - type: string title: captured_amount description: The payment's captured amount. - type: number title: captured_amount description: The payment's captured amount. - type: string title: captured_amount description: The payment's captured amount. - $ref: '#/components/schemas/IBigNumber' refunded_amount: oneOf: - type: string title: refunded_amount description: The payment's refunded amount. - type: number title: refunded_amount description: The payment's refunded amount. - type: string title: refunded_amount description: The payment's refunded amount. - $ref: '#/components/schemas/IBigNumber' captures: type: array description: The payment's captures. items: $ref: '#/components/schemas/BaseCapture' refunds: type: array description: The payment's refunds. items: $ref: '#/components/schemas/BaseRefund' payment_collection: $ref: '#/components/schemas/BasePaymentCollection' payment_session: $ref: '#/components/schemas/BasePaymentSession' AdminPaymentCollection: type: object description: The payment collection's payment collections. x-schemaName: AdminPaymentCollection required: - id - currency_code - region_id - amount - status - payment_providers properties: id: type: string title: id description: The payment collection's ID. currency_code: type: string title: currency_code description: The payment collection's currency code. region_id: type: string title: region_id description: The payment collection's region id. amount: oneOf: - type: string title: amount description: The payment collection's amount. - type: number title: amount description: The payment collection's amount. - type: string title: amount description: The payment collection's amount. - $ref: '#/components/schemas/IBigNumber' authorized_amount: oneOf: - type: string title: authorized_amount description: The payment collection's authorized amount. - type: number title: authorized_amount description: The payment collection's authorized amount. - type: string title: authorized_amount description: The payment collection's authorized amount. - $ref: '#/components/schemas/IBigNumber' captured_amount: oneOf: - type: string title: captured_amount description: The payment collection's captured amount. - type: number title: captured_amount description: The payment collection's captured amount. - type: string title: captured_amount description: The payment collection's captured amount. - $ref: '#/components/schemas/IBigNumber' refunded_amount: oneOf: - type: string title: refunded_amount description: The payment collection's refunded amount. - type: number title: refunded_amount description: The payment collection's refunded amount. - type: string title: refunded_amount description: The payment collection's refunded amount. - $ref: '#/components/schemas/IBigNumber' completed_at: oneOf: - type: string title: completed_at description: The payment collection's completed at. - type: string title: completed_at description: The payment collection's completed at. format: date-time created_at: type: string format: date-time title: created_at description: The payment collection's created at. updated_at: type: string format: date-time title: updated_at description: The payment collection's updated at. metadata: type: object description: The payment collection's metadata. status: type: string enum: - canceled - not_paid - awaiting - authorized - partially_authorized payment_providers: type: array description: The payment collection's payment providers. items: $ref: '#/components/schemas/BasePaymentProvider' payment_sessions: type: array description: The payment collection's payment sessions. items: $ref: '#/components/schemas/BasePaymentSession' payments: type: array description: The payment collection's payments. items: $ref: '#/components/schemas/BasePayment' AdminPaymentCollectionResponse: type: object description: SUMMARY x-schemaName: AdminPaymentCollectionResponse required: - payment_collection properties: payment_collection: $ref: '#/components/schemas/AdminPaymentCollection' AdminPaymentProvider: type: object description: The payment provider's payment providers. x-schemaName: AdminPaymentProvider AdminPaymentResponse: type: object description: SUMMARY x-schemaName: AdminPaymentResponse required: - payment properties: payment: $ref: '#/components/schemas/AdminPayment' AdminPostCancelClaimReqSchema: type: object description: SUMMARY x-schemaName: AdminPostCancelClaimReqSchema properties: no_notification: type: boolean title: no_notification description: The claim's no notification. AdminPostCancelExchangeReqSchema: type: object description: SUMMARY x-schemaName: AdminPostCancelExchangeReqSchema properties: no_notification: type: boolean title: no_notification description: The exchange's no notification. AdminPostCancelReturnReqSchema: type: object description: SUMMARY x-schemaName: AdminPostCancelReturnReqSchema properties: no_notification: type: boolean title: no_notification description: The return's no notification. AdminPostClaimItemsReqSchema: type: object description: SUMMARY x-schemaName: AdminPostClaimItemsReqSchema properties: items: type: array description: The claim's items. items: type: object description: The item's items. required: - id - quantity properties: id: type: string title: id description: The item's ID. quantity: type: number title: quantity description: The item's quantity. reason: type: string enum: - missing_item - wrong_item - production_failure - other description: type: string title: description description: The item's description. internal_note: type: string title: internal_note description: The item's internal note. AdminPostClaimsAddItemsReqSchema: type: object description: SUMMARY x-schemaName: AdminPostClaimsAddItemsReqSchema properties: items: type: array description: The claim's items. items: type: object description: The item's items. required: - variant_id - quantity properties: variant_id: type: string title: variant_id description: The item's variant id. quantity: type: number title: quantity description: The item's quantity. unit_price: type: number title: unit_price description: The item's unit price. internal_note: type: string title: internal_note description: The item's internal note. metadata: type: object description: The item's metadata. AdminPostClaimsItemsActionReqSchema: type: object description: SUMMARY x-schemaName: AdminPostClaimsItemsActionReqSchema required: - reason_id properties: quantity: type: number title: quantity description: The claim's quantity. reason_id: type: string title: reason_id description: The claim's reason id. internal_note: type: string title: internal_note description: The claim's internal note. AdminPostClaimsShippingActionReqSchema: type: object description: SUMMARY x-schemaName: AdminPostClaimsShippingActionReqSchema properties: custom_price: type: number title: custom_price description: The claim's custom price. internal_note: type: string title: internal_note description: The claim's internal note. metadata: type: object description: The claim's metadata. AdminPostClaimsShippingReqSchema: type: object description: SUMMARY x-schemaName: AdminPostClaimsShippingReqSchema required: - shipping_option_id properties: shipping_option_id: type: string title: shipping_option_id description: The claim's shipping option id. custom_price: type: number title: custom_price description: The claim's custom price. description: type: string title: description description: The claim's description. internal_note: type: string title: internal_note description: The claim's internal note. metadata: type: object description: The claim's metadata. AdminPostExchangesAddItemsReqSchema: type: object description: SUMMARY x-schemaName: AdminPostExchangesAddItemsReqSchema properties: items: type: array description: The exchange's items. items: type: object description: The item's items. required: - variant_id - quantity properties: variant_id: type: string title: variant_id description: The item's variant id. quantity: type: number title: quantity description: The item's quantity. unit_price: type: number title: unit_price description: The item's unit price. internal_note: type: string title: internal_note description: The item's internal note. allow_backorder: type: boolean title: allow_backorder description: The item's allow backorder. metadata: type: object description: The item's metadata. AdminPostExchangesItemsActionReqSchema: type: object description: SUMMARY x-schemaName: AdminPostExchangesItemsActionReqSchema properties: quantity: type: number title: quantity description: The exchange's quantity. internal_note: type: string title: internal_note description: The exchange's internal note. AdminPostExchangesRequestItemsReturnActionReqSchema: type: object description: SUMMARY x-schemaName: AdminPostExchangesRequestItemsReturnActionReqSchema properties: quantity: type: number title: quantity description: The exchange's quantity. internal_note: type: string title: internal_note description: The exchange's internal note. reason_id: type: string title: reason_id description: The exchange's reason id. metadata: type: object description: The exchange's metadata. AdminPostExchangesReturnRequestItemsReqSchema: type: object description: SUMMARY x-schemaName: AdminPostExchangesReturnRequestItemsReqSchema properties: items: type: array description: The exchange's items. items: type: object description: The item's items. required: - id - quantity properties: id: type: string title: id description: The item's ID. quantity: type: number title: quantity description: The item's quantity. description: type: string title: description description: The item's description. internal_note: type: string title: internal_note description: The item's internal note. reason_id: type: string title: reason_id description: The item's reason id. metadata: type: object description: The item's metadata. AdminPostExchangesShippingActionReqSchema: type: object description: SUMMARY x-schemaName: AdminPostExchangesShippingActionReqSchema properties: custom_price: type: number title: custom_price description: The exchange's custom price. internal_note: type: string title: internal_note description: The exchange's internal note. metadata: type: object description: The exchange's metadata. AdminPostExchangesShippingReqSchema: type: object description: SUMMARY x-schemaName: AdminPostExchangesShippingReqSchema required: - shipping_option_id properties: shipping_option_id: type: string title: shipping_option_id description: The exchange's shipping option id. custom_price: type: number title: custom_price description: The exchange's custom price. description: type: string title: description description: The exchange's description. internal_note: type: string title: internal_note description: The exchange's internal note. metadata: type: object description: The exchange's metadata. AdminPostOrderClaimsReqSchema: type: object description: SUMMARY x-schemaName: AdminPostOrderClaimsReqSchema required: - type - order_id - reason_id - metadata properties: type: type: string enum: - refund - replace order_id: type: string title: order_id description: The claim's order id. description: type: string title: description description: The claim's description. internal_note: type: string title: internal_note description: The claim's internal note. reason_id: type: string title: reason_id description: The claim's reason id. metadata: type: object description: The claim's metadata. AdminPostOrderEditsAddItemsReqSchema: type: object description: SUMMARY x-schemaName: AdminPostOrderEditsAddItemsReqSchema properties: items: type: array description: The order edit's items. items: type: object description: The item's items. required: - variant_id - quantity properties: variant_id: type: string title: variant_id description: The item's variant id. quantity: type: number title: quantity description: The item's quantity. unit_price: type: number title: unit_price description: The item's unit price. internal_note: type: string title: internal_note description: The item's internal note. allow_backorder: type: boolean title: allow_backorder description: The item's allow backorder. metadata: type: object description: The item's metadata. AdminPostOrderEditsItemsActionReqSchema: type: object description: SUMMARY x-schemaName: AdminPostOrderEditsItemsActionReqSchema 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. AdminPostOrderEditsReqSchema: type: object description: SUMMARY x-schemaName: AdminPostOrderEditsReqSchema required: - order_id - metadata properties: order_id: type: string title: order_id description: The order edit's order id. description: type: string title: description description: The order edit's description. internal_note: type: string title: internal_note description: The order edit's internal note. metadata: type: object description: The order edit's metadata. AdminPostOrderEditsShippingActionReqSchema: type: object description: SUMMARY x-schemaName: AdminPostOrderEditsShippingActionReqSchema properties: custom_price: type: number title: custom_price description: The order edit's custom price. internal_note: type: string title: internal_note description: The order edit's internal note. metadata: type: object description: The order edit's metadata. AdminPostOrderEditsShippingReqSchema: type: object description: SUMMARY x-schemaName: AdminPostOrderEditsShippingReqSchema required: - shipping_option_id properties: shipping_option_id: type: string title: shipping_option_id description: The order edit's shipping option id. custom_price: type: number title: custom_price description: The order edit's custom price. description: type: string title: description description: The order edit's description. internal_note: type: string title: internal_note description: The order edit's internal note. metadata: type: object description: The order edit's metadata. 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. AdminPostOrderExchangesReqSchema: type: object description: SUMMARY x-schemaName: AdminPostOrderExchangesReqSchema required: - order_id - metadata properties: order_id: type: string title: order_id description: The exchange's order id. description: type: string title: description description: The exchange's description. internal_note: type: string title: internal_note description: The exchange's internal note. metadata: type: object description: The exchange's metadata. AdminPostReceiveReturnsReqSchema: type: object description: SUMMARY x-schemaName: AdminPostReceiveReturnsReqSchema required: - metadata properties: internal_note: type: string title: internal_note description: The return's internal note. description: type: string title: description description: The return's description. metadata: type: object description: The return's metadata. AdminPostReturnsConfirmRequestReqSchema: type: object description: SUMMARY x-schemaName: AdminPostReturnsConfirmRequestReqSchema properties: no_notification: type: boolean title: no_notification description: The return's no notification. AdminPostReturnsDismissItemsActionReqSchema: type: object description: SUMMARY x-schemaName: AdminPostReturnsDismissItemsActionReqSchema properties: quantity: type: number title: quantity description: The return's quantity. internal_note: type: string title: internal_note description: The return's internal note. AdminPostReturnsReceiveItemsActionReqSchema: type: object description: SUMMARY x-schemaName: AdminPostReturnsReceiveItemsActionReqSchema properties: quantity: type: number title: quantity description: The return's quantity. internal_note: type: string title: internal_note description: The return's internal note. AdminPostReturnsReceiveItemsReqSchema: type: object description: SUMMARY x-schemaName: AdminPostReturnsReceiveItemsReqSchema properties: items: type: array description: The return's items. items: type: object description: The item's items. required: - id - quantity properties: id: type: string title: id description: The item's ID. quantity: type: number title: quantity description: The item's quantity. description: type: string title: description description: The item's description. internal_note: type: string title: internal_note description: The item's internal note. AdminPostReturnsReqSchema: type: object description: SUMMARY x-schemaName: AdminPostReturnsReqSchema required: - order_id - metadata properties: order_id: type: string title: order_id description: The return's order id. location_id: type: string title: location_id description: The return's location id. description: type: string title: description description: The return's description. internal_note: type: string title: internal_note description: The return's internal note. no_notification: type: boolean title: no_notification description: The return's no notification. metadata: type: object description: The return's metadata. AdminPostReturnsRequestItemsActionReqSchema: type: object description: SUMMARY x-schemaName: AdminPostReturnsRequestItemsActionReqSchema properties: quantity: type: number title: quantity description: The claim's quantity. internal_note: type: string title: internal_note description: The claim's internal note. reason_id: type: string title: reason_id description: The claim's reason id. metadata: type: object description: The claim's metadata. AdminPostReturnsRequestItemsReqSchema: type: object description: SUMMARY x-schemaName: AdminPostReturnsRequestItemsReqSchema properties: items: type: array description: The claim's items. items: type: object description: The item's items. required: - id - quantity properties: id: type: string title: id description: The item's ID. quantity: type: number title: quantity description: The item's quantity. description: type: string title: description description: The item's description. internal_note: type: string title: internal_note description: The item's internal note. reason_id: type: string title: reason_id description: The item's reason id. metadata: type: object description: The item's metadata. AdminPostReturnsReturnReqSchema: type: object description: SUMMARY x-schemaName: AdminPostReturnsReturnReqSchema required: - metadata properties: location_id: type: string title: location_id description: The return's location id. no_notification: type: boolean title: no_notification description: The return's no notification. metadata: type: object description: The return's metadata. AdminPostReturnsShippingActionReqSchema: type: object description: SUMMARY x-schemaName: AdminPostReturnsShippingActionReqSchema properties: custom_price: type: number title: custom_price description: The return's custom price. internal_note: type: string title: internal_note description: The return's internal note. metadata: type: object description: The return's metadata. AdminPostReturnsShippingReqSchema: type: object description: SUMMARY x-schemaName: AdminPostReturnsShippingReqSchema required: - shipping_option_id properties: shipping_option_id: type: string title: shipping_option_id description: The exchange's shipping option id. custom_price: type: number title: custom_price description: The exchange's custom price. description: type: string title: description description: The exchange's description. internal_note: type: string title: internal_note description: The exchange's internal note. metadata: type: object description: The exchange's metadata. AdminPrice: type: object description: The price's prices. x-schemaName: AdminPrice required: - id - title - currency_code - amount - raw_amount - min_quantity - max_quantity - price_set_id - created_at - updated_at - deleted_at properties: id: type: string title: id description: The price's ID. title: type: string title: title description: The price's title. currency_code: type: string title: currency_code description: The price's currency code. amount: type: number title: amount description: The price's amount. raw_amount: type: object description: The price's raw amount. min_quantity: type: number title: min_quantity description: The price's min quantity. max_quantity: type: number title: max_quantity description: The price's max quantity. price_set_id: type: string title: price_set_id description: The price's price set id. created_at: type: string format: date-time title: created_at description: The price's created at. updated_at: type: string format: date-time title: updated_at description: The price's updated at. deleted_at: type: string format: date-time title: deleted_at description: The price's deleted at. AdminPriceList: type: object description: The price list's details. x-schemaName: AdminPriceList required: - id - title - description - rules - starts_at - ends_at - status - type - prices - created_at - updated_at - deleted_at properties: id: type: string title: id description: The price list's ID. title: type: string title: title description: The price list's title. description: type: string title: description description: The price list's description. rules: type: object description: The price list's rules. starts_at: type: string title: starts_at description: The price list's starts at. ends_at: type: string title: ends_at description: The price list's ends at. status: type: string enum: - draft - active type: type: string enum: - sale - override prices: type: array description: The price list's prices. items: $ref: '#/components/schemas/AdminPriceListPrice' created_at: type: string format: date-time title: created_at description: The price list's created at. updated_at: type: string format: date-time title: updated_at description: The price list's updated at. deleted_at: type: string format: date-time title: deleted_at description: The price list's deleted at. AdminPriceListBatchResponse: type: object description: SUMMARY x-schemaName: AdminPriceListBatchResponse required: - created - updated - deleted properties: created: type: array description: The price list's created. items: $ref: '#/components/schemas/AdminPrice' updated: type: array description: The price list's updated. items: $ref: '#/components/schemas/AdminPrice' deleted: type: object description: The price list's deleted. required: - ids - object - deleted properties: ids: type: array description: The deleted's ids. items: type: string title: ids description: The id's ids. object: type: string title: object description: The deleted's object. deleted: type: boolean title: deleted description: The deleted's details. AdminPriceListDeleteResponse: type: object description: SUMMARY x-schemaName: AdminPriceListDeleteResponse required: - id - object - deleted properties: id: type: string title: id description: The price list's ID. object: type: string title: object description: The price list's object. default: price_list deleted: type: boolean title: deleted description: The price list's deleted. parent: type: object description: The price list's parent. AdminPriceListListResponse: type: object description: SUMMARY x-schemaName: AdminPriceListListResponse required: - limit - offset - count - price_lists properties: limit: type: number title: limit description: The price list's limit. offset: type: number title: offset description: The price list's offset. count: type: number title: count description: The price list's count. price_lists: type: array description: The price list's price lists. items: $ref: '#/components/schemas/AdminPriceList' AdminPriceListPrice: type: object description: The price's prices. x-schemaName: AdminPriceListPrice required: - variant_id - rules - id - title - currency_code - amount - raw_amount - min_quantity - max_quantity - price_set_id - created_at - updated_at - deleted_at properties: variant_id: type: string title: variant_id description: The price's variant id. rules: type: object description: The price's rules. id: type: string title: id description: The price's ID. title: type: string title: title description: The price's title. currency_code: type: string title: currency_code description: The price's currency code. amount: type: number title: amount description: The price's amount. raw_amount: type: object description: The price's raw amount. min_quantity: type: number title: min_quantity description: The price's min quantity. max_quantity: type: number title: max_quantity description: The price's max quantity. price_set_id: type: string title: price_set_id description: The price's price set id. created_at: type: string format: date-time title: created_at description: The price's created at. updated_at: type: string format: date-time title: updated_at description: The price's updated at. deleted_at: type: string format: date-time title: deleted_at description: The price's deleted at. AdminPriceListResponse: type: object description: SUMMARY x-schemaName: AdminPriceListResponse required: - price_list properties: price_list: $ref: '#/components/schemas/AdminPriceList' AdminPricePreference: type: object description: The price preference's details. x-schemaName: AdminPricePreference required: - id - attribute - value - is_tax_inclusive - created_at - updated_at - deleted_at properties: id: type: string title: id description: The price preference's ID. attribute: type: string title: attribute description: The price preference's attribute. value: type: string title: value description: The price preference's value. is_tax_inclusive: type: boolean title: is_tax_inclusive description: The price preference's is tax inclusive. created_at: type: string format: date-time title: created_at description: The price preference's created at. updated_at: type: string format: date-time title: updated_at description: The price preference's updated at. deleted_at: type: string format: date-time title: deleted_at description: The price preference's deleted at. AdminPricePreferenceDeleteResponse: type: object description: SUMMARY x-schemaName: AdminPricePreferenceDeleteResponse required: - id - object - deleted properties: id: type: string title: id description: The price preference's ID. object: type: string title: object description: The price preference's object. default: price_preference deleted: type: boolean title: deleted description: The price preference's deleted. parent: type: object description: The price preference's parent. AdminPricePreferenceListResponse: type: object description: SUMMARY x-schemaName: AdminPricePreferenceListResponse required: - limit - offset - count - price_preferences properties: limit: type: number title: limit description: The price preference's limit. offset: type: number title: offset description: The price preference's offset. count: type: number title: count description: The price preference's count. price_preferences: type: array description: The price preference's price preferences. items: $ref: '#/components/schemas/AdminPricePreference' AdminPricePreferenceResponse: type: object description: SUMMARY x-schemaName: AdminPricePreferenceResponse required: - price_preference properties: price_preference: $ref: '#/components/schemas/AdminPricePreference' AdminProduct: type: object description: The product's parent. x-schemaName: AdminProduct required: - type - title - status - length - options - description - id - created_at - updated_at - handle - subtitle - is_giftcard - thumbnail - width - weight - height - origin_country - hs_code - mid_code - material - collection_id - type_id - images - discountable - external_id - deleted_at properties: collection: $ref: '#/components/schemas/AdminCollection' categories: type: array description: The parent's categories. items: $ref: '#/components/schemas/AdminProductCategory' sales_channels: type: array description: The parent's sales channels. items: $ref: '#/components/schemas/AdminSalesChannel' variants: type: array description: The parent's variants. items: $ref: '#/components/schemas/AdminProductVariant' type: type: object tags: type: array description: The parent's tags. items: $ref: '#/components/schemas/AdminProductTag' title: type: string title: title description: The parent's title. status: type: string enum: - draft - proposed - published - rejected length: type: number title: length description: The parent's length. options: type: array description: The parent's options. items: $ref: '#/components/schemas/BaseProductOption' description: type: string title: description description: The parent's description. id: type: string title: id description: The parent's ID. metadata: type: object description: The parent's metadata. created_at: type: string format: date-time title: created_at description: The parent's created at. updated_at: type: string format: date-time title: updated_at description: The parent's updated at. handle: type: string title: handle description: The parent's handle. subtitle: type: string title: subtitle description: The parent's subtitle. is_giftcard: type: boolean title: is_giftcard description: The parent's is giftcard. thumbnail: type: string title: thumbnail description: The parent's thumbnail. width: type: number title: width description: The parent's width. weight: type: number title: weight description: The parent's weight. height: type: number title: height description: The parent's height. origin_country: type: string title: origin_country description: The parent's origin country. hs_code: type: string title: hs_code description: The parent's hs code. mid_code: type: string title: mid_code description: The parent's mid code. material: type: string title: material description: The parent's material. collection_id: type: string title: collection_id description: The parent's collection id. type_id: type: string title: type_id description: The parent's type id. images: type: array description: The parent's images. items: $ref: '#/components/schemas/BaseProductImage' discountable: type: boolean title: discountable description: The parent's discountable. external_id: type: string title: external_id description: The parent's external id. deleted_at: type: string format: date-time title: deleted_at description: The parent's deleted at. AdminProductCategory: type: object description: The category's categories. x-schemaName: AdminProductCategory required: - category_children - parent_category - name - description - id - created_at - updated_at - handle - deleted_at - is_active - is_internal - rank - parent_category_id properties: category_children: type: array description: The category's category children. items: type: object parent_category: type: object products: type: array description: The category's products. items: type: object name: type: string title: name description: The category's name. description: type: string title: description description: The category's description. id: type: string title: id description: The category's ID. created_at: type: string format: date-time title: created_at description: The category's created at. updated_at: type: string format: date-time title: updated_at description: The category's updated at. handle: type: string title: handle description: The category's handle. deleted_at: type: string format: date-time title: deleted_at description: The category's deleted at. is_active: type: boolean title: is_active description: The category's is active. is_internal: type: boolean title: is_internal description: The category's is internal. rank: type: number title: rank description: The category's rank. parent_category_id: type: string title: parent_category_id description: The category's parent category id. AdminProductCategoryDeleteResponse: type: object description: SUMMARY x-schemaName: AdminProductCategoryDeleteResponse required: - id - object - deleted properties: id: type: string title: id description: The product category's ID. object: type: string title: object description: The product category's object. default: product_category deleted: type: boolean title: deleted description: The product category's deleted. parent: type: object description: The product category's parent. AdminProductCategoryListResponse: type: object description: SUMMARY x-schemaName: AdminProductCategoryListResponse required: - limit - offset - count - product_categories properties: limit: type: number title: limit description: The product category's limit. offset: type: number title: offset description: The product category's offset. count: type: number title: count description: The product category's count. product_categories: type: array description: The product category's product categories. items: $ref: '#/components/schemas/AdminProductCategory' AdminProductCategoryResponse: type: object description: SUMMARY x-schemaName: AdminProductCategoryResponse required: - product_category properties: product_category: $ref: '#/components/schemas/AdminProductCategory' AdminProductDeleteResponse: type: object description: SUMMARY x-schemaName: AdminProductDeleteResponse required: - id - object - deleted properties: id: type: string title: id description: The product's ID. object: type: string title: object description: The product's object. default: product deleted: type: boolean title: deleted description: The product's deleted. parent: type: object description: The product's parent. AdminProductOption: type: object description: The product's product option. x-schemaName: AdminProductOption required: - id - title properties: id: type: string title: id description: The product option's ID. title: type: string title: title description: The product option's title. product: $ref: '#/components/schemas/BaseProduct' product_id: type: string title: product_id description: The product option's product id. values: type: array description: The product option's values. items: $ref: '#/components/schemas/BaseProductOptionValue' metadata: type: object description: The product option's metadata. created_at: type: string format: date-time title: created_at description: The product option's created at. updated_at: type: string format: date-time title: updated_at description: The product option's updated at. deleted_at: type: string format: date-time title: deleted_at description: The product option's deleted at. AdminProductOptionDeleteResponse: type: object description: SUMMARY x-schemaName: AdminProductOptionDeleteResponse required: - id - object - deleted properties: id: type: string title: id description: The product's ID. object: type: string title: object description: The product's object. default: product_option deleted: type: boolean title: deleted description: The product's deleted. parent: $ref: '#/components/schemas/AdminProduct' AdminProductOptionResponse: type: object description: SUMMARY x-schemaName: AdminProductOptionResponse required: - product_option properties: product_option: $ref: '#/components/schemas/AdminProductOption' AdminProductResponse: type: object description: SUMMARY x-schemaName: AdminProductResponse required: - product properties: product: $ref: '#/components/schemas/AdminProduct' AdminProductTag: type: object description: The tag's tags. x-schemaName: AdminProductTag required: - id - value - created_at - updated_at properties: id: type: string title: id description: The tag's ID. value: type: string title: value description: The tag's value. created_at: type: string format: date-time title: created_at description: The tag's created at. updated_at: type: string format: date-time title: updated_at description: The tag's updated at. deleted_at: type: string format: date-time title: deleted_at description: The tag's deleted at. metadata: type: object description: The tag's metadata. AdminProductTagDeleteResponse: type: object description: SUMMARY x-schemaName: AdminProductTagDeleteResponse required: - id - object - deleted properties: id: type: string title: id description: The product tag's ID. object: type: string title: object description: The product tag's object. default: product_tag deleted: type: boolean title: deleted description: The product tag's deleted. parent: type: object description: The product tag's parent. AdminProductTagListResponse: type: object description: SUMMARY x-schemaName: AdminProductTagListResponse required: - limit - offset - count - product_tags properties: limit: type: number title: limit description: The product tag's limit. offset: type: number title: offset description: The product tag's offset. count: type: number title: count description: The product tag's count. product_tags: type: array description: The product tag's product tags. items: $ref: '#/components/schemas/AdminProductTag' AdminProductTagResponse: type: object description: SUMMARY x-schemaName: AdminProductTagResponse required: - product_tag properties: product_tag: $ref: '#/components/schemas/AdminProductTag' AdminProductTypeDeleteResponse: type: object description: SUMMARY x-schemaName: AdminProductTypeDeleteResponse required: - id - object - deleted properties: id: type: string title: id description: The product type's ID. object: type: string title: object description: The product type's object. default: product_type deleted: type: boolean title: deleted description: The product type's deleted. parent: type: object description: The product type's parent. AdminProductTypeListResponse: type: object description: SUMMARY x-schemaName: AdminProductTypeListResponse required: - limit - offset - count - product_types properties: limit: type: number title: limit description: The product type's limit. offset: type: number title: offset description: The product type's offset. count: type: number title: count description: The product type's count. product_types: type: array description: The product type's product types. items: $ref: '#/components/schemas/AdminProduct' AdminProductTypeResponse: type: object description: SUMMARY x-schemaName: AdminProductTypeResponse required: - product_type properties: product_type: $ref: '#/components/schemas/AdminProduct' AdminProductVariant: type: object description: The product's parent. x-schemaName: AdminProductVariant required: - prices - id - title - sku - barcode - ean - upc - allow_backorder - manage_inventory - hs_code - origin_country - mid_code - material - weight - length - height - width - options - created_at - updated_at - deleted_at properties: prices: type: array description: The parent's prices. items: $ref: '#/components/schemas/AdminPrice' id: type: string title: id description: The parent's ID. title: type: string title: title description: The parent's title. sku: type: string title: sku description: The parent's sku. barcode: type: string title: barcode description: The parent's barcode. ean: type: string title: ean description: The parent's ean. upc: type: string title: upc description: The parent's upc. allow_backorder: type: boolean title: allow_backorder description: The parent's allow backorder. manage_inventory: type: boolean title: manage_inventory description: The parent's manage inventory. hs_code: type: string title: hs_code description: The parent's hs code. origin_country: type: string title: origin_country description: The parent's origin country. mid_code: type: string title: mid_code description: The parent's mid code. material: type: string title: material description: The parent's material. weight: type: number title: weight description: The parent's weight. length: type: number title: length description: The parent's length. height: type: number title: height description: The parent's height. width: type: number title: width description: The parent's width. variant_rank: type: number title: variant_rank description: The parent's variant rank. options: type: array description: The parent's options. items: $ref: '#/components/schemas/BaseProductOptionValue' product: $ref: '#/components/schemas/BaseProduct' product_id: type: string title: product_id description: The parent's product id. calculated_price: $ref: '#/components/schemas/BaseCalculatedPriceSet' created_at: type: string format: date-time title: created_at description: The parent's created at. updated_at: type: string format: date-time title: updated_at description: The parent's updated at. deleted_at: type: string format: date-time title: deleted_at description: The parent's deleted at. metadata: type: object description: The parent's metadata. AdminProductVariantDeleteResponse: type: object description: SUMMARY x-schemaName: AdminProductVariantDeleteResponse required: - id - object - deleted properties: id: type: string title: id description: The product's ID. object: type: string title: object description: The product's object. default: variant deleted: type: boolean title: deleted description: The product's deleted. parent: $ref: '#/components/schemas/AdminProduct' AdminProductVariantInventoryBatchResponse: type: object description: SUMMARY x-schemaName: AdminProductVariantInventoryBatchResponse required: - created - updated - deleted properties: created: oneOf: - $ref: '#/components/schemas/AdminProductVariantInventoryLink' - type: array description: The product's created. items: type: object description: The created's details. x-schemaName: AdminProductVariantInventoryLink required: - productService - inventoryService properties: productService: type: object description: The created's productservice. required: - variant_id properties: variant_id: type: string title: variant_id description: The productservice's variant id. inventoryService: type: object description: The created's inventoryservice. required: - inventory_item_id properties: inventory_item_id: type: string title: inventory_item_id description: The inventoryservice's inventory item id. updated: oneOf: - $ref: '#/components/schemas/AdminProductVariantInventoryLink' - type: array description: The product's updated. items: type: object description: The updated's details. x-schemaName: AdminProductVariantInventoryLink required: - productService - inventoryService properties: productService: type: object description: The updated's productservice. required: - variant_id properties: variant_id: type: string title: variant_id description: The productservice's variant id. inventoryService: type: object description: The updated's inventoryservice. required: - inventory_item_id properties: inventory_item_id: type: string title: inventory_item_id description: The inventoryservice's inventory item id. deleted: oneOf: - $ref: '#/components/schemas/AdminProductVariantInventoryLink' - type: array description: The product's deleted. items: type: object description: The deleted's details. x-schemaName: AdminProductVariantInventoryLink required: - productService - inventoryService properties: productService: type: object description: The deleted's productservice. required: - variant_id properties: variant_id: type: string title: variant_id description: The productservice's variant id. inventoryService: type: object description: The deleted's inventoryservice. required: - inventory_item_id properties: inventory_item_id: type: string title: inventory_item_id description: The inventoryservice's inventory item id. AdminProductVariantInventoryLink: type: object description: The product's ID. x-schemaName: AdminProductVariantInventoryLink required: - productService - inventoryService properties: productService: type: object description: The id's productservice. required: - variant_id properties: variant_id: type: string title: variant_id description: The productservice's variant id. inventoryService: type: object description: The id's inventoryservice. required: - inventory_item_id properties: inventory_item_id: type: string title: inventory_item_id description: The inventoryservice's inventory item id. AdminProductVariantInventoryLinkDeleteResponse: type: object description: SUMMARY x-schemaName: AdminProductVariantInventoryLinkDeleteResponse required: - id - object - deleted - parent properties: id: $ref: '#/components/schemas/AdminProductVariantInventoryLink' object: type: string title: object description: The product's object. deleted: type: boolean title: deleted description: The product's deleted. parent: $ref: '#/components/schemas/AdminProductVariant' AdminProductVariantParams: type: object description: The product's variants. x-schemaName: AdminProductVariantParams properties: q: type: string title: q description: The variant's q. id: oneOf: - type: string title: id description: The variant's ID. - type: array description: The variant's ID. items: type: string title: id description: The id's ID. sku: oneOf: - type: string title: sku description: The variant's sku. - type: array description: The variant's sku. items: type: string title: sku description: The sku's details. product_id: oneOf: - type: string title: product_id description: The variant's product id. - type: array description: The variant's product id. items: type: string title: product_id description: The product id's details. options: type: object description: The variant's options. limit: type: number title: limit description: The variant's limit. offset: type: number title: offset description: The variant's offset. order: type: string title: order description: The variant's order. fields: type: string title: fields description: The variant's fields. $and: type: array description: The variant's $and. items: type: array description: The $and's details. items: type: object title: $and $or: type: array description: The variant's $or. items: type: array description: The $or's details. items: type: object title: $or AdminProductVariantResponse: type: object description: SUMMARY x-schemaName: AdminProductVariantResponse required: - variant properties: variant: $ref: '#/components/schemas/AdminProductVariant' AdminPromotion: type: object description: The promotion's details. x-schemaName: AdminPromotion required: - id properties: id: type: string title: id description: The promotion's ID. code: type: string title: code description: The promotion's code. type: type: string enum: - standard - buyget is_automatic: type: boolean title: is_automatic description: The promotion's is automatic. application_method: $ref: '#/components/schemas/BaseApplicationMethod' rules: type: array description: The promotion's rules. items: $ref: '#/components/schemas/BasePromotionRule' campaign_id: type: string title: campaign_id description: The promotion's campaign id. campaign: $ref: '#/components/schemas/CampaignResponse' AdminPromotionResponse: type: object description: SUMMARY x-schemaName: AdminPromotionResponse required: - promotion properties: promotion: $ref: '#/components/schemas/AdminPromotion' AdminPromotionRule: type: object description: The updated's details. x-schemaName: AdminPromotionRule required: - id - values properties: id: type: string title: id description: The updated's ID. description: type: string title: description description: The updated's description. attribute: type: string title: attribute description: The updated's attribute. operator: type: string enum: - gt - lt - eq - ne - in - lte - gte values: type: array description: The updated's values. items: $ref: '#/components/schemas/BasePromotionRuleValue' AdminRefundReason: type: object description: The refund reason's details. x-schemaName: AdminRefundReason required: - id - label - metadata - created_at - updated_at properties: id: type: string title: id description: The refund reason's ID. label: type: string title: label description: The refund reason's label. description: type: string title: description description: The refund reason's description. metadata: type: object description: The refund reason's metadata. created_at: type: string format: date-time title: created_at description: The refund reason's created at. updated_at: type: string format: date-time title: updated_at description: The refund reason's updated at. AdminRegion: type: object description: The region's details. x-schemaName: AdminRegion required: - id - name - currency_code properties: id: type: string title: id description: The region's ID. name: type: string title: name description: The region's name. currency_code: type: string title: currency_code description: The region's currency code. automatic_taxes: type: boolean title: automatic_taxes description: The region's automatic taxes. countries: type: array description: The region's countries. items: $ref: '#/components/schemas/BaseRegionCountry' payment_providers: type: array description: The region's payment providers. items: $ref: '#/components/schemas/AdminPaymentProvider' metadata: type: object description: The region's metadata. created_at: type: string format: date-time title: created_at description: The region's created at. updated_at: type: string format: date-time title: updated_at description: The region's updated at. AdminRegionResponse: type: object description: SUMMARY x-schemaName: AdminRegionResponse required: - region properties: region: $ref: '#/components/schemas/AdminRegion' AdminReservationResponse: type: object description: SUMMARY x-schemaName: AdminReservationResponse required: - reservation properties: reservation: $ref: '#/components/schemas/ReservationResponse' AdminReturn: type: object description: The exchange's return. x-schemaName: AdminReturn required: - id - order_id - order_version - display_id - items - received_at - created_at properties: id: type: string title: id description: The return's ID. order_id: type: string title: order_id description: The return's order id. status: type: string title: status description: The return's status. exchange_id: type: string title: exchange_id description: The return's exchange id. location_id: type: string title: location_id description: The return's location id. claim_id: type: string title: claim_id description: The return's claim id. order_version: type: number title: order_version description: The return's order version. display_id: type: number title: display_id description: The return's display id. no_notification: type: boolean title: no_notification description: The return's no notification. refund_amount: type: number title: refund_amount description: The return's refund amount. items: type: array description: The return's items. items: $ref: '#/components/schemas/BaseReturnItem' received_at: type: string title: received_at description: The return's received at. created_at: type: string format: date-time title: created_at description: The return's created at. AdminReturnItem: type: object description: The return item's return items. x-schemaName: AdminReturnItem required: - id - quantity - received_quantity - item_id - return_id properties: id: type: string title: id description: The return item's ID. quantity: type: number title: quantity description: The return item's quantity. received_quantity: type: number title: received_quantity description: The return item's received quantity. reason_id: type: string title: reason_id description: The return item's reason id. note: type: string title: note description: The return item's note. item_id: type: string title: item_id description: The return item's item id. return_id: type: string title: return_id description: The return item's return id. metadata: type: object description: The return item's metadata. AdminReturnPreviewResponse: type: object description: SUMMARY x-schemaName: AdminReturnPreviewResponse required: - order_preview - return properties: order_preview: $ref: '#/components/schemas/AdminOrderPreview' return: $ref: '#/components/schemas/AdminReturn' AdminReturnReason: type: object description: The return reason's details. x-schemaName: AdminReturnReason required: - id - value - label - created_at - updated_at properties: id: type: string title: id description: The return reason's ID. value: type: string title: value description: The return reason's value. label: type: string title: label description: The return reason's label. description: type: string title: description description: The return reason's description. metadata: type: object description: The return reason's metadata. created_at: type: string format: date-time title: created_at description: The return reason's created at. updated_at: type: string format: date-time title: updated_at description: The return reason's updated at. AdminReturnReasonListResponse: type: object description: SUMMARY x-schemaName: AdminReturnReasonListResponse required: - limit - offset - count - return_reasons properties: limit: type: number title: limit description: The return reason's limit. offset: type: number title: offset description: The return reason's offset. count: type: number title: count description: The return reason's count. return_reasons: type: array description: The return reason's return reasons. items: $ref: '#/components/schemas/AdminReturnReason' AdminReturnReasonResponse: type: object description: SUMMARY x-schemaName: AdminReturnReasonResponse required: - return_reason properties: return_reason: $ref: '#/components/schemas/AdminReturnReason' AdminReturnResponse: type: object description: SUMMARY x-schemaName: AdminReturnResponse required: - return properties: return: $ref: '#/components/schemas/AdminReturn' AdminRevokeApiKey: type: object description: SUMMARY x-schemaName: AdminRevokeApiKey properties: revoke_in: type: number title: revoke_in description: The api key's revoke in. AdminRuleAttributeOption: type: object description: The attribute's attributes. x-schemaName: AdminRuleAttributeOption required: - id - value - label - field_type - required - disguised - operators properties: id: type: string title: id description: The attribute's ID. value: type: string title: value description: The attribute's value. label: type: string title: label description: The attribute's label. field_type: type: string title: field_type description: The attribute's field type. required: type: boolean title: required description: The attribute's required. disguised: type: boolean title: disguised description: The attribute's disguised. operators: type: array description: The attribute's operators. items: $ref: '#/components/schemas/BaseRuleOperatorOptions' AdminRuleValueOption: type: object description: The value's values. x-schemaName: AdminRuleValueOption required: - id - value - label properties: id: type: string title: id description: The value's ID. value: type: string title: value description: The value's details. label: type: string title: label description: The value's label. AdminSalesChannel: type: object description: The sales channel's sales channels. x-schemaName: AdminSalesChannel required: - id - name - description - is_disabled - metadata - created_at - updated_at - deleted_at properties: id: type: string title: id description: The sales channel's ID. name: type: string title: name description: The sales channel's name. description: type: string title: description description: The sales channel's description. is_disabled: type: boolean title: is_disabled description: The sales channel's is disabled. metadata: type: object description: The sales channel's metadata. created_at: type: string format: date-time title: created_at description: The sales channel's created at. updated_at: type: string format: date-time title: updated_at description: The sales channel's updated at. deleted_at: type: string format: date-time title: deleted_at description: The sales channel's deleted at. AdminSalesChannelDeleteResponse: type: object description: SUMMARY x-schemaName: AdminSalesChannelDeleteResponse required: - id - object - deleted properties: id: type: string title: id description: The sales channel's ID. object: type: string title: object description: The sales channel's object. default: sales-channel deleted: type: boolean title: deleted description: The sales channel's deleted. parent: type: object description: The sales channel's parent. AdminSalesChannelResponse: type: object description: SUMMARY x-schemaName: AdminSalesChannelResponse required: - sales_channel properties: sales_channel: $ref: '#/components/schemas/AdminSalesChannel' AdminServiceZone: type: object description: The service zone's service zones. x-schemaName: AdminServiceZone required: - id - name - fulfillment_set_id - fulfillment_set - geo_zones - shipping_options - created_at - updated_at - deleted_at properties: id: type: string title: id description: The service zone's ID. name: type: string title: name description: The service zone's name. fulfillment_set_id: type: string title: fulfillment_set_id description: The service zone's fulfillment set id. fulfillment_set: type: object geo_zones: type: array description: The service zone's geo zones. items: $ref: '#/components/schemas/AdminGeoZone' shipping_options: type: array description: The service zone's shipping options. items: $ref: '#/components/schemas/AdminShippingOption' created_at: type: string format: date-time title: created_at description: The service zone's created at. updated_at: type: string format: date-time title: updated_at description: The service zone's updated at. deleted_at: type: string format: date-time title: deleted_at description: The service zone's deleted at. AdminServiceZoneResponse: type: object description: SUMMARY x-schemaName: AdminServiceZoneResponse required: - service_zone properties: service_zone: $ref: '#/components/schemas/AdminServiceZone' AdminShippingOption: type: object description: The shipping option's shipping options. x-schemaName: AdminShippingOption AdminShippingOptionDeleteResponse: type: object description: SUMMARY x-schemaName: AdminShippingOptionDeleteResponse required: - id - object - deleted properties: id: type: string title: id description: The shipping option's ID. object: type: string title: object description: The shipping option's object. default: shipping_option deleted: type: boolean title: deleted description: The shipping option's deleted. parent: type: object description: The shipping option's parent. AdminShippingOptionResponse: type: object description: SUMMARY x-schemaName: AdminShippingOptionResponse required: - shipping_option properties: shipping_option: $ref: '#/components/schemas/AdminShippingOption' AdminShippingOptionRule: type: object description: The updated's details. x-schemaName: AdminShippingOptionRule required: - id - attribute - operator - value - shipping_option_id - created_at - updated_at - deleted_at properties: id: type: string title: id description: The updated's ID. attribute: type: string title: attribute description: The updated's attribute. operator: type: string title: operator description: The updated's operator. value: oneOf: - type: string title: value description: The updated's value. - type: array description: The updated's value. items: type: string title: value description: The value's details. shipping_option_id: type: string title: shipping_option_id description: The updated's shipping option id. created_at: type: string format: date-time title: created_at description: The updated's created at. updated_at: type: string format: date-time title: updated_at description: The updated's updated at. deleted_at: type: string format: date-time title: deleted_at description: The updated's deleted at. AdminShippingProfile: type: object description: The shipping option's shipping profile. x-schemaName: AdminShippingProfile AdminShippingProfileDeleteResponse: type: object description: SUMMARY x-schemaName: AdminShippingProfileDeleteResponse required: - id - object - deleted properties: id: type: string title: id description: The shipping profile's ID. object: type: string title: object description: The shipping profile's object. default: shipping_profile deleted: type: boolean title: deleted description: The shipping profile's deleted. parent: type: object description: The shipping profile's parent. AdminShippingProfileResponse: type: object description: SUMMARY x-schemaName: AdminShippingProfileResponse required: - shipping_profile properties: shipping_profile: $ref: '#/components/schemas/AdminShippingProfile' AdminStockLocation: type: object description: The fulfillment set's location. x-schemaName: AdminStockLocation required: - id - name - address_id properties: id: type: string title: id description: The location's ID. name: type: string title: name description: The location's name. address_id: type: string title: address_id description: The location's address id. address: $ref: '#/components/schemas/AdminStockLocationAddress' sales_channels: type: array description: The location's sales channels. items: $ref: '#/components/schemas/AdminSalesChannel' fulfillment_providers: type: array description: The location's fulfillment providers. items: $ref: '#/components/schemas/AdminFulfillmentProvider' fulfillment_sets: type: array description: The location's fulfillment sets. items: type: object AdminStockLocationAddress: type: object description: The location's address. x-schemaName: AdminStockLocationAddress AdminStockLocationDeleteResponse: type: object description: SUMMARY x-schemaName: AdminStockLocationDeleteResponse required: - id - object - deleted properties: id: type: string title: id description: The stock location's ID. object: type: string title: object description: The stock location's object. default: stock_location deleted: type: boolean title: deleted description: The stock location's deleted. parent: type: object description: The stock location's parent. AdminStockLocationListResponse: type: object description: SUMMARY x-schemaName: AdminStockLocationListResponse required: - limit - offset - count - stock_locations properties: limit: type: number title: limit description: The stock location's limit. offset: type: number title: offset description: The stock location's offset. count: type: number title: count description: The stock location's count. stock_locations: type: array description: The stock location's stock locations. items: $ref: '#/components/schemas/AdminStockLocation' AdminStockLocationResponse: type: object description: SUMMARY x-schemaName: AdminStockLocationResponse required: - stock_location properties: stock_location: $ref: '#/components/schemas/AdminStockLocation' AdminStore: type: object description: The store's details. x-schemaName: AdminStore required: - id - name - supported_currencies - default_sales_channel_id - default_region_id - default_location_id - metadata - created_at - updated_at properties: id: type: string title: id description: The store's ID. name: type: string title: name description: The store's name. supported_currencies: type: array description: The store's supported currencies. items: $ref: '#/components/schemas/AdminStoreCurrency' default_sales_channel_id: type: string title: default_sales_channel_id description: The store's default sales channel id. default_region_id: type: string title: default_region_id description: The store's default region id. default_location_id: type: string title: default_location_id description: The store's default location id. metadata: type: object description: The store's metadata. created_at: type: string format: date-time title: created_at description: The store's created at. updated_at: type: string format: date-time title: updated_at description: The store's updated at. AdminStoreCurrency: type: object description: The supported currency's supported currencies. x-schemaName: AdminStoreCurrency required: - id - currency_code - store_id - is_default - currency - created_at - updated_at - deleted_at properties: id: type: string title: id description: The supported currency's ID. currency_code: type: string title: currency_code description: The supported currency's currency code. store_id: type: string title: store_id description: The supported currency's store id. is_default: type: boolean title: is_default description: The supported currency's is default. currency: $ref: '#/components/schemas/AdminCurrency' created_at: type: string format: date-time title: created_at description: The supported currency's created at. updated_at: type: string format: date-time title: updated_at description: The supported currency's updated at. deleted_at: type: string format: date-time title: deleted_at description: The supported currency's deleted at. AdminStoreListResponse: type: object description: SUMMARY x-schemaName: AdminStoreListResponse required: - limit - offset - count - stores properties: limit: type: number title: limit description: The store's limit. offset: type: number title: offset description: The store's offset. count: type: number title: count description: The store's count. stores: type: array description: The store's stores. items: $ref: '#/components/schemas/AdminStore' AdminStoreResponse: type: object description: SUMMARY x-schemaName: AdminStoreResponse required: - store properties: store: $ref: '#/components/schemas/AdminStore' AdminTaxRate: type: object description: The tax rate's details. x-schemaName: AdminTaxRate required: - id - rate - code - name - metadata - tax_region_id - is_combinable - is_default - created_at - updated_at - deleted_at - created_by - tax_region - rules properties: id: type: string title: id description: The tax rate's ID. rate: type: number title: rate description: The tax rate's rate. code: type: string title: code description: The tax rate's code. name: type: string title: name description: The tax rate's name. metadata: type: object description: The tax rate's metadata. tax_region_id: type: string title: tax_region_id description: The tax rate's tax region id. is_combinable: type: boolean title: is_combinable description: The tax rate's is combinable. is_default: type: boolean title: is_default description: The tax rate's is default. created_at: type: string format: date-time title: created_at description: The tax rate's created at. updated_at: type: string format: date-time title: updated_at description: The tax rate's updated at. deleted_at: type: string format: date-time title: deleted_at description: The tax rate's deleted at. created_by: type: string title: created_by description: The tax rate's created by. tax_region: $ref: '#/components/schemas/AdminTaxRegion' rules: type: array description: The tax rate's rules. items: $ref: '#/components/schemas/AdminTaxRateRule' AdminTaxRateDeleteResponse: type: object description: SUMMARY x-schemaName: AdminTaxRateDeleteResponse 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. default: tax_rate deleted: type: boolean title: deleted description: The tax rate's deleted. parent: type: object description: The tax rate's parent. AdminTaxRateResponse: type: object description: SUMMARY x-schemaName: AdminTaxRateResponse required: - tax_rate properties: tax_rate: $ref: '#/components/schemas/AdminTaxRate' AdminTaxRateRule: type: object description: The rule's rules. x-schemaName: AdminTaxRateRule required: - reference - reference_id properties: reference: type: string title: reference description: The rule's reference. reference_id: type: string title: reference_id description: The rule's reference id. AdminTaxRegion: type: object description: The tax rate's tax region. x-schemaName: AdminTaxRegion required: - id - rate - code - country_code - province_code - name - metadata - tax_region_id - is_combinable - is_default - parent_id - created_at - updated_at - deleted_at - created_by - tax_rates - parent - children properties: id: type: string title: id description: The tax region's ID. rate: type: number title: rate description: The tax region's rate. code: type: string title: code description: The tax region's code. country_code: type: string title: country_code description: The tax region's country code. province_code: type: string title: province_code description: The tax region's province code. name: type: string title: name description: The tax region's name. metadata: type: object description: The tax region's metadata. tax_region_id: type: string title: tax_region_id description: The tax region's tax region id. is_combinable: type: boolean title: is_combinable description: The tax region's is combinable. is_default: type: boolean title: is_default description: The tax region's is default. parent_id: type: string title: parent_id description: The tax region's parent id. created_at: type: string format: date-time title: created_at description: The tax region's created at. updated_at: type: string format: date-time title: updated_at description: The tax region's updated at. deleted_at: type: string format: date-time title: deleted_at description: The tax region's deleted at. created_by: type: string title: created_by description: The tax region's created by. tax_rates: type: array description: The tax region's tax rates. items: type: object parent: type: object children: type: array description: The tax region's children. items: type: object AdminTaxRegionDeleteResponse: type: object description: SUMMARY x-schemaName: AdminTaxRegionDeleteResponse required: - id - object - deleted properties: id: type: string title: id description: The tax region's ID. object: type: string title: object description: The tax region's object. default: tax_region deleted: type: boolean title: deleted description: The tax region's deleted. parent: type: object description: The tax region's parent. AdminTaxRegionResponse: type: object description: SUMMARY x-schemaName: AdminTaxRegionResponse required: - tax_region properties: tax_region: $ref: '#/components/schemas/AdminTaxRegion' AdminUpdateApiKey: type: object description: SUMMARY x-schemaName: AdminUpdateApiKey required: - title properties: title: type: string title: title description: The api key's title. AdminUpdateCollection: type: object description: SUMMARY x-schemaName: AdminUpdateCollection required: - metadata properties: title: type: string title: title description: The collection's title. handle: type: string title: handle description: The collection's handle. metadata: type: object description: The collection's metadata. AdminUpdateCustomerGroup: type: object description: SUMMARY x-schemaName: AdminUpdateCustomerGroup required: - metadata properties: name: type: string title: name description: The customer group's name. metadata: type: object description: The customer group's metadata. AdminUpdatePriceList: type: object description: SUMMARY x-schemaName: AdminUpdatePriceList required: - description - starts_at - ends_at properties: title: type: string title: title description: The price list's title. description: type: string title: description description: The price list's description. starts_at: type: string title: starts_at description: The price list's starts at. ends_at: type: string title: ends_at description: The price list's ends at. status: type: string enum: - active - draft type: type: string enum: - sale - override rules: type: object description: The price list's rules. AdminUpdatePricePreference: type: object description: SUMMARY x-schemaName: AdminUpdatePricePreference properties: attribute: type: string title: attribute description: The price preference's attribute. value: type: string title: value description: The price preference's value. is_tax_inclusive: type: boolean title: is_tax_inclusive description: The price preference's is tax inclusive. AdminUpdateProduct: type: object description: The update's details. x-schemaName: AdminUpdateProduct properties: title: type: string title: title description: The update's title. subtitle: type: string title: subtitle description: The update's subtitle. description: type: string title: description description: The update's description. is_giftcard: type: boolean title: is_giftcard description: The update's is giftcard. discountable: type: boolean title: discountable description: The update's discountable. images: type: array description: The update's images. items: type: object description: The image's images. required: - url properties: url: type: string title: url description: The image's url. thumbnail: type: string title: thumbnail description: The update's thumbnail. handle: type: string title: handle description: The update's handle. status: type: string enum: - draft - proposed - published - rejected type_id: type: string title: type_id description: The update's type id. collection_id: type: string title: collection_id description: The update's collection id. categories: type: array description: The update's categories. items: type: object description: The category's categories. required: - id properties: id: type: string title: id description: The category's ID. tags: type: array description: The update's tags. items: type: object description: The tag's tags. required: - id properties: id: type: string title: id description: The tag's ID. options: type: array description: The update's options. items: $ref: '#/components/schemas/AdminUpdateProductOption' variants: type: array description: The update's variants. items: oneOf: - type: object description: The variant's variants. x-schemaName: AdminCreateProductVariant required: - title - prices properties: title: type: string title: title description: The variant's title. sku: type: string title: sku description: The variant's sku. ean: type: string title: ean description: The variant's ean. upc: type: string title: upc description: The variant's upc. barcode: type: string title: barcode description: The variant's barcode. hs_code: type: string title: hs_code description: The variant's hs code. mid_code: type: string title: mid_code description: The variant's mid code. allow_backorder: type: boolean title: allow_backorder description: The variant's allow backorder. manage_inventory: type: boolean title: manage_inventory description: The variant's manage inventory. variant_rank: type: number title: variant_rank description: The variant's variant rank. weight: type: number title: weight description: The variant's weight. length: type: number title: length description: The variant's length. height: type: number title: height description: The variant's height. width: type: number title: width description: The variant's width. origin_country: type: string title: origin_country description: The variant's origin country. material: type: string title: material description: The variant's material. metadata: type: object description: The variant's metadata. prices: type: array description: The variant's prices. items: $ref: '#/components/schemas/AdminCreateProductVariantPrice' options: type: object description: The variant's options. - type: object description: The variant's variants. x-schemaName: AdminUpdateProductVariant properties: title: type: string title: title description: The variant's title. sku: type: string title: sku description: The variant's sku. ean: type: string title: ean description: The variant's ean. upc: type: string title: upc description: The variant's upc. barcode: type: string title: barcode description: The variant's barcode. hs_code: type: string title: hs_code description: The variant's hs code. mid_code: type: string title: mid_code description: The variant's mid code. allow_backorder: type: boolean title: allow_backorder description: The variant's allow backorder. manage_inventory: type: boolean title: manage_inventory description: The variant's manage inventory. variant_rank: type: number title: variant_rank description: The variant's variant rank. weight: type: number title: weight description: The variant's weight. length: type: number title: length description: The variant's length. height: type: number title: height description: The variant's height. width: type: number title: width description: The variant's width. origin_country: type: string title: origin_country description: The variant's origin country. material: type: string title: material description: The variant's material. metadata: type: object description: The variant's metadata. prices: type: array description: The variant's prices. items: $ref: '#/components/schemas/AdminCreateProductVariantPrice' options: type: object description: The variant's options. sales_channels: type: array description: The update's sales channels. items: type: object description: The sales channel's sales channels. required: - id properties: id: type: string title: id description: The sales channel's ID. weight: type: number title: weight description: The update's weight. length: type: number title: length description: The update's length. height: type: number title: height description: The update's height. width: type: number title: width description: The update's width. hs_code: type: string title: hs_code description: The update's hs code. mid_code: type: string title: mid_code description: The update's mid code. origin_country: type: string title: origin_country description: The update's origin country. material: type: string title: material description: The update's material. metadata: type: object description: The update's metadata. AdminUpdateProductOption: type: object description: SUMMARY x-schemaName: AdminUpdateProductOption properties: title: type: string title: title description: The product's title. values: type: array description: The product's values. items: type: string title: values description: The value's values. AdminUpdateProductVariant: type: object description: The update's details. x-schemaName: AdminUpdateProductVariant properties: title: type: string title: title description: The update's title. sku: type: string title: sku description: The update's sku. ean: type: string title: ean description: The update's ean. upc: type: string title: upc description: The update's upc. barcode: type: string title: barcode description: The update's barcode. hs_code: type: string title: hs_code description: The update's hs code. mid_code: type: string title: mid_code description: The update's mid code. allow_backorder: type: boolean title: allow_backorder description: The update's allow backorder. manage_inventory: type: boolean title: manage_inventory description: The update's manage inventory. variant_rank: type: number title: variant_rank description: The update's variant rank. weight: type: number title: weight description: The update's weight. length: type: number title: length description: The update's length. height: type: number title: height description: The update's height. width: type: number title: width description: The update's width. origin_country: type: string title: origin_country description: The update's origin country. material: type: string title: material description: The update's material. metadata: type: object description: The update's metadata. prices: type: array description: The update's prices. items: $ref: '#/components/schemas/AdminCreateProductVariantPrice' options: type: object description: The update's options. AdminUpdateSalesChannel: type: object description: SUMMARY x-schemaName: AdminUpdateSalesChannel required: - description - metadata properties: name: type: string title: name description: The sales channel's name. description: type: string title: description description: The sales channel's description. is_disabled: type: boolean title: is_disabled description: The sales channel's is disabled. metadata: type: object description: The sales channel's metadata. AdminUpdateStockLocation: type: object description: SUMMARY x-schemaName: AdminUpdateStockLocation required: - address_id - metadata properties: name: type: string title: name description: The stock location's name. address: type: object description: The stock location's address. required: - address_1 - address_2 - company - city - country_code - phone - postal_code - province properties: address_1: type: string title: address_1 description: The address's address 1. address_2: type: string title: address_2 description: The address's address 2. company: type: string title: company description: The address's company. city: type: string title: city description: The address's city. country_code: type: string title: country_code description: The address's country code. phone: type: string title: phone description: The address's phone. postal_code: type: string title: postal_code description: The address's postal code. province: type: string title: province description: The address's province. address_id: type: string title: address_id description: The stock location's address id. metadata: type: object description: The stock location's metadata. AdminUpdateStore: type: object description: SUMMARY x-schemaName: AdminUpdateStore required: - default_sales_channel_id - default_region_id - default_location_id - metadata properties: name: type: string title: name description: The store's name. supported_currencies: type: array description: The store's supported currencies. items: type: object description: The supported currency's supported currencies. required: - currency_code properties: currency_code: type: string title: currency_code description: The supported currency's currency code. is_default: type: boolean title: is_default description: The supported currency's is default. is_tax_inclusive: type: boolean title: is_tax_inclusive description: The supported currency's is tax inclusive. default_sales_channel_id: type: string title: default_sales_channel_id description: The store's default sales channel id. default_region_id: type: string title: default_region_id description: The store's default region id. default_location_id: type: string title: default_location_id description: The store's default location id. metadata: type: object description: The store's metadata. AdminUpdateTaxRate: type: object description: SUMMARY x-schemaName: AdminUpdateTaxRate required: - code - metadata properties: rate: type: number title: rate description: The tax rate's rate. code: type: string title: code description: The tax rate's code. rules: type: array description: The tax rate's rules. items: type: object description: The rule's rules. required: - reference - reference_id properties: reference: type: string title: reference description: The rule's reference. reference_id: type: string title: reference_id description: The rule's reference id. name: type: string title: name description: The tax rate's name. is_default: type: boolean title: is_default description: The tax rate's is default. is_combinable: type: boolean title: is_combinable description: The tax rate's is combinable. metadata: type: object description: The tax rate's metadata. AdminUpdateUser: type: object description: SUMMARY x-schemaName: AdminUpdateUser required: - first_name - last_name - avatar_url properties: first_name: type: string title: first_name description: The user's first name. last_name: type: string title: last_name description: The user's last name. avatar_url: type: string title: avatar_url description: The user's avatar url. AdminUpdateVariantInventoryItem: type: object description: SUMMARY x-schemaName: AdminUpdateVariantInventoryItem required: - required_quantity properties: required_quantity: type: number title: required_quantity description: The product's required quantity. AdminUser: type: object description: The user's details. x-schemaName: AdminUser required: - id - email - first_name - last_name - avatar_url - metadata - created_at - updated_at - deleted_at properties: id: type: string title: id description: The user's ID. email: type: string title: email description: The user's email. format: email first_name: type: string title: first_name description: The user's first name. last_name: type: string title: last_name description: The user's last name. avatar_url: type: string title: avatar_url description: The user's avatar url. metadata: type: object description: The user's metadata. created_at: type: string format: date-time title: created_at description: The user's created at. updated_at: type: string format: date-time title: updated_at description: The user's updated at. deleted_at: type: string format: date-time title: deleted_at description: The user's deleted at. AdminUserDeleteResponse: type: object description: SUMMARY x-schemaName: AdminUserDeleteResponse required: - id - object - deleted properties: id: type: string title: id description: The user's ID. object: type: string title: object description: The user's object. default: user deleted: type: boolean title: deleted description: The user's deleted. parent: type: object description: The user's parent. AdminUserListResponse: type: object description: SUMMARY x-schemaName: AdminUserListResponse required: - limit - offset - count - users properties: limit: type: number title: limit description: The user's limit. offset: type: number title: offset description: The user's offset. count: type: number title: count description: The user's count. users: type: array description: The user's users. items: $ref: '#/components/schemas/AdminUser' AdminUserResponse: type: object description: SUMMARY x-schemaName: AdminUserResponse required: - user properties: user: $ref: '#/components/schemas/AdminUser' AdminWorkflowExecution: type: object description: The workflows execution's workflow execution. x-schemaName: AdminWorkflowExecution required: - id - workflow_id - transaction_id - execution - context - state - created_at - updated_at - deleted_at properties: id: type: string title: id description: The workflow execution's ID. workflow_id: type: string title: workflow_id description: The workflow execution's workflow id. transaction_id: type: string title: transaction_id description: The workflow execution's transaction id. execution: type: string title: execution description: The workflow execution's execution. context: type: string title: context description: The workflow execution's context. state: {} created_at: type: string title: created_at description: The workflow execution's created at. format: date-time updated_at: type: string title: updated_at description: The workflow execution's updated at. format: date-time deleted_at: type: string title: deleted_at description: The workflow execution's deleted at. format: date-time AdminWorkflowExecutionResponse: type: object description: SUMMARY x-schemaName: AdminWorkflowExecutionResponse required: - workflow_execution properties: workflow_execution: $ref: '#/components/schemas/AdminWorkflowExecution' ApiKeyResponse: type: object description: The api key's details. x-schemaName: ApiKeyResponse required: - id - token - redacted - title - type - last_used_at - created_by - created_at - revoked_by - revoked_at properties: id: type: string title: id description: The api key's ID. token: type: string title: token description: The api key's token. redacted: type: string title: redacted description: The api key's redacted. title: type: string title: title description: The api key's title. type: type: string enum: - secret - publishable last_used_at: type: string title: last_used_at description: The api key's last used at. format: date-time created_by: type: string title: created_by description: The api key's created by. created_at: type: string title: created_at description: The api key's created at. format: date-time revoked_by: type: string title: revoked_by description: The api key's revoked by. revoked_at: type: string title: revoked_at description: The api key's revoked at. format: date-time BaseApplicationMethod: type: object description: The promotion's application method. x-schemaName: BaseApplicationMethod required: - id properties: id: type: string title: id description: The application method's ID. type: type: string enum: - fixed - percentage target_type: type: string enum: - items - shipping_methods - order allocation: type: string enum: - each - across value: type: number title: value description: The application method's value. currency_code: type: string title: currency_code description: The application method's currency code. max_quantity: type: number title: max_quantity description: The application method's max quantity. buy_rules_min_quantity: type: number title: buy_rules_min_quantity description: The application method's buy rules min quantity. apply_to_quantity: type: number title: apply_to_quantity description: The application method's apply to quantity. promotion: $ref: '#/components/schemas/BasePromotion' target_rules: type: array description: The application method's target rules. items: $ref: '#/components/schemas/BasePromotionRule' buy_rules: type: array description: The application method's buy rules. items: $ref: '#/components/schemas/BasePromotionRule' BaseCalculatedPriceSet: type: object description: The parent's calculated price. x-schemaName: BaseCalculatedPriceSet required: - id - calculated_amount - original_amount - currency_code properties: id: type: string title: id description: The calculated price's ID. is_calculated_price_price_list: type: boolean title: is_calculated_price_price_list description: The calculated price's is calculated price price list. is_calculated_price_tax_inclusive: type: boolean title: is_calculated_price_tax_inclusive description: The calculated price's is calculated price tax inclusive. calculated_amount: type: number title: calculated_amount description: The calculated price's calculated amount. calculated_amount_with_tax: type: number title: calculated_amount_with_tax description: The calculated price's calculated amount with tax. calculated_amount_without_tax: type: number title: calculated_amount_without_tax description: The calculated price's calculated amount without tax. is_original_price_price_list: type: boolean title: is_original_price_price_list description: The calculated price's is original price price list. is_original_price_tax_inclusive: type: boolean title: is_original_price_tax_inclusive description: The calculated price's is original price tax inclusive. original_amount: type: number title: original_amount description: The calculated price's original amount. currency_code: type: string title: currency_code description: The calculated price's currency code. calculated_price: type: object description: The calculated price's details. original_price: type: object description: The calculated price's original price. BaseCapture: type: object description: The capture's captures. x-schemaName: BaseCapture BaseCart: type: object description: The item's cart. x-schemaName: BaseCart BaseCartAddress: type: object description: The cart's billing address. x-schemaName: BaseCartAddress required: - id - created_at - updated_at properties: id: type: string title: id description: The billing address's ID. customer_id: type: string title: customer_id description: The billing address's customer id. first_name: type: string title: first_name description: The billing address's first name. last_name: type: string title: last_name description: The billing address's last name. phone: type: string title: phone description: The billing address's phone. company: type: string title: company description: The billing address's company. address_1: type: string title: address_1 description: The billing address's address 1. address_2: type: string title: address_2 description: The billing address's address 2. city: type: string title: city description: The billing address's city. country_code: type: string title: country_code description: The billing address's country code. province: type: string title: province description: The billing address's province. postal_code: type: string title: postal_code description: The billing address's postal code. metadata: type: object description: The billing address's metadata. created_at: type: string format: date-time title: created_at description: The billing address's created at. updated_at: type: string format: date-time title: updated_at description: The billing address's updated at. BaseCartLineItem: type: object description: The item's items. x-schemaName: BaseCartLineItem required: - id - title - quantity - requires_shipping - is_discountable - is_tax_inclusive - unit_price - cart - cart_id - original_total - original_subtotal - original_tax_total - item_total - item_subtotal - item_tax_total - total - subtotal - tax_total - discount_total - discount_tax_total properties: id: type: string title: id description: The item's ID. title: type: string title: title description: The item's title. subtitle: type: string title: subtitle description: The item's subtitle. thumbnail: type: string title: thumbnail description: The item's thumbnail. quantity: oneOf: - type: string title: quantity description: The item's quantity. - type: number title: quantity description: The item's quantity. - type: string title: quantity description: The item's quantity. - $ref: '#/components/schemas/IBigNumber' product: $ref: '#/components/schemas/BaseProduct' product_id: type: string title: product_id description: The item's product id. product_title: type: string title: product_title description: The item's product title. product_description: type: string title: product_description description: The item's product description. product_subtitle: type: string title: product_subtitle description: The item's product subtitle. product_type: type: string title: product_type description: The item's product type. product_collection: type: string title: product_collection description: The item's product collection. product_handle: type: string title: product_handle description: The item's product handle. variant: $ref: '#/components/schemas/BaseProductVariant' variant_id: type: string title: variant_id description: The item's variant id. variant_sku: type: string title: variant_sku description: The item's variant sku. variant_barcode: type: string title: variant_barcode description: The item's variant barcode. variant_title: type: string title: variant_title description: The item's variant title. variant_option_values: type: object description: The item's variant option values. requires_shipping: type: boolean title: requires_shipping description: The item's requires shipping. is_discountable: type: boolean title: is_discountable description: The item's is discountable. is_tax_inclusive: type: boolean title: is_tax_inclusive description: The item's is tax inclusive. compare_at_unit_price: oneOf: - type: string title: compare_at_unit_price description: The item's compare at unit price. - type: number title: compare_at_unit_price description: The item's compare at unit price. - type: string title: compare_at_unit_price description: The item's compare at unit price. - $ref: '#/components/schemas/IBigNumber' unit_price: oneOf: - type: string title: unit_price description: The item's unit price. - type: number title: unit_price description: The item's unit price. - type: string title: unit_price description: The item's unit price. - $ref: '#/components/schemas/IBigNumber' tax_lines: type: array description: The item's tax lines. items: $ref: '#/components/schemas/BaseLineItemTaxLine' adjustments: type: array description: The item's adjustments. items: $ref: '#/components/schemas/BaseLineItemAdjustment' cart: $ref: '#/components/schemas/BaseCart' cart_id: type: string title: cart_id description: The item's cart id. metadata: type: object description: The item's metadata. created_at: type: string title: created_at description: The item's created at. format: date-time updated_at: type: string title: updated_at description: The item's updated at. format: date-time deleted_at: type: string title: deleted_at description: The item's deleted at. format: date-time original_total: oneOf: - type: string title: original_total description: The item's original total. - type: number title: original_total description: The item's original total. - type: string title: original_total description: The item's original total. - $ref: '#/components/schemas/IBigNumber' original_subtotal: oneOf: - type: string title: original_subtotal description: The item's original subtotal. - type: number title: original_subtotal description: The item's original subtotal. - type: string title: original_subtotal description: The item's original subtotal. - $ref: '#/components/schemas/IBigNumber' original_tax_total: oneOf: - type: string title: original_tax_total description: The item's original tax total. - type: number title: original_tax_total description: The item's original tax total. - type: string title: original_tax_total description: The item's original tax total. - $ref: '#/components/schemas/IBigNumber' item_total: oneOf: - type: string title: item_total description: The item's item total. - type: number title: item_total description: The item's item total. - type: string title: item_total description: The item's item total. - $ref: '#/components/schemas/IBigNumber' item_subtotal: oneOf: - type: string title: item_subtotal description: The item's item subtotal. - type: number title: item_subtotal description: The item's item subtotal. - type: string title: item_subtotal description: The item's item subtotal. - $ref: '#/components/schemas/IBigNumber' item_tax_total: oneOf: - type: string title: item_tax_total description: The item's item tax total. - type: number title: item_tax_total description: The item's item tax total. - type: string title: item_tax_total description: The item's item tax total. - $ref: '#/components/schemas/IBigNumber' total: oneOf: - type: string title: total description: The item's total. - type: number title: total description: The item's total. - type: string title: total description: The item's total. - $ref: '#/components/schemas/IBigNumber' subtotal: oneOf: - type: string title: subtotal description: The item's subtotal. - type: number title: subtotal description: The item's subtotal. - type: string title: subtotal description: The item's subtotal. - $ref: '#/components/schemas/IBigNumber' tax_total: oneOf: - type: string title: tax_total description: The item's tax total. - type: number title: tax_total description: The item's tax total. - type: string title: tax_total description: The item's tax total. - $ref: '#/components/schemas/IBigNumber' discount_total: oneOf: - type: string title: discount_total description: The item's discount total. - type: number title: discount_total description: The item's discount total. - type: string title: discount_total description: The item's discount total. - $ref: '#/components/schemas/IBigNumber' discount_tax_total: oneOf: - type: string title: discount_tax_total description: The item's discount tax total. - type: number title: discount_tax_total description: The item's discount tax total. - type: string title: discount_tax_total description: The item's discount tax total. - $ref: '#/components/schemas/IBigNumber' BaseCartShippingMethod: type: object description: The shipping method's shipping methods. x-schemaName: BaseCartShippingMethod required: - id - cart_id - name - amount - is_tax_inclusive - created_at - updated_at - original_total - original_subtotal - original_tax_total - total - subtotal - tax_total - discount_total - discount_tax_total properties: id: type: string title: id description: The shipping method's ID. cart_id: type: string title: cart_id description: The shipping method's cart id. name: type: string title: name description: The shipping method's name. description: type: string title: description description: The shipping method's description. amount: oneOf: - type: string title: amount description: The shipping method's amount. - type: number title: amount description: The shipping method's amount. - type: string title: amount description: The shipping method's amount. - $ref: '#/components/schemas/IBigNumber' is_tax_inclusive: type: boolean title: is_tax_inclusive description: The shipping method's is tax inclusive. shipping_option_id: type: string title: shipping_option_id description: The shipping method's shipping option id. data: type: object description: The shipping method's data. metadata: type: object description: The shipping method's metadata. tax_lines: type: array description: The shipping method's tax lines. items: $ref: '#/components/schemas/BaseShippingMethodTaxLine' adjustments: type: array description: The shipping method's adjustments. items: $ref: '#/components/schemas/BaseShippingMethodAdjustment' created_at: type: string format: date-time title: created_at description: The shipping method's created at. updated_at: type: string format: date-time title: updated_at description: The shipping method's updated at. original_total: oneOf: - type: string title: original_total description: The shipping method's original total. - type: number title: original_total description: The shipping method's original total. - type: string title: original_total description: The shipping method's original total. - $ref: '#/components/schemas/IBigNumber' original_subtotal: oneOf: - type: string title: original_subtotal description: The shipping method's original subtotal. - type: number title: original_subtotal description: The shipping method's original subtotal. - type: string title: original_subtotal description: The shipping method's original subtotal. - $ref: '#/components/schemas/IBigNumber' original_tax_total: oneOf: - type: string title: original_tax_total description: The shipping method's original tax total. - type: number title: original_tax_total description: The shipping method's original tax total. - type: string title: original_tax_total description: The shipping method's original tax total. - $ref: '#/components/schemas/IBigNumber' total: oneOf: - type: string title: total description: The shipping method's total. - type: number title: total description: The shipping method's total. - type: string title: total description: The shipping method's total. - $ref: '#/components/schemas/IBigNumber' subtotal: oneOf: - type: string title: subtotal description: The shipping method's subtotal. - type: number title: subtotal description: The shipping method's subtotal. - type: string title: subtotal description: The shipping method's subtotal. - $ref: '#/components/schemas/IBigNumber' tax_total: oneOf: - type: string title: tax_total description: The shipping method's tax total. - type: number title: tax_total description: The shipping method's tax total. - type: string title: tax_total description: The shipping method's tax total. - $ref: '#/components/schemas/IBigNumber' discount_total: oneOf: - type: string title: discount_total description: The shipping method's discount total. - type: number title: discount_total description: The shipping method's discount total. - type: string title: discount_total description: The shipping method's discount total. - $ref: '#/components/schemas/IBigNumber' discount_tax_total: oneOf: - type: string title: discount_tax_total description: The shipping method's discount tax total. - type: number title: discount_tax_total description: The shipping method's discount tax total. - type: string title: discount_tax_total description: The shipping method's discount tax total. - $ref: '#/components/schemas/IBigNumber' BaseClaim: type: object description: The order change's claim. x-schemaName: BaseClaim BaseClaimItem: type: object description: The claim item's claim items. x-schemaName: BaseClaimItem required: - id - claim_id - order_id - item_id - quantity - reason - raw_quantity properties: id: type: string title: id description: The claim item's ID. claim_id: type: string title: claim_id description: The claim item's claim id. order_id: type: string title: order_id description: The claim item's order id. item_id: type: string title: item_id description: The claim item's item id. quantity: type: number title: quantity description: The claim item's quantity. reason: type: string enum: - missing_item - wrong_item - production_failure - other raw_quantity: type: object description: The claim item's raw quantity. metadata: type: object description: The claim item's metadata. created_at: type: string format: date-time title: created_at description: The claim item's created at. updated_at: type: string format: date-time title: updated_at description: The claim item's updated at. BaseCollection: type: object description: The product's collection. x-schemaName: BaseCollection BaseCustomer: type: object description: The customer's customers. x-schemaName: BaseCustomer BaseCustomerAddress: type: object description: The address's addresses. x-schemaName: BaseCustomerAddress required: - id - address_name - is_default_shipping - is_default_billing - customer_id - company - first_name - last_name - address_1 - address_2 - city - country_code - province - postal_code - phone - metadata - created_at - updated_at properties: id: type: string title: id description: The address's ID. address_name: type: string title: address_name description: The address's address name. is_default_shipping: type: boolean title: is_default_shipping description: The address's is default shipping. is_default_billing: type: boolean title: is_default_billing description: The address's is default billing. customer_id: type: string title: customer_id description: The address's customer id. company: type: string title: company description: The address's company. first_name: type: string title: first_name description: The address's first name. last_name: type: string title: last_name description: The address's last name. address_1: type: string title: address_1 description: The address's address 1. address_2: type: string title: address_2 description: The address's address 2. city: type: string title: city description: The address's city. country_code: type: string title: country_code description: The address's country code. province: type: string title: province description: The address's province. postal_code: type: string title: postal_code description: The address's postal code. phone: type: string title: phone description: The address's phone. metadata: type: object description: The address's metadata. created_at: type: string format: date-time title: created_at description: The address's created at. updated_at: type: string format: date-time title: updated_at description: The address's updated at. BaseExchangeItem: type: object description: The additional item's additional items. x-schemaName: BaseExchangeItem required: - id - exchange_id - order_id - item_id - quantity - created_at - updated_at properties: id: type: string title: id description: The additional item's ID. exchange_id: type: string title: exchange_id description: The additional item's exchange id. order_id: type: string title: order_id description: The additional item's order id. item_id: type: string title: item_id description: The additional item's item id. quantity: type: number title: quantity description: The additional item's quantity. metadata: type: object description: The additional item's metadata. created_at: type: string format: date-time title: created_at description: The additional item's created at. updated_at: type: string format: date-time title: updated_at description: The additional item's updated at. BaseFulfillmentProvider: type: object description: The shipping option's provider. x-schemaName: BaseFulfillmentProvider required: - id - is_enabled properties: id: type: string title: id description: The provider's ID. is_enabled: type: boolean title: is_enabled description: The provider's is enabled. BaseLineItemAdjustment: type: object description: The adjustment's adjustments. x-schemaName: BaseLineItemAdjustment BaseLineItemTaxLine: type: object description: The tax line's tax lines. x-schemaName: BaseLineItemTaxLine BaseOrder: type: object description: The order change's order. x-schemaName: BaseOrder BaseOrderAddress: type: object description: The order's billing address. x-schemaName: BaseOrderAddress required: - id - metadata - created_at - updated_at properties: id: type: string title: id description: The billing address's ID. customer_id: type: string title: customer_id description: The billing address's customer id. first_name: type: string title: first_name description: The billing address's first name. last_name: type: string title: last_name description: The billing address's last name. phone: type: string title: phone description: The billing address's phone. company: type: string title: company description: The billing address's company. address_1: type: string title: address_1 description: The billing address's address 1. address_2: type: string title: address_2 description: The billing address's address 2. city: type: string title: city description: The billing address's city. country_code: type: string title: country_code description: The billing address's country code. province: type: string title: province description: The billing address's province. postal_code: type: string title: postal_code description: The billing address's postal code. metadata: type: object description: The billing address's metadata. created_at: type: string format: date-time title: created_at description: The billing address's created at. updated_at: type: string format: date-time title: updated_at description: The billing address's updated at. BaseOrderChange: type: object description: The order preview's order change. x-schemaName: BaseOrderChange required: - id - order_id - actions - status - requested_by - requested_at - confirmed_by - confirmed_at - declined_by - declined_reason - metadata - declined_at - canceled_by - canceled_at - created_at - updated_at - version - return_id - exchange_id - claim_id - order - return_order - exchange - claim properties: id: type: string title: id description: The order change's ID. order_id: type: string title: order_id description: The order change's order id. actions: type: array description: The order change's actions. items: $ref: '#/components/schemas/BaseOrderChangeAction' status: type: string title: status description: The order change's status. requested_by: type: string title: requested_by description: The order change's requested by. requested_at: oneOf: - type: string title: requested_at description: The order change's requested at. - type: string title: requested_at description: The order change's requested at. format: date-time confirmed_by: type: string title: confirmed_by description: The order change's confirmed by. confirmed_at: oneOf: - type: string title: confirmed_at description: The order change's confirmed at. - type: string title: confirmed_at description: The order change's confirmed at. format: date-time declined_by: type: string title: declined_by description: The order change's declined by. declined_reason: type: string title: declined_reason description: The order change's declined reason. metadata: type: object description: The order change's metadata. declined_at: oneOf: - type: string title: declined_at description: The order change's declined at. - type: string title: declined_at description: The order change's declined at. format: date-time canceled_by: type: string title: canceled_by description: The order change's canceled by. canceled_at: oneOf: - type: string title: canceled_at description: The order change's canceled at. - type: string title: canceled_at description: The order change's canceled at. format: date-time created_at: type: string format: date-time title: created_at description: The order change's created at. updated_at: type: string format: date-time title: updated_at description: The order change's updated at. version: type: number title: version description: The order change's version. change_type: type: string enum: - return - exchange - claim - edit return_id: type: string title: return_id description: The order change's return id. exchange_id: type: string title: exchange_id description: The order change's exchange id. claim_id: type: string title: claim_id description: The order change's claim id. order: $ref: '#/components/schemas/BaseOrder' return_order: {} exchange: {} claim: $ref: '#/components/schemas/BaseClaim' BaseOrderChangeAction: type: object description: The action's actions. x-schemaName: BaseOrderChangeAction BaseOrderFulfillment: type: object description: The fulfillment's fulfillments. x-schemaName: BaseOrderFulfillment required: - id - location_id - packed_at - shipped_at - delivered_at - canceled_at - data - provider_id - shipping_option_id - metadata - created_at - updated_at properties: id: type: string title: id description: The fulfillment's ID. location_id: type: string title: location_id description: The fulfillment's location id. packed_at: type: string title: packed_at description: The fulfillment's packed at. format: date-time shipped_at: type: string title: shipped_at description: The fulfillment's shipped at. format: date-time delivered_at: type: string title: delivered_at description: The fulfillment's delivered at. format: date-time canceled_at: type: string title: canceled_at description: The fulfillment's canceled at. format: date-time data: type: object description: The fulfillment's data. provider_id: type: string title: provider_id description: The fulfillment's provider id. shipping_option_id: type: string title: shipping_option_id description: The fulfillment's shipping option id. metadata: type: object description: The fulfillment's metadata. created_at: type: string title: created_at description: The fulfillment's created at. format: date-time updated_at: type: string title: updated_at description: The fulfillment's updated at. format: date-time BaseOrderItemDetail: type: object description: The item's detail. x-schemaName: BaseOrderItemDetail BaseOrderLineItem: type: object description: The item's items. x-schemaName: BaseOrderLineItem required: - id - title - subtitle - thumbnail - variant_id - product_id - product_title - product_description - product_subtitle - product_type - product_collection - product_handle - variant_sku - variant_barcode - variant_title - variant_option_values - requires_shipping - is_discountable - is_tax_inclusive - unit_price - quantity - detail - created_at - updated_at - metadata - original_total - original_subtotal - original_tax_total - item_total - item_subtotal - item_tax_total - total - subtotal - tax_total - discount_total - discount_tax_total - refundable_total - refundable_total_per_unit properties: id: type: string title: id description: The item's ID. title: type: string title: title description: The item's title. subtitle: type: string title: subtitle description: The item's subtitle. thumbnail: type: string title: thumbnail description: The item's thumbnail. variant: $ref: '#/components/schemas/BaseProductVariant' variant_id: type: string title: variant_id description: The item's variant id. product: $ref: '#/components/schemas/BaseProduct' product_id: type: string title: product_id description: The item's product id. product_title: type: string title: product_title description: The item's product title. product_description: type: string title: product_description description: The item's product description. product_subtitle: type: string title: product_subtitle description: The item's product subtitle. product_type: type: string title: product_type description: The item's product type. product_collection: type: string title: product_collection description: The item's product collection. product_handle: type: string title: product_handle description: The item's product handle. variant_sku: type: string title: variant_sku description: The item's variant sku. variant_barcode: type: string title: variant_barcode description: The item's variant barcode. variant_title: type: string title: variant_title description: The item's variant title. variant_option_values: type: object description: The item's variant option values. requires_shipping: type: boolean title: requires_shipping description: The item's requires shipping. is_discountable: type: boolean title: is_discountable description: The item's is discountable. is_tax_inclusive: type: boolean title: is_tax_inclusive description: The item's is tax inclusive. compare_at_unit_price: type: number title: compare_at_unit_price description: The item's compare at unit price. unit_price: type: number title: unit_price description: The item's unit price. quantity: type: number title: quantity description: The item's quantity. tax_lines: type: array description: The item's tax lines. items: $ref: '#/components/schemas/BaseOrderLineItemTaxLine' adjustments: type: array description: The item's adjustments. items: $ref: '#/components/schemas/BaseOrderLineItemAdjustment' detail: $ref: '#/components/schemas/BaseOrderItemDetail' created_at: type: string title: created_at description: The item's created at. format: date-time updated_at: type: string title: updated_at description: The item's updated at. format: date-time metadata: type: object description: The item's metadata. original_total: type: number title: original_total description: The item's original total. original_subtotal: type: number title: original_subtotal description: The item's original subtotal. original_tax_total: type: number title: original_tax_total description: The item's original tax total. item_total: type: number title: item_total description: The item's item total. item_subtotal: type: number title: item_subtotal description: The item's item subtotal. item_tax_total: type: number title: item_tax_total description: The item's item tax total. total: type: number title: total description: The item's total. subtotal: type: number title: subtotal description: The item's subtotal. tax_total: type: number title: tax_total description: The item's tax total. discount_total: type: number title: discount_total description: The item's discount total. discount_tax_total: type: number title: discount_tax_total description: The item's discount tax total. refundable_total: type: number title: refundable_total description: The item's refundable total. refundable_total_per_unit: type: number title: refundable_total_per_unit description: The item's refundable total per unit. BaseOrderLineItemAdjustment: type: object description: The adjustment's adjustments. x-schemaName: BaseOrderLineItemAdjustment BaseOrderLineItemTaxLine: type: object description: The tax line's tax lines. x-schemaName: BaseOrderLineItemTaxLine BaseOrderShippingMethod: type: object description: The shipping method's shipping methods. x-schemaName: BaseOrderShippingMethod required: - id - order_id - name - amount - is_tax_inclusive - shipping_option_id - data - metadata - original_total - original_subtotal - original_tax_total - total - subtotal - tax_total - discount_total - discount_tax_total - created_at - updated_at properties: id: type: string title: id description: The shipping method's ID. order_id: type: string title: order_id description: The shipping method's order id. name: type: string title: name description: The shipping method's name. description: type: string title: description description: The shipping method's description. amount: type: number title: amount description: The shipping method's amount. is_tax_inclusive: type: boolean title: is_tax_inclusive description: The shipping method's is tax inclusive. shipping_option_id: type: string title: shipping_option_id description: The shipping method's shipping option id. data: type: object description: The shipping method's data. metadata: type: object description: The shipping method's metadata. tax_lines: type: array description: The shipping method's tax lines. items: $ref: '#/components/schemas/BaseOrderShippingMethodTaxLine' adjustments: type: array description: The shipping method's adjustments. items: $ref: '#/components/schemas/BaseOrderShippingMethodAdjustment' original_total: oneOf: - type: string title: original_total description: The shipping method's original total. - type: number title: original_total description: The shipping method's original total. - type: string title: original_total description: The shipping method's original total. - $ref: '#/components/schemas/IBigNumber' original_subtotal: oneOf: - type: string title: original_subtotal description: The shipping method's original subtotal. - type: number title: original_subtotal description: The shipping method's original subtotal. - type: string title: original_subtotal description: The shipping method's original subtotal. - $ref: '#/components/schemas/IBigNumber' original_tax_total: oneOf: - type: string title: original_tax_total description: The shipping method's original tax total. - type: number title: original_tax_total description: The shipping method's original tax total. - type: string title: original_tax_total description: The shipping method's original tax total. - $ref: '#/components/schemas/IBigNumber' total: oneOf: - type: string title: total description: The shipping method's total. - type: number title: total description: The shipping method's total. - type: string title: total description: The shipping method's total. - $ref: '#/components/schemas/IBigNumber' subtotal: oneOf: - type: string title: subtotal description: The shipping method's subtotal. - type: number title: subtotal description: The shipping method's subtotal. - type: string title: subtotal description: The shipping method's subtotal. - $ref: '#/components/schemas/IBigNumber' tax_total: oneOf: - type: string title: tax_total description: The shipping method's tax total. - type: number title: tax_total description: The shipping method's tax total. - type: string title: tax_total description: The shipping method's tax total. - $ref: '#/components/schemas/IBigNumber' discount_total: oneOf: - type: string title: discount_total description: The shipping method's discount total. - type: number title: discount_total description: The shipping method's discount total. - type: string title: discount_total description: The shipping method's discount total. - $ref: '#/components/schemas/IBigNumber' discount_tax_total: oneOf: - type: string title: discount_tax_total description: The shipping method's discount tax total. - type: number title: discount_tax_total description: The shipping method's discount tax total. - type: string title: discount_tax_total description: The shipping method's discount tax total. - $ref: '#/components/schemas/IBigNumber' created_at: type: string format: date-time title: created_at description: The shipping method's created at. updated_at: type: string format: date-time title: updated_at description: The shipping method's updated at. BaseOrderShippingMethodAdjustment: type: object description: The adjustment's adjustments. x-schemaName: BaseOrderShippingMethodAdjustment BaseOrderShippingMethodTaxLine: type: object description: The tax line's tax lines. x-schemaName: BaseOrderShippingMethodTaxLine BaseOrderSummary: type: object description: The order's summary. x-schemaName: BaseOrderSummary required: - total - subtotal - total_tax - ordered_total - fulfilled_total - returned_total - return_request_total - write_off_total - projected_total - net_total - net_subtotal - net_total_tax - balance - paid_total - refunded_total properties: total: type: number title: total description: The summary's total. subtotal: type: number title: subtotal description: The summary's subtotal. total_tax: type: number title: total_tax description: The summary's total tax. ordered_total: type: number title: ordered_total description: The summary's ordered total. fulfilled_total: type: number title: fulfilled_total description: The summary's fulfilled total. returned_total: type: number title: returned_total description: The summary's returned total. return_request_total: type: number title: return_request_total description: The summary's return request total. write_off_total: type: number title: write_off_total description: The summary's write off total. projected_total: type: number title: projected_total description: The summary's projected total. net_total: type: number title: net_total description: The summary's net total. net_subtotal: type: number title: net_subtotal description: The summary's net subtotal. net_total_tax: type: number title: net_total_tax description: The summary's net total tax. balance: type: number title: balance description: The summary's balance. paid_total: type: number title: paid_total description: The summary's paid total. refunded_total: type: number title: refunded_total description: The summary's refunded total. BaseOrderTransaction: type: object description: The transaction's transactions. x-schemaName: BaseOrderTransaction required: - id - order_id - amount - currency_code - reference - reference_id - metadata - created_at - updated_at properties: id: type: string title: id description: The transaction's ID. order_id: type: string title: order_id description: The transaction's order id. amount: type: number title: amount description: The transaction's amount. currency_code: type: string title: currency_code description: The transaction's currency code. reference: type: string title: reference description: The transaction's reference. reference_id: type: string title: reference_id description: The transaction's reference id. metadata: type: object description: The transaction's metadata. created_at: type: string format: date-time title: created_at description: The transaction's created at. updated_at: type: string format: date-time title: updated_at description: The transaction's updated at. BasePayment: type: object description: The payment's payments. x-schemaName: BasePayment BasePaymentCollection: type: object description: The payment collection's payment collections. x-schemaName: BasePaymentCollection required: - id - currency_code - region_id - amount - status - payment_providers properties: id: type: string title: id description: The payment collection's ID. currency_code: type: string title: currency_code description: The payment collection's currency code. region_id: type: string title: region_id description: The payment collection's region id. amount: oneOf: - type: string title: amount description: The payment collection's amount. - type: number title: amount description: The payment collection's amount. - type: string title: amount description: The payment collection's amount. - $ref: '#/components/schemas/IBigNumber' authorized_amount: oneOf: - type: string title: authorized_amount description: The payment collection's authorized amount. - type: number title: authorized_amount description: The payment collection's authorized amount. - type: string title: authorized_amount description: The payment collection's authorized amount. - $ref: '#/components/schemas/IBigNumber' captured_amount: oneOf: - type: string title: captured_amount description: The payment collection's captured amount. - type: number title: captured_amount description: The payment collection's captured amount. - type: string title: captured_amount description: The payment collection's captured amount. - $ref: '#/components/schemas/IBigNumber' refunded_amount: oneOf: - type: string title: refunded_amount description: The payment collection's refunded amount. - type: number title: refunded_amount description: The payment collection's refunded amount. - type: string title: refunded_amount description: The payment collection's refunded amount. - $ref: '#/components/schemas/IBigNumber' completed_at: oneOf: - type: string title: completed_at description: The payment collection's completed at. - type: string title: completed_at description: The payment collection's completed at. format: date-time created_at: type: string format: date-time title: created_at description: The payment collection's created at. updated_at: type: string format: date-time title: updated_at description: The payment collection's updated at. metadata: type: object description: The payment collection's metadata. status: type: string enum: - canceled - not_paid - awaiting - authorized - partially_authorized payment_providers: type: array description: The payment collection's payment providers. items: $ref: '#/components/schemas/BasePaymentProvider' payment_sessions: type: array description: The payment collection's payment sessions. items: $ref: '#/components/schemas/BasePaymentSession' payments: type: array description: The payment collection's payments. items: $ref: '#/components/schemas/BasePayment' BasePaymentProvider: type: object description: The payment provider's payment providers. x-schemaName: BasePaymentProvider BasePaymentSession: type: object description: The payment session's payment sessions. x-schemaName: BasePaymentSession BaseProduct: type: object description: The parent's product. x-schemaName: BaseProduct required: - id - title - handle - subtitle - description - is_giftcard - status - thumbnail - width - weight - length - height - origin_country - hs_code - mid_code - material - collection_id - type_id - variants - options - images - discountable - external_id - created_at - updated_at - deleted_at properties: id: type: string title: id description: The product's ID. title: type: string title: title description: The product's title. handle: type: string title: handle description: The product's handle. subtitle: type: string title: subtitle description: The product's subtitle. description: type: string title: description description: The product's description. is_giftcard: type: boolean title: is_giftcard description: The product's is giftcard. status: type: string enum: - draft - proposed - published - rejected thumbnail: type: string title: thumbnail description: The product's thumbnail. width: type: number title: width description: The product's width. weight: type: number title: weight description: The product's weight. length: type: number title: length description: The product's length. height: type: number title: height description: The product's height. origin_country: type: string title: origin_country description: The product's origin country. hs_code: type: string title: hs_code description: The product's hs code. mid_code: type: string title: mid_code description: The product's mid code. material: type: string title: material description: The product's material. collection: $ref: '#/components/schemas/BaseCollection' collection_id: type: string title: collection_id description: The product's collection id. categories: type: array description: The product's categories. items: $ref: '#/components/schemas/BaseProductCategory' type: type: object type_id: type: string title: type_id description: The product's type id. tags: type: array description: The product's tags. items: $ref: '#/components/schemas/BaseProductTag' variants: type: array description: The product's variants. items: $ref: '#/components/schemas/BaseProductVariant' options: type: array description: The product's options. items: $ref: '#/components/schemas/BaseProductOption' images: type: array description: The product's images. items: $ref: '#/components/schemas/BaseProductImage' discountable: type: boolean title: discountable description: The product's discountable. external_id: type: string title: external_id description: The product's external id. created_at: type: string format: date-time title: created_at description: The product's created at. updated_at: type: string format: date-time title: updated_at description: The product's updated at. deleted_at: type: string format: date-time title: deleted_at description: The product's deleted at. metadata: type: object description: The product's metadata. BaseProductCategory: type: object description: The category's categories. x-schemaName: BaseProductCategory BaseProductImage: type: object description: The image's images. x-schemaName: BaseProductImage BaseProductOption: type: object description: The option's options. x-schemaName: BaseProductOption BaseProductOptionValue: type: object description: The option's options. x-schemaName: BaseProductOptionValue required: - id - value properties: id: type: string title: id description: The option's ID. value: type: string title: value description: The option's value. option: $ref: '#/components/schemas/BaseProductOption' option_id: type: string title: option_id description: The option's option id. metadata: type: object description: The option's metadata. created_at: type: string format: date-time title: created_at description: The option's created at. updated_at: type: string format: date-time title: updated_at description: The option's updated at. deleted_at: type: string format: date-time title: deleted_at description: The option's deleted at. BaseProductTag: type: object description: The tag's tags. x-schemaName: BaseProductTag BaseProductVariant: type: object description: The variant's variants. x-schemaName: BaseProductVariant BasePromotion: type: object description: The application method's promotion. x-schemaName: BasePromotion BasePromotionRule: type: object description: The rule's rules. x-schemaName: BasePromotionRule required: - id - values properties: id: type: string title: id description: The rule's ID. description: type: string title: description description: The rule's description. attribute: type: string title: attribute description: The rule's attribute. operator: type: string enum: - gt - lt - eq - ne - in - lte - gte values: type: array description: The rule's values. items: $ref: '#/components/schemas/BasePromotionRuleValue' BasePromotionRuleValue: type: object description: The value's values. x-schemaName: BasePromotionRuleValue required: - id properties: id: type: string title: id description: The value's ID. value: type: string title: value description: The value's details. BaseRefund: type: object description: The refund's refunds. x-schemaName: BaseRefund BaseRegion: type: object description: The cart's region. x-schemaName: BaseRegion required: - id - name - currency_code properties: id: type: string title: id description: The region's ID. name: type: string title: name description: The region's name. currency_code: type: string title: currency_code description: The region's currency code. automatic_taxes: type: boolean title: automatic_taxes description: The region's automatic taxes. countries: type: array description: The region's countries. items: $ref: '#/components/schemas/BaseRegionCountry' payment_providers: type: array description: The region's payment providers. items: $ref: '#/components/schemas/AdminPaymentProvider' metadata: type: object description: The region's metadata. created_at: type: string format: date-time title: created_at description: The region's created at. updated_at: type: string format: date-time title: updated_at description: The region's updated at. BaseRegionCountry: type: object description: The country's countries. x-schemaName: BaseRegionCountry BaseReturnItem: type: object description: The item's items. x-schemaName: BaseReturnItem BaseRuleOperatorOptions: type: object description: The operator's operators. x-schemaName: BaseRuleOperatorOptions required: - id - value - label properties: id: type: string title: id description: The operator's ID. value: type: string title: value description: The operator's value. label: type: string title: label description: The operator's label. BaseShippingMethodAdjustment: type: object description: The adjustment's adjustments. x-schemaName: BaseShippingMethodAdjustment BaseShippingMethodTaxLine: type: object description: The tax line's tax lines. x-schemaName: BaseShippingMethodTaxLine CampaignResponse: type: object description: The campaign's details. x-schemaName: CampaignResponse required: - id - name - description - currency - campaign_identifier - starts_at - ends_at - budget properties: id: type: string title: id description: The campaign's ID. name: type: string title: name description: The campaign's name. description: type: string title: description description: The campaign's description. currency: type: string title: currency description: The campaign's currency. campaign_identifier: type: string title: campaign_identifier description: The campaign's campaign identifier. starts_at: type: string title: starts_at description: The campaign's starts at. ends_at: type: string title: ends_at description: The campaign's ends at. budget: type: object description: The campaign's budget. required: - id - type - currency_code - limit - used properties: id: type: string title: id description: The budget's ID. type: type: string enum: - spend - usage currency_code: type: string title: currency_code description: The budget's currency code. limit: type: number title: limit description: The budget's limit. used: type: number title: used description: The budget's used. CreateAddress: type: object description: The cart's shipping address. x-schemaName: CreateAddress properties: customer_id: type: string title: customer_id description: The shipping address's customer id. company: type: string title: company description: The shipping address's company. first_name: type: string title: first_name description: The shipping address's first name. last_name: type: string title: last_name description: The shipping address's last name. address_1: type: string title: address_1 description: The shipping address's address 1. address_2: type: string title: address_2 description: The shipping address's address 2. city: type: string title: city description: The shipping address's city. country_code: type: string title: country_code description: The shipping address's country code. province: type: string title: province description: The shipping address's province. postal_code: type: string title: postal_code description: The shipping address's postal code. phone: type: string title: phone description: The shipping address's phone. metadata: type: object description: The shipping address's metadata. CreateCartAddress: type: object description: The cart's billing address. x-schemaName: CreateCartAddress properties: first_name: type: string title: first_name description: The billing address's first name. last_name: type: string title: last_name description: The billing address's last name. phone: type: string title: phone description: The billing address's phone. company: type: string title: company description: The billing address's company. address_1: type: string title: address_1 description: The billing address's address 1. address_2: type: string title: address_2 description: The billing address's address 2. city: type: string title: city description: The billing address's city. country_code: type: string title: country_code description: The billing address's country code. province: type: string title: province description: The billing address's province. postal_code: type: string title: postal_code description: The billing address's postal code. metadata: type: object description: The billing address's metadata. CreateCartCreateLineItem: type: object description: The item's items. x-schemaName: CreateCartCreateLineItem required: - quantity - variant_id properties: quantity: type: string title: quantity description: The item's quantity. variant_id: type: string title: variant_id description: The item's variant id. title: type: string title: title description: The item's title. subtitle: type: string title: subtitle description: The item's subtitle. thumbnail: type: string title: thumbnail description: The item's thumbnail. product_id: type: string title: product_id description: The item's product id. product_title: type: string title: product_title description: The item's product title. product_description: type: string title: product_description description: The item's product description. product_subtitle: type: string title: product_subtitle description: The item's product subtitle. product_type: type: string title: product_type description: The item's product type. product_collection: type: string title: product_collection description: The item's product collection. product_handle: type: string title: product_handle description: The item's product handle. variant_sku: type: string title: variant_sku description: The item's variant sku. variant_barcode: type: string title: variant_barcode description: The item's variant barcode. variant_title: type: string title: variant_title description: The item's variant title. variant_option_values: type: object description: The item's variant option values. requires_shipping: type: boolean title: requires_shipping description: The item's requires shipping. is_discountable: type: boolean title: is_discountable description: The item's is discountable. is_tax_inclusive: type: boolean title: is_tax_inclusive description: The item's is tax inclusive. is_giftcard: type: boolean title: is_giftcard description: The item's is giftcard. compare_at_unit_price: type: string title: compare_at_unit_price description: The item's compare at unit price. unit_price: type: string title: unit_price description: The item's unit price. metadata: type: object description: The item's metadata. CreateCartWorkflowInput: type: object description: SUMMARY x-schemaName: CreateCartWorkflowInput properties: region_id: type: string title: region_id description: The cart's region id. customer_id: type: string title: customer_id description: The cart's customer id. sales_channel_id: type: string title: sales_channel_id description: The cart's sales channel id. email: type: string title: email description: The cart's email. format: email currency_code: type: string title: currency_code description: The cart's currency code. shipping_address_id: type: string title: shipping_address_id description: The cart's shipping address id. billing_address_id: type: string title: billing_address_id description: The cart's billing address id. shipping_address: oneOf: - type: string title: shipping_address description: The cart's shipping address. - $ref: '#/components/schemas/CreateCartAddress' billing_address: oneOf: - type: string title: billing_address description: The cart's billing address. - $ref: '#/components/schemas/CreateCartAddress' metadata: type: object description: The cart's metadata. items: type: array description: The cart's items. items: $ref: '#/components/schemas/CreateCartCreateLineItem' promo_codes: type: array description: The cart's promo codes. items: type: string title: promo_codes description: The promo code's promo codes. CreateOrderReturnReason: type: object description: SUMMARY x-schemaName: CreateOrderReturnReason required: - value - label properties: value: type: string title: value description: The return reason's value. label: type: string title: label description: The return reason's label. description: type: string title: description description: The return reason's description. parent_return_reason_id: type: string title: parent_return_reason_id description: The return reason's parent return reason id. metadata: type: object description: The return reason's metadata. 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 message: type: string description: Description of the error that occurred. 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 File: type: object description: The product's file. x-schemaName: File required: - lastModified - name - webkitRelativePath - size - type - arrayBuffer - stream - text properties: lastModified: type: number title: lastModified description: The file's lastmodified. name: type: string title: name description: The file's name. webkitRelativePath: type: string title: webkitRelativePath description: The file's webkitrelativepath. size: type: number title: size description: The file's size. type: type: string title: type description: The file's type. arrayBuffer: type: object description: The file's arraybuffer. slice: type: object description: The file's slice. stream: type: object description: The file's stream. text: type: object description: The file's text. IBigNumber: type: object description: The shipping method's discount tax total. x-schemaName: IBigNumber InventoryLevel: type: object description: The inventory level's inventory levels. x-schemaName: InventoryLevel required: - id - inventory_item_id - location_id - stocked_quantity - reserved_quantity - available_quantity - incoming_quantity properties: id: type: string title: id description: The inventory level's ID. inventory_item_id: type: string title: inventory_item_id description: The inventory level's inventory item id. location_id: type: string title: location_id description: The inventory level's location id. stocked_quantity: type: number title: stocked_quantity description: The inventory level's stocked quantity. reserved_quantity: type: number title: reserved_quantity description: The inventory level's reserved quantity. available_quantity: type: number title: available_quantity description: The inventory level's available quantity. incoming_quantity: type: number title: incoming_quantity description: The inventory level's incoming quantity. metadata: type: object description: The inventory level's metadata. Order: type: object description: The transaction's order. x-schemaName: Order OrderAddress: type: object description: The order preview's billing address. x-schemaName: OrderAddress required: - id - created_at - updated_at properties: id: type: string title: id description: The billing address's ID. customer_id: type: string title: customer_id description: The billing address's customer id. first_name: type: string title: first_name description: The billing address's first name. last_name: type: string title: last_name description: The billing address's last name. phone: type: string title: phone description: The billing address's phone. company: type: string title: company description: The billing address's company. address_1: type: string title: address_1 description: The billing address's address 1. address_2: type: string title: address_2 description: The billing address's address 2. city: type: string title: city description: The billing address's city. country_code: type: string title: country_code description: The billing address's country code. province: type: string title: province description: The billing address's province. postal_code: type: string title: postal_code description: The billing address's postal code. metadata: type: object description: The billing address's metadata. created_at: type: string format: date-time title: created_at description: The billing address's created at. updated_at: type: string format: date-time title: updated_at description: The billing address's updated at. OrderChange: type: object description: The order preview's order change. x-schemaName: OrderChange required: - id - version - order_id - return_id - exchange_id - claim_id - order - return_order - exchange - claim - actions - status - requested_by - requested_at - confirmed_by - confirmed_at - declined_by - declined_reason - metadata - declined_at - canceled_by - canceled_at - created_at - updated_at properties: id: type: string title: id description: The order change's ID. version: type: number title: version description: The order change's version. change_type: type: string enum: - return - exchange - claim - edit order_id: type: string title: order_id description: The order change's order id. return_id: type: string title: return_id description: The order change's return id. exchange_id: type: string title: exchange_id description: The order change's exchange id. claim_id: type: string title: claim_id description: The order change's claim id. order: type: object return_order: $ref: '#/components/schemas/Return' exchange: $ref: '#/components/schemas/OrderExchange' claim: $ref: '#/components/schemas/OrderClaim' actions: type: array description: The order change's actions. items: $ref: '#/components/schemas/OrderChangeAction' status: type: string title: status description: The order change's status. requested_by: type: string title: requested_by description: The order change's requested by. requested_at: oneOf: - type: string title: requested_at description: The order change's requested at. - type: string title: requested_at description: The order change's requested at. format: date-time confirmed_by: type: string title: confirmed_by description: The order change's confirmed by. confirmed_at: oneOf: - type: string title: confirmed_at description: The order change's confirmed at. - type: string title: confirmed_at description: The order change's confirmed at. format: date-time declined_by: type: string title: declined_by description: The order change's declined by. declined_reason: type: string title: declined_reason description: The order change's declined reason. metadata: type: object description: The order change's metadata. declined_at: oneOf: - type: string title: declined_at description: The order change's declined at. - type: string title: declined_at description: The order change's declined at. format: date-time canceled_by: type: string title: canceled_by description: The order change's canceled by. canceled_at: oneOf: - type: string title: canceled_at description: The order change's canceled at. - type: string title: canceled_at description: The order change's canceled at. format: date-time created_at: type: string format: date-time title: created_at description: The order change's created at. updated_at: type: string format: date-time title: updated_at description: The order change's updated at. OrderChangeAction: type: object description: The action's actions. x-schemaName: OrderChangeAction OrderClaim: type: object description: The order change's claim. x-schemaName: OrderClaim OrderExchange: type: object description: The order change's exchange. x-schemaName: OrderExchange OrderItem: type: object description: The item's detail. x-schemaName: OrderItem OrderLineItemAdjustment: type: object description: The adjustment's adjustments. x-schemaName: OrderLineItemAdjustment OrderLineItemTaxLine: type: object description: The tax line's tax lines. x-schemaName: OrderLineItemTaxLine OrderPreview: type: object description: The order edit's order preview. x-schemaName: OrderPreview required: - order_change - status - currency_code - id - version - original_item_total - original_item_subtotal - original_item_tax_total - item_total - item_subtotal - item_tax_total - original_total - original_subtotal - original_tax_total - total - subtotal - tax_total - discount_total - discount_tax_total - gift_card_total - gift_card_tax_total - shipping_total - shipping_subtotal - shipping_tax_total - original_shipping_total - original_shipping_subtotal - original_shipping_tax_total - raw_original_item_total - raw_original_item_subtotal - raw_original_item_tax_total - raw_item_total - raw_item_subtotal - raw_item_tax_total - raw_original_total - raw_original_subtotal - raw_original_tax_total - raw_total - raw_subtotal - raw_tax_total - raw_discount_total - raw_discount_tax_total - raw_gift_card_total - raw_gift_card_tax_total - raw_shipping_total - raw_shipping_subtotal - raw_shipping_tax_total - raw_original_shipping_total - raw_original_shipping_subtotal - raw_original_shipping_tax_total properties: order_change: $ref: '#/components/schemas/OrderChange' items: type: array description: The order preview's items. items: allOf: - type: object description: The item's items. x-schemaName: OrderLineItem required: - id - title - requires_shipping - is_discountable - is_tax_inclusive - unit_price - raw_unit_price - quantity - raw_quantity - detail - created_at - updated_at - original_total - original_subtotal - original_tax_total - item_total - item_subtotal - item_tax_total - total - subtotal - tax_total - discount_total - discount_tax_total - refundable_total - refundable_total_per_unit - raw_original_total - raw_original_subtotal - raw_original_tax_total - raw_item_total - raw_item_subtotal - raw_item_tax_total - raw_total - raw_subtotal - raw_tax_total - raw_discount_total - raw_discount_tax_total - raw_refundable_total - raw_refundable_total_per_unit properties: id: type: string title: id description: The item's ID. title: type: string title: title description: The item's title. subtitle: type: string title: subtitle description: The item's subtitle. thumbnail: type: string title: thumbnail description: The item's thumbnail. variant_id: type: string title: variant_id description: The item's variant id. product_id: type: string title: product_id description: The item's product id. product_title: type: string title: product_title description: The item's product title. product_description: type: string title: product_description description: The item's product description. product_subtitle: type: string title: product_subtitle description: The item's product subtitle. product_type: type: string title: product_type description: The item's product type. product_collection: type: string title: product_collection description: The item's product collection. product_handle: type: string title: product_handle description: The item's product handle. variant_sku: type: string title: variant_sku description: The item's variant sku. variant_barcode: type: string title: variant_barcode description: The item's variant barcode. variant_title: type: string title: variant_title description: The item's variant title. variant_option_values: type: object description: The item's variant option values. requires_shipping: type: boolean title: requires_shipping description: The item's requires shipping. is_discountable: type: boolean title: is_discountable description: The item's is discountable. is_tax_inclusive: type: boolean title: is_tax_inclusive description: The item's is tax inclusive. compare_at_unit_price: type: number title: compare_at_unit_price description: The item's compare at unit price. raw_compare_at_unit_price: type: object description: The item's raw compare at unit price. unit_price: type: number title: unit_price description: The item's unit price. raw_unit_price: type: object description: The item's raw unit price. quantity: type: number title: quantity description: The item's quantity. raw_quantity: type: object description: The item's raw quantity. tax_lines: type: array description: The item's tax lines. items: $ref: '#/components/schemas/OrderLineItemTaxLine' adjustments: type: array description: The item's adjustments. items: $ref: '#/components/schemas/OrderLineItemAdjustment' detail: $ref: '#/components/schemas/OrderItem' created_at: type: string title: created_at description: The item's created at. format: date-time updated_at: type: string title: updated_at description: The item's updated at. format: date-time metadata: type: object description: The item's metadata. original_total: oneOf: - type: string title: original_total description: The item's original total. - type: number title: original_total description: The item's original total. - type: string title: original_total description: The item's original total. - $ref: '#/components/schemas/IBigNumber' original_subtotal: oneOf: - type: string title: original_subtotal description: The item's original subtotal. - type: number title: original_subtotal description: The item's original subtotal. - type: string title: original_subtotal description: The item's original subtotal. - $ref: '#/components/schemas/IBigNumber' original_tax_total: oneOf: - type: string title: original_tax_total description: The item's original tax total. - type: number title: original_tax_total description: The item's original tax total. - type: string title: original_tax_total description: The item's original tax total. - $ref: '#/components/schemas/IBigNumber' item_total: oneOf: - type: string title: item_total description: The item's item total. - type: number title: item_total description: The item's item total. - type: string title: item_total description: The item's item total. - $ref: '#/components/schemas/IBigNumber' item_subtotal: oneOf: - type: string title: item_subtotal description: The item's item subtotal. - type: number title: item_subtotal description: The item's item subtotal. - type: string title: item_subtotal description: The item's item subtotal. - $ref: '#/components/schemas/IBigNumber' item_tax_total: oneOf: - type: string title: item_tax_total description: The item's item tax total. - type: number title: item_tax_total description: The item's item tax total. - type: string title: item_tax_total description: The item's item tax total. - $ref: '#/components/schemas/IBigNumber' total: oneOf: - type: string title: total description: The item's total. - type: number title: total description: The item's total. - type: string title: total description: The item's total. - $ref: '#/components/schemas/IBigNumber' subtotal: oneOf: - type: string title: subtotal description: The item's subtotal. - type: number title: subtotal description: The item's subtotal. - type: string title: subtotal description: The item's subtotal. - $ref: '#/components/schemas/IBigNumber' tax_total: oneOf: - type: string title: tax_total description: The item's tax total. - type: number title: tax_total description: The item's tax total. - type: string title: tax_total description: The item's tax total. - $ref: '#/components/schemas/IBigNumber' discount_total: oneOf: - type: string title: discount_total description: The item's discount total. - type: number title: discount_total description: The item's discount total. - type: string title: discount_total description: The item's discount total. - $ref: '#/components/schemas/IBigNumber' discount_tax_total: oneOf: - type: string title: discount_tax_total description: The item's discount tax total. - type: number title: discount_tax_total description: The item's discount tax total. - type: string title: discount_tax_total description: The item's discount tax total. - $ref: '#/components/schemas/IBigNumber' refundable_total: oneOf: - type: string title: refundable_total description: The item's refundable total. - type: number title: refundable_total description: The item's refundable total. - type: string title: refundable_total description: The item's refundable total. - $ref: '#/components/schemas/IBigNumber' refundable_total_per_unit: oneOf: - type: string title: refundable_total_per_unit description: The item's refundable total per unit. - type: number title: refundable_total_per_unit description: The item's refundable total per unit. - type: string title: refundable_total_per_unit description: The item's refundable total per unit. - $ref: '#/components/schemas/IBigNumber' raw_original_total: type: object description: The item's raw original total. raw_original_subtotal: type: object description: The item's raw original subtotal. raw_original_tax_total: type: object description: The item's raw original tax total. raw_item_total: type: object description: The item's raw item total. raw_item_subtotal: type: object description: The item's raw item subtotal. raw_item_tax_total: type: object description: The item's raw item tax total. raw_total: type: object description: The item's raw total. raw_subtotal: type: object description: The item's raw subtotal. raw_tax_total: type: object description: The item's raw tax total. raw_discount_total: type: object description: The item's raw discount total. raw_discount_tax_total: type: object description: The item's raw discount tax total. raw_refundable_total: type: object description: The item's raw refundable total. raw_refundable_total_per_unit: type: object description: The item's raw refundable total per unit. - type: object description: The item's items. properties: actions: type: array description: The item's actions. items: type: object description: The action's actions. x-schemaName: OrderChangeAction shipping_methods: type: array description: The order preview's shipping methods. items: allOf: - type: object description: The shipping method's shipping methods. x-schemaName: OrderShippingMethod required: - id - order_id - name - amount - raw_amount - is_tax_inclusive - created_at - updated_at - original_total - original_subtotal - original_tax_total - total - subtotal - tax_total - discount_total - discount_tax_total - raw_original_total - raw_original_subtotal - raw_original_tax_total - raw_total - raw_subtotal - raw_tax_total - raw_discount_total - raw_discount_tax_total properties: id: type: string title: id description: The shipping method's ID. order_id: type: string title: order_id description: The shipping method's order id. name: type: string title: name description: The shipping method's name. description: type: string title: description description: The shipping method's description. amount: oneOf: - type: string title: amount description: The shipping method's amount. - type: number title: amount description: The shipping method's amount. - type: string title: amount description: The shipping method's amount. - $ref: '#/components/schemas/IBigNumber' raw_amount: type: object description: The shipping method's raw amount. is_tax_inclusive: type: boolean title: is_tax_inclusive description: The shipping method's is tax inclusive. shipping_option_id: type: string title: shipping_option_id description: The shipping method's shipping option id. data: type: object description: The shipping method's data. metadata: type: object description: The shipping method's metadata. tax_lines: type: array description: The shipping method's tax lines. items: $ref: '#/components/schemas/OrderShippingMethodTaxLine' adjustments: type: array description: The shipping method's adjustments. items: $ref: '#/components/schemas/OrderShippingMethodAdjustment' created_at: type: string format: date-time title: created_at description: The shipping method's created at. updated_at: type: string format: date-time title: updated_at description: The shipping method's updated at. original_total: oneOf: - type: string title: original_total description: The shipping method's original total. - type: number title: original_total description: The shipping method's original total. - type: string title: original_total description: The shipping method's original total. - $ref: '#/components/schemas/IBigNumber' original_subtotal: oneOf: - type: string title: original_subtotal description: The shipping method's original subtotal. - type: number title: original_subtotal description: The shipping method's original subtotal. - type: string title: original_subtotal description: The shipping method's original subtotal. - $ref: '#/components/schemas/IBigNumber' original_tax_total: oneOf: - type: string title: original_tax_total description: The shipping method's original tax total. - type: number title: original_tax_total description: The shipping method's original tax total. - type: string title: original_tax_total description: The shipping method's original tax total. - $ref: '#/components/schemas/IBigNumber' total: oneOf: - type: string title: total description: The shipping method's total. - type: number title: total description: The shipping method's total. - type: string title: total description: The shipping method's total. - $ref: '#/components/schemas/IBigNumber' subtotal: oneOf: - type: string title: subtotal description: The shipping method's subtotal. - type: number title: subtotal description: The shipping method's subtotal. - type: string title: subtotal description: The shipping method's subtotal. - $ref: '#/components/schemas/IBigNumber' tax_total: oneOf: - type: string title: tax_total description: The shipping method's tax total. - type: number title: tax_total description: The shipping method's tax total. - type: string title: tax_total description: The shipping method's tax total. - $ref: '#/components/schemas/IBigNumber' discount_total: oneOf: - type: string title: discount_total description: The shipping method's discount total. - type: number title: discount_total description: The shipping method's discount total. - type: string title: discount_total description: The shipping method's discount total. - $ref: '#/components/schemas/IBigNumber' discount_tax_total: oneOf: - type: string title: discount_tax_total description: The shipping method's discount tax total. - type: number title: discount_tax_total description: The shipping method's discount tax total. - type: string title: discount_tax_total description: The shipping method's discount tax total. - $ref: '#/components/schemas/IBigNumber' raw_original_total: type: object description: The shipping method's raw original total. raw_original_subtotal: type: object description: The shipping method's raw original subtotal. raw_original_tax_total: type: object description: The shipping method's raw original tax total. raw_total: type: object description: The shipping method's raw total. raw_subtotal: type: object description: The shipping method's raw subtotal. raw_tax_total: type: object description: The shipping method's raw tax total. raw_discount_total: type: object description: The shipping method's raw discount total. raw_discount_tax_total: type: object description: The shipping method's raw discount tax total. - type: object description: The shipping method's shipping methods. properties: actions: type: array description: The shipping method's actions. items: type: object description: The action's actions. x-schemaName: OrderChangeAction status: type: string enum: - canceled - requires_action - pending - completed - draft - archived currency_code: type: string title: currency_code description: The order preview's currency code. id: type: string title: id description: The order preview's ID. version: type: number title: version description: The order preview's version. region_id: type: string title: region_id description: The order preview's region id. customer_id: type: string title: customer_id description: The order preview's customer id. sales_channel_id: type: string title: sales_channel_id description: The order preview's sales channel id. email: type: string title: email description: The order preview's email. format: email shipping_address: $ref: '#/components/schemas/OrderAddress' billing_address: $ref: '#/components/schemas/OrderAddress' transactions: type: array description: The order preview's transactions. items: $ref: '#/components/schemas/OrderTransaction' summary: type: object description: The order preview's summary. required: - total - subtotal - total_tax - ordered_total - fulfilled_total - returned_total - return_request_total - write_off_total - projected_total - net_total - net_subtotal - net_total_tax - balance - paid_total - refunded_total properties: total: oneOf: - type: string title: total description: The summary's total. - type: number title: total description: The summary's total. - type: string title: total description: The summary's total. - type: object description: The summary's total. x-schemaName: IBigNumber subtotal: oneOf: - type: string title: subtotal description: The summary's subtotal. - type: number title: subtotal description: The summary's subtotal. - type: string title: subtotal description: The summary's subtotal. - type: object description: The summary's subtotal. x-schemaName: IBigNumber total_tax: oneOf: - type: string title: total_tax description: The summary's total tax. - type: number title: total_tax description: The summary's total tax. - type: string title: total_tax description: The summary's total tax. - type: object description: The summary's total tax. x-schemaName: IBigNumber ordered_total: oneOf: - type: string title: ordered_total description: The summary's ordered total. - type: number title: ordered_total description: The summary's ordered total. - type: string title: ordered_total description: The summary's ordered total. - type: object description: The summary's ordered total. x-schemaName: IBigNumber fulfilled_total: oneOf: - type: string title: fulfilled_total description: The summary's fulfilled total. - type: number title: fulfilled_total description: The summary's fulfilled total. - type: string title: fulfilled_total description: The summary's fulfilled total. - type: object description: The summary's fulfilled total. x-schemaName: IBigNumber returned_total: oneOf: - type: string title: returned_total description: The summary's returned total. - type: number title: returned_total description: The summary's returned total. - type: string title: returned_total description: The summary's returned total. - type: object description: The summary's returned total. x-schemaName: IBigNumber return_request_total: oneOf: - type: string title: return_request_total description: The summary's return request total. - type: number title: return_request_total description: The summary's return request total. - type: string title: return_request_total description: The summary's return request total. - type: object description: The summary's return request total. x-schemaName: IBigNumber write_off_total: oneOf: - type: string title: write_off_total description: The summary's write off total. - type: number title: write_off_total description: The summary's write off total. - type: string title: write_off_total description: The summary's write off total. - type: object description: The summary's write off total. x-schemaName: IBigNumber projected_total: oneOf: - type: string title: projected_total description: The summary's projected total. - type: number title: projected_total description: The summary's projected total. - type: string title: projected_total description: The summary's projected total. - type: object description: The summary's projected total. x-schemaName: IBigNumber net_total: oneOf: - type: string title: net_total description: The summary's net total. - type: number title: net_total description: The summary's net total. - type: string title: net_total description: The summary's net total. - type: object description: The summary's net total. x-schemaName: IBigNumber net_subtotal: oneOf: - type: string title: net_subtotal description: The summary's net subtotal. - type: number title: net_subtotal description: The summary's net subtotal. - type: string title: net_subtotal description: The summary's net subtotal. - type: object description: The summary's net subtotal. x-schemaName: IBigNumber net_total_tax: oneOf: - type: string title: net_total_tax description: The summary's net total tax. - type: number title: net_total_tax description: The summary's net total tax. - type: string title: net_total_tax description: The summary's net total tax. - type: object description: The summary's net total tax. x-schemaName: IBigNumber balance: oneOf: - type: string title: balance description: The summary's balance. - type: number title: balance description: The summary's balance. - type: string title: balance description: The summary's balance. - type: object description: The summary's balance. x-schemaName: IBigNumber paid_total: oneOf: - type: string title: paid_total description: The summary's paid total. - type: number title: paid_total description: The summary's paid total. - type: string title: paid_total description: The summary's paid total. - type: object description: The summary's paid total. x-schemaName: IBigNumber refunded_total: oneOf: - type: string title: refunded_total description: The summary's refunded total. - type: number title: refunded_total description: The summary's refunded total. - type: string title: refunded_total description: The summary's refunded total. - type: object description: The summary's refunded total. x-schemaName: IBigNumber metadata: type: object description: The order preview's metadata. created_at: type: string format: date-time title: created_at description: The order preview's created at. updated_at: type: string format: date-time title: updated_at description: The order preview's updated at. original_item_total: oneOf: - type: string title: original_item_total description: The order preview's original item total. - type: number title: original_item_total description: The order preview's original item total. - type: string title: original_item_total description: The order preview's original item total. - $ref: '#/components/schemas/IBigNumber' original_item_subtotal: oneOf: - type: string title: original_item_subtotal description: The order preview's original item subtotal. - type: number title: original_item_subtotal description: The order preview's original item subtotal. - type: string title: original_item_subtotal description: The order preview's original item subtotal. - $ref: '#/components/schemas/IBigNumber' original_item_tax_total: oneOf: - type: string title: original_item_tax_total description: The order preview's original item tax total. - type: number title: original_item_tax_total description: The order preview's original item tax total. - type: string title: original_item_tax_total description: The order preview's original item tax total. - $ref: '#/components/schemas/IBigNumber' item_total: oneOf: - type: string title: item_total description: The order preview's item total. - type: number title: item_total description: The order preview's item total. - type: string title: item_total description: The order preview's item total. - $ref: '#/components/schemas/IBigNumber' item_subtotal: oneOf: - type: string title: item_subtotal description: The order preview's item subtotal. - type: number title: item_subtotal description: The order preview's item subtotal. - type: string title: item_subtotal description: The order preview's item subtotal. - $ref: '#/components/schemas/IBigNumber' item_tax_total: oneOf: - type: string title: item_tax_total description: The order preview's item tax total. - type: number title: item_tax_total description: The order preview's item tax total. - type: string title: item_tax_total description: The order preview's item tax total. - $ref: '#/components/schemas/IBigNumber' original_total: oneOf: - type: string title: original_total description: The order preview's original total. - type: number title: original_total description: The order preview's original total. - type: string title: original_total description: The order preview's original total. - $ref: '#/components/schemas/IBigNumber' original_subtotal: oneOf: - type: string title: original_subtotal description: The order preview's original subtotal. - type: number title: original_subtotal description: The order preview's original subtotal. - type: string title: original_subtotal description: The order preview's original subtotal. - $ref: '#/components/schemas/IBigNumber' original_tax_total: oneOf: - type: string title: original_tax_total description: The order preview's original tax total. - type: number title: original_tax_total description: The order preview's original tax total. - type: string title: original_tax_total description: The order preview's original tax total. - $ref: '#/components/schemas/IBigNumber' total: oneOf: - type: string title: total description: The order preview's total. - type: number title: total description: The order preview's total. - type: string title: total description: The order preview's total. - $ref: '#/components/schemas/IBigNumber' subtotal: oneOf: - type: string title: subtotal description: The order preview's subtotal. - type: number title: subtotal description: The order preview's subtotal. - type: string title: subtotal description: The order preview's subtotal. - $ref: '#/components/schemas/IBigNumber' tax_total: oneOf: - type: string title: tax_total description: The order preview's tax total. - type: number title: tax_total description: The order preview's tax total. - type: string title: tax_total description: The order preview's tax total. - $ref: '#/components/schemas/IBigNumber' discount_total: oneOf: - type: string title: discount_total description: The order preview's discount total. - type: number title: discount_total description: The order preview's discount total. - type: string title: discount_total description: The order preview's discount total. - $ref: '#/components/schemas/IBigNumber' discount_tax_total: oneOf: - type: string title: discount_tax_total description: The order preview's discount tax total. - type: number title: discount_tax_total description: The order preview's discount tax total. - type: string title: discount_tax_total description: The order preview's discount tax total. - $ref: '#/components/schemas/IBigNumber' gift_card_total: oneOf: - type: string title: gift_card_total description: The order preview's gift card total. - type: number title: gift_card_total description: The order preview's gift card total. - type: string title: gift_card_total description: The order preview's gift card total. - $ref: '#/components/schemas/IBigNumber' gift_card_tax_total: oneOf: - type: string title: gift_card_tax_total description: The order preview's gift card tax total. - type: number title: gift_card_tax_total description: The order preview's gift card tax total. - type: string title: gift_card_tax_total description: The order preview's gift card tax total. - $ref: '#/components/schemas/IBigNumber' shipping_total: oneOf: - type: string title: shipping_total description: The order preview's shipping total. - type: number title: shipping_total description: The order preview's shipping total. - type: string title: shipping_total description: The order preview's shipping total. - $ref: '#/components/schemas/IBigNumber' shipping_subtotal: oneOf: - type: string title: shipping_subtotal description: The order preview's shipping subtotal. - type: number title: shipping_subtotal description: The order preview's shipping subtotal. - type: string title: shipping_subtotal description: The order preview's shipping subtotal. - $ref: '#/components/schemas/IBigNumber' shipping_tax_total: oneOf: - type: string title: shipping_tax_total description: The order preview's shipping tax total. - type: number title: shipping_tax_total description: The order preview's shipping tax total. - type: string title: shipping_tax_total description: The order preview's shipping tax total. - $ref: '#/components/schemas/IBigNumber' original_shipping_total: oneOf: - type: string title: original_shipping_total description: The order preview's original shipping total. - type: number title: original_shipping_total description: The order preview's original shipping total. - type: string title: original_shipping_total description: The order preview's original shipping total. - $ref: '#/components/schemas/IBigNumber' original_shipping_subtotal: oneOf: - type: string title: original_shipping_subtotal description: The order preview's original shipping subtotal. - type: number title: original_shipping_subtotal description: The order preview's original shipping subtotal. - type: string title: original_shipping_subtotal description: The order preview's original shipping subtotal. - $ref: '#/components/schemas/IBigNumber' original_shipping_tax_total: oneOf: - type: string title: original_shipping_tax_total description: The order preview's original shipping tax total. - type: number title: original_shipping_tax_total description: The order preview's original shipping tax total. - type: string title: original_shipping_tax_total description: The order preview's original shipping tax total. - $ref: '#/components/schemas/IBigNumber' canceled_at: oneOf: - type: string title: canceled_at description: The order preview's canceled at. - type: string title: canceled_at description: The order preview's canceled at. format: date-time raw_original_item_total: type: object description: The order preview's raw original item total. required: - value properties: value: oneOf: - type: string title: value description: The raw original item total's value. - type: number title: value description: The raw original item total's value. raw_original_item_subtotal: type: object description: The order preview's raw original item subtotal. required: - value properties: value: oneOf: - type: string title: value description: The raw original item subtotal's value. - type: number title: value description: The raw original item subtotal's value. raw_original_item_tax_total: type: object description: The order preview's raw original item tax total. required: - value properties: value: oneOf: - type: string title: value description: The raw original item tax total's value. - type: number title: value description: The raw original item tax total's value. raw_item_total: type: object description: The order preview's raw item total. required: - value properties: value: oneOf: - type: string title: value description: The raw item total's value. - type: number title: value description: The raw item total's value. raw_item_subtotal: type: object description: The order preview's raw item subtotal. required: - value properties: value: oneOf: - type: string title: value description: The raw item subtotal's value. - type: number title: value description: The raw item subtotal's value. raw_item_tax_total: type: object description: The order preview's raw item tax total. required: - value properties: value: oneOf: - type: string title: value description: The raw item tax total's value. - type: number title: value description: The raw item tax total's value. raw_original_total: type: object description: The order preview's raw original total. required: - value properties: value: oneOf: - type: string title: value description: The raw original total's value. - type: number title: value description: The raw original total's value. raw_original_subtotal: type: object description: The order preview's raw original subtotal. required: - value properties: value: oneOf: - type: string title: value description: The raw original subtotal's value. - type: number title: value description: The raw original subtotal's value. raw_original_tax_total: type: object description: The order preview's raw original tax total. required: - value properties: value: oneOf: - type: string title: value description: The raw original tax total's value. - type: number title: value description: The raw original tax total's value. raw_total: type: object description: The order preview's raw total. required: - value properties: value: oneOf: - type: string title: value description: The raw total's value. - type: number title: value description: The raw total's value. raw_subtotal: type: object description: The order preview's raw subtotal. required: - value properties: value: oneOf: - type: string title: value description: The raw subtotal's value. - type: number title: value description: The raw subtotal's value. raw_tax_total: type: object description: The order preview's raw tax total. required: - value properties: value: oneOf: - type: string title: value description: The raw tax total's value. - type: number title: value description: The raw tax total's value. raw_discount_total: type: object description: The order preview's raw discount total. required: - value properties: value: oneOf: - type: string title: value description: The raw discount total's value. - type: number title: value description: The raw discount total's value. raw_discount_tax_total: type: object description: The order preview's raw discount tax total. required: - value properties: value: oneOf: - type: string title: value description: The raw discount tax total's value. - type: number title: value description: The raw discount tax total's value. raw_gift_card_total: type: object description: The order preview's raw gift card total. required: - value properties: value: oneOf: - type: string title: value description: The raw gift card total's value. - type: number title: value description: The raw gift card total's value. raw_gift_card_tax_total: type: object description: The order preview's raw gift card tax total. required: - value properties: value: oneOf: - type: string title: value description: The raw gift card tax total's value. - type: number title: value description: The raw gift card tax total's value. raw_shipping_total: type: object description: The order preview's raw shipping total. required: - value properties: value: oneOf: - type: string title: value description: The raw shipping total's value. - type: number title: value description: The raw shipping total's value. raw_shipping_subtotal: type: object description: The order preview's raw shipping subtotal. required: - value properties: value: oneOf: - type: string title: value description: The raw shipping subtotal's value. - type: number title: value description: The raw shipping subtotal's value. raw_shipping_tax_total: type: object description: The order preview's raw shipping tax total. required: - value properties: value: oneOf: - type: string title: value description: The raw shipping tax total's value. - type: number title: value description: The raw shipping tax total's value. raw_original_shipping_total: type: object description: The order preview's raw original shipping total. required: - value properties: value: oneOf: - type: string title: value description: The raw original shipping total's value. - type: number title: value description: The raw original shipping total's value. raw_original_shipping_subtotal: type: object description: The order preview's raw original shipping subtotal. required: - value properties: value: oneOf: - type: string title: value description: The raw original shipping subtotal's value. - type: number title: value description: The raw original shipping subtotal's value. raw_original_shipping_tax_total: type: object description: The order preview's raw original shipping tax total. required: - value properties: value: oneOf: - type: string title: value description: The raw original shipping tax total's value. - type: number title: value description: The raw original shipping tax total's value. OrderShippingMethodAdjustment: type: object description: The adjustment's adjustments. x-schemaName: OrderShippingMethodAdjustment OrderShippingMethodTaxLine: type: object description: The tax line's tax lines. x-schemaName: OrderShippingMethodTaxLine OrderTransaction: type: object description: The transaction's transactions. x-schemaName: OrderTransaction required: - id - order_id - order - amount - raw_amount - currency_code - reference - reference_id - created_at - updated_at - metadata properties: id: type: string title: id description: The transaction's ID. order_id: type: string title: order_id description: The transaction's order id. order: type: object amount: oneOf: - type: string title: amount description: The transaction's amount. - type: number title: amount description: The transaction's amount. - type: string title: amount description: The transaction's amount. - $ref: '#/components/schemas/IBigNumber' raw_amount: type: object description: The transaction's raw amount. currency_code: type: string title: currency_code description: The transaction's currency code. reference: type: string title: reference description: The transaction's reference. reference_id: type: string title: reference_id description: The transaction's reference id. created_at: type: string format: date-time title: created_at description: The transaction's created at. updated_at: type: string format: date-time title: updated_at description: The transaction's updated at. metadata: type: object description: The transaction's metadata. RefundReasonResponse: type: object description: SUMMARY x-schemaName: RefundReasonResponse required: - refund_reason properties: refund_reason: $ref: '#/components/schemas/AdminRefundReason' ReservationResponse: type: object description: The reservation's details. x-schemaName: ReservationResponse required: - id - line_item_id - location_id - quantity - external_id - description - inventory_item_id - inventory_item properties: id: type: string title: id description: The reservation's ID. line_item_id: type: string title: line_item_id description: The reservation's line item id. location_id: type: string title: location_id description: The reservation's location id. quantity: type: string title: quantity description: The reservation's quantity. external_id: type: string title: external_id description: The reservation's external id. description: type: string title: description description: The reservation's description. inventory_item_id: type: string title: inventory_item_id description: The reservation's inventory item id. inventory_item: type: object description: The reservation's inventory item. metadata: type: object description: The reservation's metadata. created_by: type: string title: created_by description: The reservation's created by. deleted_at: type: string format: date-time title: deleted_at description: The reservation's deleted at. created_at: type: string format: date-time title: created_at description: The reservation's created at. updated_at: type: string format: date-time title: updated_at description: The reservation's updated at. Return: type: object description: The order change's return order. x-schemaName: Return StoreAddCartLineItem: type: object description: SUMMARY x-schemaName: StoreAddCartLineItem required: - variant_id - quantity - metadata properties: variant_id: type: string title: variant_id description: The cart's variant id. quantity: type: number title: quantity description: The cart's quantity. metadata: type: object description: The cart's metadata. StoreCalculateCartTaxes: type: object description: SUMMARY x-schemaName: StoreCalculateCartTaxes properties: fields: type: string title: fields description: The cart's fields. StoreCart: type: object description: The cart's details. x-schemaName: StoreCart required: - id - currency_code - original_item_total - original_item_subtotal - original_item_tax_total - item_total - item_subtotal - item_tax_total - original_total - original_subtotal - original_tax_total - total - subtotal - tax_total - discount_total - discount_tax_total - gift_card_total - gift_card_tax_total - shipping_total - shipping_subtotal - shipping_tax_total - original_shipping_total - original_shipping_subtotal - original_shipping_tax_total properties: id: type: string title: id description: The cart's ID. region: $ref: '#/components/schemas/BaseRegion' region_id: type: string title: region_id description: The cart's region id. customer_id: type: string title: customer_id description: The cart's customer id. sales_channel_id: type: string title: sales_channel_id description: The cart's sales channel id. email: type: string title: email description: The cart's email. format: email currency_code: type: string title: currency_code description: The cart's currency code. shipping_address: $ref: '#/components/schemas/BaseCartAddress' billing_address: $ref: '#/components/schemas/BaseCartAddress' items: type: array description: The cart's items. items: $ref: '#/components/schemas/BaseCartLineItem' shipping_methods: type: array description: The cart's shipping methods. items: $ref: '#/components/schemas/BaseCartShippingMethod' payment_collection: $ref: '#/components/schemas/BasePaymentCollection' metadata: type: object description: The cart's metadata. created_at: type: string format: date-time title: created_at description: The cart's created at. updated_at: type: string format: date-time title: updated_at description: The cart's updated at. original_item_total: oneOf: - type: string title: original_item_total description: The cart's original item total. - type: number title: original_item_total description: The cart's original item total. - type: string title: original_item_total description: The cart's original item total. - $ref: '#/components/schemas/IBigNumber' original_item_subtotal: oneOf: - type: string title: original_item_subtotal description: The cart's original item subtotal. - type: number title: original_item_subtotal description: The cart's original item subtotal. - type: string title: original_item_subtotal description: The cart's original item subtotal. - $ref: '#/components/schemas/IBigNumber' original_item_tax_total: oneOf: - type: string title: original_item_tax_total description: The cart's original item tax total. - type: number title: original_item_tax_total description: The cart's original item tax total. - type: string title: original_item_tax_total description: The cart's original item tax total. - $ref: '#/components/schemas/IBigNumber' item_total: oneOf: - type: string title: item_total description: The cart's item total. - type: number title: item_total description: The cart's item total. - type: string title: item_total description: The cart's item total. - $ref: '#/components/schemas/IBigNumber' item_subtotal: oneOf: - type: string title: item_subtotal description: The cart's item subtotal. - type: number title: item_subtotal description: The cart's item subtotal. - type: string title: item_subtotal description: The cart's item subtotal. - $ref: '#/components/schemas/IBigNumber' item_tax_total: oneOf: - type: string title: item_tax_total description: The cart's item tax total. - type: number title: item_tax_total description: The cart's item tax total. - type: string title: item_tax_total description: The cart's item tax total. - $ref: '#/components/schemas/IBigNumber' original_total: oneOf: - type: string title: original_total description: The cart's original total. - type: number title: original_total description: The cart's original total. - type: string title: original_total description: The cart's original total. - $ref: '#/components/schemas/IBigNumber' original_subtotal: oneOf: - type: string title: original_subtotal description: The cart's original subtotal. - type: number title: original_subtotal description: The cart's original subtotal. - type: string title: original_subtotal description: The cart's original subtotal. - $ref: '#/components/schemas/IBigNumber' original_tax_total: oneOf: - type: string title: original_tax_total description: The cart's original tax total. - type: number title: original_tax_total description: The cart's original tax total. - type: string title: original_tax_total description: The cart's original tax total. - $ref: '#/components/schemas/IBigNumber' total: oneOf: - type: string title: total description: The cart's total. - type: number title: total description: The cart's total. - type: string title: total description: The cart's total. - $ref: '#/components/schemas/IBigNumber' subtotal: oneOf: - type: string title: subtotal description: The cart's subtotal. - type: number title: subtotal description: The cart's subtotal. - type: string title: subtotal description: The cart's subtotal. - $ref: '#/components/schemas/IBigNumber' tax_total: oneOf: - type: string title: tax_total description: The cart's tax total. - type: number title: tax_total description: The cart's tax total. - type: string title: tax_total description: The cart's tax total. - $ref: '#/components/schemas/IBigNumber' discount_total: oneOf: - type: string title: discount_total description: The cart's discount total. - type: number title: discount_total description: The cart's discount total. - type: string title: discount_total description: The cart's discount total. - $ref: '#/components/schemas/IBigNumber' discount_tax_total: oneOf: - type: string title: discount_tax_total description: The cart's discount tax total. - type: number title: discount_tax_total description: The cart's discount tax total. - type: string title: discount_tax_total description: The cart's discount tax total. - $ref: '#/components/schemas/IBigNumber' gift_card_total: oneOf: - type: string title: gift_card_total description: The cart's gift card total. - type: number title: gift_card_total description: The cart's gift card total. - type: string title: gift_card_total description: The cart's gift card total. - $ref: '#/components/schemas/IBigNumber' gift_card_tax_total: oneOf: - type: string title: gift_card_tax_total description: The cart's gift card tax total. - type: number title: gift_card_tax_total description: The cart's gift card tax total. - type: string title: gift_card_tax_total description: The cart's gift card tax total. - $ref: '#/components/schemas/IBigNumber' shipping_total: oneOf: - type: string title: shipping_total description: The cart's shipping total. - type: number title: shipping_total description: The cart's shipping total. - type: string title: shipping_total description: The cart's shipping total. - $ref: '#/components/schemas/IBigNumber' shipping_subtotal: oneOf: - type: string title: shipping_subtotal description: The cart's shipping subtotal. - type: number title: shipping_subtotal description: The cart's shipping subtotal. - type: string title: shipping_subtotal description: The cart's shipping subtotal. - $ref: '#/components/schemas/IBigNumber' shipping_tax_total: oneOf: - type: string title: shipping_tax_total description: The cart's shipping tax total. - type: number title: shipping_tax_total description: The cart's shipping tax total. - type: string title: shipping_tax_total description: The cart's shipping tax total. - $ref: '#/components/schemas/IBigNumber' original_shipping_total: oneOf: - type: string title: original_shipping_total description: The cart's original shipping total. - type: number title: original_shipping_total description: The cart's original shipping total. - type: string title: original_shipping_total description: The cart's original shipping total. - $ref: '#/components/schemas/IBigNumber' original_shipping_subtotal: oneOf: - type: string title: original_shipping_subtotal description: The cart's original shipping subtotal. - type: number title: original_shipping_subtotal description: The cart's original shipping subtotal. - type: string title: original_shipping_subtotal description: The cart's original shipping subtotal. - $ref: '#/components/schemas/IBigNumber' original_shipping_tax_total: oneOf: - type: string title: original_shipping_tax_total description: The cart's original shipping tax total. - type: number title: original_shipping_tax_total description: The cart's original shipping tax total. - type: string title: original_shipping_tax_total description: The cart's original shipping tax total. - $ref: '#/components/schemas/IBigNumber' StoreCartResponse: type: object description: SUMMARY x-schemaName: StoreCartResponse required: - cart properties: cart: $ref: '#/components/schemas/StoreCart' StoreCollection: type: object description: The collection's details. x-schemaName: StoreCollection required: - id - title - handle - created_at - updated_at - deleted_at - metadata properties: id: type: string title: id description: The collection's ID. title: type: string title: title description: The collection's title. handle: type: string title: handle description: The collection's handle. created_at: type: string format: date-time title: created_at description: The collection's created at. updated_at: type: string format: date-time title: updated_at description: The collection's updated at. deleted_at: type: string format: date-time title: deleted_at description: The collection's deleted at. products: type: array description: The collection's products. items: $ref: '#/components/schemas/AdminProduct' metadata: type: object description: The collection's metadata. StoreCollectionResponse: type: object description: SUMMARY x-schemaName: StoreCollectionResponse required: - collection properties: collection: $ref: '#/components/schemas/StoreCollection' StoreCreateCustomer: type: object description: SUMMARY x-schemaName: StoreCreateCustomer required: - email - company_name - first_name - last_name - phone properties: email: type: string title: email description: The customer's email. format: email company_name: type: string title: company_name description: The customer's company name. first_name: type: string title: first_name description: The customer's first name. last_name: type: string title: last_name description: The customer's last name. phone: type: string title: phone description: The customer's phone. StoreCurrency: type: object description: The currency's details. x-schemaName: StoreCurrency required: - code - symbol - symbol_native - name - decimal_digits - rounding - raw_rounding - created_at - updated_at - deleted_at properties: code: type: string title: code description: The currency's code. symbol: type: string title: symbol description: The currency's symbol. symbol_native: type: string title: symbol_native description: The currency's symbol native. name: type: string title: name description: The currency's name. decimal_digits: type: number title: decimal_digits description: The currency's decimal digits. rounding: type: number title: rounding description: The currency's rounding. raw_rounding: type: object description: The currency's raw rounding. required: - value - precision properties: value: type: string title: value description: The raw rounding's value. precision: type: number title: precision description: The raw rounding's precision. created_at: type: string format: date-time title: created_at description: The currency's created at. updated_at: type: string format: date-time title: updated_at description: The currency's updated at. deleted_at: type: string format: date-time title: deleted_at description: The currency's deleted at. StoreCurrencyListResponse: type: object description: SUMMARY x-schemaName: StoreCurrencyListResponse required: - limit - offset - count - currencies properties: limit: type: number title: limit description: The currency's limit. offset: type: number title: offset description: The currency's offset. count: type: number title: count description: The currency's count. currencies: type: array description: The currency's currencies. items: $ref: '#/components/schemas/StoreCurrency' StoreCurrencyResponse: type: object description: SUMMARY x-schemaName: StoreCurrencyResponse required: - currency properties: currency: $ref: '#/components/schemas/StoreCurrency' StoreCustomer: type: object description: The customer's details. x-schemaName: StoreCustomer required: - id - email - default_billing_address_id - default_shipping_address_id - company_name - first_name - last_name - addresses properties: id: type: string title: id description: The customer's ID. email: type: string title: email description: The customer's email. format: email default_billing_address_id: type: string title: default_billing_address_id description: The customer's default billing address id. default_shipping_address_id: type: string title: default_shipping_address_id description: The customer's default shipping address id. company_name: type: string title: company_name description: The customer's company name. first_name: type: string title: first_name description: The customer's first name. last_name: type: string title: last_name description: The customer's last name. addresses: type: array description: The customer's addresses. items: $ref: '#/components/schemas/BaseCustomerAddress' phone: type: string title: phone description: The customer's phone. metadata: type: object description: The customer's metadata. created_by: type: string title: created_by description: The customer's created by. deleted_at: type: string format: date-time title: deleted_at description: The customer's deleted at. created_at: type: string format: date-time title: created_at description: The customer's created at. updated_at: type: string format: date-time title: updated_at description: The customer's updated at. StoreCustomerAddress: type: object description: The customer's address. x-schemaName: StoreCustomerAddress required: - id - address_name - is_default_shipping - is_default_billing - customer_id - company - first_name - last_name - address_1 - address_2 - city - country_code - province - postal_code - phone - metadata - created_at - updated_at properties: id: type: string title: id description: The address's ID. address_name: type: string title: address_name description: The address's address name. is_default_shipping: type: boolean title: is_default_shipping description: The address's is default shipping. is_default_billing: type: boolean title: is_default_billing description: The address's is default billing. customer_id: type: string title: customer_id description: The address's customer id. company: type: string title: company description: The address's company. first_name: type: string title: first_name description: The address's first name. last_name: type: string title: last_name description: The address's last name. address_1: type: string title: address_1 description: The address's address 1. address_2: type: string title: address_2 description: The address's address 2. city: type: string title: city description: The address's city. country_code: type: string title: country_code description: The address's country code. province: type: string title: province description: The address's province. postal_code: type: string title: postal_code description: The address's postal code. phone: type: string title: phone description: The address's phone. metadata: type: object description: The address's metadata. created_at: type: string format: date-time title: created_at description: The address's created at. updated_at: type: string format: date-time title: updated_at description: The address's updated at. StoreCustomerAddressListResponse: type: object description: SUMMARY x-schemaName: StoreCustomerAddressListResponse required: - limit - offset - count - addresses 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. addresses: type: array description: The customer's addresses. items: $ref: '#/components/schemas/StoreCustomerAddress' StoreCustomerAddressResponse: type: object description: SUMMARY x-schemaName: StoreCustomerAddressResponse required: - address properties: address: $ref: '#/components/schemas/StoreCustomerAddress' StoreCustomerResponse: type: object description: SUMMARY x-schemaName: StoreCustomerResponse required: - customer properties: customer: $ref: '#/components/schemas/StoreCustomer' StoreOrder: type: object description: The cart's order. x-schemaName: StoreOrder required: - id - version - region_id - customer_id - sales_channel_id - email - currency_code - items - shipping_methods - payment_status - fulfillment_status - summary - metadata - created_at - updated_at - original_item_total - original_item_subtotal - original_item_tax_total - item_total - item_subtotal - item_tax_total - original_total - original_subtotal - original_tax_total - total - subtotal - tax_total - discount_total - discount_tax_total - gift_card_total - gift_card_tax_total - shipping_total - shipping_subtotal - shipping_tax_total - original_shipping_total - original_shipping_subtotal - original_shipping_tax_total properties: id: type: string title: id description: The order's ID. version: type: number title: version description: The order's version. region_id: type: string title: region_id description: The order's region id. customer_id: type: string title: customer_id description: The order's customer id. sales_channel_id: type: string title: sales_channel_id description: The order's sales channel id. email: type: string title: email description: The order's email. format: email currency_code: type: string title: currency_code description: The order's currency code. display_id: type: string title: display_id description: The order's display id. shipping_address: $ref: '#/components/schemas/BaseOrderAddress' billing_address: $ref: '#/components/schemas/BaseOrderAddress' items: type: array description: The order's items. items: $ref: '#/components/schemas/BaseOrderLineItem' shipping_methods: type: array description: The order's shipping methods. items: $ref: '#/components/schemas/BaseOrderShippingMethod' payment_collections: type: array description: The order's payment collections. items: $ref: '#/components/schemas/BasePaymentCollection' payment_status: type: string enum: - canceled - not_paid - awaiting - authorized - partially_authorized - captured - partially_captured - partially_refunded - refunded - requires_action fulfillments: type: array description: The order's fulfillments. items: $ref: '#/components/schemas/BaseOrderFulfillment' fulfillment_status: type: string enum: - canceled - not_fulfilled - partially_fulfilled - fulfilled - partially_shipped - shipped - partially_delivered - delivered transactions: type: array description: The order's transactions. items: $ref: '#/components/schemas/BaseOrderTransaction' summary: $ref: '#/components/schemas/BaseOrderSummary' metadata: type: object description: The order's metadata. created_at: type: string format: date-time title: created_at description: The order's created at. updated_at: type: string format: date-time title: updated_at description: The order's updated at. original_item_total: type: number title: original_item_total description: The order's original item total. original_item_subtotal: type: number title: original_item_subtotal description: The order's original item subtotal. original_item_tax_total: type: number title: original_item_tax_total description: The order's original item tax total. item_total: type: number title: item_total description: The order's item total. item_subtotal: type: number title: item_subtotal description: The order's item subtotal. item_tax_total: type: number title: item_tax_total description: The order's item tax total. original_total: type: number title: original_total description: The order's original total. original_subtotal: type: number title: original_subtotal description: The order's original subtotal. original_tax_total: type: number title: original_tax_total description: The order's original tax total. total: type: number title: total description: The order's total. subtotal: type: number title: subtotal description: The order's subtotal. tax_total: type: number title: tax_total description: The order's tax total. discount_total: type: number title: discount_total description: The order's discount total. discount_tax_total: type: number title: discount_tax_total description: The order's discount tax total. gift_card_total: type: number title: gift_card_total description: The order's gift card total. gift_card_tax_total: type: number title: gift_card_tax_total description: The order's gift card tax total. shipping_total: type: number title: shipping_total description: The order's shipping total. shipping_subtotal: type: number title: shipping_subtotal description: The order's shipping subtotal. shipping_tax_total: type: number title: shipping_tax_total description: The order's shipping tax total. original_shipping_total: type: number title: original_shipping_total description: The order's original shipping total. original_shipping_subtotal: type: number title: original_shipping_subtotal description: The order's original shipping subtotal. original_shipping_tax_total: type: number title: original_shipping_tax_total description: The order's original shipping tax total. StoreOrderResponse: type: object description: SUMMARY x-schemaName: StoreOrderResponse required: - order properties: order: $ref: '#/components/schemas/StoreOrder' StorePaymentCollection: type: object description: The payment collection's details. x-schemaName: StorePaymentCollection required: - id - currency_code - region_id - amount - status - payment_providers properties: id: type: string title: id description: The payment collection's ID. currency_code: type: string title: currency_code description: The payment collection's currency code. region_id: type: string title: region_id description: The payment collection's region id. amount: oneOf: - type: string title: amount description: The payment collection's amount. - type: number title: amount description: The payment collection's amount. - type: string title: amount description: The payment collection's amount. - $ref: '#/components/schemas/IBigNumber' authorized_amount: oneOf: - type: string title: authorized_amount description: The payment collection's authorized amount. - type: number title: authorized_amount description: The payment collection's authorized amount. - type: string title: authorized_amount description: The payment collection's authorized amount. - $ref: '#/components/schemas/IBigNumber' captured_amount: oneOf: - type: string title: captured_amount description: The payment collection's captured amount. - type: number title: captured_amount description: The payment collection's captured amount. - type: string title: captured_amount description: The payment collection's captured amount. - $ref: '#/components/schemas/IBigNumber' refunded_amount: oneOf: - type: string title: refunded_amount description: The payment collection's refunded amount. - type: number title: refunded_amount description: The payment collection's refunded amount. - type: string title: refunded_amount description: The payment collection's refunded amount. - $ref: '#/components/schemas/IBigNumber' completed_at: oneOf: - type: string title: completed_at description: The payment collection's completed at. - type: string title: completed_at description: The payment collection's completed at. format: date-time created_at: type: string format: date-time title: created_at description: The payment collection's created at. updated_at: type: string format: date-time title: updated_at description: The payment collection's updated at. metadata: type: object description: The payment collection's metadata. status: type: string enum: - canceled - not_paid - awaiting - authorized - partially_authorized payment_providers: type: array description: The payment collection's payment providers. items: $ref: '#/components/schemas/BasePaymentProvider' payment_sessions: type: array description: The payment collection's payment sessions. items: $ref: '#/components/schemas/BasePaymentSession' payments: type: array description: The payment collection's payments. items: $ref: '#/components/schemas/BasePayment' StorePaymentCollectionResponse: type: object description: SUMMARY x-schemaName: StorePaymentCollectionResponse required: - payment_collection properties: payment_collection: $ref: '#/components/schemas/StorePaymentCollection' StorePaymentProvider: type: object description: The payment provider's payment providers. x-schemaName: StorePaymentProvider required: - id properties: id: type: string title: id description: The payment provider's ID. StorePostReturnsReqSchema: type: object description: SUMMARY x-schemaName: StorePostReturnsReqSchema required: - order_id - items - return_shipping - note - location_id properties: order_id: type: string title: order_id description: The return's order id. items: type: array description: The return's items. items: type: object description: The item's items. required: - id - quantity - reason_id - note properties: id: type: string title: id description: The item's ID. quantity: type: number title: quantity description: The item's quantity. reason_id: type: string title: reason_id description: The item's reason id. note: type: string title: note description: The item's note. return_shipping: type: object description: The return's return shipping. required: - option_id properties: option_id: type: string title: option_id description: The return shipping's option id. price: type: number title: price description: The return shipping's price. note: type: string title: note description: The return's note. receive_now: type: boolean title: receive_now description: The return's receive now. location_id: type: string title: location_id description: The return's location id. StoreProduct: type: object description: The product's details. x-schemaName: StoreProduct required: - title - status - length - options - description - id - created_at - updated_at - variants - handle - subtitle - is_giftcard - thumbnail - width - weight - height - origin_country - hs_code - mid_code - material - collection_id - type_id - images - discountable - external_id - deleted_at properties: categories: type: array description: The product's categories. items: type: object type: type: object title: type: string title: title description: The product's title. status: type: string enum: - draft - proposed - published - rejected length: type: number title: length description: The product's length. options: type: array description: The product's options. items: $ref: '#/components/schemas/BaseProductOption' description: type: string title: description description: The product's description. id: type: string title: id description: The product's ID. metadata: type: object description: The product's metadata. created_at: type: string format: date-time title: created_at description: The product's created at. updated_at: type: string format: date-time title: updated_at description: The product's updated at. variants: type: array description: The product's variants. items: $ref: '#/components/schemas/BaseProductVariant' handle: type: string title: handle description: The product's handle. subtitle: type: string title: subtitle description: The product's subtitle. is_giftcard: type: boolean title: is_giftcard description: The product's is giftcard. thumbnail: type: string title: thumbnail description: The product's thumbnail. width: type: number title: width description: The product's width. weight: type: number title: weight description: The product's weight. height: type: number title: height description: The product's height. origin_country: type: string title: origin_country description: The product's origin country. hs_code: type: string title: hs_code description: The product's hs code. mid_code: type: string title: mid_code description: The product's mid code. material: type: string title: material description: The product's material. collection: $ref: '#/components/schemas/BaseCollection' collection_id: type: string title: collection_id description: The product's collection id. type_id: type: string title: type_id description: The product's type id. tags: type: array description: The product's tags. items: $ref: '#/components/schemas/BaseProductTag' images: type: array description: The product's images. items: $ref: '#/components/schemas/BaseProductImage' discountable: type: boolean title: discountable description: The product's discountable. external_id: type: string title: external_id description: The product's external id. deleted_at: type: string format: date-time title: deleted_at description: The product's deleted at. StoreProductCategory: type: object description: The category's categories. x-schemaName: StoreProductCategory required: - id - name - description - handle - is_active - is_internal - rank - parent_category_id - parent_category - category_children - created_at - updated_at - deleted_at properties: products: type: array description: The category's products. items: $ref: '#/components/schemas/StoreProduct' id: type: string title: id description: The category's ID. name: type: string title: name description: The category's name. description: type: string title: description description: The category's description. handle: type: string title: handle description: The category's handle. is_active: type: boolean title: is_active description: The category's is active. is_internal: type: boolean title: is_internal description: The category's is internal. rank: type: number title: rank description: The category's rank. parent_category_id: type: string title: parent_category_id description: The category's parent category id. parent_category: $ref: '#/components/schemas/BaseProductCategory' category_children: type: array description: The category's category children. items: $ref: '#/components/schemas/BaseProductCategory' created_at: type: string format: date-time title: created_at description: The category's created at. updated_at: type: string format: date-time title: updated_at description: The category's updated at. deleted_at: type: string format: date-time title: deleted_at description: The category's deleted at. StoreProductCategoryListResponse: type: object description: SUMMARY x-schemaName: StoreProductCategoryListResponse required: - limit - offset - count - product_categories properties: limit: type: number title: limit description: The product category's limit. offset: type: number title: offset description: The product category's offset. count: type: number title: count description: The product category's count. product_categories: type: array description: The product category's product categories. items: $ref: '#/components/schemas/StoreProductCategory' StoreProductCategoryResponse: type: object description: SUMMARY x-schemaName: StoreProductCategoryResponse required: - product_category properties: product_category: $ref: '#/components/schemas/StoreProductCategory' StoreProductResponse: type: object description: SUMMARY x-schemaName: StoreProductResponse required: - product properties: product: $ref: '#/components/schemas/StoreProduct' StoreRegion: type: object description: The region's details. x-schemaName: StoreRegion required: - id - name - currency_code properties: id: type: string title: id description: The region's ID. name: type: string title: name description: The region's name. currency_code: type: string title: currency_code description: The region's currency code. automatic_taxes: type: boolean title: automatic_taxes description: The region's automatic taxes. countries: type: array description: The region's countries. items: $ref: '#/components/schemas/BaseRegionCountry' payment_providers: type: array description: The region's payment providers. items: $ref: '#/components/schemas/AdminPaymentProvider' metadata: type: object description: The region's metadata. created_at: type: string format: date-time title: created_at description: The region's created at. updated_at: type: string format: date-time title: updated_at description: The region's updated at. StoreReturn: type: object description: The return's details. x-schemaName: StoreReturn required: - id - order_id - order_version - display_id - items - received_at - created_at properties: id: type: string title: id description: The return's ID. order_id: type: string title: order_id description: The return's order id. status: type: string title: status description: The return's status. exchange_id: type: string title: exchange_id description: The return's exchange id. location_id: type: string title: location_id description: The return's location id. claim_id: type: string title: claim_id description: The return's claim id. order_version: type: number title: order_version description: The return's order version. display_id: type: number title: display_id description: The return's display id. no_notification: type: boolean title: no_notification description: The return's no notification. refund_amount: type: number title: refund_amount description: The return's refund amount. items: type: array description: The return's items. items: $ref: '#/components/schemas/BaseReturnItem' received_at: type: string title: received_at description: The return's received at. created_at: type: string format: date-time title: created_at description: The return's created at. StoreReturnReason: type: object description: The return reason's details. x-schemaName: StoreReturnReason required: - id - value - label - created_at - updated_at properties: id: type: string title: id description: The return reason's ID. value: type: string title: value description: The return reason's value. label: type: string title: label description: The return reason's label. description: type: string title: description description: The return reason's description. metadata: type: object description: The return reason's metadata. created_at: type: string format: date-time title: created_at description: The return reason's created at. updated_at: type: string format: date-time title: updated_at description: The return reason's updated at. StoreReturnReasonResponse: type: object description: SUMMARY x-schemaName: StoreReturnReasonResponse required: - return_reason properties: return_reason: $ref: '#/components/schemas/StoreReturnReason' StoreReturnResponse: type: object description: SUMMARY x-schemaName: StoreReturnResponse required: - return properties: return: $ref: '#/components/schemas/StoreReturn' StoreShippingOption: type: object description: The shipping option's shipping options. x-schemaName: StoreShippingOption required: - id - name - price_type - service_zone_id - provider_id - provider - shipping_option_type_id - type - shipping_profile_id - amount - is_tax_inclusive - data - metadata properties: id: type: string title: id description: The shipping option's ID. name: type: string title: name description: The shipping option's name. price_type: type: string enum: - flat - calculated service_zone_id: type: string title: service_zone_id description: The shipping option's service zone id. provider_id: type: string title: provider_id description: The shipping option's provider id. provider: $ref: '#/components/schemas/BaseFulfillmentProvider' shipping_option_type_id: type: string title: shipping_option_type_id description: The shipping option's shipping option type id. type: type: object shipping_profile_id: type: string title: shipping_profile_id description: The shipping option's shipping profile id. amount: type: number title: amount description: The shipping option's amount. is_tax_inclusive: type: boolean title: is_tax_inclusive description: The shipping option's is tax inclusive. data: type: object description: The shipping option's data. metadata: type: object description: The shipping option's metadata. StoreShippingOptionListResponse: type: object description: SUMMARY x-schemaName: StoreShippingOptionListResponse required: - shipping_options properties: shipping_options: type: array description: The shipping option's shipping options. items: $ref: '#/components/schemas/StoreShippingOption' StoreUpdateCartLineItem: type: object description: SUMMARY x-schemaName: StoreUpdateCartLineItem required: - quantity - metadata properties: quantity: type: number title: quantity description: The cart's quantity. metadata: type: object description: The cart's metadata. StoreUpdateCustomer: type: object description: SUMMARY x-schemaName: StoreUpdateCustomer required: - company_name - first_name - last_name - phone properties: company_name: type: string title: company_name description: The customer's company name. first_name: type: string title: first_name description: The customer's first name. last_name: type: string title: last_name description: The customer's last name. phone: type: string title: phone description: The customer's phone. UpdateAddress: type: object description: The cart's shipping address. x-schemaName: UpdateAddress required: - id properties: id: type: string title: id description: The shipping address's ID. customer_id: type: string title: customer_id description: The shipping address's customer id. company: type: string title: company description: The shipping address's company. first_name: type: string title: first_name description: The shipping address's first name. last_name: type: string title: last_name description: The shipping address's last name. address_1: type: string title: address_1 description: The shipping address's address 1. address_2: type: string title: address_2 description: The shipping address's address 2. city: type: string title: city description: The shipping address's city. country_code: type: string title: country_code description: The shipping address's country code. province: type: string title: province description: The shipping address's province. postal_code: type: string title: postal_code description: The shipping address's postal code. phone: type: string title: phone description: The shipping address's phone. metadata: type: object description: The shipping address's metadata. UpdateCartData: type: object description: SUMMARY x-schemaName: UpdateCartData properties: region_id: type: string title: region_id description: The cart's region id. customer_id: type: string title: customer_id description: The cart's customer id. sales_channel_id: type: string title: sales_channel_id description: The cart's sales channel id. email: type: string title: email description: The cart's email. format: email currency_code: type: string title: currency_code description: The cart's currency code. shipping_address_id: type: string title: shipping_address_id description: The cart's shipping address id. billing_address_id: type: string title: billing_address_id description: The cart's billing address id. billing_address: oneOf: - $ref: '#/components/schemas/CreateAddress' - $ref: '#/components/schemas/UpdateAddress' shipping_address: oneOf: - $ref: '#/components/schemas/CreateAddress' - $ref: '#/components/schemas/UpdateAddress' metadata: type: object description: The cart's metadata. UpdateOrderReturnReason: type: object description: SUMMARY x-schemaName: UpdateOrderReturnReason properties: id: type: string title: id description: The return reason's ID. label: type: string title: label description: The return reason's label. value: type: string title: value description: The return reason's value. description: type: string title: description description: The return reason's description. metadata: type: object description: The return reason's metadata. responses: default_error: description: Default Error content: application/json: schema: $ref: '#/components/schemas/Error' example: code: unknown_error message: An unknown error occurred. type: unknown_error invalid_state_error: description: Invalid State Error content: application/json: schema: $ref: '#/components/schemas/Error' example: code: unknown_error message: The request conflicted with another request. You may retry the request with the provided Idempotency-Key. type: QueryRunnerAlreadyReleasedError invalid_request_error: description: Invalid Request Error content: application/json: schema: $ref: '#/components/schemas/Error' example: code: invalid_request_error message: Discount with code TEST already exists. type: duplicate_error not_found_error: description: Not Found Error content: application/json: schema: $ref: '#/components/schemas/Error' example: message: Entity with id 1 was not found type: not_found 400_error: description: Client Error content: application/json: schema: $ref: '#/components/schemas/Error' examples: not_allowed: $ref: '#/components/examples/not_allowed_error' invalid_data: $ref: '#/components/examples/invalid_data_error' 500_error: description: Server Error content: application/json: schema: $ref: '#/components/schemas/Error' examples: database: $ref: '#/components/examples/database_error' unexpected_state: $ref: '#/components/examples/unexpected_state_error' invalid_argument: $ref: '#/components/examples/invalid_argument_error' default_error: $ref: '#/components/examples/default_error' unauthorized: description: User is not authorized. Must log in first content: text/plain: schema: type: string default: Unauthorized example: Unauthorized incorrect_credentials: description: User does not exist or incorrect credentials content: text/plain: schema: type: string default: Unauthorized example: Unauthorized examples: not_allowed_error: summary: Not Allowed Error value: message: Discount must be set to dynamic type: not_allowed invalid_data_error: summary: Invalid Data Error value: message: first_name must be a string type: invalid_data multiple_errors: summary: Multiple Errors value: message: Provided request body contains errors. Please check the data and retry the request errors: - message: first_name must be a string type: invalid_data - message: Discount must be set to dynamic type: not_allowed database_error: summary: Database Error value: code: api_error message: An error occured while hashing password type: database_error unexpected_state_error: summary: Unexpected State Error value: message: cart.total must be defined type: unexpected_state invalid_argument_error: summary: Invalid Argument Error value: message: cart.total must be defined type: unexpected_state default_error: summary: Default Error value: code: unknown_error message: An unknown error occurred. type: unknown_error securitySchemes: api_token: type: apiKey x-displayName: API Token in: header name: x-medusa-access-token jwt_token: type: http x-displayName: JWT Token scheme: bearer cookie_auth: type: apiKey in: cookie name: connect.sid x-displayName: Cookie Session ID