Files
medusa-store/www/apps/api-reference/specs/admin/openapi.full.yaml
github-actions[bot] cc3e84f081 chore(docs): Updated API Reference (v2) (#8686)
Automated changes by [create-pull-request](https://github.com/peter-evans/create-pull-request) GitHub action
2024-08-21 07:20:13 +00:00

59227 lines
2.1 MiB

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
- amount
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/payment-collections/{id}:
delete:
operationId: DeletePaymentCollectionsId
summary: Delete a Payment Collection
description: Delete a payment collection.
x-authenticated: true
parameters:
- name: id
in: path
description: The payment 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/payment-collections/{id}' \
-H 'x-medusa-access-token: {api_token}'
tags:
- Payment Collections
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
description: SUMMARY
required:
- id
- object
- deleted
properties:
id:
type: string
title: id
description: The payment collection's ID.
object:
type: string
title: object
description: The payment collection's object.
deleted:
type: boolean
title: deleted
description: The payment collection's deleted.
parent:
type: object
description: The payment collection'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/payment-collections/{id}/mark-as-paid:
post:
operationId: PostPaymentCollectionsIdMarkAsPaid
summary: Add Mark As Paids to Payment Collection
description: Add a list of mark as paids to a payment collection.
x-authenticated: true
parameters:
- name: id
in: path
description: The payment 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
required:
- order_id
properties:
order_id:
type: string
title: order_id
description: The payment collection's order id.
x-codeSamples:
- lang: Shell
label: cURL
source: |-
curl -X POST '{backend_url}/admin/payment-collections/{id}/mark-as-paid' \
-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'
/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'
fulfillments:
type: array
description: The order's fulfillments.
items:
$ref: '#/components/schemas/BaseOrderFulfillment'
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
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