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

47025 lines
1.8 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
- 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
- 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: Fulfillment Providers
x-associatedSchema:
$ref: '#/components/schemas/AdminFulfillmentProvider'
- name: Fulfillment Sets
x-associatedSchema:
$ref: '#/components/schemas/AdminFulfillmentSet'
- name: Fulfillments
- name: Inventory Items
- 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
- name: Notifications
- name: Orders
- name: Payments
- name: Price Lists
- name: Price Preferences
- name: Product Categories
x-associatedSchema:
$ref: '#/components/schemas/AdminProductCategory'
- name: Product Tags
x-associatedSchema:
$ref: '#/components/schemas/AdminProductTag'
- name: Product Types
- name: Products
x-associatedSchema:
$ref: '#/components/schemas/AdminProduct'
- name: Promotions
- 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
- name: Reservations
- name: Return Reasons
- name: Returns
- 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
- name: Stores
- name: Tax Rates
- name: Tax Regions
- name: Uploads
- name: Users
- 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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}:
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
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.
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
$ref: '#/components/schemas/AdminUpdateCampaign'
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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/{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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: 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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: 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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: 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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: 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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: 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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}/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
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}:
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
$ref: '#/components/schemas/AdminCreateCustomer'
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:
type: object
description: SUMMARY
required:
- customer
properties:
customer:
$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'
/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:
type: object
description: SUMMARY
required:
- customer
properties:
customer:
$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: 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:
$ref: '#/components/schemas/AdminUpdateCustomer'
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:
type: object
description: SUMMARY
required:
- customer
properties:
customer:
$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'
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
$ref: '#/components/schemas/AdminCreateCustomerAddress'
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
$ref: '#/components/schemas/AdminCreateCustomerAddress'
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
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.
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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/{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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: {}
- name: $or
in: query
required: false
schema: {}
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}:
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: {}
- name: $or
in: query
required: false
schema: {}
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: {}
- name: $or
in: query
required: false
schema: {}
x-codeSamples:
- lang: Shell
label: cURL
source: curl '{backend_url}/admin/invites'
tags:
- Invites
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'
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: {}
- name: $or
in: query
required: false
schema: {}
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
$ref: '#/components/schemas/AdminCompleteOrder'
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
$ref: '#/components/schemas/AdminOrderCreateFulfillment'
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
$ref: '#/components/schemas/AdminOrderCancelFulfillment'
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
$ref: '#/components/schemas/AdminOrderCreateShipment'
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: {}
- name: $or
in: query
required: false
schema: {}
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: {}
- name: $or
in: query
required: false
schema: {}
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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.
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: {}
- name: $or
in: query
required: false
schema: {}
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'
/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: {}
- name: $or
in: query
required: false
schema: {}
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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/{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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: 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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: {}
- name: $or
in: query
required: false
schema: {}
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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/{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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: 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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
type: object
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:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
properties:
q:
type: string
title: q
description: The $and's q.
status:
oneOf:
- type: string
title: status
description: The $and's status.
- type: string
title: status
description: The $and's status.
- type: string
title: status
description: The $and's status.
- type: string
title: status
description: The $and's status.
- type: array
description: The $and's status.
items:
type: string
enum:
- draft
- proposed
- published
- rejected
sales_channel_id:
oneOf:
- type: string
title: sales_channel_id
description: The $and's sales channel id.
- type: array
description: The $and's sales channel id.
items:
type: string
title: sales_channel_id
description: The sales channel id's details.
title:
oneOf:
- type: string
title: title
description: The $and's title.
- type: array
description: The $and's title.
items:
type: string
title: title
description: The title's details.
handle:
oneOf:
- type: string
title: handle
description: The $and's handle.
- type: array
description: The $and's handle.
items:
type: string
title: handle
description: The handle's details.
id:
oneOf:
- type: string
title: id
description: The $and's ID.
- type: array
description: The $and's ID.
items:
type: string
title: id
description: The id's ID.
is_giftcard:
type: boolean
title: is_giftcard
description: The $and's is giftcard.
tags:
type: object
description: The $and's tags.
properties:
value:
type: array
description: The tag's value.
items:
type: string
title: value
description: The value's details.
type_id:
oneOf:
- type: string
title: type_id
description: The $and's type id.
- type: array
description: The $and's type id.
items:
type: string
title: type_id
description: The type id's details.
category_id:
oneOf:
- type: string
title: category_id
description: The $and's category id.
- type: array
description: The $and's category id.
items:
type: string
title: category_id
description: The category id's details.
- type: object
description: The $and'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
- 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 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
- 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 category id's $eq.
- type: object
description: The category id's $eq.
x-schemaName: RegExp
- 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
$ne:
oneOf:
- type: string
title: $ne
description: The category id's $ne.
- type: object
description: The category id's $ne.
x-schemaName: RegExp
$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
$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
$not:
oneOf:
- type: string
title: $not
description: The category id's $not.
- type: object
description: The category id's $not.
x-schemaName: RegExp
- type: object
description: The category id's $not.
- 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
$gt:
oneOf:
- type: string
title: $gt
description: The category id's $gt.
- type: object
description: The category id's $gt.
x-schemaName: RegExp
$gte:
oneOf:
- type: string
title: $gte
description: The category id's $gte.
- type: object
description: The category id's $gte.
x-schemaName: RegExp
$lt:
oneOf:
- type: string
title: $lt
description: The category id's $lt.
- type: object
description: The category id's $lt.
x-schemaName: RegExp
$lte:
oneOf:
- type: string
title: $lte
description: The category id's $lte.
- type: object
description: The category id's $lte.
x-schemaName: RegExp
$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.
categories:
oneOf:
- type: object
description: The $and's categories.
required:
- id
properties:
id:
type: object
description: The category's ID.
- type: object
description: The $and's categories.
required:
- id
properties:
id:
type: object
description: The category's ID.
collection_id:
oneOf:
- type: string
title: collection_id
description: The $and's collection id.
- type: array
description: The $and's collection id.
items:
type: string
title: collection_id
description: The collection id's details.
- type: object
description: The $and'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
- 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 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
- 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 collection id's $eq.
- type: object
description: The collection id's $eq.
x-schemaName: RegExp
- 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
$ne:
oneOf:
- type: string
title: $ne
description: The collection id's $ne.
- type: object
description: The collection id's $ne.
x-schemaName: RegExp
$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
$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
$not:
oneOf:
- type: string
title: $not
description: The collection id's $not.
- type: object
description: The collection id's $not.
x-schemaName: RegExp
- type: object
description: The collection id's $not.
- 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
$gt:
oneOf:
- type: string
title: $gt
description: The collection id's $gt.
- type: object
description: The collection id's $gt.
x-schemaName: RegExp
$gte:
oneOf:
- type: string
title: $gte
description: The collection id's $gte.
- type: object
description: The collection id's $gte.
x-schemaName: RegExp
$lt:
oneOf:
- type: string
title: $lt
description: The collection id's $lt.
- type: object
description: The collection id's $lt.
x-schemaName: RegExp
$lte:
oneOf:
- type: string
title: $lte
description: The collection id's $lte.
- type: object
description: The collection id's $lte.
x-schemaName: RegExp
$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.
created_at:
type: object
description: The $and'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
- 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 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
- 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 created at's $eq.
- type: object
description: The created at's $eq.
x-schemaName: RegExp
- 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
$ne:
oneOf:
- type: string
title: $ne
description: The created at's $ne.
- type: object
description: The created at's $ne.
x-schemaName: RegExp
$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
$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
$not:
oneOf:
- type: string
title: $not
description: The created at's $not.
- type: object
description: The created at's $not.
x-schemaName: RegExp
- type: object
description: The created at's $not.
- 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
$gt:
oneOf:
- type: string
title: $gt
description: The created at's $gt.
- type: object
description: The created at's $gt.
x-schemaName: RegExp
$gte:
oneOf:
- type: string
title: $gte
description: The created at's $gte.
- type: object
description: The created at's $gte.
x-schemaName: RegExp
$lt:
oneOf:
- type: string
title: $lt
description: The created at's $lt.
- type: object
description: The created at's $lt.
x-schemaName: RegExp
$lte:
oneOf:
- type: string
title: $lte
description: The created at's $lte.
- type: object
description: The created at's $lte.
x-schemaName: RegExp
$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.
updated_at:
type: object
description: The $and'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
- 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 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
- 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 updated at's $eq.
- type: object
description: The updated at's $eq.
x-schemaName: RegExp
- 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
$ne:
oneOf:
- type: string
title: $ne
description: The updated at's $ne.
- type: object
description: The updated at's $ne.
x-schemaName: RegExp
$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
$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
$not:
oneOf:
- type: string
title: $not
description: The updated at's $not.
- type: object
description: The updated at's $not.
x-schemaName: RegExp
- type: object
description: The updated at's $not.
- 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
$gt:
oneOf:
- type: string
title: $gt
description: The updated at's $gt.
- type: object
description: The updated at's $gt.
x-schemaName: RegExp
$gte:
oneOf:
- type: string
title: $gte
description: The updated at's $gte.
- type: object
description: The updated at's $gte.
x-schemaName: RegExp
$lt:
oneOf:
- type: string
title: $lt
description: The updated at's $lt.
- type: object
description: The updated at's $lt.
x-schemaName: RegExp
$lte:
oneOf:
- type: string
title: $lte
description: The updated at's $lte.
- type: object
description: The updated at's $lte.
x-schemaName: RegExp
$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.
deleted_at:
type: object
description: The $and'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
- 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 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
- 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 deleted at's $eq.
- type: object
description: The deleted at's $eq.
x-schemaName: RegExp
- 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
$ne:
oneOf:
- type: string
title: $ne
description: The deleted at's $ne.
- type: object
description: The deleted at's $ne.
x-schemaName: RegExp
$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
$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
$not:
oneOf:
- type: string
title: $not
description: The deleted at's $not.
- type: object
description: The deleted at's $not.
x-schemaName: RegExp
- type: object
description: The deleted at's $not.
- 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
$gt:
oneOf:
- type: string
title: $gt
description: The deleted at's $gt.
- type: object
description: The deleted at's $gt.
x-schemaName: RegExp
$gte:
oneOf:
- type: string
title: $gte
description: The deleted at's $gte.
- type: object
description: The deleted at's $gte.
x-schemaName: RegExp
$lt:
oneOf:
- type: string
title: $lt
description: The deleted at's $lt.
- type: object
description: The deleted at's $lt.
x-schemaName: RegExp
$lte:
oneOf:
- type: string
title: $lte
description: The deleted at's $lte.
- type: object
description: The deleted at's $lte.
x-schemaName: RegExp
$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.
limit:
type: number
title: limit
description: The $and's limit.
offset:
type: number
title: offset
description: The $and's offset.
order:
type: string
title: order
description: The $and's order.
fields:
type: string
title: fields
description: The $and's fields.
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
properties:
q:
type: string
title: q
description: The $and's q.
status:
oneOf:
- type: string
title: status
description: The $and's status.
- type: string
title: status
description: The $and's status.
- type: string
title: status
description: The $and's status.
- type: string
title: status
description: The $and's status.
- type: array
description: The $and's status.
items:
type: string
enum:
- draft
- proposed
- published
- rejected
sales_channel_id:
oneOf:
- type: string
title: sales_channel_id
description: The $and's sales channel id.
- type: array
description: The $and's sales channel id.
items:
type: string
title: sales_channel_id
description: The sales channel id's details.
title:
oneOf:
- type: string
title: title
description: The $and's title.
- type: array
description: The $and's title.
items:
type: string
title: title
description: The title's details.
handle:
oneOf:
- type: string
title: handle
description: The $and's handle.
- type: array
description: The $and's handle.
items:
type: string
title: handle
description: The handle's details.
id:
oneOf:
- type: string
title: id
description: The $and's ID.
- type: array
description: The $and's ID.
items:
type: string
title: id
description: The id's ID.
is_giftcard:
type: boolean
title: is_giftcard
description: The $and's is giftcard.
tags:
type: object
description: The $and's tags.
type_id:
oneOf:
- type: string
title: type_id
description: The $and's type id.
- type: array
description: The $and's type id.
items:
type: string
title: type_id
description: The type id's details.
category_id:
oneOf:
- type: string
title: category_id
description: The $and's category id.
- type: array
description: The $and's category id.
items:
type: string
title: category_id
description: The category id's details.
- type: object
description: The $and's category id.
categories:
oneOf:
- type: object
description: The $and's categories.
- type: object
description: The $and's categories.
collection_id:
oneOf:
- type: string
title: collection_id
description: The $and's collection id.
- type: array
description: The $and's collection id.
items:
type: string
title: collection_id
description: The collection id's details.
- type: object
description: The $and's collection id.
created_at:
type: object
description: The $and's created at.
updated_at:
type: object
description: The $and's updated at.
deleted_at:
type: object
description: The $and's deleted at.
limit:
type: number
title: limit
description: The $and's limit.
offset:
type: number
title: offset
description: The $and's offset.
order:
type: string
title: order
description: The $and's order.
fields:
type: string
title: fields
description: The $and's fields.
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
- type: object
description: The $and's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
- type: object
description: The $or's details.
- type: object
description: The $and's details.
properties:
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
- type: object
description: The $and's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
- type: object
description: The $or's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
properties:
q:
type: string
title: q
description: The $or's q.
status:
oneOf:
- type: string
title: status
description: The $or's status.
- type: string
title: status
description: The $or's status.
- type: string
title: status
description: The $or's status.
- type: string
title: status
description: The $or's status.
- type: array
description: The $or's status.
items:
type: string
enum:
- draft
- proposed
- published
- rejected
sales_channel_id:
oneOf:
- type: string
title: sales_channel_id
description: The $or's sales channel id.
- type: array
description: The $or's sales channel id.
items:
type: string
title: sales_channel_id
description: The sales channel id's details.
title:
oneOf:
- type: string
title: title
description: The $or's title.
- type: array
description: The $or's title.
items:
type: string
title: title
description: The title's details.
handle:
oneOf:
- type: string
title: handle
description: The $or's handle.
- type: array
description: The $or's handle.
items:
type: string
title: handle
description: The handle's details.
id:
oneOf:
- type: string
title: id
description: The $or's ID.
- type: array
description: The $or's ID.
items:
type: string
title: id
description: The id's ID.
is_giftcard:
type: boolean
title: is_giftcard
description: The $or's is giftcard.
tags:
type: object
description: The $or's tags.
type_id:
oneOf:
- type: string
title: type_id
description: The $or's type id.
- type: array
description: The $or's type id.
items:
type: string
title: type_id
description: The type id's details.
category_id:
oneOf:
- type: string
title: category_id
description: The $or's category id.
- type: array
description: The $or's category id.
items:
type: string
title: category_id
description: The category id's details.
- type: object
description: The $or's category id.
categories:
oneOf:
- type: object
description: The $or's categories.
- type: object
description: The $or's categories.
collection_id:
oneOf:
- type: string
title: collection_id
description: The $or's collection id.
- type: array
description: The $or's collection id.
items:
type: string
title: collection_id
description: The collection id's details.
- type: object
description: The $or's collection id.
created_at:
type: object
description: The $or's created at.
updated_at:
type: object
description: The $or's updated at.
deleted_at:
type: object
description: The $or's deleted at.
limit:
type: number
title: limit
description: The $or's limit.
offset:
type: number
title: offset
description: The $or's offset.
order:
type: string
title: order
description: The $or's order.
fields:
type: string
title: fields
description: The $or's fields.
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
- type: object
description: The $and's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
- type: object
description: The $or's details.
- type: object
description: The $or's details.
properties:
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
- type: object
description: The $and's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
- type: object
description: The $or's details.
- type: object
description: The $and's details.
properties:
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
properties:
q:
type: string
title: q
description: The $and's q.
status:
oneOf:
- type: string
title: status
description: The $and's status.
- type: string
title: status
description: The $and's status.
- type: string
title: status
description: The $and's status.
- type: string
title: status
description: The $and's status.
- type: array
description: The $and's status.
items:
type: string
enum:
- draft
- proposed
- published
- rejected
sales_channel_id:
oneOf:
- type: string
title: sales_channel_id
description: The $and's sales channel id.
- type: array
description: The $and's sales channel id.
items:
type: string
title: sales_channel_id
description: The sales channel id's details.
title:
oneOf:
- type: string
title: title
description: The $and's title.
- type: array
description: The $and's title.
items:
type: string
title: title
description: The title's details.
handle:
oneOf:
- type: string
title: handle
description: The $and's handle.
- type: array
description: The $and's handle.
items:
type: string
title: handle
description: The handle's details.
id:
oneOf:
- type: string
title: id
description: The $and's ID.
- type: array
description: The $and's ID.
items:
type: string
title: id
description: The id's ID.
is_giftcard:
type: boolean
title: is_giftcard
description: The $and's is giftcard.
tags:
type: object
description: The $and's tags.
type_id:
oneOf:
- type: string
title: type_id
description: The $and's type id.
- type: array
description: The $and's type id.
items:
type: string
title: type_id
description: The type id's details.
category_id:
oneOf:
- type: string
title: category_id
description: The $and's category id.
- type: array
description: The $and's category id.
items:
type: string
title: category_id
description: The category id's details.
- type: object
description: The $and's category id.
categories:
oneOf:
- type: object
description: The $and's categories.
- type: object
description: The $and's categories.
collection_id:
oneOf:
- type: string
title: collection_id
description: The $and's collection id.
- type: array
description: The $and's collection id.
items:
type: string
title: collection_id
description: The collection id's details.
- type: object
description: The $and's collection id.
created_at:
type: object
description: The $and's created at.
updated_at:
type: object
description: The $and's updated at.
deleted_at:
type: object
description: The $and's deleted at.
limit:
type: number
title: limit
description: The $and's limit.
offset:
type: number
title: offset
description: The $and's offset.
order:
type: string
title: order
description: The $and's order.
fields:
type: string
title: fields
description: The $and's fields.
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
- type: object
description: The $and's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
- type: object
description: The $or's details.
- type: object
description: The $and's details.
properties:
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
- type: object
description: The $and's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
- type: object
description: The $or's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
properties:
q:
type: string
title: q
description: The $or's q.
status:
oneOf:
- type: string
title: status
description: The $or's status.
- type: string
title: status
description: The $or's status.
- type: string
title: status
description: The $or's status.
- type: string
title: status
description: The $or's status.
- type: array
description: The $or's status.
items:
type: string
enum:
- draft
- proposed
- published
- rejected
sales_channel_id:
oneOf:
- type: string
title: sales_channel_id
description: The $or's sales channel id.
- type: array
description: The $or's sales channel id.
items:
type: string
title: sales_channel_id
description: The sales channel id's details.
title:
oneOf:
- type: string
title: title
description: The $or's title.
- type: array
description: The $or's title.
items:
type: string
title: title
description: The title's details.
handle:
oneOf:
- type: string
title: handle
description: The $or's handle.
- type: array
description: The $or's handle.
items:
type: string
title: handle
description: The handle's details.
id:
oneOf:
- type: string
title: id
description: The $or's ID.
- type: array
description: The $or's ID.
items:
type: string
title: id
description: The id's ID.
is_giftcard:
type: boolean
title: is_giftcard
description: The $or's is giftcard.
tags:
type: object
description: The $or's tags.
type_id:
oneOf:
- type: string
title: type_id
description: The $or's type id.
- type: array
description: The $or's type id.
items:
type: string
title: type_id
description: The type id's details.
category_id:
oneOf:
- type: string
title: category_id
description: The $or's category id.
- type: array
description: The $or's category id.
items:
type: string
title: category_id
description: The category id's details.
- type: object
description: The $or's category id.
categories:
oneOf:
- type: object
description: The $or's categories.
- type: object
description: The $or's categories.
collection_id:
oneOf:
- type: string
title: collection_id
description: The $or's collection id.
- type: array
description: The $or's collection id.
items:
type: string
title: collection_id
description: The collection id's details.
- type: object
description: The $or's collection id.
created_at:
type: object
description: The $or's created at.
updated_at:
type: object
description: The $or's updated at.
deleted_at:
type: object
description: The $or's deleted at.
limit:
type: number
title: limit
description: The $or's limit.
offset:
type: number
title: offset
description: The $or's offset.
order:
type: string
title: order
description: The $or's order.
fields:
type: string
title: fields
description: The $or's fields.
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
- type: object
description: The $and's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
- type: object
description: The $or's details.
- type: object
description: The $or's details.
properties:
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
- type: object
description: The $and's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
- type: object
description: The $or's details.
- name: $or
in: query
description: The product's $or.
required: false
schema:
type: array
description: The product's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
properties:
q:
type: string
title: q
description: The $or's q.
status:
oneOf:
- type: string
title: status
description: The $or's status.
- type: string
title: status
description: The $or's status.
- type: string
title: status
description: The $or's status.
- type: string
title: status
description: The $or's status.
- type: array
description: The $or's status.
items:
type: string
enum:
- draft
- proposed
- published
- rejected
sales_channel_id:
oneOf:
- type: string
title: sales_channel_id
description: The $or's sales channel id.
- type: array
description: The $or's sales channel id.
items:
type: string
title: sales_channel_id
description: The sales channel id's details.
title:
oneOf:
- type: string
title: title
description: The $or's title.
- type: array
description: The $or's title.
items:
type: string
title: title
description: The title's details.
handle:
oneOf:
- type: string
title: handle
description: The $or's handle.
- type: array
description: The $or's handle.
items:
type: string
title: handle
description: The handle's details.
id:
oneOf:
- type: string
title: id
description: The $or's ID.
- type: array
description: The $or's ID.
items:
type: string
title: id
description: The id's ID.
is_giftcard:
type: boolean
title: is_giftcard
description: The $or's is giftcard.
tags:
type: object
description: The $or's tags.
properties:
value:
type: array
description: The tag's value.
items:
type: string
title: value
description: The value's details.
type_id:
oneOf:
- type: string
title: type_id
description: The $or's type id.
- type: array
description: The $or's type id.
items:
type: string
title: type_id
description: The type id's details.
category_id:
oneOf:
- type: string
title: category_id
description: The $or's category id.
- type: array
description: The $or's category id.
items:
type: string
title: category_id
description: The category id's details.
- type: object
description: The $or'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
- 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 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
- 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 category id's $eq.
- type: object
description: The category id's $eq.
x-schemaName: RegExp
- 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
$ne:
oneOf:
- type: string
title: $ne
description: The category id's $ne.
- type: object
description: The category id's $ne.
x-schemaName: RegExp
$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
$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
$not:
oneOf:
- type: string
title: $not
description: The category id's $not.
- type: object
description: The category id's $not.
x-schemaName: RegExp
- type: object
description: The category id's $not.
- 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
$gt:
oneOf:
- type: string
title: $gt
description: The category id's $gt.
- type: object
description: The category id's $gt.
x-schemaName: RegExp
$gte:
oneOf:
- type: string
title: $gte
description: The category id's $gte.
- type: object
description: The category id's $gte.
x-schemaName: RegExp
$lt:
oneOf:
- type: string
title: $lt
description: The category id's $lt.
- type: object
description: The category id's $lt.
x-schemaName: RegExp
$lte:
oneOf:
- type: string
title: $lte
description: The category id's $lte.
- type: object
description: The category id's $lte.
x-schemaName: RegExp
$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.
categories:
oneOf:
- type: object
description: The $or's categories.
required:
- id
properties:
id:
type: object
description: The category's ID.
- type: object
description: The $or's categories.
required:
- id
properties:
id:
type: object
description: The category's ID.
collection_id:
oneOf:
- type: string
title: collection_id
description: The $or's collection id.
- type: array
description: The $or's collection id.
items:
type: string
title: collection_id
description: The collection id's details.
- type: object
description: The $or'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
- 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 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
- 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 collection id's $eq.
- type: object
description: The collection id's $eq.
x-schemaName: RegExp
- 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
$ne:
oneOf:
- type: string
title: $ne
description: The collection id's $ne.
- type: object
description: The collection id's $ne.
x-schemaName: RegExp
$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
$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
$not:
oneOf:
- type: string
title: $not
description: The collection id's $not.
- type: object
description: The collection id's $not.
x-schemaName: RegExp
- type: object
description: The collection id's $not.
- 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
$gt:
oneOf:
- type: string
title: $gt
description: The collection id's $gt.
- type: object
description: The collection id's $gt.
x-schemaName: RegExp
$gte:
oneOf:
- type: string
title: $gte
description: The collection id's $gte.
- type: object
description: The collection id's $gte.
x-schemaName: RegExp
$lt:
oneOf:
- type: string
title: $lt
description: The collection id's $lt.
- type: object
description: The collection id's $lt.
x-schemaName: RegExp
$lte:
oneOf:
- type: string
title: $lte
description: The collection id's $lte.
- type: object
description: The collection id's $lte.
x-schemaName: RegExp
$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.
created_at:
type: object
description: The $or'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
- 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 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
- 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 created at's $eq.
- type: object
description: The created at's $eq.
x-schemaName: RegExp
- 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
$ne:
oneOf:
- type: string
title: $ne
description: The created at's $ne.
- type: object
description: The created at's $ne.
x-schemaName: RegExp
$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
$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
$not:
oneOf:
- type: string
title: $not
description: The created at's $not.
- type: object
description: The created at's $not.
x-schemaName: RegExp
- type: object
description: The created at's $not.
- 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
$gt:
oneOf:
- type: string
title: $gt
description: The created at's $gt.
- type: object
description: The created at's $gt.
x-schemaName: RegExp
$gte:
oneOf:
- type: string
title: $gte
description: The created at's $gte.
- type: object
description: The created at's $gte.
x-schemaName: RegExp
$lt:
oneOf:
- type: string
title: $lt
description: The created at's $lt.
- type: object
description: The created at's $lt.
x-schemaName: RegExp
$lte:
oneOf:
- type: string
title: $lte
description: The created at's $lte.
- type: object
description: The created at's $lte.
x-schemaName: RegExp
$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.
updated_at:
type: object
description: The $or'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
- 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 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
- 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 updated at's $eq.
- type: object
description: The updated at's $eq.
x-schemaName: RegExp
- 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
$ne:
oneOf:
- type: string
title: $ne
description: The updated at's $ne.
- type: object
description: The updated at's $ne.
x-schemaName: RegExp
$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
$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
$not:
oneOf:
- type: string
title: $not
description: The updated at's $not.
- type: object
description: The updated at's $not.
x-schemaName: RegExp
- type: object
description: The updated at's $not.
- 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
$gt:
oneOf:
- type: string
title: $gt
description: The updated at's $gt.
- type: object
description: The updated at's $gt.
x-schemaName: RegExp
$gte:
oneOf:
- type: string
title: $gte
description: The updated at's $gte.
- type: object
description: The updated at's $gte.
x-schemaName: RegExp
$lt:
oneOf:
- type: string
title: $lt
description: The updated at's $lt.
- type: object
description: The updated at's $lt.
x-schemaName: RegExp
$lte:
oneOf:
- type: string
title: $lte
description: The updated at's $lte.
- type: object
description: The updated at's $lte.
x-schemaName: RegExp
$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.
deleted_at:
type: object
description: The $or'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
- 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 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
- 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 deleted at's $eq.
- type: object
description: The deleted at's $eq.
x-schemaName: RegExp
- 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
$ne:
oneOf:
- type: string
title: $ne
description: The deleted at's $ne.
- type: object
description: The deleted at's $ne.
x-schemaName: RegExp
$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
$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
$not:
oneOf:
- type: string
title: $not
description: The deleted at's $not.
- type: object
description: The deleted at's $not.
x-schemaName: RegExp
- type: object
description: The deleted at's $not.
- 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
$gt:
oneOf:
- type: string
title: $gt
description: The deleted at's $gt.
- type: object
description: The deleted at's $gt.
x-schemaName: RegExp
$gte:
oneOf:
- type: string
title: $gte
description: The deleted at's $gte.
- type: object
description: The deleted at's $gte.
x-schemaName: RegExp
$lt:
oneOf:
- type: string
title: $lt
description: The deleted at's $lt.
- type: object
description: The deleted at's $lt.
x-schemaName: RegExp
$lte:
oneOf:
- type: string
title: $lte
description: The deleted at's $lte.
- type: object
description: The deleted at's $lte.
x-schemaName: RegExp
$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.
limit:
type: number
title: limit
description: The $or's limit.
offset:
type: number
title: offset
description: The $or's offset.
order:
type: string
title: order
description: The $or's order.
fields:
type: string
title: fields
description: The $or's fields.
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
properties:
q:
type: string
title: q
description: The $and's q.
status:
oneOf:
- type: string
title: status
description: The $and's status.
- type: string
title: status
description: The $and's status.
- type: string
title: status
description: The $and's status.
- type: string
title: status
description: The $and's status.
- type: array
description: The $and's status.
items:
type: string
enum:
- draft
- proposed
- published
- rejected
sales_channel_id:
oneOf:
- type: string
title: sales_channel_id
description: The $and's sales channel id.
- type: array
description: The $and's sales channel id.
items:
type: string
title: sales_channel_id
description: The sales channel id's details.
title:
oneOf:
- type: string
title: title
description: The $and's title.
- type: array
description: The $and's title.
items:
type: string
title: title
description: The title's details.
handle:
oneOf:
- type: string
title: handle
description: The $and's handle.
- type: array
description: The $and's handle.
items:
type: string
title: handle
description: The handle's details.
id:
oneOf:
- type: string
title: id
description: The $and's ID.
- type: array
description: The $and's ID.
items:
type: string
title: id
description: The id's ID.
is_giftcard:
type: boolean
title: is_giftcard
description: The $and's is giftcard.
tags:
type: object
description: The $and's tags.
type_id:
oneOf:
- type: string
title: type_id
description: The $and's type id.
- type: array
description: The $and's type id.
items:
type: string
title: type_id
description: The type id's details.
category_id:
oneOf:
- type: string
title: category_id
description: The $and's category id.
- type: array
description: The $and's category id.
items:
type: string
title: category_id
description: The category id's details.
- type: object
description: The $and's category id.
categories:
oneOf:
- type: object
description: The $and's categories.
- type: object
description: The $and's categories.
collection_id:
oneOf:
- type: string
title: collection_id
description: The $and's collection id.
- type: array
description: The $and's collection id.
items:
type: string
title: collection_id
description: The collection id's details.
- type: object
description: The $and's collection id.
created_at:
type: object
description: The $and's created at.
updated_at:
type: object
description: The $and's updated at.
deleted_at:
type: object
description: The $and's deleted at.
limit:
type: number
title: limit
description: The $and's limit.
offset:
type: number
title: offset
description: The $and's offset.
order:
type: string
title: order
description: The $and's order.
fields:
type: string
title: fields
description: The $and's fields.
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
- type: object
description: The $and's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
- type: object
description: The $or's details.
- type: object
description: The $and's details.
properties:
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
- type: object
description: The $and's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
- type: object
description: The $or's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
properties:
q:
type: string
title: q
description: The $or's q.
status:
oneOf:
- type: string
title: status
description: The $or's status.
- type: string
title: status
description: The $or's status.
- type: string
title: status
description: The $or's status.
- type: string
title: status
description: The $or's status.
- type: array
description: The $or's status.
items:
type: string
enum:
- draft
- proposed
- published
- rejected
sales_channel_id:
oneOf:
- type: string
title: sales_channel_id
description: The $or's sales channel id.
- type: array
description: The $or's sales channel id.
items:
type: string
title: sales_channel_id
description: The sales channel id's details.
title:
oneOf:
- type: string
title: title
description: The $or's title.
- type: array
description: The $or's title.
items:
type: string
title: title
description: The title's details.
handle:
oneOf:
- type: string
title: handle
description: The $or's handle.
- type: array
description: The $or's handle.
items:
type: string
title: handle
description: The handle's details.
id:
oneOf:
- type: string
title: id
description: The $or's ID.
- type: array
description: The $or's ID.
items:
type: string
title: id
description: The id's ID.
is_giftcard:
type: boolean
title: is_giftcard
description: The $or's is giftcard.
tags:
type: object
description: The $or's tags.
type_id:
oneOf:
- type: string
title: type_id
description: The $or's type id.
- type: array
description: The $or's type id.
items:
type: string
title: type_id
description: The type id's details.
category_id:
oneOf:
- type: string
title: category_id
description: The $or's category id.
- type: array
description: The $or's category id.
items:
type: string
title: category_id
description: The category id's details.
- type: object
description: The $or's category id.
categories:
oneOf:
- type: object
description: The $or's categories.
- type: object
description: The $or's categories.
collection_id:
oneOf:
- type: string
title: collection_id
description: The $or's collection id.
- type: array
description: The $or's collection id.
items:
type: string
title: collection_id
description: The collection id's details.
- type: object
description: The $or's collection id.
created_at:
type: object
description: The $or's created at.
updated_at:
type: object
description: The $or's updated at.
deleted_at:
type: object
description: The $or's deleted at.
limit:
type: number
title: limit
description: The $or's limit.
offset:
type: number
title: offset
description: The $or's offset.
order:
type: string
title: order
description: The $or's order.
fields:
type: string
title: fields
description: The $or's fields.
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
- type: object
description: The $and's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
- type: object
description: The $or's details.
- type: object
description: The $or's details.
properties:
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
- type: object
description: The $and's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
- type: object
description: The $or's details.
- type: object
description: The $or's details.
properties:
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
properties:
q:
type: string
title: q
description: The $and's q.
status:
oneOf:
- type: string
title: status
description: The $and's status.
- type: string
title: status
description: The $and's status.
- type: string
title: status
description: The $and's status.
- type: string
title: status
description: The $and's status.
- type: array
description: The $and's status.
items:
type: string
enum:
- draft
- proposed
- published
- rejected
sales_channel_id:
oneOf:
- type: string
title: sales_channel_id
description: The $and's sales channel id.
- type: array
description: The $and's sales channel id.
items:
type: string
title: sales_channel_id
description: The sales channel id's details.
title:
oneOf:
- type: string
title: title
description: The $and's title.
- type: array
description: The $and's title.
items:
type: string
title: title
description: The title's details.
handle:
oneOf:
- type: string
title: handle
description: The $and's handle.
- type: array
description: The $and's handle.
items:
type: string
title: handle
description: The handle's details.
id:
oneOf:
- type: string
title: id
description: The $and's ID.
- type: array
description: The $and's ID.
items:
type: string
title: id
description: The id's ID.
is_giftcard:
type: boolean
title: is_giftcard
description: The $and's is giftcard.
tags:
type: object
description: The $and's tags.
type_id:
oneOf:
- type: string
title: type_id
description: The $and's type id.
- type: array
description: The $and's type id.
items:
type: string
title: type_id
description: The type id's details.
category_id:
oneOf:
- type: string
title: category_id
description: The $and's category id.
- type: array
description: The $and's category id.
items:
type: string
title: category_id
description: The category id's details.
- type: object
description: The $and's category id.
categories:
oneOf:
- type: object
description: The $and's categories.
- type: object
description: The $and's categories.
collection_id:
oneOf:
- type: string
title: collection_id
description: The $and's collection id.
- type: array
description: The $and's collection id.
items:
type: string
title: collection_id
description: The collection id's details.
- type: object
description: The $and's collection id.
created_at:
type: object
description: The $and's created at.
updated_at:
type: object
description: The $and's updated at.
deleted_at:
type: object
description: The $and's deleted at.
limit:
type: number
title: limit
description: The $and's limit.
offset:
type: number
title: offset
description: The $and's offset.
order:
type: string
title: order
description: The $and's order.
fields:
type: string
title: fields
description: The $and's fields.
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
- type: object
description: The $and's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
- type: object
description: The $or's details.
- type: object
description: The $and's details.
properties:
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
- type: object
description: The $and's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
- type: object
description: The $or's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
properties:
q:
type: string
title: q
description: The $or's q.
status:
oneOf:
- type: string
title: status
description: The $or's status.
- type: string
title: status
description: The $or's status.
- type: string
title: status
description: The $or's status.
- type: string
title: status
description: The $or's status.
- type: array
description: The $or's status.
items:
type: string
enum:
- draft
- proposed
- published
- rejected
sales_channel_id:
oneOf:
- type: string
title: sales_channel_id
description: The $or's sales channel id.
- type: array
description: The $or's sales channel id.
items:
type: string
title: sales_channel_id
description: The sales channel id's details.
title:
oneOf:
- type: string
title: title
description: The $or's title.
- type: array
description: The $or's title.
items:
type: string
title: title
description: The title's details.
handle:
oneOf:
- type: string
title: handle
description: The $or's handle.
- type: array
description: The $or's handle.
items:
type: string
title: handle
description: The handle's details.
id:
oneOf:
- type: string
title: id
description: The $or's ID.
- type: array
description: The $or's ID.
items:
type: string
title: id
description: The id's ID.
is_giftcard:
type: boolean
title: is_giftcard
description: The $or's is giftcard.
tags:
type: object
description: The $or's tags.
type_id:
oneOf:
- type: string
title: type_id
description: The $or's type id.
- type: array
description: The $or's type id.
items:
type: string
title: type_id
description: The type id's details.
category_id:
oneOf:
- type: string
title: category_id
description: The $or's category id.
- type: array
description: The $or's category id.
items:
type: string
title: category_id
description: The category id's details.
- type: object
description: The $or's category id.
categories:
oneOf:
- type: object
description: The $or's categories.
- type: object
description: The $or's categories.
collection_id:
oneOf:
- type: string
title: collection_id
description: The $or's collection id.
- type: array
description: The $or's collection id.
items:
type: string
title: collection_id
description: The collection id's details.
- type: object
description: The $or's collection id.
created_at:
type: object
description: The $or's created at.
updated_at:
type: object
description: The $or's updated at.
deleted_at:
type: object
description: The $or's deleted at.
limit:
type: number
title: limit
description: The $or's limit.
offset:
type: number
title: offset
description: The $or's offset.
order:
type: string
title: order
description: The $or's order.
fields:
type: string
title: fields
description: The $or's fields.
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
- type: object
description: The $and's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
- type: object
description: The $or's details.
- type: object
description: The $or's details.
properties:
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductListParams
- type: object
description: The $and's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductListParams
- type: object
description: The $or's details.
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:
$ref: '#/components/schemas/AdminCreateProduct'
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'
/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'
/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'
/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'
/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:
$ref: '#/components/schemas/AdminUpdateProduct'
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'
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:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
properties:
q:
type: string
title: q
description: The $and's q.
id:
oneOf:
- type: string
title: id
description: The $and's ID.
- type: array
description: The $and's ID.
items:
type: string
title: id
description: The id's ID.
title:
oneOf:
- type: string
title: title
description: The $and's title.
- type: array
description: The $and's title.
items:
type: string
title: title
description: The title's details.
product_id:
oneOf:
- type: string
title: product_id
description: The $and's product id.
- type: array
description: The $and's product id.
items:
type: string
title: product_id
description: The product id's details.
limit:
type: number
title: limit
description: The $and's limit.
offset:
type: number
title: offset
description: The $and's offset.
order:
type: string
title: order
description: The $and's order.
fields:
type: string
title: fields
description: The $and's fields.
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
properties:
q:
type: string
title: q
description: The $and's q.
id:
oneOf:
- type: string
title: id
description: The $and's ID.
- type: array
description: The $and's ID.
items:
type: string
title: id
description: The id's ID.
title:
oneOf:
- type: string
title: title
description: The $and's title.
- type: array
description: The $and's title.
items:
type: string
title: title
description: The title's details.
product_id:
oneOf:
- type: string
title: product_id
description: The $and's product id.
- type: array
description: The $and's product id.
items:
type: string
title: product_id
description: The product id's details.
limit:
type: number
title: limit
description: The $and's limit.
offset:
type: number
title: offset
description: The $and's offset.
order:
type: string
title: order
description: The $and's order.
fields:
type: string
title: fields
description: The $and's fields.
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $and's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $or's details.
- type: object
description: The $and's details.
properties:
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $and's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $or's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
properties:
q:
type: string
title: q
description: The $or's q.
id:
oneOf:
- type: string
title: id
description: The $or's ID.
- type: array
description: The $or's ID.
items:
type: string
title: id
description: The id's ID.
title:
oneOf:
- type: string
title: title
description: The $or's title.
- type: array
description: The $or's title.
items:
type: string
title: title
description: The title's details.
product_id:
oneOf:
- type: string
title: product_id
description: The $or's product id.
- type: array
description: The $or's product id.
items:
type: string
title: product_id
description: The product id's details.
limit:
type: number
title: limit
description: The $or's limit.
offset:
type: number
title: offset
description: The $or's offset.
order:
type: string
title: order
description: The $or's order.
fields:
type: string
title: fields
description: The $or's fields.
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $and's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $or's details.
- type: object
description: The $or's details.
properties:
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $and's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $or's details.
- type: object
description: The $and's details.
properties:
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
properties:
q:
type: string
title: q
description: The $and's q.
id:
oneOf:
- type: string
title: id
description: The $and's ID.
- type: array
description: The $and's ID.
items:
type: string
title: id
description: The id's ID.
title:
oneOf:
- type: string
title: title
description: The $and's title.
- type: array
description: The $and's title.
items:
type: string
title: title
description: The title's details.
product_id:
oneOf:
- type: string
title: product_id
description: The $and's product id.
- type: array
description: The $and's product id.
items:
type: string
title: product_id
description: The product id's details.
limit:
type: number
title: limit
description: The $and's limit.
offset:
type: number
title: offset
description: The $and's offset.
order:
type: string
title: order
description: The $and's order.
fields:
type: string
title: fields
description: The $and's fields.
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $and's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $or's details.
- type: object
description: The $and's details.
properties:
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $and's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $or's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
properties:
q:
type: string
title: q
description: The $or's q.
id:
oneOf:
- type: string
title: id
description: The $or's ID.
- type: array
description: The $or's ID.
items:
type: string
title: id
description: The id's ID.
title:
oneOf:
- type: string
title: title
description: The $or's title.
- type: array
description: The $or's title.
items:
type: string
title: title
description: The title's details.
product_id:
oneOf:
- type: string
title: product_id
description: The $or's product id.
- type: array
description: The $or's product id.
items:
type: string
title: product_id
description: The product id's details.
limit:
type: number
title: limit
description: The $or's limit.
offset:
type: number
title: offset
description: The $or's offset.
order:
type: string
title: order
description: The $or's order.
fields:
type: string
title: fields
description: The $or's fields.
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $and's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $or's details.
- type: object
description: The $or's details.
properties:
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $and's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $or's details.
- name: $or
in: query
description: The product's $or.
required: false
schema:
type: array
description: The product's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
properties:
q:
type: string
title: q
description: The $or's q.
id:
oneOf:
- type: string
title: id
description: The $or's ID.
- type: array
description: The $or's ID.
items:
type: string
title: id
description: The id's ID.
title:
oneOf:
- type: string
title: title
description: The $or's title.
- type: array
description: The $or's title.
items:
type: string
title: title
description: The title's details.
product_id:
oneOf:
- type: string
title: product_id
description: The $or's product id.
- type: array
description: The $or's product id.
items:
type: string
title: product_id
description: The product id's details.
limit:
type: number
title: limit
description: The $or's limit.
offset:
type: number
title: offset
description: The $or's offset.
order:
type: string
title: order
description: The $or's order.
fields:
type: string
title: fields
description: The $or's fields.
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
properties:
q:
type: string
title: q
description: The $and's q.
id:
oneOf:
- type: string
title: id
description: The $and's ID.
- type: array
description: The $and's ID.
items:
type: string
title: id
description: The id's ID.
title:
oneOf:
- type: string
title: title
description: The $and's title.
- type: array
description: The $and's title.
items:
type: string
title: title
description: The title's details.
product_id:
oneOf:
- type: string
title: product_id
description: The $and's product id.
- type: array
description: The $and's product id.
items:
type: string
title: product_id
description: The product id's details.
limit:
type: number
title: limit
description: The $and's limit.
offset:
type: number
title: offset
description: The $and's offset.
order:
type: string
title: order
description: The $and's order.
fields:
type: string
title: fields
description: The $and's fields.
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $and's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $or's details.
- type: object
description: The $and's details.
properties:
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $and's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $or's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
properties:
q:
type: string
title: q
description: The $or's q.
id:
oneOf:
- type: string
title: id
description: The $or's ID.
- type: array
description: The $or's ID.
items:
type: string
title: id
description: The id's ID.
title:
oneOf:
- type: string
title: title
description: The $or's title.
- type: array
description: The $or's title.
items:
type: string
title: title
description: The title's details.
product_id:
oneOf:
- type: string
title: product_id
description: The $or's product id.
- type: array
description: The $or's product id.
items:
type: string
title: product_id
description: The product id's details.
limit:
type: number
title: limit
description: The $or's limit.
offset:
type: number
title: offset
description: The $or's offset.
order:
type: string
title: order
description: The $or's order.
fields:
type: string
title: fields
description: The $or's fields.
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $and's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $or's details.
- type: object
description: The $or's details.
properties:
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $and's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $or's details.
- type: object
description: The $or's details.
properties:
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
properties:
q:
type: string
title: q
description: The $and's q.
id:
oneOf:
- type: string
title: id
description: The $and's ID.
- type: array
description: The $and's ID.
items:
type: string
title: id
description: The id's ID.
title:
oneOf:
- type: string
title: title
description: The $and's title.
- type: array
description: The $and's title.
items:
type: string
title: title
description: The title's details.
product_id:
oneOf:
- type: string
title: product_id
description: The $and's product id.
- type: array
description: The $and's product id.
items:
type: string
title: product_id
description: The product id's details.
limit:
type: number
title: limit
description: The $and's limit.
offset:
type: number
title: offset
description: The $and's offset.
order:
type: string
title: order
description: The $and's order.
fields:
type: string
title: fields
description: The $and's fields.
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $and's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $or's details.
- type: object
description: The $and's details.
properties:
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $and's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $or's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
properties:
q:
type: string
title: q
description: The $or's q.
id:
oneOf:
- type: string
title: id
description: The $or's ID.
- type: array
description: The $or's ID.
items:
type: string
title: id
description: The id's ID.
title:
oneOf:
- type: string
title: title
description: The $or's title.
- type: array
description: The $or's title.
items:
type: string
title: title
description: The title's details.
product_id:
oneOf:
- type: string
title: product_id
description: The $or's product id.
- type: array
description: The $or's product id.
items:
type: string
title: product_id
description: The product id's details.
limit:
type: number
title: limit
description: The $or's limit.
offset:
type: number
title: offset
description: The $or's offset.
order:
type: string
title: order
description: The $or's order.
fields:
type: string
title: fields
description: The $or's fields.
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $and's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $or's details.
- type: object
description: The $or's details.
properties:
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $and's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductOptionParams
- type: object
description: The $or's details.
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:
$ref: '#/components/schemas/AdminCreateProductOption'
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:
$ref: '#/components/schemas/AdminUpdateProductOption'
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:
$ref: '#/components/schemas/AdminCreateProductVariant'
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'
/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}:
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:
$ref: '#/components/schemas/AdminUpdateProductVariant'
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
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: {}
- name: $or
in: query
required: false
schema: {}
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
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.
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
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.
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}/{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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: {}
- name: $or
in: query
required: false
schema: {}
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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/{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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: 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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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/{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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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 `-`.
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: 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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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/{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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: 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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: 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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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/{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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: 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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: 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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
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: {}
- name: $or
in: query
required: false
schema: {}
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}:
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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-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: {}
- name: $or
in: query
required: false
schema: {}
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'
/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: {}
- name: $or
in: query
required: false
schema: {}
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}:
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: {}
- name: $or
in: query
required: false
schema: {}
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
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: {}
- name: $or
in: query
required: false
schema: {}
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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}:
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: {}
- name: $or
in: query
required: false
schema: {}
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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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/{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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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/{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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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: PostUsers
summary: Create User
description: Create a user.
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:
$ref: '#/components/schemas/CreateUser'
x-codeSamples:
- lang: Shell
label: cURL
source: |-
curl -X POST '{backend_url}/admin/users' \
-H 'Content-Type: application/json' \
--data-raw '{
"email": "Janie42@hotmail.com"
}'
tags:
- Users
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/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/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:
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
schemas:
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.
AdminCancelFulfillment:
type: object
description: SUMMARY
x-schemaName: AdminCancelFulfillment
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.
AdminCompleteOrder:
type: object
description: SUMMARY
x-schemaName: AdminCompleteOrder
required:
- order_id
properties:
order_id:
type: string
title: order_id
description: The order's order id.
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.
AdminCreateCustomer:
type: object
description: SUMMARY
x-schemaName: AdminCreateCustomer
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.
AdminCreateCustomerAddress:
type: object
description: SUMMARY
x-schemaName: AdminCreateCustomerAddress
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.
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.
properties:
id:
type: string
title: id
description: The tag's ID.
value:
type: string
title: value
description: The tag's value.
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.
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.
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.
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.
AdminFulfillmentProvider:
type: object
description: The shipping option's provider.
x-schemaName: AdminFulfillmentProvider
AdminFulfillmentSet:
type: object
description: The fulfillment set's details.
x-schemaName: AdminFulfillmentSet
required:
- id
- name
- type
- 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.
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
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.
AdminOrderCancelFulfillment:
type: object
description: SUMMARY
x-schemaName: AdminOrderCancelFulfillment
properties:
no_notification:
type: boolean
title: no_notification
description: The order's no notification.
AdminOrderCreateFulfillment:
type: object
description: SUMMARY
x-schemaName: AdminOrderCreateFulfillment
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.
AdminOrderCreateShipment:
type: object
description: SUMMARY
x-schemaName: AdminOrderCreateShipment
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.
AdminPostCancelReturnReqSchema:
type: object
description: SUMMARY
x-schemaName: AdminPostCancelReturnReqSchema
required:
- internal_note
properties:
no_notification:
type: boolean
title: no_notification
description: The return's no notification.
internal_note:
type: string
title: internal_note
description: The return's internal note.
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
properties:
quantity:
type: number
title: quantity
description: The claim's quantity.
reason:
type: string
enum:
- missing_item
- wrong_item
- production_failure
- other
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.
AdminPostOrderClaimsReqSchema:
type: object
description: SUMMARY
x-schemaName: AdminPostOrderClaimsReqSchema
required:
- type
- order_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.
metadata:
type: object
description: The claim'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 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.
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.
AdminProduct:
type: object
description: The product's parent.
x-schemaName: AdminProduct
required:
- type
- title
- status
- length
- options
- description
- id
- handle
- hs_code
- weight
- height
- width
- origin_country
- mid_code
- material
- thumbnail
- created_at
- updated_at
- deleted_at
- subtitle
- is_giftcard
- collection_id
- type_id
- images
- discountable
- external_id
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.
handle:
type: string
title: handle
description: The parent's handle.
hs_code:
type: string
title: hs_code
description: The parent's hs code.
weight:
type: number
title: weight
description: The parent's weight.
height:
type: number
title: height
description: The parent's height.
width:
type: number
title: width
description: The parent's width.
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.
thumbnail:
type: string
title: thumbnail
description: The parent's thumbnail.
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.
subtitle:
type: string
title: subtitle
description: The parent's subtitle.
is_giftcard:
type: boolean
title: is_giftcard
description: The parent's is giftcard.
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.
AdminProductCategory:
type: object
description: The category's categories.
x-schemaName: AdminProductCategory
required:
- category_children
- parent_category
- name
- description
- id
- handle
- created_at
- updated_at
- deleted_at
- parent_category_id
- is_internal
- is_active
- rank
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.
handle:
type: string
title: handle
description: The category's handle.
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.
parent_category_id:
type: string
title: parent_category_id
description: The category's parent category id.
is_internal:
type: boolean
title: is_internal
description: The category's is internal.
is_active:
type: boolean
title: is_active
description: The category's is active.
rank:
type: number
title: rank
description: The category's rank.
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.
AdminProductVariant:
type: object
description: The updated's details.
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 updated's prices.
items:
$ref: '#/components/schemas/AdminPrice'
id:
type: string
title: id
description: The updated's ID.
title:
type: string
title: title
description: The updated's title.
sku:
type: string
title: sku
description: The updated's sku.
barcode:
type: string
title: barcode
description: The updated's barcode.
ean:
type: string
title: ean
description: The updated's ean.
upc:
type: string
title: upc
description: The updated's upc.
allow_backorder:
type: boolean
title: allow_backorder
description: The updated's allow backorder.
manage_inventory:
type: boolean
title: manage_inventory
description: The updated's manage inventory.
hs_code:
type: string
title: hs_code
description: The updated's hs code.
origin_country:
type: string
title: origin_country
description: The updated's origin country.
mid_code:
type: string
title: mid_code
description: The updated's mid code.
material:
type: string
title: material
description: The updated's material.
weight:
type: number
title: weight
description: The updated's weight.
length:
type: number
title: length
description: The updated's length.
height:
type: number
title: height
description: The updated's height.
width:
type: number
title: width
description: The updated's width.
variant_rank:
type: number
title: variant_rank
description: The updated's variant rank.
options:
type: array
description: The updated's options.
items:
$ref: '#/components/schemas/BaseProductOptionValue'
product:
$ref: '#/components/schemas/BaseProduct'
product_id:
type: string
title: product_id
description: The updated's product id.
calculated_price:
$ref: '#/components/schemas/BaseCalculatedPriceSet'
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.
metadata:
type: object
description: The updated'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'
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:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductVariantParams
properties:
q:
type: string
title: q
description: The $and's q.
id:
oneOf:
- type: string
title: id
description: The $and's ID.
- type: array
description: The $and's ID.
items:
type: string
title: id
description: The id's ID.
sku:
oneOf:
- type: string
title: sku
description: The $and's sku.
- type: array
description: The $and's sku.
items:
type: string
title: sku
description: The sku's details.
product_id:
oneOf:
- type: string
title: product_id
description: The $and's product id.
- type: array
description: The $and's product id.
items:
type: string
title: product_id
description: The product id's details.
options:
type: object
description: The $and's options.
limit:
type: number
title: limit
description: The $and's limit.
offset:
type: number
title: offset
description: The $and's offset.
order:
type: string
title: order
description: The $and's order.
fields:
type: string
title: fields
description: The $and's fields.
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductVariantParams
- type: object
description: The $and's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductVariantParams
- type: object
description: The $or's details.
- type: object
description: The $and's details.
properties:
$and:
type: array
description: The $and's details.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductVariantParams
- type: object
description: The $and's details.
$or:
type: array
description: The $and's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductVariantParams
- type: object
description: The $or's details.
$or:
type: array
description: The variant's $or.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductVariantParams
properties:
q:
type: string
title: q
description: The $or's q.
id:
oneOf:
- type: string
title: id
description: The $or's ID.
- type: array
description: The $or's ID.
items:
type: string
title: id
description: The id's ID.
sku:
oneOf:
- type: string
title: sku
description: The $or's sku.
- type: array
description: The $or's sku.
items:
type: string
title: sku
description: The sku's details.
product_id:
oneOf:
- type: string
title: product_id
description: The $or's product id.
- type: array
description: The $or's product id.
items:
type: string
title: product_id
description: The product id's details.
options:
type: object
description: The $or's options.
limit:
type: number
title: limit
description: The $or's limit.
offset:
type: number
title: offset
description: The $or's offset.
order:
type: string
title: order
description: The $or's order.
fields:
type: string
title: fields
description: The $or's fields.
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductVariantParams
- type: object
description: The $and's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductVariantParams
- type: object
description: The $or's details.
- type: object
description: The $or's details.
properties:
$and:
type: array
description: The $or's $and.
items:
oneOf:
- type: object
description: The $and's details.
x-schemaName: BaseProductVariantParams
- type: object
description: The $and's details.
$or:
type: array
description: The $or's details.
items:
oneOf:
- type: object
description: The $or's details.
x-schemaName: BaseProductVariantParams
- type: object
description: The $or's details.
AdminProductVariantResponse:
type: object
description: SUMMARY
x-schemaName: AdminProductVariantResponse
required:
- variant
properties:
variant:
$ref: '#/components/schemas/AdminProductVariant'
AdminRevokeApiKey:
type: object
description: SUMMARY
x-schemaName: AdminRevokeApiKey
properties:
revoke_in:
type: number
title: revoke_in
description: The api key's revoke in.
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.
AdminServiceZone:
type: object
description: The service zone's service zones.
x-schemaName: AdminServiceZone
required:
- id
- name
- fulfillment_set_id
- 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.
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'
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'
AdminUpdateApiKey:
type: object
description: SUMMARY
x-schemaName: AdminUpdateApiKey
required:
- title
properties:
title:
type: string
title: title
description: The api key's title.
AdminUpdateCampaign:
type: object
description: SUMMARY
x-schemaName: AdminUpdateCampaign
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.
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.
AdminUpdateCustomer:
type: object
description: SUMMARY
x-schemaName: AdminUpdateCustomer
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.
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.
properties:
id:
type: string
title: id
description: The tag's ID.
value:
type: string
title: value
description: The tag's value.
options:
type: array
description: The update's options.
items:
$ref: '#/components/schemas/AdminUpdateProductOption'
variants:
type: array
description: The update's variants.
items:
$ref: '#/components/schemas/AdminCreateProductVariant'
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.
BaseCalculatedPriceSet:
type: object
description: The updated'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.
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.
BaseProduct:
type: object
description: The updated'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
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.
CreateUser:
type: object
description: SUMMARY
x-schemaName: CreateUser
required:
- email
properties:
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.
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
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.
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.
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 products.
x-schemaName: StoreProduct
required:
- title
- status
- length
- options
- description
- id
- handle
- hs_code
- weight
- height
- width
- origin_country
- mid_code
- material
- thumbnail
- created_at
- updated_at
- deleted_at
- variants
- subtitle
- is_giftcard
- collection_id
- type_id
- images
- discountable
- external_id
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.
handle:
type: string
title: handle
description: The product's handle.
hs_code:
type: string
title: hs_code
description: The product's hs code.
weight:
type: number
title: weight
description: The product's weight.
height:
type: number
title: height
description: The product's height.
width:
type: number
title: width
description: The product's width.
origin_country:
type: string
title: origin_country
description: The product's origin country.
mid_code:
type: string
title: mid_code
description: The product's mid code.
material:
type: string
title: material
description: The product's material.
thumbnail:
type: string
title: thumbnail
description: The product's thumbnail.
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.
variants:
type: array
description: The product's variants.
items:
$ref: '#/components/schemas/BaseProductVariant'
subtitle:
type: string
title: subtitle
description: The product's subtitle.
is_giftcard:
type: boolean
title: is_giftcard
description: The product's is giftcard.
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.
StoreProductCategory:
type: object
description: The product category's details.
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 product category's products.
items:
$ref: '#/components/schemas/StoreProduct'
id:
type: string
title: id
description: The product category's ID.
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_active:
type: boolean
title: is_active
description: The product category's is active.
is_internal:
type: boolean
title: is_internal
description: The product category's is internal.
rank:
type: number
title: rank
description: The product category's rank.
parent_category_id:
type: string
title: parent_category_id
description: The product category's parent category id.
parent_category:
$ref: '#/components/schemas/BaseProductCategory'
category_children:
type: array
description: The product category's category children.
items:
$ref: '#/components/schemas/BaseProductCategory'
created_at:
type: string
format: date-time
title: created_at
description: The product category's created at.
updated_at:
type: string
format: date-time
title: updated_at
description: The product category's updated at.
deleted_at:
type: string
format: date-time
title: deleted_at
description: The product 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'
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.