* docs: updates following authentication flow changes * generate sidebar * added open api specs * fix up OAS * changes to existing pages * change sidebar items * update marketplace recipe
59531 lines
2.1 MiB
59531 lines
2.1 MiB
openapi: 3.0.0
|
|
info:
|
|
version: 2.0.0
|
|
title: Medusa Admin API
|
|
license:
|
|
name: MIT
|
|
url: https://github.com/medusajs/medusa/blob/master/LICENSE
|
|
servers:
|
|
- url: http://localhost:9000
|
|
- url: https://api.medusa-commerce.com
|
|
tags:
|
|
- name: Auth
|
|
description: |
|
|
Auth API routes allow you to manage an admin user's authentication.
|
|
- name: Api Keys
|
|
- name: Campaigns
|
|
- name: Claims
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminClaim'
|
|
- name: Collections
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminCollection'
|
|
- name: Currencies
|
|
description: |
|
|
A store can use unlimited currencies, and each region must be associated with at least one currency.
|
|
Currencies are defined within the Medusa backend. Currency API Routes allow admins to list and update currencies.
|
|
externalDocs:
|
|
description: How to manage currencies
|
|
url: https://docs.medusajs.com/modules/regions-and-currencies/admin/manage-currencies
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminCurrency'
|
|
- name: Customer Groups
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminCustomerGroup'
|
|
- name: Customers
|
|
description: |
|
|
Customers can either be created when they register through the Store APIs, or created by the admin using the Admin APIs.
|
|
externalDocs:
|
|
description: How to manage customers
|
|
url: https://docs.medusajs.com/modules/customers/admin/manage-customers
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminCustomer'
|
|
- name: Draft Orders
|
|
- name: Exchanges
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminExchange'
|
|
- name: Fulfillment Providers
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminFulfillmentProvider'
|
|
- name: Fulfillment Sets
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminFulfillmentSet'
|
|
- name: Fulfillments
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminFulfillment'
|
|
- name: Inventory Items
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminInventoryItem'
|
|
- name: Invites
|
|
description: |
|
|
An admin can invite new users to manage their team. This would allow new users to authenticate as admins and perform admin functionalities.
|
|
externalDocs:
|
|
description: How to manage invites
|
|
url: https://docs.medusajs.com/modules/users/admin/manage-invites
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminInvite'
|
|
- name: Notifications
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminNotification'
|
|
- name: Order Edits
|
|
- name: Orders
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminOrder'
|
|
- name: Payment Collections
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminPaymentCollection'
|
|
- name: Payments
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminPayment'
|
|
- name: Price Lists
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminPriceList'
|
|
- name: Price Preferences
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminPricePreference'
|
|
- name: Product Categories
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminProductCategory'
|
|
- name: Product Tags
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminProductTag'
|
|
- name: Product Types
|
|
- name: Product Variants
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminProductVariant'
|
|
- name: Products
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminProduct'
|
|
- name: Promotions
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminPromotion'
|
|
- name: Refund Reasons
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminRefundReason'
|
|
- name: Regions
|
|
description: |
|
|
Regions are different countries or geographical regions that the commerce store serves customers in.
|
|
Admins can manage these regions, their providers, and more.
|
|
externalDocs:
|
|
description: How to manage regions
|
|
url: https://docs.medusajs.com/modules/regions-and-currencies/admin/manage-regions
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminRegion'
|
|
- name: Reservations
|
|
- name: Return Reasons
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminReturnReason'
|
|
- name: Returns
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminReturn'
|
|
- name: Sales Channels
|
|
description: |
|
|
A sales channel indicates a channel where products can be sold in. For example, a webshop or a mobile app.
|
|
Admins can manage sales channels and the products available in them.
|
|
externalDocs:
|
|
description: How to manage sales channels
|
|
url: https://docs.medusajs.com/modules/sales-channels/admin/manage
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminSalesChannel'
|
|
- name: Shipping Options
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminShippingOption'
|
|
- name: Shipping Profiles
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminShippingProfile'
|
|
- name: Stock Locations
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminStockLocation'
|
|
- name: Stores
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminStore'
|
|
- name: Tax Rates
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminTaxRate'
|
|
- name: Tax Regions
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminTaxRegion'
|
|
- name: Uploads
|
|
- name: Users
|
|
x-associatedSchema:
|
|
$ref: '#/components/schemas/AdminUser'
|
|
- name: Workflows Executions
|
|
paths:
|
|
/admin/api-keys:
|
|
get:
|
|
operationId: GetApiKeys
|
|
summary: List Api Keys
|
|
description: Retrieve a list of api keys. The api keys can be filtered by fields such as `id`. The api keys can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/api-keys' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Api Keys
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The api key's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The api key's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The api key's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- api_keys
|
|
properties:
|
|
api_keys:
|
|
type: array
|
|
description: The api key's api keys.
|
|
items:
|
|
$ref: '#/components/schemas/ApiKeyResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostApiKeys
|
|
summary: Create Api Key
|
|
description: Create a api key.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCreateApiKey'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/api-keys' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"title": "{value}",
|
|
"type": "{value}"
|
|
}'
|
|
tags:
|
|
- Api Keys
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminApiKeyResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createApiKeysWorkflow
|
|
/admin/api-keys/{id}:
|
|
get:
|
|
operationId: GetApiKeysId
|
|
summary: Get a Api Key
|
|
description: Retrieve a api key by its ID. You can expand the api key's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The api key's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/api-keys/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Api Keys
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminApiKeyResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostApiKeysId
|
|
summary: Update a Api Key
|
|
description: Update a api key's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The api key's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminUpdateApiKey'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/api-keys/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"title": "{value}"
|
|
}'
|
|
tags:
|
|
- Api Keys
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminApiKeyResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteApiKeysId
|
|
summary: Delete a Api Key
|
|
description: Delete a api key.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The api key's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/api-keys/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Api Keys
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The api key's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The api key's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The api key's deleted.
|
|
parent:
|
|
type: object
|
|
description: The api key's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/api-keys/{id}/revoke:
|
|
post:
|
|
operationId: PostApiKeysIdRevoke
|
|
summary: Add Revokes to Api Key
|
|
description: Add a list of revokes to a api key.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The api key's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminRevokeApiKey'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/api-keys/{id}/revoke' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Api Keys
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminApiKeyResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/api-keys/{id}/sales-channels:
|
|
post:
|
|
operationId: PostApiKeysIdSalesChannels
|
|
summary: Add Sales Channels to Api Key
|
|
description: Add a list of sales channels to a api key.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The api key's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
add:
|
|
type: array
|
|
description: The api key's add.
|
|
items:
|
|
type: string
|
|
title: add
|
|
description: The add's details.
|
|
remove:
|
|
type: array
|
|
description: The api key's remove.
|
|
items:
|
|
type: string
|
|
title: remove
|
|
description: The remove's details.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/api-keys/{id}/sales-channels' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Api Keys
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminApiKeyResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/campaigns:
|
|
get:
|
|
operationId: GetCampaigns
|
|
summary: List Campaigns
|
|
description: Retrieve a list of campaigns. The campaigns can be filtered by fields such as `id`. The campaigns can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/campaigns' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Campaigns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The campaign's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The campaign's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The campaign's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- campaigns
|
|
properties:
|
|
campaigns:
|
|
type: array
|
|
description: The campaign's campaigns.
|
|
items:
|
|
$ref: '#/components/schemas/CampaignResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostCampaigns
|
|
summary: Create Campaign
|
|
description: Create a campaign.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- name
|
|
- campaign_identifier
|
|
- description
|
|
- budget
|
|
- starts_at
|
|
- ends_at
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The campaign's name.
|
|
campaign_identifier:
|
|
type: string
|
|
title: campaign_identifier
|
|
description: The campaign's campaign identifier.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The campaign's description.
|
|
budget:
|
|
type: object
|
|
description: The campaign's budget.
|
|
required:
|
|
- type
|
|
- limit
|
|
- currency_code
|
|
properties:
|
|
type:
|
|
type: string
|
|
enum:
|
|
- spend
|
|
- usage
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The budget's limit.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The budget's currency code.
|
|
starts_at:
|
|
type: string
|
|
title: starts_at
|
|
description: The campaign's starts at.
|
|
format: date-time
|
|
ends_at:
|
|
type: string
|
|
title: ends_at
|
|
description: The campaign's ends at.
|
|
format: date-time
|
|
promotions:
|
|
type: array
|
|
description: The campaign's promotions.
|
|
items:
|
|
type: object
|
|
description: The promotion's promotions.
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The promotion's ID.
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/campaigns' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"name": "Gunner",
|
|
"campaign_identifier": "{value}",
|
|
"description": "{value}",
|
|
"starts_at": "2024-08-24T00:19:14.144Z",
|
|
"ends_at": "2024-10-01T06:47:50.133Z"
|
|
}'
|
|
tags:
|
|
- Campaigns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCampaignResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/campaigns/{id}:
|
|
get:
|
|
operationId: GetCampaignsId
|
|
summary: Get a Campaign
|
|
description: Retrieve a campaign by its ID. You can expand the campaign's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The campaign's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/campaigns/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Campaigns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCampaignResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostCampaignsId
|
|
summary: Update a Campaign
|
|
description: Update a campaign's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The campaign's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- description
|
|
- starts_at
|
|
- ends_at
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The campaign's name.
|
|
campaign_identifier:
|
|
type: string
|
|
title: campaign_identifier
|
|
description: The campaign's campaign identifier.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The campaign's description.
|
|
budget:
|
|
type: object
|
|
description: The campaign's budget.
|
|
required:
|
|
- limit
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The budget's limit.
|
|
starts_at:
|
|
type: string
|
|
title: starts_at
|
|
description: The campaign's starts at.
|
|
format: date-time
|
|
ends_at:
|
|
type: string
|
|
title: ends_at
|
|
description: The campaign's ends at.
|
|
format: date-time
|
|
promotions:
|
|
type: array
|
|
description: The campaign's promotions.
|
|
items:
|
|
type: object
|
|
description: The promotion's promotions.
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The promotion's ID.
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/campaigns/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"description": "{value}",
|
|
"starts_at": "2024-08-10T14:44:10.530Z",
|
|
"ends_at": "2024-07-13T17:45:37.462Z"
|
|
}'
|
|
tags:
|
|
- Campaigns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCampaignResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteCampaignsId
|
|
summary: Delete a Campaign
|
|
description: Delete a campaign.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The campaign's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/campaigns/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Campaigns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The campaign's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The campaign's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The campaign's deleted.
|
|
parent:
|
|
type: object
|
|
description: The campaign's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/campaigns/{id}/promotions:
|
|
post:
|
|
operationId: PostCampaignsIdPromotions
|
|
summary: Add Promotions to Campaign
|
|
description: Add a list of promotions to a campaign.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The campaign's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
add:
|
|
type: array
|
|
description: The campaign's add.
|
|
items:
|
|
type: string
|
|
title: add
|
|
description: The add's details.
|
|
remove:
|
|
type: array
|
|
description: The campaign's remove.
|
|
items:
|
|
type: string
|
|
title: remove
|
|
description: The remove's details.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/campaigns/{id}/promotions' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Campaigns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCampaignResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/claims:
|
|
get:
|
|
operationId: GetClaims
|
|
summary: List Claims
|
|
description: Retrieve a list of claims. The claims can be filtered by fields such as `id`. The claims can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/claims' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostClaims
|
|
summary: Create Claim
|
|
description: Create a claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostOrderClaimsReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/claims' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"type": "{value}",
|
|
"order_id": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimOrderResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/claims/{id}:
|
|
get:
|
|
operationId: GetClaimsId
|
|
summary: Get a Claim
|
|
description: Retrieve a claim by its ID. You can expand the claim's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/claims/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/claims/{id}/cancel:
|
|
post:
|
|
operationId: PostClaimsIdCancel
|
|
summary: Add Cancels to Claim
|
|
description: Add a list of cancels to a claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostCancelClaimReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/claims/{id}/cancel' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/claims/{id}/claim-items:
|
|
post:
|
|
operationId: PostClaimsIdClaimItems
|
|
summary: Add Claim Items to Claim
|
|
description: Add a list of claim items to a claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostClaimItemsReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/claims/{id}/claim-items' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: orderClaimItemWorkflow
|
|
/admin/claims/{id}/claim-items/{action_id}:
|
|
post:
|
|
operationId: PostClaimsIdClaimItemsAction_id
|
|
summary: Add Claim Items to Claim
|
|
description: Add a list of claim items to a claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The claim's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostClaimsItemsActionReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/claims/{id}/claim-items/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateClaimItemWorkflow
|
|
delete:
|
|
operationId: DeleteClaimsIdClaimItemsAction_id
|
|
summary: Remove Claim Items from Claim
|
|
description: Remove a list of claim items from a claim. This doesn't delete the Claim Item, only the association between the Claim Item and the claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The claim's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/claims/{id}/claim-items/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: removeItemClaimActionWorkflow
|
|
/admin/claims/{id}/inbound/items:
|
|
post:
|
|
operationId: PostClaimsIdInboundItems
|
|
summary: Add Items to Claim
|
|
description: Add a list of items to a claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostReturnsRequestItemsReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/claims/{id}/inbound/items' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: orderClaimRequestItemReturnWorkflow
|
|
/admin/claims/{id}/inbound/items/{action_id}:
|
|
post:
|
|
operationId: PostClaimsIdInboundItemsAction_id
|
|
summary: Add Items to Claim
|
|
description: Add a list of items to a claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The claim's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostReturnsRequestItemsActionReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/claims/{id}/inbound/items/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateRequestItemReturnWorkflow
|
|
delete:
|
|
operationId: DeleteClaimsIdInboundItemsAction_id
|
|
summary: Remove Items from Claim
|
|
description: Remove a list of items from a claim. This doesn't delete the Item, only the association between the Item and the claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The claim's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/claims/{id}/inbound/items/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: removeItemReturnActionWorkflow
|
|
/admin/claims/{id}/inbound/shipping-method:
|
|
post:
|
|
operationId: PostClaimsIdInboundShippingMethod
|
|
summary: Add Shipping Methods to Claim
|
|
description: Add a list of shipping methods to a claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostReturnsShippingReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/claims/{id}/inbound/shipping-method' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"shipping_option_id": "{value}"
|
|
}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createClaimShippingMethodWorkflow
|
|
/admin/claims/{id}/inbound/shipping-method/{action_id}:
|
|
post:
|
|
operationId: PostClaimsIdInboundShippingMethodAction_id
|
|
summary: Add Shipping Methods to Claim
|
|
description: Add a list of shipping methods to a claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The claim's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostClaimsShippingActionReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/claims/{id}/inbound/shipping-method/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateReturnShippingMethodWorkflow
|
|
delete:
|
|
operationId: DeleteClaimsIdInboundShippingMethodAction_id
|
|
summary: Remove Shipping Methods from Claim
|
|
description: Remove a list of shipping methods from a claim. This doesn't delete the Shipping Method, only the association between the Shipping Method and the claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The claim's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/claims/{id}/inbound/shipping-method/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: removeClaimShippingMethodWorkflow
|
|
/admin/claims/{id}/outbound/items:
|
|
post:
|
|
operationId: PostClaimsIdOutboundItems
|
|
summary: Add Items to Claim
|
|
description: Add a list of items to a claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostClaimsAddItemsReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/claims/{id}/outbound/items' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: orderClaimAddNewItemWorkflow
|
|
/admin/claims/{id}/outbound/items/{action_id}:
|
|
post:
|
|
operationId: PostClaimsIdOutboundItemsAction_id
|
|
summary: Add Items to Claim
|
|
description: Add a list of items to a claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The claim's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostClaimsItemsActionReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/claims/{id}/outbound/items/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateClaimAddItemWorkflow
|
|
delete:
|
|
operationId: DeleteClaimsIdOutboundItemsAction_id
|
|
summary: Remove Items from Claim
|
|
description: Remove a list of items from a claim. This doesn't delete the Item, only the association between the Item and the claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The claim's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/claims/{id}/outbound/items/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: removeAddItemClaimActionWorkflow
|
|
/admin/claims/{id}/outbound/shipping-method:
|
|
post:
|
|
operationId: PostClaimsIdOutboundShippingMethod
|
|
summary: Add Shipping Methods to Claim
|
|
description: Add a list of shipping methods to a claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostClaimsShippingReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/claims/{id}/outbound/shipping-method' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"shipping_option_id": "{value}"
|
|
}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createClaimShippingMethodWorkflow
|
|
/admin/claims/{id}/outbound/shipping-method/{action_id}:
|
|
post:
|
|
operationId: PostClaimsIdOutboundShippingMethodAction_id
|
|
summary: Add Shipping Methods to Claim
|
|
description: Add a list of shipping methods to a claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The claim's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostClaimsShippingActionReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/claims/{id}/outbound/shipping-method/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateClaimShippingMethodWorkflow
|
|
delete:
|
|
operationId: DeleteClaimsIdOutboundShippingMethodAction_id
|
|
summary: Remove Shipping Methods from Claim
|
|
description: Remove a list of shipping methods from a claim. This doesn't delete the Shipping Method, only the association between the Shipping Method and the claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The claim's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/claims/{id}/outbound/shipping-method/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: removeClaimShippingMethodWorkflow
|
|
/admin/claims/{id}/request:
|
|
post:
|
|
operationId: PostClaimsIdRequest
|
|
summary: Add Requests to Claim
|
|
description: Add a list of requests to a claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/claims/{id}/request' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimRequestResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema: {}
|
|
x-workflow: confirmClaimRequestWorkflow
|
|
delete:
|
|
operationId: DeleteClaimsIdRequest
|
|
summary: Remove Requests from Claim
|
|
description: Remove a list of requests from a claim. This doesn't delete the Request, only the association between the Request and the claim.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The claim's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/claims/{id}/request' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Claims
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminClaimDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/collections:
|
|
get:
|
|
operationId: GetCollections
|
|
summary: List Collections
|
|
description: Retrieve a list of collections. The collections can be filtered by fields such as `id`. The collections can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/collections' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Collections
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCollectionListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostCollections
|
|
summary: Create Collection
|
|
description: Create a collection.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCreateCollection'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/collections' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"title": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Collections
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCollectionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createCollectionsWorkflow
|
|
/admin/collections/{id}:
|
|
get:
|
|
operationId: GetCollectionsId
|
|
summary: Get a Collection
|
|
description: Retrieve a collection by its ID. You can expand the collection's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The collection's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/collections/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Collections
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCollectionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostCollectionsId
|
|
summary: Update a Collection
|
|
description: Update a collection's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The collection's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminUpdateCollection'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/collections/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Collections
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCollectionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteCollectionsId
|
|
summary: Delete a Collection
|
|
description: Delete a collection.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The collection's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/collections/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Collections
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCollectionDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/collections/{id}/products:
|
|
post:
|
|
operationId: PostCollectionsIdProducts
|
|
summary: Add Products to Collection
|
|
description: Add a list of products to a collection.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The collection's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
add:
|
|
type: array
|
|
description: The collection's add.
|
|
items:
|
|
type: string
|
|
title: add
|
|
description: The add's details.
|
|
remove:
|
|
type: array
|
|
description: The collection's remove.
|
|
items:
|
|
type: string
|
|
title: remove
|
|
description: The remove's details.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/collections/{id}/products' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Collections
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCollectionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/currencies:
|
|
get:
|
|
operationId: GetCurrencies
|
|
summary: List Currencies
|
|
description: Retrieve a list of currencies. The currencies can be filtered by fields such as `id`. The currencies can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/currencies' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Currencies
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCurrencyListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/currencies/{code}:
|
|
get:
|
|
operationId: GetCurrenciesCode
|
|
summary: Get a Currency
|
|
description: Retrieve a currency by its ID. You can expand the currency's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: code
|
|
in: path
|
|
description: The currency's code.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/currencies/{code}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Currencies
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCurrencyResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/customer-groups:
|
|
get:
|
|
operationId: GetCustomerGroups
|
|
summary: List Customer Groups
|
|
description: Retrieve a list of customer groups. The customer groups can be filtered by fields such as `id`. The customer groups can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/customer-groups' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Customer Groups
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The customer group's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The customer group's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The customer group's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- customer_groups
|
|
properties:
|
|
customer_groups:
|
|
type: array
|
|
description: The customer group's customer groups.
|
|
items:
|
|
$ref: '#/components/schemas/AdminCustomerGroup'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostCustomerGroups
|
|
summary: Create Customer Group
|
|
description: Create a customer group.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCreateCustomerGroup'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/customer-groups' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"name": "Solon",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Customer Groups
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCustomerGroupResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/customer-groups/{id}:
|
|
get:
|
|
operationId: GetCustomerGroupsId
|
|
summary: Get a Customer Group
|
|
description: Retrieve a customer group by its ID. You can expand the customer group's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The customer group's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/customer-groups/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Customer Groups
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCustomerGroupResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostCustomerGroupsId
|
|
summary: Update a Customer Group
|
|
description: Update a customer group's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The customer group's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminUpdateCustomerGroup'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/customer-groups/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"name": "Corbin",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Customer Groups
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCustomerGroupResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteCustomerGroupsId
|
|
summary: Delete a Customer Group
|
|
description: Delete a customer group.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The customer group's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/customer-groups/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Customer Groups
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The customer group's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The customer group's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The customer group's deleted.
|
|
parent:
|
|
type: object
|
|
description: The customer group's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/customer-groups/{id}/customers:
|
|
post:
|
|
operationId: PostCustomerGroupsIdCustomers
|
|
summary: Add Customers to Customer Group
|
|
description: Add a list of customers to a customer group.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The customer group's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
add:
|
|
type: array
|
|
description: The customer group's add.
|
|
items:
|
|
type: string
|
|
title: add
|
|
description: The add's details.
|
|
remove:
|
|
type: array
|
|
description: The customer group's remove.
|
|
items:
|
|
type: string
|
|
title: remove
|
|
description: The remove's details.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/customer-groups/{id}/customers' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Customer Groups
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCustomerGroupResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/customers:
|
|
get:
|
|
operationId: GetCustomers
|
|
summary: List Customers
|
|
description: Retrieve a list of customers. The customers can be filtered by fields such as `id`. The customers can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/customers' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Customers
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The customer's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The customer's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The customer's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- customers
|
|
properties:
|
|
customers:
|
|
$ref: '#/components/schemas/AdminCustomer'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostCustomers
|
|
summary: Create Customer
|
|
description: Create a customer.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- email
|
|
- company_name
|
|
- first_name
|
|
- last_name
|
|
- phone
|
|
- metadata
|
|
properties:
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The customer's email.
|
|
format: email
|
|
company_name:
|
|
type: string
|
|
title: company_name
|
|
description: The customer's company name.
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The customer's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The customer's last name.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The customer's phone.
|
|
metadata:
|
|
type: object
|
|
description: The customer's metadata.
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/customers' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"email": "Tomas.Toy16@yahoo.com",
|
|
"company_name": "{value}",
|
|
"first_name": "{value}",
|
|
"last_name": "{value}",
|
|
"phone": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Customers
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCustomerResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/customers/{id}:
|
|
get:
|
|
operationId: GetCustomersId
|
|
summary: Get a Customer
|
|
description: Retrieve a customer by its ID. You can expand the customer's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The customer's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/customers/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Customers
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCustomerResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostCustomersId
|
|
summary: Update a Customer
|
|
description: Update a customer's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The customer's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- email
|
|
- company_name
|
|
- first_name
|
|
- last_name
|
|
- phone
|
|
- metadata
|
|
properties:
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The customer's email.
|
|
format: email
|
|
company_name:
|
|
type: string
|
|
title: company_name
|
|
description: The customer's company name.
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The customer's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The customer's last name.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The customer's phone.
|
|
metadata:
|
|
type: object
|
|
description: The customer's metadata.
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/customers/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"email": "Daren_Rodriguez-Rutherford93@gmail.com",
|
|
"company_name": "{value}",
|
|
"first_name": "{value}",
|
|
"last_name": "{value}",
|
|
"phone": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Customers
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCustomerResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteCustomersId
|
|
summary: Delete a Customer
|
|
description: Delete a customer.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The customer's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/customers/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Customers
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The customer's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The customer's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The customer's deleted.
|
|
parent:
|
|
type: object
|
|
description: The customer's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/customers/{id}/addresses:
|
|
get:
|
|
operationId: GetCustomersIdAddresses
|
|
summary: List Addresses
|
|
description: Retrieve a list of addresses in a customer. The addresses can be filtered by fields like FILTER FIELDS. The addresses can also be paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The customer's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/customers/{id}/addresses' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Customers
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The customer's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The customer's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The customer's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- addresses
|
|
properties:
|
|
addresses:
|
|
type: array
|
|
description: The customer's addresses.
|
|
items:
|
|
$ref: '#/components/schemas/AdminCustomerAddress'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostCustomersIdAddresses
|
|
summary: Add Addresses to Customer
|
|
description: Add a list of addresses to a customer.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The customer's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- address_name
|
|
- company
|
|
- first_name
|
|
- last_name
|
|
- address_1
|
|
- address_2
|
|
- city
|
|
- country_code
|
|
- province
|
|
- postal_code
|
|
- phone
|
|
- metadata
|
|
properties:
|
|
address_name:
|
|
type: string
|
|
title: address_name
|
|
description: The customer's address name.
|
|
is_default_shipping:
|
|
type: boolean
|
|
title: is_default_shipping
|
|
description: The customer's is default shipping.
|
|
is_default_billing:
|
|
type: boolean
|
|
title: is_default_billing
|
|
description: The customer's is default billing.
|
|
company:
|
|
type: string
|
|
title: company
|
|
description: The customer's company.
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The customer's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The customer's last name.
|
|
address_1:
|
|
type: string
|
|
title: address_1
|
|
description: The customer's address 1.
|
|
address_2:
|
|
type: string
|
|
title: address_2
|
|
description: The customer's address 2.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The customer's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The customer's country code.
|
|
province:
|
|
type: string
|
|
title: province
|
|
description: The customer's province.
|
|
postal_code:
|
|
type: string
|
|
title: postal_code
|
|
description: The customer's postal code.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The customer's phone.
|
|
metadata:
|
|
type: object
|
|
description: The customer's metadata.
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/customers/{id}/addresses' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"address_name": "{value}",
|
|
"company": "{value}",
|
|
"first_name": "{value}",
|
|
"last_name": "{value}",
|
|
"address_1": "{value}",
|
|
"address_2": "{value}",
|
|
"city": "{value}",
|
|
"country_code": "{value}",
|
|
"province": "{value}",
|
|
"postal_code": "{value}",
|
|
"phone": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Customers
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCustomerResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/customers/{id}/addresses/{address_id}:
|
|
get:
|
|
operationId: GetCustomersIdAddressesAddress_id
|
|
summary: List Addresses
|
|
description: Retrieve a list of addresses in a customer. The addresses can be filtered by fields like FILTER FIELDS. The addresses can also be paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The customer's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: address_id
|
|
in: path
|
|
description: The customer's address id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/customers/{id}/addresses/{address_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Customers
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCustomerAddressResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostCustomersIdAddressesAddress_id
|
|
summary: Add Addresses to Customer
|
|
description: Add a list of addresses to a customer.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The customer's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: address_id
|
|
in: path
|
|
description: The customer's address id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- address_name
|
|
- company
|
|
- first_name
|
|
- last_name
|
|
- address_1
|
|
- address_2
|
|
- city
|
|
- country_code
|
|
- province
|
|
- postal_code
|
|
- phone
|
|
- metadata
|
|
properties:
|
|
address_name:
|
|
type: string
|
|
title: address_name
|
|
description: The customer's address name.
|
|
is_default_shipping:
|
|
type: boolean
|
|
title: is_default_shipping
|
|
description: The customer's is default shipping.
|
|
is_default_billing:
|
|
type: boolean
|
|
title: is_default_billing
|
|
description: The customer's is default billing.
|
|
company:
|
|
type: string
|
|
title: company
|
|
description: The customer's company.
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The customer's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The customer's last name.
|
|
address_1:
|
|
type: string
|
|
title: address_1
|
|
description: The customer's address 1.
|
|
address_2:
|
|
type: string
|
|
title: address_2
|
|
description: The customer's address 2.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The customer's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The customer's country code.
|
|
province:
|
|
type: string
|
|
title: province
|
|
description: The customer's province.
|
|
postal_code:
|
|
type: string
|
|
title: postal_code
|
|
description: The customer's postal code.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The customer's phone.
|
|
metadata:
|
|
type: object
|
|
description: The customer's metadata.
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/customers/{id}/addresses/{address_id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"address_name": "{value}",
|
|
"company": "{value}",
|
|
"first_name": "{value}",
|
|
"last_name": "{value}",
|
|
"address_1": "{value}",
|
|
"address_2": "{value}",
|
|
"city": "{value}",
|
|
"country_code": "{value}",
|
|
"province": "{value}",
|
|
"postal_code": "{value}",
|
|
"phone": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Customers
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCustomerResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteCustomersIdAddressesAddress_id
|
|
summary: Remove Addresses from Customer
|
|
description: Remove a list of addresses from a customer. This doesn't delete the Address, only the association between the Address and the customer.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The customer's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: address_id
|
|
in: path
|
|
description: The customer's address id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/customers/{id}/addresses/{address_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Customers
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The customer's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The customer's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The customer's deleted.
|
|
parent:
|
|
type: object
|
|
description: The customer's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/draft-orders:
|
|
get:
|
|
operationId: GetDraftOrders
|
|
summary: List Draft Orders
|
|
description: Retrieve a list of draft orders. The draft orders can be filtered by fields such as `id`. The draft orders can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/draft-orders' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Draft Orders
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The draft order's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The draft order's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The draft order's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- draft_orders
|
|
properties:
|
|
draft_orders:
|
|
$ref: '#/components/schemas/AdminOrder'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostDraftOrders
|
|
summary: Create Draft Order
|
|
description: Create a draft order.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- sales_channel_id
|
|
- email
|
|
- customer_id
|
|
- region_id
|
|
- currency_code
|
|
- shipping_methods
|
|
- metadata
|
|
properties:
|
|
status:
|
|
type: boolean
|
|
title: status
|
|
description: The draft order's status.
|
|
sales_channel_id:
|
|
type: string
|
|
title: sales_channel_id
|
|
description: The draft order's sales channel id.
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The draft order's email.
|
|
format: email
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The draft order's customer id.
|
|
billing_address:
|
|
type: object
|
|
description: The draft order's billing address.
|
|
required:
|
|
- first_name
|
|
- last_name
|
|
- phone
|
|
- company
|
|
- address_1
|
|
- address_2
|
|
- city
|
|
- country_code
|
|
- province
|
|
- postal_code
|
|
- metadata
|
|
properties:
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The billing address's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The billing address's last name.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The billing address's phone.
|
|
company:
|
|
type: string
|
|
title: company
|
|
description: The billing address's company.
|
|
address_1:
|
|
type: string
|
|
title: address_1
|
|
description: The billing address's address 1.
|
|
address_2:
|
|
type: string
|
|
title: address_2
|
|
description: The billing address's address 2.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The billing address's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The billing address's country code.
|
|
province:
|
|
type: string
|
|
title: province
|
|
description: The billing address's province.
|
|
postal_code:
|
|
type: string
|
|
title: postal_code
|
|
description: The billing address's postal code.
|
|
metadata:
|
|
type: object
|
|
description: The billing address's metadata.
|
|
shipping_address:
|
|
type: object
|
|
description: The draft order's shipping address.
|
|
required:
|
|
- first_name
|
|
- last_name
|
|
- phone
|
|
- company
|
|
- address_1
|
|
- address_2
|
|
- city
|
|
- country_code
|
|
- province
|
|
- postal_code
|
|
- metadata
|
|
properties:
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The shipping address's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The shipping address's last name.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The shipping address's phone.
|
|
company:
|
|
type: string
|
|
title: company
|
|
description: The shipping address's company.
|
|
address_1:
|
|
type: string
|
|
title: address_1
|
|
description: The shipping address's address 1.
|
|
address_2:
|
|
type: string
|
|
title: address_2
|
|
description: The shipping address's address 2.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The shipping address's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The shipping address's country code.
|
|
province:
|
|
type: string
|
|
title: province
|
|
description: The shipping address's province.
|
|
postal_code:
|
|
type: string
|
|
title: postal_code
|
|
description: The shipping address's postal code.
|
|
metadata:
|
|
type: object
|
|
description: The shipping address's metadata.
|
|
items:
|
|
type: array
|
|
description: The draft order's items.
|
|
items:
|
|
type: object
|
|
description: The item's items.
|
|
required:
|
|
- title
|
|
- sku
|
|
- barcode
|
|
- variant_id
|
|
- unit_price
|
|
- quantity
|
|
- metadata
|
|
properties:
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The item's title.
|
|
sku:
|
|
type: string
|
|
title: sku
|
|
description: The item's sku.
|
|
barcode:
|
|
type: string
|
|
title: barcode
|
|
description: The item's barcode.
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The item's variant id.
|
|
unit_price:
|
|
oneOf:
|
|
- type: string
|
|
title: unit_price
|
|
description: The item's unit price.
|
|
- type: number
|
|
title: unit_price
|
|
description: The item's unit price.
|
|
- type: object
|
|
description: The item's unit price.
|
|
required:
|
|
- value
|
|
- precision
|
|
properties:
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The unit price's value.
|
|
precision:
|
|
type: number
|
|
title: precision
|
|
description: The unit price's precision.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The item's quantity.
|
|
metadata:
|
|
type: object
|
|
description: The item's metadata.
|
|
region_id:
|
|
type: string
|
|
title: region_id
|
|
description: The draft order's region id.
|
|
promo_codes:
|
|
type: array
|
|
description: The draft order's promo codes.
|
|
items:
|
|
type: string
|
|
title: promo_codes
|
|
description: The promo code's promo codes.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The draft order's currency code.
|
|
no_notification_order:
|
|
type: boolean
|
|
title: no_notification_order
|
|
description: The draft order's no notification order.
|
|
shipping_methods:
|
|
type: array
|
|
description: The draft order's shipping methods.
|
|
items:
|
|
type: object
|
|
description: The shipping method's shipping methods.
|
|
required:
|
|
- shipping_method_id
|
|
- order_id
|
|
- name
|
|
- option_id
|
|
- amount
|
|
properties:
|
|
shipping_method_id:
|
|
type: string
|
|
title: shipping_method_id
|
|
description: The shipping method's shipping method id.
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The shipping method's order id.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The shipping method's name.
|
|
option_id:
|
|
type: string
|
|
title: option_id
|
|
description: The shipping method's option id.
|
|
data:
|
|
type: object
|
|
description: The shipping method's data.
|
|
amount:
|
|
oneOf:
|
|
- type: string
|
|
title: amount
|
|
description: The shipping method's amount.
|
|
- type: number
|
|
title: amount
|
|
description: The shipping method's amount.
|
|
- type: object
|
|
description: The shipping method's amount.
|
|
required:
|
|
- value
|
|
- precision
|
|
properties:
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The amount's value.
|
|
precision:
|
|
type: number
|
|
title: precision
|
|
description: The amount's precision.
|
|
metadata:
|
|
type: object
|
|
description: The draft order's metadata.
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/draft-orders' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"sales_channel_id": "{value}",
|
|
"email": "Bartholome.Goodwin90@yahoo.com",
|
|
"customer_id": "{value}",
|
|
"region_id": "{value}",
|
|
"currency_code": "{value}",
|
|
"shipping_methods": [
|
|
{
|
|
"shipping_method_id": "{value}",
|
|
"order_id": "{value}",
|
|
"name": "Cheyanne",
|
|
"option_id": "{value}"
|
|
}
|
|
],
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Draft Orders
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminDraftOrderResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createOrdersWorkflow
|
|
/admin/draft-orders/{id}:
|
|
get:
|
|
operationId: GetDraftOrdersId
|
|
summary: Get a Draft Order
|
|
description: Retrieve a draft order by its ID. You can expand the draft order's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The draft order's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/draft-orders/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Draft Orders
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminDraftOrderResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/exchanges:
|
|
get:
|
|
operationId: GetExchanges
|
|
summary: List Exchanges
|
|
description: Retrieve a list of exchanges. The exchanges can be filtered by fields such as `id`. The exchanges can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/exchanges' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Exchanges
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The exchange's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The exchange's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The exchange's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- exchanges
|
|
properties:
|
|
exchanges:
|
|
$ref: '#/components/schemas/AdminExchange'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostExchanges
|
|
summary: Create Exchange
|
|
description: Create a exchange.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostOrderExchangesReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/exchanges' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"order_id": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Exchanges
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminExchangeOrderResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/exchanges/{id}:
|
|
get:
|
|
operationId: GetExchangesId
|
|
summary: Get a Exchange
|
|
description: Retrieve a exchange by its ID. You can expand the exchange's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The exchange's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/exchanges/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Exchanges
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminExchangeResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/exchanges/{id}/cancel:
|
|
post:
|
|
operationId: PostExchangesIdCancel
|
|
summary: Add Cancels to Exchange
|
|
description: Add a list of cancels to a exchange.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The exchange's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostCancelExchangeReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/exchanges/{id}/cancel' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Exchanges
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminExchangeResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/exchanges/{id}/inbound/items:
|
|
post:
|
|
operationId: PostExchangesIdInboundItems
|
|
summary: Add Items to Exchange
|
|
description: Add a list of items to a exchange.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The exchange's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostExchangesReturnRequestItemsReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/exchanges/{id}/inbound/items' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Exchanges
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminExchangeReturnResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: orderExchangeRequestItemReturnWorkflow
|
|
/admin/exchanges/{id}/inbound/items/{action_id}:
|
|
post:
|
|
operationId: PostExchangesIdInboundItemsAction_id
|
|
summary: Add Items to Exchange
|
|
description: Add a list of items to a exchange.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The exchange's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The exchange's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostExchangesRequestItemsReturnActionReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/exchanges/{id}/inbound/items/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Exchanges
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminExchangeReturnResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateRequestItemReturnWorkflow
|
|
delete:
|
|
operationId: DeleteExchangesIdInboundItemsAction_id
|
|
summary: Remove Items from Exchange
|
|
description: Remove a list of items from a exchange. This doesn't delete the Item, only the association between the Item and the exchange.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The exchange's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The exchange's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/exchanges/{id}/inbound/items/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Exchanges
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminExchangeReturnResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: removeItemReturnActionWorkflow
|
|
/admin/exchanges/{id}/inbound/shipping-method:
|
|
post:
|
|
operationId: PostExchangesIdInboundShippingMethod
|
|
summary: Add Shipping Methods to Exchange
|
|
description: Add a list of shipping methods to a exchange.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The exchange's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostReturnsShippingReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/exchanges/{id}/inbound/shipping-method' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"shipping_option_id": "{value}"
|
|
}'
|
|
tags:
|
|
- Exchanges
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminExchangeReturnResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createExchangeShippingMethodWorkflow
|
|
/admin/exchanges/{id}/inbound/shipping-method/{action_id}:
|
|
post:
|
|
operationId: PostExchangesIdInboundShippingMethodAction_id
|
|
summary: Add Shipping Methods to Exchange
|
|
description: Add a list of shipping methods to a exchange.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The exchange's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The exchange's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostExchangesShippingActionReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/exchanges/{id}/inbound/shipping-method/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Exchanges
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminExchangePreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateReturnShippingMethodWorkflow
|
|
delete:
|
|
operationId: DeleteExchangesIdInboundShippingMethodAction_id
|
|
summary: Remove Shipping Methods from Exchange
|
|
description: Remove a list of shipping methods from a exchange. This doesn't delete the Shipping Method, only the association between the Shipping Method and the exchange.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The exchange's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The exchange's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/exchanges/{id}/inbound/shipping-method/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Exchanges
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminExchangeReturnResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: removeReturnShippingMethodWorkflow
|
|
/admin/exchanges/{id}/outbound/items:
|
|
post:
|
|
operationId: PostExchangesIdOutboundItems
|
|
summary: Add Items to Exchange
|
|
description: Add a list of items to a exchange.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The exchange's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostExchangesAddItemsReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/exchanges/{id}/outbound/items' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Exchanges
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminExchangePreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: orderExchangeAddNewItemWorkflow
|
|
/admin/exchanges/{id}/outbound/items/{action_id}:
|
|
post:
|
|
operationId: PostExchangesIdOutboundItemsAction_id
|
|
summary: Add Items to Exchange
|
|
description: Add a list of items to a exchange.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The exchange's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The exchange's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostExchangesItemsActionReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/exchanges/{id}/outbound/items/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Exchanges
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminExchangePreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateExchangeAddItemWorkflow
|
|
delete:
|
|
operationId: DeleteExchangesIdOutboundItemsAction_id
|
|
summary: Remove Items from Exchange
|
|
description: Remove a list of items from a exchange. This doesn't delete the Item, only the association between the Item and the exchange.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The exchange's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The exchange's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/exchanges/{id}/outbound/items/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Exchanges
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminExchangePreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: removeItemExchangeActionWorkflow
|
|
/admin/exchanges/{id}/outbound/shipping-method:
|
|
post:
|
|
operationId: PostExchangesIdOutboundShippingMethod
|
|
summary: Add Shipping Methods to Exchange
|
|
description: Add a list of shipping methods to a exchange.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The exchange's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostExchangesShippingReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/exchanges/{id}/outbound/shipping-method' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"shipping_option_id": "{value}"
|
|
}'
|
|
tags:
|
|
- Exchanges
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminExchangePreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createExchangeShippingMethodWorkflow
|
|
/admin/exchanges/{id}/outbound/shipping-method/{action_id}:
|
|
post:
|
|
operationId: PostExchangesIdOutboundShippingMethodAction_id
|
|
summary: Add Shipping Methods to Exchange
|
|
description: Add a list of shipping methods to a exchange.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The exchange's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The exchange's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostExchangesShippingActionReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/exchanges/{id}/outbound/shipping-method/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Exchanges
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminExchangePreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateExchangeShippingMethodWorkflow
|
|
delete:
|
|
operationId: DeleteExchangesIdOutboundShippingMethodAction_id
|
|
summary: Remove Shipping Methods from Exchange
|
|
description: Remove a list of shipping methods from a exchange. This doesn't delete the Shipping Method, only the association between the Shipping Method and the exchange.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The exchange's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The exchange's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/exchanges/{id}/outbound/shipping-method/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Exchanges
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminExchangePreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: removeExchangeShippingMethodWorkflow
|
|
/admin/exchanges/{id}/request:
|
|
post:
|
|
operationId: PostExchangesIdRequest
|
|
summary: Add Requests to Exchange
|
|
description: Add a list of requests to a exchange.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The exchange's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/exchanges/{id}/request' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Exchanges
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminExchangeRequestResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: confirmExchangeRequestWorkflow
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema: {}
|
|
delete:
|
|
operationId: DeleteExchangesIdRequest
|
|
summary: Remove Requests from Exchange
|
|
description: Remove a list of requests from a exchange. This doesn't delete the Request, only the association between the Request and the exchange.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The exchange's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/exchanges/{id}/request' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Exchanges
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The exchange's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The exchange's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The exchange's deleted.
|
|
parent:
|
|
type: object
|
|
description: The exchange's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/fulfillment-providers:
|
|
get:
|
|
operationId: GetFulfillmentProviders
|
|
summary: List Fulfillment Providers
|
|
description: Retrieve a list of fulfillment providers. The fulfillment providers can be filtered by fields such as `id`. The fulfillment providers can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The fulfillment provider's ID.
|
|
- type: array
|
|
description: The fulfillment provider's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: is_enabled
|
|
in: query
|
|
description: The fulfillment provider's is enabled.
|
|
required: true
|
|
schema:
|
|
type: boolean
|
|
title: is_enabled
|
|
description: The fulfillment provider's is enabled.
|
|
- name: q
|
|
in: query
|
|
description: The fulfillment provider's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The fulfillment provider's q.
|
|
- name: stock_location_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: stock_location_id
|
|
description: The fulfillment provider's stock location id.
|
|
- type: array
|
|
description: The fulfillment provider's stock location id.
|
|
items:
|
|
type: string
|
|
title: stock_location_id
|
|
description: The stock location id's details.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/fulfillment-providers' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Fulfillment Providers
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminFulfillmentProviderListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/fulfillment-sets/{id}:
|
|
delete:
|
|
operationId: DeleteFulfillmentSetsId
|
|
summary: Delete a Fulfillment Set
|
|
description: Delete a fulfillment set.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The fulfillment set's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/fulfillment-sets/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Fulfillment Sets
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminFulfillmentSetDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/fulfillment-sets/{id}/service-zones:
|
|
post:
|
|
operationId: PostFulfillmentSetsIdServiceZones
|
|
summary: Add Service Zones to Fulfillment Set
|
|
description: Add a list of service zones to a fulfillment set.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The fulfillment set's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- name
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The fulfillment set's name.
|
|
geo_zones:
|
|
type: array
|
|
description: The fulfillment set's geo zones.
|
|
items:
|
|
oneOf:
|
|
- type: object
|
|
description: The geo zone's geo zones.
|
|
required:
|
|
- metadata
|
|
- country_code
|
|
- type
|
|
properties:
|
|
metadata:
|
|
type: object
|
|
description: The geo zone's metadata.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The geo zone's country code.
|
|
type:
|
|
type: string
|
|
title: type
|
|
description: The geo zone's type.
|
|
- type: object
|
|
description: The geo zone's geo zones.
|
|
required:
|
|
- metadata
|
|
- country_code
|
|
- type
|
|
- province_code
|
|
properties:
|
|
metadata:
|
|
type: object
|
|
description: The geo zone's metadata.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The geo zone's country code.
|
|
type:
|
|
type: string
|
|
title: type
|
|
description: The geo zone's type.
|
|
province_code:
|
|
type: string
|
|
title: province_code
|
|
description: The geo zone's province code.
|
|
- type: object
|
|
description: The geo zone's geo zones.
|
|
required:
|
|
- metadata
|
|
- country_code
|
|
- type
|
|
- province_code
|
|
- city
|
|
properties:
|
|
metadata:
|
|
type: object
|
|
description: The geo zone's metadata.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The geo zone's country code.
|
|
type:
|
|
type: string
|
|
title: type
|
|
description: The geo zone's type.
|
|
province_code:
|
|
type: string
|
|
title: province_code
|
|
description: The geo zone's province code.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The geo zone's city.
|
|
- type: object
|
|
description: The geo zone's geo zones.
|
|
required:
|
|
- metadata
|
|
- country_code
|
|
- type
|
|
- province_code
|
|
- city
|
|
- postal_expression
|
|
properties:
|
|
metadata:
|
|
type: object
|
|
description: The geo zone's metadata.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The geo zone's country code.
|
|
type:
|
|
type: string
|
|
title: type
|
|
description: The geo zone's type.
|
|
province_code:
|
|
type: string
|
|
title: province_code
|
|
description: The geo zone's province code.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The geo zone's city.
|
|
postal_expression:
|
|
type: object
|
|
description: The geo zone's postal expression.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/fulfillment-sets/{id}/service-zones' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"name": "Layla"
|
|
}'
|
|
tags:
|
|
- Fulfillment Sets
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminFulfillmentSetResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/fulfillment-sets/{id}/service-zones/{zone_id}:
|
|
get:
|
|
operationId: GetFulfillmentSetsIdServiceZonesZone_id
|
|
summary: List Service Zones
|
|
description: Retrieve a list of service zones in a fulfillment set. The service zones can be filtered by fields like FILTER FIELDS. The service zones can also be paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The fulfillment set's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: zone_id
|
|
in: path
|
|
description: The fulfillment set's zone id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/fulfillment-sets/{id}/service-zones/{zone_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Fulfillment Sets
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminServiceZoneResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostFulfillmentSetsIdServiceZonesZone_id
|
|
summary: Add Service Zones to Fulfillment Set
|
|
description: Add a list of service zones to a fulfillment set.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The fulfillment set's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: zone_id
|
|
in: path
|
|
description: The fulfillment set's zone id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- name
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The fulfillment set's name.
|
|
geo_zones:
|
|
type: array
|
|
description: The fulfillment set's geo zones.
|
|
items:
|
|
oneOf:
|
|
- type: object
|
|
description: The geo zone's geo zones.
|
|
required:
|
|
- type
|
|
- metadata
|
|
- country_code
|
|
properties:
|
|
type:
|
|
type: string
|
|
title: type
|
|
description: The geo zone's type.
|
|
metadata:
|
|
type: object
|
|
description: The geo zone's metadata.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The geo zone's country code.
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The geo zone's ID.
|
|
- type: object
|
|
description: The geo zone's geo zones.
|
|
required:
|
|
- type
|
|
- metadata
|
|
- country_code
|
|
- province_code
|
|
properties:
|
|
type:
|
|
type: string
|
|
title: type
|
|
description: The geo zone's type.
|
|
metadata:
|
|
type: object
|
|
description: The geo zone's metadata.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The geo zone's country code.
|
|
province_code:
|
|
type: string
|
|
title: province_code
|
|
description: The geo zone's province code.
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The geo zone's ID.
|
|
- type: object
|
|
description: The geo zone's geo zones.
|
|
required:
|
|
- type
|
|
- metadata
|
|
- city
|
|
- country_code
|
|
- province_code
|
|
properties:
|
|
type:
|
|
type: string
|
|
title: type
|
|
description: The geo zone's type.
|
|
metadata:
|
|
type: object
|
|
description: The geo zone's metadata.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The geo zone's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The geo zone's country code.
|
|
province_code:
|
|
type: string
|
|
title: province_code
|
|
description: The geo zone's province code.
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The geo zone's ID.
|
|
- type: object
|
|
description: The geo zone's geo zones.
|
|
required:
|
|
- type
|
|
- metadata
|
|
- city
|
|
- country_code
|
|
- province_code
|
|
- postal_expression
|
|
properties:
|
|
type:
|
|
type: string
|
|
title: type
|
|
description: The geo zone's type.
|
|
metadata:
|
|
type: object
|
|
description: The geo zone's metadata.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The geo zone's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The geo zone's country code.
|
|
province_code:
|
|
type: string
|
|
title: province_code
|
|
description: The geo zone's province code.
|
|
postal_expression:
|
|
type: object
|
|
description: The geo zone's postal expression.
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The geo zone's ID.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/fulfillment-sets/{id}/service-zones/{zone_id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"name": "Elvis"
|
|
}'
|
|
tags:
|
|
- Fulfillment Sets
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminFulfillmentSetResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteFulfillmentSetsIdServiceZonesZone_id
|
|
summary: Remove Service Zones from Fulfillment Set
|
|
description: Remove a list of service zones from a fulfillment set. This doesn't delete the Service Zone, only the association between the Service Zone and the fulfillment set.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The fulfillment set's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: zone_id
|
|
in: path
|
|
description: The fulfillment set's zone id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/fulfillment-sets/{id}/service-zones/{zone_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Fulfillment Sets
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The fulfillment set's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The fulfillment set's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The fulfillment set's deleted.
|
|
parent:
|
|
type: object
|
|
description: The fulfillment set's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/fulfillments:
|
|
post:
|
|
operationId: PostFulfillments
|
|
summary: Create Fulfillment
|
|
description: Create a fulfillment.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCreateFulfillment'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/fulfillments' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"location_id": "{value}",
|
|
"provider_id": "{value}",
|
|
"delivery_address": {
|
|
"first_name": "{value}",
|
|
"last_name": "{value}",
|
|
"phone": "{value}",
|
|
"company": "{value}",
|
|
"address_1": "{value}",
|
|
"address_2": "{value}",
|
|
"city": "{value}",
|
|
"country_code": "{value}",
|
|
"province": "{value}",
|
|
"postal_code": "{value}",
|
|
"metadata": {}
|
|
},
|
|
"items": [
|
|
{
|
|
"title": "{value}",
|
|
"sku": "{value}",
|
|
"quantity": 1667318922870784,
|
|
"barcode": "{value}",
|
|
"line_item_id": "{value}",
|
|
"inventory_item_id": "{value}"
|
|
}
|
|
],
|
|
"labels": [
|
|
{
|
|
"tracking_number": "{value}",
|
|
"tracking_url": "{value}",
|
|
"label_url": "{value}"
|
|
}
|
|
],
|
|
"order": {},
|
|
"order_id": "{value}",
|
|
"shipping_option_id": "{value}",
|
|
"data": {},
|
|
"packed_at": "2024-11-12T18:37:37.122Z",
|
|
"shipped_at": "2025-04-13T12:39:42.432Z",
|
|
"delivered_at": "2025-01-29T19:05:57.056Z",
|
|
"canceled_at": "2025-02-16T02:12:11.763Z",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Fulfillments
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminFulfillmentResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createFulfillmentWorkflow
|
|
/admin/fulfillments/{id}/cancel:
|
|
post:
|
|
operationId: PostFulfillmentsIdCancel
|
|
summary: Add Cancels to Fulfillment
|
|
description: Add a list of cancels to a fulfillment.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The fulfillment's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCancelFulfillment'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/fulfillments/{id}/cancel' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Fulfillments
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminFulfillmentResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/fulfillments/{id}/shipment:
|
|
post:
|
|
operationId: PostFulfillmentsIdShipment
|
|
summary: Add Shipments to Fulfillment
|
|
description: Add a list of shipments to a fulfillment.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The fulfillment's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCreateShipment'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/fulfillments/{id}/shipment' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"labels": [
|
|
{
|
|
"tracking_number": "{value}",
|
|
"tracking_url": "{value}",
|
|
"label_url": "{value}"
|
|
}
|
|
]
|
|
}'
|
|
tags:
|
|
- Fulfillments
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminFulfillmentResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/inventory-items:
|
|
get:
|
|
operationId: GetInventoryItems
|
|
summary: List Inventory Items
|
|
description: Retrieve a list of inventory items. The inventory items can be filtered by fields such as `id`. The inventory items can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: q
|
|
in: query
|
|
description: The inventory item's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The inventory item's q.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The inventory item's ID.
|
|
- type: array
|
|
description: The inventory item's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: sku
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: sku
|
|
description: The inventory item's sku.
|
|
- type: array
|
|
description: The inventory item's sku.
|
|
items:
|
|
type: string
|
|
title: sku
|
|
description: The sku's details.
|
|
- name: origin_country
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: origin_country
|
|
description: The inventory item's origin country.
|
|
- type: array
|
|
description: The inventory item's origin country.
|
|
items:
|
|
type: string
|
|
title: origin_country
|
|
description: The origin country's details.
|
|
- name: mid_code
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: mid_code
|
|
description: The inventory item's mid code.
|
|
- type: array
|
|
description: The inventory item's mid code.
|
|
items:
|
|
type: string
|
|
title: mid_code
|
|
description: The mid code's details.
|
|
- name: hs_code
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: hs_code
|
|
description: The inventory item's hs code.
|
|
- type: array
|
|
description: The inventory item's hs code.
|
|
items:
|
|
type: string
|
|
title: hs_code
|
|
description: The hs code's details.
|
|
- name: material
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: material
|
|
description: The inventory item's material.
|
|
- type: array
|
|
description: The inventory item's material.
|
|
items:
|
|
type: string
|
|
title: material
|
|
description: The material's details.
|
|
- name: requires_shipping
|
|
in: query
|
|
description: The inventory item's requires shipping.
|
|
required: true
|
|
schema:
|
|
type: boolean
|
|
title: requires_shipping
|
|
description: The inventory item's requires shipping.
|
|
- name: weight
|
|
in: query
|
|
description: The inventory item's weight.
|
|
required: false
|
|
schema:
|
|
description: The inventory item's weight.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
- name: length
|
|
in: query
|
|
description: The inventory item's length.
|
|
required: false
|
|
schema:
|
|
description: The inventory item's length.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
- name: height
|
|
in: query
|
|
description: The inventory item's height.
|
|
required: false
|
|
schema:
|
|
description: The inventory item's height.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
- name: width
|
|
in: query
|
|
description: The inventory item's width.
|
|
required: false
|
|
schema:
|
|
description: The inventory item's width.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
- name: location_levels
|
|
in: query
|
|
description: The inventory item's location levels.
|
|
required: false
|
|
schema:
|
|
type: object
|
|
description: The inventory item's location levels.
|
|
properties:
|
|
location_id:
|
|
oneOf:
|
|
- type: string
|
|
title: location_id
|
|
description: The location level's location id.
|
|
- type: array
|
|
description: The location level's location id.
|
|
items:
|
|
type: string
|
|
title: location_id
|
|
description: The location id's details.
|
|
- name: $and
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The inventory item's $and.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The inventory item's $or.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/inventory-items' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Inventory Items
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The inventory item's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The inventory item's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The inventory item's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- inventory_items
|
|
properties:
|
|
inventory_items:
|
|
type: array
|
|
description: The inventory item's inventory items.
|
|
items:
|
|
$ref: '#/components/schemas/AdminInventoryItem'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostInventoryItems
|
|
summary: Create Inventory Item
|
|
description: Create a inventory item.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- sku
|
|
- hs_code
|
|
- weight
|
|
- length
|
|
- height
|
|
- width
|
|
- origin_country
|
|
- mid_code
|
|
- material
|
|
- title
|
|
- description
|
|
- thumbnail
|
|
- metadata
|
|
properties:
|
|
sku:
|
|
type: string
|
|
title: sku
|
|
description: The inventory item's sku.
|
|
hs_code:
|
|
type: string
|
|
title: hs_code
|
|
description: The inventory item's hs code.
|
|
weight:
|
|
type: number
|
|
title: weight
|
|
description: The inventory item's weight.
|
|
length:
|
|
type: number
|
|
title: length
|
|
description: The inventory item's length.
|
|
height:
|
|
type: number
|
|
title: height
|
|
description: The inventory item's height.
|
|
width:
|
|
type: number
|
|
title: width
|
|
description: The inventory item's width.
|
|
origin_country:
|
|
type: string
|
|
title: origin_country
|
|
description: The inventory item's origin country.
|
|
mid_code:
|
|
type: string
|
|
title: mid_code
|
|
description: The inventory item's mid code.
|
|
material:
|
|
type: string
|
|
title: material
|
|
description: The inventory item's material.
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The inventory item's title.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The inventory item's description.
|
|
requires_shipping:
|
|
type: boolean
|
|
title: requires_shipping
|
|
description: The inventory item's requires shipping.
|
|
thumbnail:
|
|
type: string
|
|
title: thumbnail
|
|
description: The inventory item's thumbnail.
|
|
metadata:
|
|
type: object
|
|
description: The inventory item's metadata.
|
|
location_levels:
|
|
type: array
|
|
description: The inventory item's location levels.
|
|
items:
|
|
type: object
|
|
description: The location level's location levels.
|
|
required:
|
|
- location_id
|
|
properties:
|
|
location_id:
|
|
type: string
|
|
title: location_id
|
|
description: The location level's location id.
|
|
stocked_quantity:
|
|
type: number
|
|
title: stocked_quantity
|
|
description: The location level's stocked quantity.
|
|
incoming_quantity:
|
|
type: number
|
|
title: incoming_quantity
|
|
description: The location level's incoming quantity.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/inventory-items' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"sku": "{value}",
|
|
"hs_code": "{value}",
|
|
"weight": 2857134683324416,
|
|
"length": 2322256963305472,
|
|
"height": 8391220613087232,
|
|
"width": 1297863250280448,
|
|
"origin_country": "{value}",
|
|
"mid_code": "{value}",
|
|
"material": "{value}",
|
|
"title": "{value}",
|
|
"description": "{value}",
|
|
"thumbnail": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Inventory Items
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminInventoryItemResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createInventoryItemsWorkflow
|
|
/admin/inventory-items/{id}:
|
|
get:
|
|
operationId: GetInventoryItemsId
|
|
summary: Get a Inventory Item
|
|
description: Retrieve a inventory item by its ID. You can expand the inventory item's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The inventory item's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/inventory-items/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Inventory Items
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminInventoryItemResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostInventoryItemsId
|
|
summary: Update a Inventory Item
|
|
description: Update a inventory item's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The inventory item's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- sku
|
|
- hs_code
|
|
- weight
|
|
- length
|
|
- height
|
|
- width
|
|
- origin_country
|
|
- mid_code
|
|
- material
|
|
- title
|
|
- description
|
|
- thumbnail
|
|
- metadata
|
|
properties:
|
|
sku:
|
|
type: string
|
|
title: sku
|
|
description: The inventory item's sku.
|
|
hs_code:
|
|
type: string
|
|
title: hs_code
|
|
description: The inventory item's hs code.
|
|
weight:
|
|
type: number
|
|
title: weight
|
|
description: The inventory item's weight.
|
|
length:
|
|
type: number
|
|
title: length
|
|
description: The inventory item's length.
|
|
height:
|
|
type: number
|
|
title: height
|
|
description: The inventory item's height.
|
|
width:
|
|
type: number
|
|
title: width
|
|
description: The inventory item's width.
|
|
origin_country:
|
|
type: string
|
|
title: origin_country
|
|
description: The inventory item's origin country.
|
|
mid_code:
|
|
type: string
|
|
title: mid_code
|
|
description: The inventory item's mid code.
|
|
material:
|
|
type: string
|
|
title: material
|
|
description: The inventory item's material.
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The inventory item's title.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The inventory item's description.
|
|
requires_shipping:
|
|
type: boolean
|
|
title: requires_shipping
|
|
description: The inventory item's requires shipping.
|
|
thumbnail:
|
|
type: string
|
|
title: thumbnail
|
|
description: The inventory item's thumbnail.
|
|
metadata:
|
|
type: object
|
|
description: The inventory item's metadata.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/inventory-items/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"sku": "{value}",
|
|
"hs_code": "{value}",
|
|
"weight": 8979922215239680,
|
|
"length": 667491233693696,
|
|
"height": 6328111551479808,
|
|
"width": 7175104570064896,
|
|
"origin_country": "{value}",
|
|
"mid_code": "{value}",
|
|
"material": "{value}",
|
|
"title": "{value}",
|
|
"description": "{value}",
|
|
"thumbnail": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Inventory Items
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminInventoryItemResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteInventoryItemsId
|
|
summary: Delete a Inventory Item
|
|
description: Delete a inventory item.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The inventory item's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/inventory-items/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Inventory Items
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The inventory item's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The inventory item's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The inventory item's deleted.
|
|
parent:
|
|
type: object
|
|
description: The inventory item's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/inventory-items/{id}/location-levels:
|
|
get:
|
|
operationId: GetInventoryItemsIdLocationLevels
|
|
summary: List Location Levels
|
|
description: Retrieve a list of location levels in a inventory item. The location levels can be filtered by fields like FILTER FIELDS. The location levels can also be paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The inventory item's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: location_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: location_id
|
|
description: The inventory item's location id.
|
|
- type: array
|
|
description: The inventory item's location id.
|
|
items:
|
|
type: string
|
|
title: location_id
|
|
description: The location id's details.
|
|
- name: $and
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The inventory item's $and.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The inventory item's $or.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/inventory-items/{id}/location-levels' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Inventory Items
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The inventory item's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The inventory item's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The inventory item's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- inventory_levels
|
|
properties:
|
|
inventory_levels:
|
|
type: array
|
|
description: The inventory item's inventory levels.
|
|
items:
|
|
$ref: '#/components/schemas/InventoryLevel'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostInventoryItemsIdLocationLevels
|
|
summary: Add Location Levels to Inventory Item
|
|
description: Add a list of location levels to a inventory item.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The inventory item's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- location_id
|
|
properties:
|
|
location_id:
|
|
type: string
|
|
title: location_id
|
|
description: The inventory item's location id.
|
|
stocked_quantity:
|
|
type: number
|
|
title: stocked_quantity
|
|
description: The inventory item's stocked quantity.
|
|
incoming_quantity:
|
|
type: number
|
|
title: incoming_quantity
|
|
description: The inventory item's incoming quantity.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/inventory-items/{id}/location-levels' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"location_id": "{value}"
|
|
}'
|
|
tags:
|
|
- Inventory Items
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminInventoryItemResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/inventory-items/{id}/location-levels/batch:
|
|
post:
|
|
operationId: PostInventoryItemsIdLocationLevelsBatch
|
|
summary: Add Location Levels to Inventory Item
|
|
description: Add a list of location levels to a inventory item.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The inventory item's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
create:
|
|
type: array
|
|
description: The inventory item's create.
|
|
items:
|
|
type: object
|
|
description: The create's details.
|
|
required:
|
|
- location_id
|
|
properties:
|
|
location_id:
|
|
type: string
|
|
title: location_id
|
|
description: The create's location id.
|
|
stocked_quantity:
|
|
type: number
|
|
title: stocked_quantity
|
|
description: The create's stocked quantity.
|
|
incoming_quantity:
|
|
type: number
|
|
title: incoming_quantity
|
|
description: The create's incoming quantity.
|
|
update:
|
|
type: array
|
|
description: The inventory item's update.
|
|
items:
|
|
type: object
|
|
description: The update's details.
|
|
properties:
|
|
stocked_quantity:
|
|
type: number
|
|
title: stocked_quantity
|
|
description: The update's stocked quantity.
|
|
incoming_quantity:
|
|
type: number
|
|
title: incoming_quantity
|
|
description: The update's incoming quantity.
|
|
delete:
|
|
type: array
|
|
description: The inventory item's delete.
|
|
items:
|
|
type: string
|
|
title: delete
|
|
description: The delete's details.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/inventory-items/{id}/location-levels/batch' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Inventory Items
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- inventory_item
|
|
properties:
|
|
inventory_item:
|
|
type: object
|
|
description: The inventory item's details.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/inventory-items/{id}/location-levels/{location_id}:
|
|
post:
|
|
operationId: PostInventoryItemsIdLocationLevelsLocation_id
|
|
summary: Add Location Levels to Inventory Item
|
|
description: Add a list of location levels to a inventory item.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The inventory item's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: location_id
|
|
in: path
|
|
description: The inventory item's location id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
stocked_quantity:
|
|
type: number
|
|
title: stocked_quantity
|
|
description: The inventory item's stocked quantity.
|
|
incoming_quantity:
|
|
type: number
|
|
title: incoming_quantity
|
|
description: The inventory item's incoming quantity.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/inventory-items/{id}/location-levels/{location_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Inventory Items
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminInventoryItemResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteInventoryItemsIdLocationLevelsLocation_id
|
|
summary: Remove Location Levels from Inventory Item
|
|
description: Remove a list of location levels from a inventory item. This doesn't delete the Location Level, only the association between the Location Level and the inventory item.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The inventory item's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: location_id
|
|
in: path
|
|
description: The inventory item's location id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/inventory-items/{id}/location-levels/{location_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Inventory Items
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The inventory item's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The inventory item's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The inventory item's deleted.
|
|
parent:
|
|
type: object
|
|
description: The inventory item's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/invites:
|
|
get:
|
|
operationId: GetInvites
|
|
summary: List Invites
|
|
description: Retrieve a list of invites. The invites can be filtered by fields such as `id`. The invites can also be sorted or paginated.
|
|
x-authenticated: false
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: q
|
|
in: query
|
|
description: The invite's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The invite's q.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The invite's ID.
|
|
- type: array
|
|
description: The invite's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: email
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: email
|
|
description: The invite's email.
|
|
format: email
|
|
- type: array
|
|
description: The invite's email.
|
|
items:
|
|
type: string
|
|
title: email
|
|
description: The email's details.
|
|
format: email
|
|
- name: created_at
|
|
in: query
|
|
description: The invite's created at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The invite's created at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: created_at
|
|
- name: updated_at
|
|
in: query
|
|
description: The invite's updated at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The invite's updated at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: updated_at
|
|
- name: deleted_at
|
|
in: query
|
|
description: The invite's deleted at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The invite's deleted at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: deleted_at
|
|
- name: $and
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The invite's $and.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The invite's $or.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: curl '{backend_url}/admin/invites'
|
|
tags:
|
|
- Invites
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The invite's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The invite's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The invite's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- invites
|
|
properties:
|
|
invites:
|
|
type: array
|
|
description: The invite's invites.
|
|
items:
|
|
$ref: '#/components/schemas/AdminInvite'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostInvites
|
|
summary: Create Invite
|
|
description: Create a invite.
|
|
x-authenticated: false
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- email
|
|
properties:
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The invite's email.
|
|
format: email
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/invites' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"email": "Whitney_Schultz@gmail.com"
|
|
}'
|
|
tags:
|
|
- Invites
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminInviteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/invites/accept:
|
|
post:
|
|
operationId: PostInvitesAccept
|
|
summary: Create Invite
|
|
description: Create a invite.
|
|
x-authenticated: false
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- email
|
|
- first_name
|
|
- last_name
|
|
properties:
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The invite's email.
|
|
format: email
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The invite's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The invite's last name.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/invites/accept' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"email": "Lila_Zemlak@hotmail.com",
|
|
"first_name": "{value}",
|
|
"last_name": "{value}"
|
|
}'
|
|
tags:
|
|
- Invites
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
oneOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- user
|
|
properties:
|
|
user:
|
|
$ref: '#/components/schemas/AdminUser'
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- message
|
|
properties:
|
|
message:
|
|
type: string
|
|
title: message
|
|
description: The invite's message.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/invites/{id}:
|
|
get:
|
|
operationId: GetInvitesId
|
|
summary: Get a Invite
|
|
description: Retrieve a invite by its ID. You can expand the invite's relations or select the fields that should be returned.
|
|
x-authenticated: false
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The invite's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: curl '{backend_url}/admin/invites/{id}'
|
|
tags:
|
|
- Invites
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminInviteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteInvitesId
|
|
summary: Delete a Invite
|
|
description: Delete a invite.
|
|
x-authenticated: false
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The invite's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: curl -X DELETE '{backend_url}/admin/invites/{id}'
|
|
tags:
|
|
- Invites
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The invite's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The invite's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The invite's deleted.
|
|
parent:
|
|
type: object
|
|
description: The invite's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/invites/{id}/resend:
|
|
post:
|
|
operationId: PostInvitesIdResend
|
|
summary: Add Resends to Invite
|
|
description: Add a list of resends to a invite.
|
|
x-authenticated: false
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The invite's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: curl -X POST '{backend_url}/admin/invites/{id}/resend'
|
|
tags:
|
|
- Invites
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminInviteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema: {}
|
|
/admin/notifications:
|
|
get:
|
|
operationId: GetNotifications
|
|
summary: List Notifications
|
|
description: Retrieve a list of notifications. The notifications can be filtered by fields such as `id`. The notifications can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: q
|
|
in: query
|
|
description: The notification's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The notification's q.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The notification's ID.
|
|
- type: array
|
|
description: The notification's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: channel
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: channel
|
|
description: The notification's channel.
|
|
- type: array
|
|
description: The notification's channel.
|
|
items:
|
|
type: string
|
|
title: channel
|
|
description: The channel's details.
|
|
- name: $and
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The notification's $and.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The notification's $or.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/notifications' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Notifications
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminNotificationListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/notifications/{id}:
|
|
get:
|
|
operationId: GetNotificationsId
|
|
summary: Get a Notification
|
|
description: Retrieve a notification by its ID. You can expand the notification's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The notification's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/notifications/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Notifications
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminNotificationResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/order-edits:
|
|
post:
|
|
operationId: PostOrderEdits
|
|
summary: Create Order Edit
|
|
description: Create a order edit.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostOrderEditsReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/order-edits' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"order_id": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Order Edits
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderEditResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/order-edits/{id}:
|
|
delete:
|
|
operationId: DeleteOrderEditsId
|
|
summary: Delete a Order Edit
|
|
description: Delete a order edit.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order edit's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/order-edits/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Order Edits
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The order edit's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The order edit's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The order edit's deleted.
|
|
parent:
|
|
type: object
|
|
description: The order edit's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/order-edits/{id}/confirm:
|
|
post:
|
|
operationId: PostOrderEditsIdConfirm
|
|
summary: Add Confirms to Order Edit
|
|
description: Add a list of confirms to a order edit.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order edit's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/order-edits/{id}/confirm' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Order Edits
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderEditPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: confirmOrderEditRequestWorkflow
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema: {}
|
|
/admin/order-edits/{id}/items:
|
|
post:
|
|
operationId: PostOrderEditsIdItems
|
|
summary: Add Items to Order Edit
|
|
description: Add a list of items to a order edit.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order edit's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostOrderEditsAddItemsReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/order-edits/{id}/items' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Order Edits
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderEditPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: orderEditAddNewItemWorkflow
|
|
/admin/order-edits/{id}/items/item/{item_id}:
|
|
post:
|
|
operationId: PostOrderEditsIdItemsItemItem_id
|
|
summary: Add Items to Order Edit
|
|
description: Add a list of items to a order edit.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order edit's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: item_id
|
|
in: path
|
|
description: The order edit's item id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostOrderEditsUpdateItemQuantityReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/order-edits/{id}/items/item/{item_id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"quantity": 7564330046324736
|
|
}'
|
|
tags:
|
|
- Order Edits
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderEditPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: orderEditUpdateItemQuantityWorkflow
|
|
/admin/order-edits/{id}/items/{action_id}:
|
|
post:
|
|
operationId: PostOrderEditsIdItemsAction_id
|
|
summary: Add Items to Order Edit
|
|
description: Add a list of items to a order edit.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order edit's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The order edit's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostOrderEditsItemsActionReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/order-edits/{id}/items/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Order Edits
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderEditPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateOrderEditAddItemWorkflow
|
|
delete:
|
|
operationId: DeleteOrderEditsIdItemsAction_id
|
|
summary: Remove Items from Order Edit
|
|
description: Remove a list of items from a order edit. This doesn't delete the Item, only the association between the Item and the order edit.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order edit's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The order edit's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/order-edits/{id}/items/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Order Edits
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderEditPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: removeItemOrderEditActionWorkflow
|
|
/admin/order-edits/{id}/request:
|
|
post:
|
|
operationId: PostOrderEditsIdRequest
|
|
summary: Add Requests to Order Edit
|
|
description: Add a list of requests to a order edit.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order edit's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/order-edits/{id}/request' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Order Edits
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderEditPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: requestOrderEditRequestWorkflow
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema: {}
|
|
/admin/order-edits/{id}/shipping-method:
|
|
post:
|
|
operationId: PostOrderEditsIdShippingMethod
|
|
summary: Add Shipping Methods to Order Edit
|
|
description: Add a list of shipping methods to a order edit.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order edit's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostOrderEditsShippingReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/order-edits/{id}/shipping-method' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"shipping_option_id": "{value}"
|
|
}'
|
|
tags:
|
|
- Order Edits
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderEditPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createOrderEditShippingMethodWorkflow
|
|
/admin/order-edits/{id}/shipping-method/{action_id}:
|
|
post:
|
|
operationId: PostOrderEditsIdShippingMethodAction_id
|
|
summary: Add Shipping Methods to Order Edit
|
|
description: Add a list of shipping methods to a order edit.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order edit's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The order edit's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostOrderEditsShippingActionReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/order-edits/{id}/shipping-method/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Order Edits
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderEditPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateOrderEditShippingMethodWorkflow
|
|
delete:
|
|
operationId: DeleteOrderEditsIdShippingMethodAction_id
|
|
summary: Remove Shipping Methods from Order Edit
|
|
description: Remove a list of shipping methods from a order edit. This doesn't delete the Shipping Method, only the association between the Shipping Method and the order edit.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order edit's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The order edit's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/order-edits/{id}/shipping-method/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Order Edits
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderEditPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: removeOrderEditShippingMethodWorkflow
|
|
/admin/orders:
|
|
get:
|
|
operationId: GetOrders
|
|
summary: List Orders
|
|
description: Retrieve a list of orders. The orders can be filtered by fields such as `id`. The orders can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/orders' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Orders
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The order's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The order's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The order's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- orders
|
|
properties:
|
|
orders:
|
|
type: array
|
|
description: The order's orders.
|
|
items:
|
|
$ref: '#/components/schemas/AdminOrder'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/orders/{id}:
|
|
get:
|
|
operationId: GetOrdersId
|
|
summary: Get a Order
|
|
description: Retrieve a order by its ID. You can expand the order's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/orders/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Orders
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostOrdersId
|
|
summary: Update a Order
|
|
description: Update a order's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/orders/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Orders
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema: {}
|
|
/admin/orders/{id}/archive:
|
|
post:
|
|
operationId: PostOrdersIdArchive
|
|
summary: Add Archives to Order
|
|
description: Add a list of archives to a order.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminArchiveOrder'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/orders/{id}/archive' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"order_id": "{value}"
|
|
}'
|
|
tags:
|
|
- Orders
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/orders/{id}/cancel:
|
|
post:
|
|
operationId: PostOrdersIdCancel
|
|
summary: Add Cancels to Order
|
|
description: Add a list of cancels to a order.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/orders/{id}/cancel' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Orders
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema: {}
|
|
/admin/orders/{id}/complete:
|
|
post:
|
|
operationId: PostOrdersIdComplete
|
|
summary: Add Completes to Order
|
|
description: Add a list of completes to a order.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- order_id
|
|
properties:
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The order's order id.
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/orders/{id}/complete' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"order_id": "{value}"
|
|
}'
|
|
tags:
|
|
- Orders
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/orders/{id}/fulfillments:
|
|
post:
|
|
operationId: PostOrdersIdFulfillments
|
|
summary: Add Fulfillments to Order
|
|
description: Add a list of fulfillments to a order.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- items
|
|
- location_id
|
|
- metadata
|
|
properties:
|
|
items:
|
|
type: array
|
|
description: The order's items.
|
|
items:
|
|
type: object
|
|
description: The item's items.
|
|
required:
|
|
- id
|
|
- quantity
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The item's ID.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The item's quantity.
|
|
location_id:
|
|
type: string
|
|
title: location_id
|
|
description: The order's location id.
|
|
no_notification:
|
|
type: boolean
|
|
title: no_notification
|
|
description: The order's no notification.
|
|
metadata:
|
|
type: object
|
|
description: The order's metadata.
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/orders/{id}/fulfillments' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"items": [
|
|
{
|
|
"id": "id_YePfQ6PBCBKvmYyreUt2",
|
|
"quantity": 6623610359775232
|
|
}
|
|
],
|
|
"location_id": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Orders
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/orders/{id}/fulfillments/{fulfillment_id}/cancel:
|
|
post:
|
|
operationId: PostOrdersIdFulfillmentsFulfillment_idCancel
|
|
summary: Add Cancels to Order
|
|
description: Add a list of cancels to a order.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: fulfillment_id
|
|
in: path
|
|
description: The order's fulfillment id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
no_notification:
|
|
type: boolean
|
|
title: no_notification
|
|
description: The order's no notification.
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/orders/{id}/fulfillments/{fulfillment_id}/cancel' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Orders
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/orders/{id}/fulfillments/{fulfillment_id}/shipments:
|
|
post:
|
|
operationId: PostOrdersIdFulfillmentsFulfillment_idShipments
|
|
summary: Add Shipments to Order
|
|
description: Add a list of shipments to a order.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: fulfillment_id
|
|
in: path
|
|
description: The order's fulfillment id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- items
|
|
- metadata
|
|
properties:
|
|
items:
|
|
type: array
|
|
description: The order's items.
|
|
items:
|
|
type: object
|
|
description: The item's items.
|
|
required:
|
|
- id
|
|
- quantity
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The item's ID.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The item's quantity.
|
|
labels:
|
|
type: array
|
|
description: The order's labels.
|
|
items:
|
|
type: object
|
|
description: The label's labels.
|
|
required:
|
|
- tracking_number
|
|
- tracking_url
|
|
- label_url
|
|
properties:
|
|
tracking_number:
|
|
type: string
|
|
title: tracking_number
|
|
description: The label's tracking number.
|
|
tracking_url:
|
|
type: string
|
|
title: tracking_url
|
|
description: The label's tracking url.
|
|
label_url:
|
|
type: string
|
|
title: label_url
|
|
description: The label's label url.
|
|
no_notification:
|
|
type: boolean
|
|
title: no_notification
|
|
description: The order's no notification.
|
|
metadata:
|
|
type: object
|
|
description: The order's metadata.
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/orders/{id}/fulfillments/{fulfillment_id}/shipments' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"items": [
|
|
{
|
|
"id": "id_3QQtl2VvE73c",
|
|
"quantity": 6772917941567488
|
|
}
|
|
],
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Orders
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/orders/{id}/preview:
|
|
get:
|
|
operationId: GetOrdersIdPreview
|
|
summary: List Previews
|
|
description: Retrieve a list of previews in a order. The previews can be filtered by fields like FILTER FIELDS. The previews can also be paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The order's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/orders/{id}/preview' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Orders
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/payment-collections:
|
|
post:
|
|
operationId: PostPaymentCollections
|
|
summary: Create Payment Collection
|
|
description: Create a payment collection.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- order_id
|
|
- amount
|
|
properties:
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The payment collection's order id.
|
|
amount:
|
|
type: number
|
|
title: amount
|
|
description: The payment collection's amount.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/payment-collections' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"order_id": "{value}"
|
|
}'
|
|
tags:
|
|
- Payment Collections
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPaymentCollectionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createOrderPaymentCollectionWorkflow
|
|
/admin/payment-collections/{id}:
|
|
delete:
|
|
operationId: DeletePaymentCollectionsId
|
|
summary: Delete a Payment Collection
|
|
description: Delete a payment collection.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The payment collection's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/payment-collections/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Payment Collections
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The payment collection's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The payment collection's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The payment collection's deleted.
|
|
parent:
|
|
type: object
|
|
description: The payment collection's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/payment-collections/{id}/mark-as-paid:
|
|
post:
|
|
operationId: PostPaymentCollectionsIdMarkAsPaid
|
|
summary: Add Mark As Paids to Payment Collection
|
|
description: Add a list of mark as paids to a payment collection.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The payment collection's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- order_id
|
|
properties:
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The payment collection's order id.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/payment-collections/{id}/mark-as-paid' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"order_id": "{value}"
|
|
}'
|
|
tags:
|
|
- Payment Collections
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPaymentCollectionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/payments:
|
|
get:
|
|
operationId: GetPayments
|
|
summary: List Payments
|
|
description: Retrieve a list of payments. The payments can be filtered by fields such as `id`. The payments can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: q
|
|
in: query
|
|
description: The payment's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The payment's q.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The payment's ID.
|
|
- type: array
|
|
description: The payment's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: payment_session_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: payment_session_id
|
|
description: The payment's payment session id.
|
|
- type: array
|
|
description: The payment's payment session id.
|
|
items:
|
|
type: string
|
|
title: payment_session_id
|
|
description: The payment session id's details.
|
|
- name: created_at
|
|
in: query
|
|
description: The payment's created at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The payment's created at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: created_at
|
|
- name: updated_at
|
|
in: query
|
|
description: The payment's updated at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The payment's updated at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: updated_at
|
|
- name: deleted_at
|
|
in: query
|
|
description: The payment's deleted at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The payment's deleted at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: deleted_at
|
|
- name: $and
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The payment's $and.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The payment's $or.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/payments' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Payments
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The payment's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The payment's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The payment's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- payments
|
|
properties:
|
|
payments:
|
|
type: array
|
|
description: The payment's payments.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPayment'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/payments/payment-providers:
|
|
get:
|
|
operationId: GetPaymentsPaymentProviders
|
|
summary: List Payments
|
|
description: Retrieve a list of payments. The payments can be filtered by fields such as `id`. The payments can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The payment's ID.
|
|
- type: array
|
|
description: The payment's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: is_enabled
|
|
in: query
|
|
description: The payment's is enabled.
|
|
required: false
|
|
schema:
|
|
type: boolean
|
|
title: is_enabled
|
|
description: The payment's is enabled.
|
|
- name: $and
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The payment's $and.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The payment's $or.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/payments/payment-providers' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Payments
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The payment's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The payment's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The payment's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- payment_providers
|
|
properties:
|
|
payment_providers:
|
|
type: array
|
|
description: The payment's payment providers.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPaymentProvider'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/payments/{id}:
|
|
get:
|
|
operationId: GetPaymentsId
|
|
summary: Get a Payment
|
|
description: Retrieve a payment by its ID. You can expand the payment's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The payment's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/payments/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Payments
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPaymentResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/payments/{id}/capture:
|
|
post:
|
|
operationId: PostPaymentsIdCapture
|
|
summary: Add Captures to Payment
|
|
description: Add a list of captures to a payment.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The payment's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
amount:
|
|
type: number
|
|
title: amount
|
|
description: The payment's amount.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/payments/{id}/capture' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Payments
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPaymentResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/payments/{id}/refund:
|
|
post:
|
|
operationId: PostPaymentsIdRefund
|
|
summary: Add Refunds to Payment
|
|
description: Add a list of refunds to a payment.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The payment's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
amount:
|
|
type: number
|
|
title: amount
|
|
description: The payment's amount.
|
|
refund_reason_id:
|
|
type: string
|
|
title: refund_reason_id
|
|
description: The payment's refund reason id.
|
|
note:
|
|
type: string
|
|
title: note
|
|
description: The payment's note.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/payments/{id}/refund' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Payments
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPaymentResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/price-lists:
|
|
get:
|
|
operationId: GetPriceLists
|
|
summary: List Price Lists
|
|
description: Retrieve a list of price lists. The price lists can be filtered by fields such as `id`. The price lists can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/price-lists' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Price Lists
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPriceListListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostPriceLists
|
|
summary: Create Price List
|
|
description: Create a price list.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCreatePriceList'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/price-lists' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"title": "{value}",
|
|
"description": "{value}",
|
|
"starts_at": "{value}",
|
|
"ends_at": "{value}"
|
|
}'
|
|
tags:
|
|
- Price Lists
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPriceListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/price-lists/{id}:
|
|
get:
|
|
operationId: GetPriceListsId
|
|
summary: Get a Price List
|
|
description: Retrieve a price list by its ID. You can expand the price list's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The price list's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/price-lists/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Price Lists
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPriceListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostPriceListsId
|
|
summary: Update a Price List
|
|
description: Update a price list's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The price list's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminUpdatePriceList'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/price-lists/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"description": "{value}",
|
|
"starts_at": "{value}",
|
|
"ends_at": "{value}"
|
|
}'
|
|
tags:
|
|
- Price Lists
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPriceListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeletePriceListsId
|
|
summary: Delete a Price List
|
|
description: Delete a price list.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The price list's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/price-lists/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Price Lists
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPriceListDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/price-lists/{id}/prices/batch:
|
|
post:
|
|
operationId: PostPriceListsIdPricesBatch
|
|
summary: Add Prices to Price List
|
|
description: Add a list of prices to a price list.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The price list's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
create:
|
|
type: array
|
|
description: The price list's create.
|
|
items:
|
|
type: object
|
|
description: The create's details.
|
|
required:
|
|
- currency_code
|
|
- amount
|
|
- variant_id
|
|
- min_quantity
|
|
- max_quantity
|
|
properties:
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The create's currency code.
|
|
amount:
|
|
type: number
|
|
title: amount
|
|
description: The create's amount.
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The create's variant id.
|
|
min_quantity:
|
|
type: number
|
|
title: min_quantity
|
|
description: The create's min quantity.
|
|
max_quantity:
|
|
type: number
|
|
title: max_quantity
|
|
description: The create's max quantity.
|
|
rules:
|
|
type: object
|
|
description: The create's rules.
|
|
update:
|
|
type: array
|
|
description: The price list's update.
|
|
items:
|
|
type: object
|
|
description: The update's details.
|
|
required:
|
|
- id
|
|
- variant_id
|
|
- min_quantity
|
|
- max_quantity
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The update's ID.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The update's currency code.
|
|
amount:
|
|
type: number
|
|
title: amount
|
|
description: The update's amount.
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The update's variant id.
|
|
min_quantity:
|
|
type: number
|
|
title: min_quantity
|
|
description: The update's min quantity.
|
|
max_quantity:
|
|
type: number
|
|
title: max_quantity
|
|
description: The update's max quantity.
|
|
rules:
|
|
type: object
|
|
description: The update's rules.
|
|
delete:
|
|
type: array
|
|
description: The price list's delete.
|
|
items:
|
|
type: string
|
|
title: delete
|
|
description: The delete's details.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/price-lists/{id}/prices/batch' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Price Lists
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPriceListBatchResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/price-lists/{id}/products:
|
|
post:
|
|
operationId: PostPriceListsIdProducts
|
|
summary: Add Products to Price List
|
|
description: Add a list of products to a price list.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The price list's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
add:
|
|
type: array
|
|
description: The price list's add.
|
|
items:
|
|
type: string
|
|
title: add
|
|
description: The add's details.
|
|
remove:
|
|
type: array
|
|
description: The price list's remove.
|
|
items:
|
|
type: string
|
|
title: remove
|
|
description: The remove's details.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/price-lists/{id}/products' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Price Lists
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPriceListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/price-preferences:
|
|
get:
|
|
operationId: GetPricePreferences
|
|
summary: List Price Preferences
|
|
description: Retrieve a list of price preferences. The price preferences can be filtered by fields such as `id`. The price preferences can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/price-preferences' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Price Preferences
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPricePreferenceListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostPricePreferences
|
|
summary: Create Price Preference
|
|
description: Create a price preference.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCreatePricePreference'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/price-preferences' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Price Preferences
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPricePreferenceResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/price-preferences/{id}:
|
|
get:
|
|
operationId: GetPricePreferencesId
|
|
summary: Get a Price Preference
|
|
description: Retrieve a price preference by its ID. You can expand the price preference's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The price preference's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/price-preferences/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Price Preferences
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPricePreferenceResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostPricePreferencesId
|
|
summary: Update a Price Preference
|
|
description: Update a price preference's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The price preference's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminUpdatePricePreference'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/price-preferences/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Price Preferences
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPricePreferenceResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeletePricePreferencesId
|
|
summary: Delete a Price Preference
|
|
description: Delete a price preference.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The price preference's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/price-preferences/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Price Preferences
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPricePreferenceDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/product-categories:
|
|
get:
|
|
operationId: GetProductCategories
|
|
summary: List Product Categories
|
|
description: Retrieve a list of product categories. The product categories can be filtered by fields such as `id`. The product categories can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: q
|
|
in: query
|
|
description: The product category's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The product category's q.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The product category's ID.
|
|
- type: array
|
|
description: The product category's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: description
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: description
|
|
description: The product category's description.
|
|
- type: array
|
|
description: The product category's description.
|
|
items:
|
|
type: string
|
|
title: description
|
|
description: The description's details.
|
|
- name: handle
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: handle
|
|
description: The product category's handle.
|
|
- type: array
|
|
description: The product category's handle.
|
|
items:
|
|
type: string
|
|
title: handle
|
|
description: The handle's details.
|
|
- name: parent_category_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: parent_category_id
|
|
description: The product category's parent category id.
|
|
- type: array
|
|
description: The product category's parent category id.
|
|
items:
|
|
type: string
|
|
title: parent_category_id
|
|
description: The parent category id's details.
|
|
- name: include_ancestors_tree
|
|
in: query
|
|
description: The product category's include ancestors tree.
|
|
required: true
|
|
schema:
|
|
type: boolean
|
|
title: include_ancestors_tree
|
|
description: The product category's include ancestors tree.
|
|
- name: include_descendants_tree
|
|
in: query
|
|
description: The product category's include descendants tree.
|
|
required: true
|
|
schema:
|
|
type: boolean
|
|
title: include_descendants_tree
|
|
description: The product category's include descendants tree.
|
|
- name: is_internal
|
|
in: query
|
|
description: The product category's is internal.
|
|
required: true
|
|
schema:
|
|
type: boolean
|
|
title: is_internal
|
|
description: The product category's is internal.
|
|
- name: is_active
|
|
in: query
|
|
description: The product category's is active.
|
|
required: true
|
|
schema:
|
|
type: boolean
|
|
title: is_active
|
|
description: The product category's is active.
|
|
- name: created_at
|
|
in: query
|
|
description: The product category's created at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The product category's created at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: created_at
|
|
- name: updated_at
|
|
in: query
|
|
description: The product category's updated at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The product category's updated at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: updated_at
|
|
- name: deleted_at
|
|
in: query
|
|
description: The product category's deleted at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The product category's deleted at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: deleted_at
|
|
- name: $and
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The product category's $and.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The product category's $or.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/product-categories' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Product Categories
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductCategoryListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostProductCategories
|
|
summary: Create Product Category
|
|
description: Create a product category.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- name
|
|
- parent_category_id
|
|
- metadata
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The product category's name.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The product category's description.
|
|
handle:
|
|
type: string
|
|
title: handle
|
|
description: The product category's handle.
|
|
is_internal:
|
|
type: boolean
|
|
title: is_internal
|
|
description: The product category's is internal.
|
|
is_active:
|
|
type: boolean
|
|
title: is_active
|
|
description: The product category's is active.
|
|
parent_category_id:
|
|
type: string
|
|
title: parent_category_id
|
|
description: The product category's parent category id.
|
|
metadata:
|
|
type: object
|
|
description: The product category's metadata.
|
|
rank:
|
|
type: number
|
|
title: rank
|
|
description: The product category's rank.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/product-categories' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"name": "Vesta",
|
|
"parent_category_id": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Product Categories
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductCategoryResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createProductCategoriesWorkflow
|
|
/admin/product-categories/{id}:
|
|
get:
|
|
operationId: GetProductCategoriesId
|
|
summary: Get a Product Category
|
|
description: Retrieve a product category by its ID. You can expand the product category's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product category's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: include_ancestors_tree
|
|
in: query
|
|
description: The product category's include ancestors tree.
|
|
required: true
|
|
schema:
|
|
type: boolean
|
|
title: include_ancestors_tree
|
|
description: The product category's include ancestors tree.
|
|
- name: include_descendants_tree
|
|
in: query
|
|
description: The product category's include descendants tree.
|
|
required: true
|
|
schema:
|
|
type: boolean
|
|
title: include_descendants_tree
|
|
description: The product category's include descendants tree.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/product-categories/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Product Categories
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductCategoryResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostProductCategoriesId
|
|
summary: Update a Product Category
|
|
description: Update a product category's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product category's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- parent_category_id
|
|
- metadata
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The product category's name.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The product category's description.
|
|
handle:
|
|
type: string
|
|
title: handle
|
|
description: The product category's handle.
|
|
is_internal:
|
|
type: boolean
|
|
title: is_internal
|
|
description: The product category's is internal.
|
|
is_active:
|
|
type: boolean
|
|
title: is_active
|
|
description: The product category's is active.
|
|
parent_category_id:
|
|
type: string
|
|
title: parent_category_id
|
|
description: The product category's parent category id.
|
|
metadata:
|
|
type: object
|
|
description: The product category's metadata.
|
|
rank:
|
|
type: number
|
|
title: rank
|
|
description: The product category's rank.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/product-categories/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"parent_category_id": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Product Categories
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductCategoryResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteProductCategoriesId
|
|
summary: Delete a Product Category
|
|
description: Delete a product category.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product category's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/product-categories/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Product Categories
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductCategoryDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/product-categories/{id}/products:
|
|
post:
|
|
operationId: PostProductCategoriesIdProducts
|
|
summary: Add Products to Product Category
|
|
description: Add a list of products to a product category.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product category's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
add:
|
|
type: array
|
|
description: The product category's add.
|
|
items:
|
|
type: string
|
|
title: add
|
|
description: The add's details.
|
|
remove:
|
|
type: array
|
|
description: The product category's remove.
|
|
items:
|
|
type: string
|
|
title: remove
|
|
description: The remove's details.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/product-categories/{id}/products' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Product Categories
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductCategoryResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/product-tags:
|
|
get:
|
|
operationId: GetProductTags
|
|
summary: List Product Tags
|
|
description: Retrieve a list of product tags. The product tags can be filtered by fields such as `id`. The product tags can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: q
|
|
in: query
|
|
description: The product tag's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The product tag's q.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The product tag's ID.
|
|
- type: array
|
|
description: The product tag's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: value
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The product tag's value.
|
|
- type: array
|
|
description: The product tag's value.
|
|
items:
|
|
type: string
|
|
title: value
|
|
description: The value's details.
|
|
- name: created_at
|
|
in: query
|
|
description: The product tag's created at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The product tag's created at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: created_at
|
|
- name: updated_at
|
|
in: query
|
|
description: The product tag's updated at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The product tag's updated at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: updated_at
|
|
- name: deleted_at
|
|
in: query
|
|
description: The product tag's deleted at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The product tag's deleted at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: deleted_at
|
|
- name: $and
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The product tag's $and.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The product tag's $or.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/product-tags' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Product Tags
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductTagListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostProductTags
|
|
summary: Create Product Tag
|
|
description: Create a product tag.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- value
|
|
- metadata
|
|
properties:
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The product tag's value.
|
|
metadata:
|
|
type: object
|
|
description: The product tag's metadata.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/product-tags' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"value": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Product Tags
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductTagResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createProductTagsWorkflow
|
|
/admin/product-tags/{id}:
|
|
get:
|
|
operationId: GetProductTagsId
|
|
summary: Get a Product Tag
|
|
description: Retrieve a product tag by its ID. You can expand the product tag's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product tag's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/product-tags/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Product Tags
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductTagResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostProductTagsId
|
|
summary: Update a Product Tag
|
|
description: Update a product tag's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product tag's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- metadata
|
|
properties:
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The product tag's value.
|
|
metadata:
|
|
type: object
|
|
description: The product tag's metadata.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/product-tags/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Product Tags
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductTagResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateProductTagsWorkflow
|
|
delete:
|
|
operationId: DeleteProductTagsId
|
|
summary: Delete a Product Tag
|
|
description: Delete a product tag.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product tag's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/product-tags/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Product Tags
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductTagDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/product-types:
|
|
get:
|
|
operationId: GetProductTypes
|
|
summary: List Product Types
|
|
description: Retrieve a list of product types. The product types can be filtered by fields such as `id`. The product types can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: q
|
|
in: query
|
|
description: The product type's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The product type's q.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The product type's ID.
|
|
- type: array
|
|
description: The product type's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: value
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The product type's value.
|
|
- type: array
|
|
description: The product type's value.
|
|
items:
|
|
type: string
|
|
title: value
|
|
description: The value's details.
|
|
- name: created_at
|
|
in: query
|
|
description: The product type's created at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The product type's created at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: created_at
|
|
- name: updated_at
|
|
in: query
|
|
description: The product type's updated at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The product type's updated at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: updated_at
|
|
- name: deleted_at
|
|
in: query
|
|
description: The product type's deleted at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The product type's deleted at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: deleted_at
|
|
- name: $and
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The product type's $and.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The product type's $or.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/product-types' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Product Types
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductTypeListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostProductTypes
|
|
summary: Create Product Type
|
|
description: Create a product type.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- value
|
|
- metadata
|
|
properties:
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The product type's value.
|
|
metadata:
|
|
type: object
|
|
description: The product type's metadata.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/product-types' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"value": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Product Types
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductTypeResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createProductTypesWorkflow
|
|
/admin/product-types/{id}:
|
|
get:
|
|
operationId: GetProductTypesId
|
|
summary: Get a Product Type
|
|
description: Retrieve a product type by its ID. You can expand the product type's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product type's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/product-types/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Product Types
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductTypeResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostProductTypesId
|
|
summary: Update a Product Type
|
|
description: Update a product type's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product type's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- metadata
|
|
properties:
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The product type's value.
|
|
metadata:
|
|
type: object
|
|
description: The product type's metadata.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/product-types/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Product Types
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductTypeResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateProductTypesWorkflow
|
|
delete:
|
|
operationId: DeleteProductTypesId
|
|
summary: Delete a Product Type
|
|
description: Delete a product type.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product type's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/product-types/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Product Types
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductTypeDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/product-variants:
|
|
get:
|
|
operationId: GetProductVariants
|
|
summary: List Product Variants
|
|
description: Retrieve a list of product variants. The product variants can be filtered by fields such as `id`. The product variants can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/product-variants' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Product Variants
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The product variant's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The product variant's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The product variant's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- variants
|
|
properties:
|
|
variants:
|
|
type: array
|
|
description: The product variant's variants.
|
|
items:
|
|
$ref: '#/components/schemas/AdminProductVariant'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/products:
|
|
get:
|
|
operationId: GetProducts
|
|
summary: List Products
|
|
description: Retrieve a list of products. The products can be filtered by fields such as `id`. The products can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: price_list_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: price_list_id
|
|
description: The product's price list id.
|
|
- type: array
|
|
description: The product's price list id.
|
|
items:
|
|
type: string
|
|
title: price_list_id
|
|
description: The price list id's details.
|
|
- name: q
|
|
in: query
|
|
description: The product's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The product's q.
|
|
- name: status
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: status
|
|
description: The product's status.
|
|
- type: string
|
|
title: status
|
|
description: The product's status.
|
|
- type: string
|
|
title: status
|
|
description: The product's status.
|
|
- type: string
|
|
title: status
|
|
description: The product's status.
|
|
- type: array
|
|
description: The product's status.
|
|
items:
|
|
type: string
|
|
enum:
|
|
- draft
|
|
- proposed
|
|
- published
|
|
- rejected
|
|
- name: sales_channel_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: sales_channel_id
|
|
description: The product's sales channel id.
|
|
- type: array
|
|
description: The product's sales channel id.
|
|
items:
|
|
type: string
|
|
title: sales_channel_id
|
|
description: The sales channel id's details.
|
|
- name: title
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: title
|
|
description: The product's title.
|
|
- type: array
|
|
description: The product's title.
|
|
items:
|
|
type: string
|
|
title: title
|
|
description: The title's details.
|
|
- name: handle
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: handle
|
|
description: The product's handle.
|
|
- type: array
|
|
description: The product's handle.
|
|
items:
|
|
type: string
|
|
title: handle
|
|
description: The handle's details.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The product's ID.
|
|
- type: array
|
|
description: The product's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: is_giftcard
|
|
in: query
|
|
description: The product's is giftcard.
|
|
required: false
|
|
schema:
|
|
type: boolean
|
|
title: is_giftcard
|
|
description: The product's is giftcard.
|
|
- name: tags
|
|
in: query
|
|
description: The product's tags.
|
|
required: false
|
|
schema:
|
|
description: The product's tags.
|
|
properties:
|
|
value:
|
|
type: array
|
|
description: The tag's value.
|
|
items:
|
|
type: string
|
|
title: value
|
|
description: The value's details.
|
|
- name: type_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: type_id
|
|
description: The product's type id.
|
|
- type: array
|
|
description: The product's type id.
|
|
items:
|
|
type: string
|
|
title: type_id
|
|
description: The type id's details.
|
|
- name: category_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: category_id
|
|
description: The product's category id.
|
|
- type: array
|
|
description: The product's category id.
|
|
items:
|
|
type: string
|
|
title: category_id
|
|
description: The category id's details.
|
|
- type: object
|
|
description: The product's category id.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The category id's $and.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $and's exec.
|
|
test:
|
|
type: object
|
|
description: The $and's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $and's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $and's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $and's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $and's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $and's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $and's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $and's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $and's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $and's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $and's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $and's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $and's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $and's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $and's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $and's @matchall@1137.
|
|
- type: object
|
|
description: The $and's details.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's details.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
$or:
|
|
type: array
|
|
description: The $and's $or.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's details.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $and's $eq.
|
|
- type: object
|
|
description: The $and's $eq.
|
|
x-schemaName: RegExp
|
|
- type: array
|
|
description: The $and's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The $and's $ne.
|
|
- type: object
|
|
description: The $and's $ne.
|
|
x-schemaName: RegExp
|
|
$in:
|
|
type: array
|
|
description: The $and's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
$nin:
|
|
type: array
|
|
description: The $and's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $and's $not.
|
|
- type: object
|
|
description: The $and's $not.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's $not.
|
|
- type: array
|
|
description: The $and's $not.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The $and's $gt.
|
|
- type: object
|
|
description: The $and's $gt.
|
|
x-schemaName: RegExp
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The $and's $gte.
|
|
- type: object
|
|
description: The $and's $gte.
|
|
x-schemaName: RegExp
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The $and's $lt.
|
|
- type: object
|
|
description: The $and's $lt.
|
|
x-schemaName: RegExp
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The $and's $lte.
|
|
- type: object
|
|
description: The $and's $lte.
|
|
x-schemaName: RegExp
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The $and's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The $and's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The $and's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The $and's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The $and's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The $and's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The $and's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The $and's $exists.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $and's exec.
|
|
test:
|
|
type: object
|
|
description: The $and's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $and's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $and's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $and's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $and's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $and's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $and's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $and's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $and's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $and's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $and's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $and's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $and's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $and's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $and's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $and's @matchall@1137.
|
|
$or:
|
|
type: array
|
|
description: The category id's $or.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $or's exec.
|
|
test:
|
|
type: object
|
|
description: The $or's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $or's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $or's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $or's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $or's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $or's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $or's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $or's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $or's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $or's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $or's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $or's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $or's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $or's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $or's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $or's @matchall@1137.
|
|
- type: object
|
|
description: The $or's details.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The $or's $and.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's details.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
$or:
|
|
type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's details.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $or's $eq.
|
|
- type: object
|
|
description: The $or's $eq.
|
|
x-schemaName: RegExp
|
|
- type: array
|
|
description: The $or's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The $or's $ne.
|
|
- type: object
|
|
description: The $or's $ne.
|
|
x-schemaName: RegExp
|
|
$in:
|
|
type: array
|
|
description: The $or's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
$nin:
|
|
type: array
|
|
description: The $or's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $or's $not.
|
|
- type: object
|
|
description: The $or's $not.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's $not.
|
|
- type: array
|
|
description: The $or's $not.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The $or's $gt.
|
|
- type: object
|
|
description: The $or's $gt.
|
|
x-schemaName: RegExp
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The $or's $gte.
|
|
- type: object
|
|
description: The $or's $gte.
|
|
x-schemaName: RegExp
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The $or's $lt.
|
|
- type: object
|
|
description: The $or's $lt.
|
|
x-schemaName: RegExp
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The $or's $lte.
|
|
- type: object
|
|
description: The $or's $lte.
|
|
x-schemaName: RegExp
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The $or's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The $or's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The $or's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The $or's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The $or's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The $or's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The $or's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The $or's $exists.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $or's exec.
|
|
test:
|
|
type: object
|
|
description: The $or's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $or's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $or's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $or's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $or's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $or's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $or's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $or's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $or's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $or's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $or's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $or's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $or's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $or's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $or's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $or's @matchall@1137.
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The category id's $eq.
|
|
- type: object
|
|
description: The category id's $eq.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $eq's exec.
|
|
test:
|
|
type: object
|
|
description: The $eq's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $eq's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $eq's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $eq's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $eq's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $eq's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $eq's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $eq's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $eq's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $eq's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $eq's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $eq's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $eq's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $eq's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $eq's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $eq's @matchall@1137.
|
|
- type: array
|
|
description: The category id's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $eq's exec.
|
|
test:
|
|
type: object
|
|
description: The $eq's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $eq's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $eq's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $eq's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $eq's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $eq's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $eq's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $eq's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $eq's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $eq's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $eq's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $eq's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $eq's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $eq's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $eq's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $eq's @matchall@1137.
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The category id's $ne.
|
|
- type: object
|
|
description: The category id's $ne.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $ne's exec.
|
|
test:
|
|
type: object
|
|
description: The $ne's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $ne's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $ne's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $ne's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $ne's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $ne's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $ne's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $ne's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $ne's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $ne's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $ne's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $ne's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $ne's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $ne's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $ne's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $ne's @matchall@1137.
|
|
$in:
|
|
type: array
|
|
description: The category id's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $in's exec.
|
|
test:
|
|
type: object
|
|
description: The $in's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $in's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $in's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $in's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $in's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $in's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $in's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $in's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $in's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $in's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $in's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $in's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $in's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $in's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $in's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $in's @matchall@1137.
|
|
$nin:
|
|
type: array
|
|
description: The category id's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $nin's exec.
|
|
test:
|
|
type: object
|
|
description: The $nin's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $nin's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $nin's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $nin's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $nin's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $nin's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $nin's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $nin's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $nin's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $nin's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $nin's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $nin's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $nin's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $nin's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $nin's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $nin's @matchall@1137.
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The category id's $not.
|
|
- type: object
|
|
description: The category id's $not.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $not's exec.
|
|
test:
|
|
type: object
|
|
description: The $not's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $not's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $not's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $not's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $not's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $not's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $not's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $not's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $not's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $not's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $not's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $not's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $not's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $not's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $not's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $not's @matchall@1137.
|
|
- type: object
|
|
description: The category id's $not.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The $not's $and.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's details.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
$or:
|
|
type: array
|
|
description: The $not's $or.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's details.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $not's $eq.
|
|
- type: object
|
|
description: The $not's $eq.
|
|
x-schemaName: RegExp
|
|
- type: array
|
|
description: The $not's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The $not's $ne.
|
|
- type: object
|
|
description: The $not's $ne.
|
|
x-schemaName: RegExp
|
|
$in:
|
|
type: array
|
|
description: The $not's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
$nin:
|
|
type: array
|
|
description: The $not's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $not's details.
|
|
- type: array
|
|
description: The $not's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The $not's $gt.
|
|
- type: object
|
|
description: The $not's $gt.
|
|
x-schemaName: RegExp
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The $not's $gte.
|
|
- type: object
|
|
description: The $not's $gte.
|
|
x-schemaName: RegExp
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The $not's $lt.
|
|
- type: object
|
|
description: The $not's $lt.
|
|
x-schemaName: RegExp
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The $not's $lte.
|
|
- type: object
|
|
description: The $not's $lte.
|
|
x-schemaName: RegExp
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The $not's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The $not's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The $not's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The $not's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The $not's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The $not's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The $not's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The $not's $exists.
|
|
- type: array
|
|
description: The category id's $not.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $not's exec.
|
|
test:
|
|
type: object
|
|
description: The $not's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $not's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $not's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $not's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $not's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $not's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $not's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $not's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $not's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $not's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $not's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $not's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $not's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $not's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $not's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $not's @matchall@1137.
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The category id's $gt.
|
|
- type: object
|
|
description: The category id's $gt.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $gt's exec.
|
|
test:
|
|
type: object
|
|
description: The $gt's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $gt's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $gt's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $gt's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $gt's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $gt's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $gt's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $gt's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $gt's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $gt's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $gt's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $gt's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $gt's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $gt's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $gt's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $gt's @matchall@1137.
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The category id's $gte.
|
|
- type: object
|
|
description: The category id's $gte.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $gte's exec.
|
|
test:
|
|
type: object
|
|
description: The $gte's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $gte's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $gte's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $gte's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $gte's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $gte's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $gte's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $gte's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $gte's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $gte's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $gte's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $gte's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $gte's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $gte's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $gte's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $gte's @matchall@1137.
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The category id's $lt.
|
|
- type: object
|
|
description: The category id's $lt.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $lt's exec.
|
|
test:
|
|
type: object
|
|
description: The $lt's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $lt's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $lt's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $lt's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $lt's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $lt's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $lt's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $lt's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $lt's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $lt's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $lt's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $lt's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $lt's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $lt's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $lt's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $lt's @matchall@1137.
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The category id's $lte.
|
|
- type: object
|
|
description: The category id's $lte.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $lte's exec.
|
|
test:
|
|
type: object
|
|
description: The $lte's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $lte's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $lte's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $lte's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $lte's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $lte's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $lte's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $lte's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $lte's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $lte's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $lte's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $lte's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $lte's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $lte's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $lte's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $lte's @matchall@1137.
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The category id's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The category id's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The category id's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The category id's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The category id's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The category id's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The category id's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The category id's $exists.
|
|
- name: categories
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: object
|
|
description: The product's categories.
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: object
|
|
description: The category's ID.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The id's $and.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's details.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
$or:
|
|
type: array
|
|
description: The id's $or.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's details.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The id's $eq.
|
|
- type: object
|
|
description: The id's $eq.
|
|
x-schemaName: RegExp
|
|
- type: array
|
|
description: The id's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The id's $ne.
|
|
- type: object
|
|
description: The id's $ne.
|
|
x-schemaName: RegExp
|
|
$in:
|
|
type: array
|
|
description: The id's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
$nin:
|
|
type: array
|
|
description: The id's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The id's $not.
|
|
- type: object
|
|
description: The id's $not.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The id's $not.
|
|
- type: array
|
|
description: The id's $not.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The id's $gt.
|
|
- type: object
|
|
description: The id's $gt.
|
|
x-schemaName: RegExp
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The id's $gte.
|
|
- type: object
|
|
description: The id's $gte.
|
|
x-schemaName: RegExp
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The id's $lt.
|
|
- type: object
|
|
description: The id's $lt.
|
|
x-schemaName: RegExp
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The id's $lte.
|
|
- type: object
|
|
description: The id's $lte.
|
|
x-schemaName: RegExp
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The id's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The id's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The id's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The id's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The id's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The id's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The id's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The id's $exists.
|
|
- type: object
|
|
description: The product's categories.
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: object
|
|
description: The category's ID.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The id's $and.
|
|
items:
|
|
type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
$or:
|
|
type: array
|
|
description: The id's $or.
|
|
items:
|
|
type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
$eq:
|
|
oneOf:
|
|
- type: array
|
|
description: The id's $eq.
|
|
items:
|
|
type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: array
|
|
description: The id's $eq.
|
|
items:
|
|
type: array
|
|
description: The $eq's details.
|
|
items:
|
|
type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
$ne:
|
|
type: array
|
|
description: The id's $ne.
|
|
items:
|
|
type: string
|
|
title: $ne
|
|
description: The $ne's details.
|
|
$in:
|
|
type: array
|
|
description: The id's $in.
|
|
items:
|
|
type: array
|
|
description: The $in's details.
|
|
items:
|
|
type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
$nin:
|
|
type: array
|
|
description: The id's $nin.
|
|
items:
|
|
type: array
|
|
description: The $nin's details.
|
|
items:
|
|
type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
$not:
|
|
type: array
|
|
description: The id's $not.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
$gt:
|
|
type: array
|
|
description: The id's $gt.
|
|
items:
|
|
type: string
|
|
title: $gt
|
|
description: The $gt's details.
|
|
$gte:
|
|
type: array
|
|
description: The id's $gte.
|
|
items:
|
|
type: string
|
|
title: $gte
|
|
description: The $gte's details.
|
|
$lt:
|
|
type: array
|
|
description: The id's $lt.
|
|
items:
|
|
type: string
|
|
title: $lt
|
|
description: The $lt's details.
|
|
$lte:
|
|
type: array
|
|
description: The id's $lte.
|
|
items:
|
|
type: string
|
|
title: $lte
|
|
description: The $lte's details.
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The id's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The id's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The id's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The id's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The id's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The id's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The id's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The id's $exists.
|
|
- name: collection_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: collection_id
|
|
description: The product's collection id.
|
|
- type: array
|
|
description: The product's collection id.
|
|
items:
|
|
type: string
|
|
title: collection_id
|
|
description: The collection id's details.
|
|
- type: object
|
|
description: The product's collection id.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The collection id's $and.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $and's exec.
|
|
test:
|
|
type: object
|
|
description: The $and's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $and's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $and's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $and's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $and's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $and's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $and's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $and's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $and's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $and's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $and's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $and's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $and's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $and's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $and's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $and's @matchall@1137.
|
|
- type: object
|
|
description: The $and's details.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's details.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
$or:
|
|
type: array
|
|
description: The $and's $or.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's details.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $and's $eq.
|
|
- type: object
|
|
description: The $and's $eq.
|
|
x-schemaName: RegExp
|
|
- type: array
|
|
description: The $and's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The $and's $ne.
|
|
- type: object
|
|
description: The $and's $ne.
|
|
x-schemaName: RegExp
|
|
$in:
|
|
type: array
|
|
description: The $and's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
$nin:
|
|
type: array
|
|
description: The $and's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $and's $not.
|
|
- type: object
|
|
description: The $and's $not.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's $not.
|
|
- type: array
|
|
description: The $and's $not.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The $and's $gt.
|
|
- type: object
|
|
description: The $and's $gt.
|
|
x-schemaName: RegExp
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The $and's $gte.
|
|
- type: object
|
|
description: The $and's $gte.
|
|
x-schemaName: RegExp
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The $and's $lt.
|
|
- type: object
|
|
description: The $and's $lt.
|
|
x-schemaName: RegExp
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The $and's $lte.
|
|
- type: object
|
|
description: The $and's $lte.
|
|
x-schemaName: RegExp
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The $and's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The $and's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The $and's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The $and's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The $and's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The $and's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The $and's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The $and's $exists.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $and's exec.
|
|
test:
|
|
type: object
|
|
description: The $and's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $and's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $and's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $and's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $and's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $and's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $and's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $and's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $and's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $and's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $and's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $and's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $and's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $and's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $and's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $and's @matchall@1137.
|
|
$or:
|
|
type: array
|
|
description: The collection id's $or.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $or's exec.
|
|
test:
|
|
type: object
|
|
description: The $or's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $or's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $or's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $or's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $or's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $or's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $or's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $or's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $or's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $or's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $or's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $or's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $or's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $or's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $or's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $or's @matchall@1137.
|
|
- type: object
|
|
description: The $or's details.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The $or's $and.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's details.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
$or:
|
|
type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's details.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $or's $eq.
|
|
- type: object
|
|
description: The $or's $eq.
|
|
x-schemaName: RegExp
|
|
- type: array
|
|
description: The $or's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The $or's $ne.
|
|
- type: object
|
|
description: The $or's $ne.
|
|
x-schemaName: RegExp
|
|
$in:
|
|
type: array
|
|
description: The $or's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
$nin:
|
|
type: array
|
|
description: The $or's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $or's $not.
|
|
- type: object
|
|
description: The $or's $not.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's $not.
|
|
- type: array
|
|
description: The $or's $not.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The $or's $gt.
|
|
- type: object
|
|
description: The $or's $gt.
|
|
x-schemaName: RegExp
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The $or's $gte.
|
|
- type: object
|
|
description: The $or's $gte.
|
|
x-schemaName: RegExp
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The $or's $lt.
|
|
- type: object
|
|
description: The $or's $lt.
|
|
x-schemaName: RegExp
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The $or's $lte.
|
|
- type: object
|
|
description: The $or's $lte.
|
|
x-schemaName: RegExp
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The $or's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The $or's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The $or's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The $or's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The $or's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The $or's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The $or's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The $or's $exists.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $or's exec.
|
|
test:
|
|
type: object
|
|
description: The $or's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $or's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $or's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $or's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $or's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $or's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $or's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $or's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $or's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $or's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $or's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $or's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $or's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $or's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $or's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $or's @matchall@1137.
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The collection id's $eq.
|
|
- type: object
|
|
description: The collection id's $eq.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $eq's exec.
|
|
test:
|
|
type: object
|
|
description: The $eq's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $eq's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $eq's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $eq's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $eq's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $eq's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $eq's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $eq's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $eq's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $eq's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $eq's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $eq's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $eq's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $eq's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $eq's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $eq's @matchall@1137.
|
|
- type: array
|
|
description: The collection id's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $eq's exec.
|
|
test:
|
|
type: object
|
|
description: The $eq's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $eq's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $eq's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $eq's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $eq's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $eq's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $eq's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $eq's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $eq's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $eq's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $eq's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $eq's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $eq's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $eq's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $eq's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $eq's @matchall@1137.
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The collection id's $ne.
|
|
- type: object
|
|
description: The collection id's $ne.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $ne's exec.
|
|
test:
|
|
type: object
|
|
description: The $ne's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $ne's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $ne's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $ne's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $ne's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $ne's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $ne's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $ne's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $ne's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $ne's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $ne's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $ne's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $ne's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $ne's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $ne's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $ne's @matchall@1137.
|
|
$in:
|
|
type: array
|
|
description: The collection id's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $in's exec.
|
|
test:
|
|
type: object
|
|
description: The $in's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $in's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $in's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $in's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $in's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $in's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $in's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $in's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $in's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $in's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $in's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $in's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $in's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $in's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $in's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $in's @matchall@1137.
|
|
$nin:
|
|
type: array
|
|
description: The collection id's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $nin's exec.
|
|
test:
|
|
type: object
|
|
description: The $nin's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $nin's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $nin's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $nin's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $nin's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $nin's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $nin's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $nin's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $nin's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $nin's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $nin's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $nin's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $nin's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $nin's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $nin's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $nin's @matchall@1137.
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The collection id's $not.
|
|
- type: object
|
|
description: The collection id's $not.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $not's exec.
|
|
test:
|
|
type: object
|
|
description: The $not's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $not's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $not's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $not's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $not's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $not's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $not's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $not's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $not's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $not's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $not's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $not's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $not's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $not's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $not's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $not's @matchall@1137.
|
|
- type: object
|
|
description: The collection id's $not.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The $not's $and.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's details.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
$or:
|
|
type: array
|
|
description: The $not's $or.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's details.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $not's $eq.
|
|
- type: object
|
|
description: The $not's $eq.
|
|
x-schemaName: RegExp
|
|
- type: array
|
|
description: The $not's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The $not's $ne.
|
|
- type: object
|
|
description: The $not's $ne.
|
|
x-schemaName: RegExp
|
|
$in:
|
|
type: array
|
|
description: The $not's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
$nin:
|
|
type: array
|
|
description: The $not's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $not's details.
|
|
- type: array
|
|
description: The $not's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The $not's $gt.
|
|
- type: object
|
|
description: The $not's $gt.
|
|
x-schemaName: RegExp
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The $not's $gte.
|
|
- type: object
|
|
description: The $not's $gte.
|
|
x-schemaName: RegExp
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The $not's $lt.
|
|
- type: object
|
|
description: The $not's $lt.
|
|
x-schemaName: RegExp
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The $not's $lte.
|
|
- type: object
|
|
description: The $not's $lte.
|
|
x-schemaName: RegExp
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The $not's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The $not's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The $not's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The $not's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The $not's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The $not's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The $not's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The $not's $exists.
|
|
- type: array
|
|
description: The collection id's $not.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $not's exec.
|
|
test:
|
|
type: object
|
|
description: The $not's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $not's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $not's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $not's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $not's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $not's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $not's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $not's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $not's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $not's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $not's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $not's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $not's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $not's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $not's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $not's @matchall@1137.
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The collection id's $gt.
|
|
- type: object
|
|
description: The collection id's $gt.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $gt's exec.
|
|
test:
|
|
type: object
|
|
description: The $gt's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $gt's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $gt's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $gt's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $gt's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $gt's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $gt's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $gt's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $gt's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $gt's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $gt's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $gt's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $gt's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $gt's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $gt's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $gt's @matchall@1137.
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The collection id's $gte.
|
|
- type: object
|
|
description: The collection id's $gte.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $gte's exec.
|
|
test:
|
|
type: object
|
|
description: The $gte's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $gte's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $gte's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $gte's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $gte's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $gte's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $gte's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $gte's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $gte's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $gte's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $gte's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $gte's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $gte's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $gte's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $gte's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $gte's @matchall@1137.
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The collection id's $lt.
|
|
- type: object
|
|
description: The collection id's $lt.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $lt's exec.
|
|
test:
|
|
type: object
|
|
description: The $lt's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $lt's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $lt's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $lt's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $lt's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $lt's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $lt's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $lt's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $lt's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $lt's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $lt's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $lt's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $lt's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $lt's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $lt's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $lt's @matchall@1137.
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The collection id's $lte.
|
|
- type: object
|
|
description: The collection id's $lte.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $lte's exec.
|
|
test:
|
|
type: object
|
|
description: The $lte's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $lte's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $lte's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $lte's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $lte's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $lte's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $lte's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $lte's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $lte's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $lte's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $lte's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $lte's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $lte's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $lte's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $lte's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $lte's @matchall@1137.
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The collection id's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The collection id's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The collection id's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The collection id's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The collection id's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The collection id's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The collection id's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The collection id's $exists.
|
|
- name: created_at
|
|
in: query
|
|
description: The product's created at.
|
|
required: false
|
|
schema:
|
|
type: object
|
|
description: The product's created at.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The created at's $and.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $and's exec.
|
|
test:
|
|
type: object
|
|
description: The $and's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $and's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $and's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $and's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $and's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $and's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $and's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $and's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $and's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $and's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $and's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $and's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $and's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $and's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $and's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $and's @matchall@1137.
|
|
- type: object
|
|
description: The $and's details.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's details.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
$or:
|
|
type: array
|
|
description: The $and's $or.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's details.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $and's $eq.
|
|
- type: object
|
|
description: The $and's $eq.
|
|
x-schemaName: RegExp
|
|
- type: array
|
|
description: The $and's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The $and's $ne.
|
|
- type: object
|
|
description: The $and's $ne.
|
|
x-schemaName: RegExp
|
|
$in:
|
|
type: array
|
|
description: The $and's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
$nin:
|
|
type: array
|
|
description: The $and's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $and's $not.
|
|
- type: object
|
|
description: The $and's $not.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's $not.
|
|
- type: array
|
|
description: The $and's $not.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The $and's $gt.
|
|
- type: object
|
|
description: The $and's $gt.
|
|
x-schemaName: RegExp
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The $and's $gte.
|
|
- type: object
|
|
description: The $and's $gte.
|
|
x-schemaName: RegExp
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The $and's $lt.
|
|
- type: object
|
|
description: The $and's $lt.
|
|
x-schemaName: RegExp
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The $and's $lte.
|
|
- type: object
|
|
description: The $and's $lte.
|
|
x-schemaName: RegExp
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The $and's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The $and's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The $and's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The $and's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The $and's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The $and's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The $and's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The $and's $exists.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $and's exec.
|
|
test:
|
|
type: object
|
|
description: The $and's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $and's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $and's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $and's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $and's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $and's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $and's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $and's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $and's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $and's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $and's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $and's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $and's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $and's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $and's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $and's @matchall@1137.
|
|
$or:
|
|
type: array
|
|
description: The created at's $or.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $or's exec.
|
|
test:
|
|
type: object
|
|
description: The $or's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $or's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $or's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $or's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $or's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $or's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $or's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $or's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $or's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $or's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $or's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $or's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $or's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $or's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $or's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $or's @matchall@1137.
|
|
- type: object
|
|
description: The $or's details.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The $or's $and.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's details.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
$or:
|
|
type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's details.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $or's $eq.
|
|
- type: object
|
|
description: The $or's $eq.
|
|
x-schemaName: RegExp
|
|
- type: array
|
|
description: The $or's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The $or's $ne.
|
|
- type: object
|
|
description: The $or's $ne.
|
|
x-schemaName: RegExp
|
|
$in:
|
|
type: array
|
|
description: The $or's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
$nin:
|
|
type: array
|
|
description: The $or's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $or's $not.
|
|
- type: object
|
|
description: The $or's $not.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's $not.
|
|
- type: array
|
|
description: The $or's $not.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The $or's $gt.
|
|
- type: object
|
|
description: The $or's $gt.
|
|
x-schemaName: RegExp
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The $or's $gte.
|
|
- type: object
|
|
description: The $or's $gte.
|
|
x-schemaName: RegExp
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The $or's $lt.
|
|
- type: object
|
|
description: The $or's $lt.
|
|
x-schemaName: RegExp
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The $or's $lte.
|
|
- type: object
|
|
description: The $or's $lte.
|
|
x-schemaName: RegExp
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The $or's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The $or's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The $or's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The $or's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The $or's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The $or's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The $or's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The $or's $exists.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $or's exec.
|
|
test:
|
|
type: object
|
|
description: The $or's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $or's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $or's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $or's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $or's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $or's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $or's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $or's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $or's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $or's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $or's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $or's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $or's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $or's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $or's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $or's @matchall@1137.
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The created at's $eq.
|
|
- type: object
|
|
description: The created at's $eq.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $eq's exec.
|
|
test:
|
|
type: object
|
|
description: The $eq's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $eq's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $eq's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $eq's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $eq's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $eq's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $eq's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $eq's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $eq's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $eq's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $eq's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $eq's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $eq's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $eq's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $eq's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $eq's @matchall@1137.
|
|
- type: array
|
|
description: The created at's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $eq's exec.
|
|
test:
|
|
type: object
|
|
description: The $eq's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $eq's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $eq's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $eq's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $eq's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $eq's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $eq's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $eq's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $eq's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $eq's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $eq's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $eq's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $eq's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $eq's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $eq's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $eq's @matchall@1137.
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The created at's $ne.
|
|
- type: object
|
|
description: The created at's $ne.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $ne's exec.
|
|
test:
|
|
type: object
|
|
description: The $ne's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $ne's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $ne's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $ne's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $ne's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $ne's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $ne's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $ne's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $ne's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $ne's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $ne's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $ne's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $ne's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $ne's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $ne's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $ne's @matchall@1137.
|
|
$in:
|
|
type: array
|
|
description: The created at's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $in's exec.
|
|
test:
|
|
type: object
|
|
description: The $in's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $in's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $in's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $in's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $in's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $in's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $in's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $in's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $in's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $in's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $in's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $in's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $in's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $in's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $in's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $in's @matchall@1137.
|
|
$nin:
|
|
type: array
|
|
description: The created at's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $nin's exec.
|
|
test:
|
|
type: object
|
|
description: The $nin's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $nin's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $nin's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $nin's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $nin's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $nin's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $nin's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $nin's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $nin's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $nin's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $nin's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $nin's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $nin's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $nin's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $nin's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $nin's @matchall@1137.
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The created at's $not.
|
|
- type: object
|
|
description: The created at's $not.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $not's exec.
|
|
test:
|
|
type: object
|
|
description: The $not's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $not's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $not's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $not's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $not's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $not's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $not's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $not's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $not's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $not's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $not's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $not's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $not's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $not's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $not's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $not's @matchall@1137.
|
|
- type: object
|
|
description: The created at's $not.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The $not's $and.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's details.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
$or:
|
|
type: array
|
|
description: The $not's $or.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's details.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $not's $eq.
|
|
- type: object
|
|
description: The $not's $eq.
|
|
x-schemaName: RegExp
|
|
- type: array
|
|
description: The $not's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The $not's $ne.
|
|
- type: object
|
|
description: The $not's $ne.
|
|
x-schemaName: RegExp
|
|
$in:
|
|
type: array
|
|
description: The $not's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
$nin:
|
|
type: array
|
|
description: The $not's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $not's details.
|
|
- type: array
|
|
description: The $not's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The $not's $gt.
|
|
- type: object
|
|
description: The $not's $gt.
|
|
x-schemaName: RegExp
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The $not's $gte.
|
|
- type: object
|
|
description: The $not's $gte.
|
|
x-schemaName: RegExp
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The $not's $lt.
|
|
- type: object
|
|
description: The $not's $lt.
|
|
x-schemaName: RegExp
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The $not's $lte.
|
|
- type: object
|
|
description: The $not's $lte.
|
|
x-schemaName: RegExp
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The $not's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The $not's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The $not's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The $not's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The $not's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The $not's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The $not's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The $not's $exists.
|
|
- type: array
|
|
description: The created at's $not.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $not's exec.
|
|
test:
|
|
type: object
|
|
description: The $not's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $not's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $not's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $not's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $not's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $not's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $not's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $not's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $not's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $not's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $not's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $not's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $not's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $not's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $not's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $not's @matchall@1137.
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The created at's $gt.
|
|
- type: object
|
|
description: The created at's $gt.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $gt's exec.
|
|
test:
|
|
type: object
|
|
description: The $gt's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $gt's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $gt's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $gt's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $gt's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $gt's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $gt's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $gt's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $gt's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $gt's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $gt's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $gt's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $gt's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $gt's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $gt's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $gt's @matchall@1137.
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The created at's $gte.
|
|
- type: object
|
|
description: The created at's $gte.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $gte's exec.
|
|
test:
|
|
type: object
|
|
description: The $gte's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $gte's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $gte's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $gte's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $gte's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $gte's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $gte's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $gte's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $gte's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $gte's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $gte's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $gte's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $gte's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $gte's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $gte's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $gte's @matchall@1137.
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The created at's $lt.
|
|
- type: object
|
|
description: The created at's $lt.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $lt's exec.
|
|
test:
|
|
type: object
|
|
description: The $lt's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $lt's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $lt's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $lt's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $lt's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $lt's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $lt's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $lt's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $lt's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $lt's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $lt's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $lt's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $lt's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $lt's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $lt's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $lt's @matchall@1137.
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The created at's $lte.
|
|
- type: object
|
|
description: The created at's $lte.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $lte's exec.
|
|
test:
|
|
type: object
|
|
description: The $lte's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $lte's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $lte's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $lte's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $lte's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $lte's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $lte's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $lte's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $lte's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $lte's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $lte's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $lte's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $lte's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $lte's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $lte's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $lte's @matchall@1137.
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The created at's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The created at's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The created at's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The created at's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The created at's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The created at's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The created at's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The created at's $exists.
|
|
- name: updated_at
|
|
in: query
|
|
description: The product's updated at.
|
|
required: false
|
|
schema:
|
|
type: object
|
|
description: The product's updated at.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The updated at's $and.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $and's exec.
|
|
test:
|
|
type: object
|
|
description: The $and's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $and's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $and's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $and's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $and's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $and's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $and's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $and's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $and's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $and's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $and's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $and's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $and's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $and's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $and's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $and's @matchall@1137.
|
|
- type: object
|
|
description: The $and's details.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's details.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
$or:
|
|
type: array
|
|
description: The $and's $or.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's details.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $and's $eq.
|
|
- type: object
|
|
description: The $and's $eq.
|
|
x-schemaName: RegExp
|
|
- type: array
|
|
description: The $and's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The $and's $ne.
|
|
- type: object
|
|
description: The $and's $ne.
|
|
x-schemaName: RegExp
|
|
$in:
|
|
type: array
|
|
description: The $and's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
$nin:
|
|
type: array
|
|
description: The $and's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $and's $not.
|
|
- type: object
|
|
description: The $and's $not.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's $not.
|
|
- type: array
|
|
description: The $and's $not.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The $and's $gt.
|
|
- type: object
|
|
description: The $and's $gt.
|
|
x-schemaName: RegExp
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The $and's $gte.
|
|
- type: object
|
|
description: The $and's $gte.
|
|
x-schemaName: RegExp
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The $and's $lt.
|
|
- type: object
|
|
description: The $and's $lt.
|
|
x-schemaName: RegExp
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The $and's $lte.
|
|
- type: object
|
|
description: The $and's $lte.
|
|
x-schemaName: RegExp
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The $and's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The $and's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The $and's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The $and's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The $and's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The $and's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The $and's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The $and's $exists.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $and's exec.
|
|
test:
|
|
type: object
|
|
description: The $and's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $and's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $and's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $and's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $and's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $and's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $and's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $and's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $and's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $and's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $and's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $and's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $and's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $and's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $and's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $and's @matchall@1137.
|
|
$or:
|
|
type: array
|
|
description: The updated at's $or.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $or's exec.
|
|
test:
|
|
type: object
|
|
description: The $or's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $or's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $or's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $or's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $or's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $or's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $or's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $or's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $or's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $or's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $or's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $or's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $or's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $or's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $or's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $or's @matchall@1137.
|
|
- type: object
|
|
description: The $or's details.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The $or's $and.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's details.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
$or:
|
|
type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's details.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $or's $eq.
|
|
- type: object
|
|
description: The $or's $eq.
|
|
x-schemaName: RegExp
|
|
- type: array
|
|
description: The $or's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The $or's $ne.
|
|
- type: object
|
|
description: The $or's $ne.
|
|
x-schemaName: RegExp
|
|
$in:
|
|
type: array
|
|
description: The $or's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
$nin:
|
|
type: array
|
|
description: The $or's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $or's $not.
|
|
- type: object
|
|
description: The $or's $not.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's $not.
|
|
- type: array
|
|
description: The $or's $not.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The $or's $gt.
|
|
- type: object
|
|
description: The $or's $gt.
|
|
x-schemaName: RegExp
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The $or's $gte.
|
|
- type: object
|
|
description: The $or's $gte.
|
|
x-schemaName: RegExp
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The $or's $lt.
|
|
- type: object
|
|
description: The $or's $lt.
|
|
x-schemaName: RegExp
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The $or's $lte.
|
|
- type: object
|
|
description: The $or's $lte.
|
|
x-schemaName: RegExp
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The $or's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The $or's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The $or's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The $or's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The $or's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The $or's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The $or's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The $or's $exists.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $or's exec.
|
|
test:
|
|
type: object
|
|
description: The $or's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $or's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $or's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $or's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $or's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $or's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $or's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $or's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $or's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $or's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $or's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $or's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $or's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $or's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $or's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $or's @matchall@1137.
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The updated at's $eq.
|
|
- type: object
|
|
description: The updated at's $eq.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $eq's exec.
|
|
test:
|
|
type: object
|
|
description: The $eq's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $eq's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $eq's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $eq's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $eq's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $eq's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $eq's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $eq's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $eq's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $eq's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $eq's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $eq's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $eq's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $eq's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $eq's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $eq's @matchall@1137.
|
|
- type: array
|
|
description: The updated at's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $eq's exec.
|
|
test:
|
|
type: object
|
|
description: The $eq's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $eq's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $eq's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $eq's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $eq's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $eq's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $eq's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $eq's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $eq's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $eq's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $eq's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $eq's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $eq's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $eq's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $eq's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $eq's @matchall@1137.
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The updated at's $ne.
|
|
- type: object
|
|
description: The updated at's $ne.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $ne's exec.
|
|
test:
|
|
type: object
|
|
description: The $ne's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $ne's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $ne's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $ne's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $ne's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $ne's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $ne's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $ne's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $ne's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $ne's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $ne's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $ne's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $ne's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $ne's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $ne's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $ne's @matchall@1137.
|
|
$in:
|
|
type: array
|
|
description: The updated at's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $in's exec.
|
|
test:
|
|
type: object
|
|
description: The $in's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $in's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $in's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $in's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $in's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $in's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $in's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $in's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $in's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $in's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $in's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $in's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $in's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $in's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $in's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $in's @matchall@1137.
|
|
$nin:
|
|
type: array
|
|
description: The updated at's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $nin's exec.
|
|
test:
|
|
type: object
|
|
description: The $nin's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $nin's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $nin's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $nin's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $nin's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $nin's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $nin's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $nin's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $nin's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $nin's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $nin's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $nin's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $nin's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $nin's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $nin's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $nin's @matchall@1137.
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The updated at's $not.
|
|
- type: object
|
|
description: The updated at's $not.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $not's exec.
|
|
test:
|
|
type: object
|
|
description: The $not's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $not's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $not's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $not's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $not's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $not's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $not's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $not's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $not's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $not's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $not's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $not's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $not's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $not's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $not's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $not's @matchall@1137.
|
|
- type: object
|
|
description: The updated at's $not.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The $not's $and.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's details.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
$or:
|
|
type: array
|
|
description: The $not's $or.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's details.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $not's $eq.
|
|
- type: object
|
|
description: The $not's $eq.
|
|
x-schemaName: RegExp
|
|
- type: array
|
|
description: The $not's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The $not's $ne.
|
|
- type: object
|
|
description: The $not's $ne.
|
|
x-schemaName: RegExp
|
|
$in:
|
|
type: array
|
|
description: The $not's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
$nin:
|
|
type: array
|
|
description: The $not's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $not's details.
|
|
- type: array
|
|
description: The $not's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The $not's $gt.
|
|
- type: object
|
|
description: The $not's $gt.
|
|
x-schemaName: RegExp
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The $not's $gte.
|
|
- type: object
|
|
description: The $not's $gte.
|
|
x-schemaName: RegExp
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The $not's $lt.
|
|
- type: object
|
|
description: The $not's $lt.
|
|
x-schemaName: RegExp
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The $not's $lte.
|
|
- type: object
|
|
description: The $not's $lte.
|
|
x-schemaName: RegExp
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The $not's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The $not's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The $not's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The $not's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The $not's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The $not's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The $not's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The $not's $exists.
|
|
- type: array
|
|
description: The updated at's $not.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $not's exec.
|
|
test:
|
|
type: object
|
|
description: The $not's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $not's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $not's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $not's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $not's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $not's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $not's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $not's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $not's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $not's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $not's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $not's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $not's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $not's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $not's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $not's @matchall@1137.
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The updated at's $gt.
|
|
- type: object
|
|
description: The updated at's $gt.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $gt's exec.
|
|
test:
|
|
type: object
|
|
description: The $gt's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $gt's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $gt's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $gt's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $gt's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $gt's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $gt's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $gt's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $gt's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $gt's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $gt's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $gt's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $gt's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $gt's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $gt's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $gt's @matchall@1137.
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The updated at's $gte.
|
|
- type: object
|
|
description: The updated at's $gte.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $gte's exec.
|
|
test:
|
|
type: object
|
|
description: The $gte's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $gte's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $gte's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $gte's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $gte's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $gte's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $gte's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $gte's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $gte's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $gte's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $gte's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $gte's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $gte's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $gte's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $gte's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $gte's @matchall@1137.
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The updated at's $lt.
|
|
- type: object
|
|
description: The updated at's $lt.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $lt's exec.
|
|
test:
|
|
type: object
|
|
description: The $lt's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $lt's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $lt's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $lt's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $lt's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $lt's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $lt's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $lt's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $lt's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $lt's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $lt's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $lt's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $lt's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $lt's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $lt's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $lt's @matchall@1137.
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The updated at's $lte.
|
|
- type: object
|
|
description: The updated at's $lte.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $lte's exec.
|
|
test:
|
|
type: object
|
|
description: The $lte's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $lte's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $lte's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $lte's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $lte's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $lte's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $lte's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $lte's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $lte's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $lte's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $lte's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $lte's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $lte's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $lte's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $lte's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $lte's @matchall@1137.
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The updated at's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The updated at's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The updated at's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The updated at's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The updated at's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The updated at's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The updated at's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The updated at's $exists.
|
|
- name: deleted_at
|
|
in: query
|
|
description: The product's deleted at.
|
|
required: false
|
|
schema:
|
|
type: object
|
|
description: The product's deleted at.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The deleted at's $and.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $and's exec.
|
|
test:
|
|
type: object
|
|
description: The $and's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $and's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $and's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $and's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $and's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $and's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $and's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $and's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $and's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $and's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $and's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $and's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $and's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $and's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $and's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $and's @matchall@1137.
|
|
- type: object
|
|
description: The $and's details.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's details.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
$or:
|
|
type: array
|
|
description: The $and's $or.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's details.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $and's $eq.
|
|
- type: object
|
|
description: The $and's $eq.
|
|
x-schemaName: RegExp
|
|
- type: array
|
|
description: The $and's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The $and's $ne.
|
|
- type: object
|
|
description: The $and's $ne.
|
|
x-schemaName: RegExp
|
|
$in:
|
|
type: array
|
|
description: The $and's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
$nin:
|
|
type: array
|
|
description: The $and's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $and's $not.
|
|
- type: object
|
|
description: The $and's $not.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's $not.
|
|
- type: array
|
|
description: The $and's $not.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The $and's $gt.
|
|
- type: object
|
|
description: The $and's $gt.
|
|
x-schemaName: RegExp
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The $and's $gte.
|
|
- type: object
|
|
description: The $and's $gte.
|
|
x-schemaName: RegExp
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The $and's $lt.
|
|
- type: object
|
|
description: The $and's $lt.
|
|
x-schemaName: RegExp
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The $and's $lte.
|
|
- type: object
|
|
description: The $and's $lte.
|
|
x-schemaName: RegExp
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The $and's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The $and's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The $and's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The $and's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The $and's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The $and's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The $and's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The $and's $exists.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $and's exec.
|
|
test:
|
|
type: object
|
|
description: The $and's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $and's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $and's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $and's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $and's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $and's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $and's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $and's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $and's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $and's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $and's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $and's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $and's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $and's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $and's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $and's @matchall@1137.
|
|
$or:
|
|
type: array
|
|
description: The deleted at's $or.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $or's exec.
|
|
test:
|
|
type: object
|
|
description: The $or's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $or's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $or's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $or's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $or's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $or's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $or's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $or's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $or's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $or's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $or's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $or's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $or's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $or's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $or's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $or's @matchall@1137.
|
|
- type: object
|
|
description: The $or's details.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The $or's $and.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's details.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
$or:
|
|
type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's details.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $or's $eq.
|
|
- type: object
|
|
description: The $or's $eq.
|
|
x-schemaName: RegExp
|
|
- type: array
|
|
description: The $or's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The $or's $ne.
|
|
- type: object
|
|
description: The $or's $ne.
|
|
x-schemaName: RegExp
|
|
$in:
|
|
type: array
|
|
description: The $or's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
$nin:
|
|
type: array
|
|
description: The $or's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $or's $not.
|
|
- type: object
|
|
description: The $or's $not.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's $not.
|
|
- type: array
|
|
description: The $or's $not.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The $or's $gt.
|
|
- type: object
|
|
description: The $or's $gt.
|
|
x-schemaName: RegExp
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The $or's $gte.
|
|
- type: object
|
|
description: The $or's $gte.
|
|
x-schemaName: RegExp
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The $or's $lt.
|
|
- type: object
|
|
description: The $or's $lt.
|
|
x-schemaName: RegExp
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The $or's $lte.
|
|
- type: object
|
|
description: The $or's $lte.
|
|
x-schemaName: RegExp
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The $or's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The $or's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The $or's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The $or's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The $or's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The $or's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The $or's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The $or's $exists.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $or's exec.
|
|
test:
|
|
type: object
|
|
description: The $or's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $or's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $or's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $or's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $or's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $or's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $or's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $or's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $or's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $or's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $or's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $or's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $or's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $or's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $or's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $or's @matchall@1137.
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The deleted at's $eq.
|
|
- type: object
|
|
description: The deleted at's $eq.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $eq's exec.
|
|
test:
|
|
type: object
|
|
description: The $eq's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $eq's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $eq's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $eq's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $eq's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $eq's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $eq's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $eq's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $eq's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $eq's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $eq's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $eq's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $eq's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $eq's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $eq's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $eq's @matchall@1137.
|
|
- type: array
|
|
description: The deleted at's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $eq's exec.
|
|
test:
|
|
type: object
|
|
description: The $eq's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $eq's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $eq's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $eq's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $eq's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $eq's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $eq's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $eq's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $eq's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $eq's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $eq's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $eq's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $eq's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $eq's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $eq's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $eq's @matchall@1137.
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The deleted at's $ne.
|
|
- type: object
|
|
description: The deleted at's $ne.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $ne's exec.
|
|
test:
|
|
type: object
|
|
description: The $ne's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $ne's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $ne's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $ne's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $ne's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $ne's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $ne's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $ne's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $ne's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $ne's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $ne's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $ne's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $ne's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $ne's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $ne's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $ne's @matchall@1137.
|
|
$in:
|
|
type: array
|
|
description: The deleted at's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $in's exec.
|
|
test:
|
|
type: object
|
|
description: The $in's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $in's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $in's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $in's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $in's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $in's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $in's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $in's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $in's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $in's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $in's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $in's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $in's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $in's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $in's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $in's @matchall@1137.
|
|
$nin:
|
|
type: array
|
|
description: The deleted at's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $nin's exec.
|
|
test:
|
|
type: object
|
|
description: The $nin's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $nin's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $nin's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $nin's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $nin's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $nin's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $nin's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $nin's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $nin's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $nin's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $nin's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $nin's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $nin's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $nin's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $nin's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $nin's @matchall@1137.
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The deleted at's $not.
|
|
- type: object
|
|
description: The deleted at's $not.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $not's exec.
|
|
test:
|
|
type: object
|
|
description: The $not's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $not's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $not's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $not's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $not's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $not's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $not's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $not's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $not's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $not's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $not's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $not's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $not's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $not's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $not's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $not's @matchall@1137.
|
|
- type: object
|
|
description: The deleted at's $not.
|
|
properties:
|
|
$and:
|
|
type: array
|
|
description: The $not's $and.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $and's details.
|
|
- type: array
|
|
description: The $and's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $and
|
|
description: The $and's details.
|
|
- type: object
|
|
description: The $and's details.
|
|
x-schemaName: RegExp
|
|
$or:
|
|
type: array
|
|
description: The $not's $or.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $or's details.
|
|
- type: array
|
|
description: The $or's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $or
|
|
description: The $or's details.
|
|
- type: object
|
|
description: The $or's details.
|
|
x-schemaName: RegExp
|
|
$eq:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $not's $eq.
|
|
- type: object
|
|
description: The $not's $eq.
|
|
x-schemaName: RegExp
|
|
- type: array
|
|
description: The $not's $eq.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $eq
|
|
description: The $eq's details.
|
|
- type: object
|
|
description: The $eq's details.
|
|
x-schemaName: RegExp
|
|
$ne:
|
|
oneOf:
|
|
- type: string
|
|
title: $ne
|
|
description: The $not's $ne.
|
|
- type: object
|
|
description: The $not's $ne.
|
|
x-schemaName: RegExp
|
|
$in:
|
|
type: array
|
|
description: The $not's $in.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $in
|
|
description: The $in's details.
|
|
- type: object
|
|
description: The $in's details.
|
|
x-schemaName: RegExp
|
|
$nin:
|
|
type: array
|
|
description: The $not's $nin.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $nin
|
|
description: The $nin's details.
|
|
- type: object
|
|
description: The $nin's details.
|
|
x-schemaName: RegExp
|
|
$not:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
- type: object
|
|
description: The $not's details.
|
|
- type: array
|
|
description: The $not's details.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The $not's $gt.
|
|
- type: object
|
|
description: The $not's $gt.
|
|
x-schemaName: RegExp
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The $not's $gte.
|
|
- type: object
|
|
description: The $not's $gte.
|
|
x-schemaName: RegExp
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The $not's $lt.
|
|
- type: object
|
|
description: The $not's $lt.
|
|
x-schemaName: RegExp
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The $not's $lte.
|
|
- type: object
|
|
description: The $not's $lte.
|
|
x-schemaName: RegExp
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The $not's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The $not's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The $not's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The $not's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The $not's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The $not's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The $not's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The $not's $exists.
|
|
- type: array
|
|
description: The deleted at's $not.
|
|
items:
|
|
oneOf:
|
|
- type: string
|
|
title: $not
|
|
description: The $not's details.
|
|
- type: object
|
|
description: The $not's details.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $not's exec.
|
|
test:
|
|
type: object
|
|
description: The $not's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $not's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $not's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $not's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $not's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $not's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $not's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $not's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $not's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $not's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $not's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $not's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $not's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $not's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $not's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $not's @matchall@1137.
|
|
$gt:
|
|
oneOf:
|
|
- type: string
|
|
title: $gt
|
|
description: The deleted at's $gt.
|
|
- type: object
|
|
description: The deleted at's $gt.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $gt's exec.
|
|
test:
|
|
type: object
|
|
description: The $gt's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $gt's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $gt's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $gt's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $gt's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $gt's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $gt's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $gt's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $gt's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $gt's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $gt's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $gt's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $gt's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $gt's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $gt's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $gt's @matchall@1137.
|
|
$gte:
|
|
oneOf:
|
|
- type: string
|
|
title: $gte
|
|
description: The deleted at's $gte.
|
|
- type: object
|
|
description: The deleted at's $gte.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $gte's exec.
|
|
test:
|
|
type: object
|
|
description: The $gte's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $gte's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $gte's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $gte's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $gte's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $gte's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $gte's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $gte's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $gte's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $gte's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $gte's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $gte's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $gte's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $gte's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $gte's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $gte's @matchall@1137.
|
|
$lt:
|
|
oneOf:
|
|
- type: string
|
|
title: $lt
|
|
description: The deleted at's $lt.
|
|
- type: object
|
|
description: The deleted at's $lt.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $lt's exec.
|
|
test:
|
|
type: object
|
|
description: The $lt's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $lt's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $lt's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $lt's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $lt's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $lt's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $lt's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $lt's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $lt's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $lt's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $lt's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $lt's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $lt's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $lt's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $lt's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $lt's @matchall@1137.
|
|
$lte:
|
|
oneOf:
|
|
- type: string
|
|
title: $lte
|
|
description: The deleted at's $lte.
|
|
- type: object
|
|
description: The deleted at's $lte.
|
|
x-schemaName: RegExp
|
|
required:
|
|
- exec
|
|
- test
|
|
- source
|
|
- global
|
|
- ignoreCase
|
|
- multiline
|
|
- lastIndex
|
|
- flags
|
|
- sticky
|
|
- unicode
|
|
- dotAll
|
|
- __@match@1128
|
|
- __@replace@1130
|
|
- __@search@1133
|
|
- __@matchAll@1137
|
|
properties:
|
|
exec:
|
|
type: object
|
|
description: The $lte's exec.
|
|
test:
|
|
type: object
|
|
description: The $lte's test.
|
|
source:
|
|
type: string
|
|
title: source
|
|
description: The $lte's source.
|
|
global:
|
|
type: boolean
|
|
title: global
|
|
description: The $lte's global.
|
|
ignoreCase:
|
|
type: boolean
|
|
title: ignoreCase
|
|
description: The $lte's ignorecase.
|
|
multiline:
|
|
type: boolean
|
|
title: multiline
|
|
description: The $lte's multiline.
|
|
lastIndex:
|
|
type: number
|
|
title: lastIndex
|
|
description: The $lte's lastindex.
|
|
compile:
|
|
type: object
|
|
description: The $lte's compile.
|
|
flags:
|
|
type: string
|
|
title: flags
|
|
description: The $lte's flags.
|
|
sticky:
|
|
type: boolean
|
|
title: sticky
|
|
description: The $lte's sticky.
|
|
unicode:
|
|
type: boolean
|
|
title: unicode
|
|
description: The $lte's unicode.
|
|
dotAll:
|
|
type: boolean
|
|
title: dotAll
|
|
description: The $lte's dotall.
|
|
__@match@1128:
|
|
type: object
|
|
description: The $lte's @match@1128.
|
|
__@replace@1130:
|
|
type: object
|
|
description: The $lte's @replace@1130.
|
|
__@search@1133:
|
|
type: object
|
|
description: The $lte's @search@1133.
|
|
__@split@1135:
|
|
type: object
|
|
description: The $lte's @split@1135.
|
|
__@matchAll@1137:
|
|
type: object
|
|
description: The $lte's @matchall@1137.
|
|
$like:
|
|
type: string
|
|
title: $like
|
|
description: The deleted at's $like.
|
|
$re:
|
|
type: string
|
|
title: $re
|
|
description: The deleted at's $re.
|
|
$ilike:
|
|
type: string
|
|
title: $ilike
|
|
description: The deleted at's $ilike.
|
|
$fulltext:
|
|
type: string
|
|
title: $fulltext
|
|
description: The deleted at's $fulltext.
|
|
$overlap:
|
|
type: array
|
|
description: The deleted at's $overlap.
|
|
items:
|
|
type: string
|
|
title: $overlap
|
|
description: The $overlap's details.
|
|
$contains:
|
|
type: array
|
|
description: The deleted at's $contains.
|
|
items:
|
|
type: string
|
|
title: $contains
|
|
description: The $contain's $contains.
|
|
$contained:
|
|
type: array
|
|
description: The deleted at's $contained.
|
|
items:
|
|
type: string
|
|
title: $contained
|
|
description: The $contained's details.
|
|
$exists:
|
|
type: boolean
|
|
title: $exists
|
|
description: The deleted at's $exists.
|
|
- name: $and
|
|
in: query
|
|
description: The product's $and.
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The product's $and.
|
|
items:
|
|
type: array
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
description: The product's $or.
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The product's $or.
|
|
items:
|
|
type: array
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/products' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The product's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The product's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The product's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- products
|
|
properties:
|
|
products:
|
|
type: array
|
|
description: The product's products.
|
|
items:
|
|
type: object
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostProducts
|
|
summary: Create Product
|
|
description: Create a product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- $ref: '#/components/schemas/AdminCreateProduct'
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/products' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"title": "{value}"
|
|
}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createProductsWorkflow
|
|
/admin/products/batch:
|
|
post:
|
|
operationId: PostProductsBatch
|
|
summary: Create Product
|
|
description: Create a product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminBatchProductRequest'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/products/batch' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminBatchProductResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: batchProductsWorkflow
|
|
/admin/products/export:
|
|
post:
|
|
operationId: PostProductsExport
|
|
summary: Create Product
|
|
description: Create a product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminExportProductRequest'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/products/export' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'202':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminExportProductResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: exportProductsWorkflow
|
|
/admin/products/import:
|
|
post:
|
|
operationId: PostProductsImport
|
|
summary: Create Product
|
|
description: Create a product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminImportProductRequest'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/products/import' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'202':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminImportProductResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: importProductsWorkflow
|
|
/admin/products/import/{transaction_id}/confirm:
|
|
post:
|
|
operationId: PostProductsImportTransaction_idConfirm
|
|
summary: Add Confirms to Product
|
|
description: Add a list of confirms to a product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: transaction_id
|
|
in: path
|
|
description: The product's transaction id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/products/import/{transaction_id}/confirm' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema: {}
|
|
/admin/products/{id}:
|
|
get:
|
|
operationId: GetProductsId
|
|
summary: Get a Product
|
|
description: Retrieve a product by its ID. You can expand the product's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/products/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostProductsId
|
|
summary: Update a Product
|
|
description: Update a product's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- $ref: '#/components/schemas/AdminUpdateProduct'
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/products/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateProductsWorkflow
|
|
delete:
|
|
operationId: DeleteProductsId
|
|
summary: Delete a Product
|
|
description: Delete a product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/products/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/products/{id}/options:
|
|
get:
|
|
operationId: GetProductsIdOptions
|
|
summary: List Options
|
|
description: Retrieve a list of options in a product. The options can be filtered by fields like FILTER FIELDS. The options can also be paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: q
|
|
in: query
|
|
description: The product's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The product's q.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The product's ID.
|
|
- type: array
|
|
description: The product's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: title
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: title
|
|
description: The product's title.
|
|
- type: array
|
|
description: The product's title.
|
|
items:
|
|
type: string
|
|
title: title
|
|
description: The title's details.
|
|
- name: product_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: product_id
|
|
description: The product's product id.
|
|
- type: array
|
|
description: The product's product id.
|
|
items:
|
|
type: string
|
|
title: product_id
|
|
description: The product id's details.
|
|
- name: $and
|
|
in: query
|
|
description: The product's $and.
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The product's $and.
|
|
items:
|
|
type: array
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
description: The product's $or.
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The product's $or.
|
|
items:
|
|
type: array
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/products/{id}/options' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The product's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The product's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The product's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- product_options
|
|
properties:
|
|
product_options:
|
|
type: array
|
|
description: The product's product options.
|
|
items:
|
|
$ref: '#/components/schemas/AdminProductOption'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostProductsIdOptions
|
|
summary: Add Options to Product
|
|
description: Add a list of options to a product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- $ref: '#/components/schemas/AdminCreateProductOption'
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/products/{id}/options' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"title": "{value}",
|
|
"values": [
|
|
"{value}"
|
|
]
|
|
}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/products/{id}/options/{option_id}:
|
|
get:
|
|
operationId: GetProductsIdOptionsOption_id
|
|
summary: List Options
|
|
description: Retrieve a list of options in a product. The options can be filtered by fields like FILTER FIELDS. The options can also be paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: option_id
|
|
in: path
|
|
description: The product's option id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/products/{id}/options/{option_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductOptionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostProductsIdOptionsOption_id
|
|
summary: Add Options to Product
|
|
description: Add a list of options to a product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: option_id
|
|
in: path
|
|
description: The product's option id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- $ref: '#/components/schemas/AdminUpdateProductOption'
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/products/{id}/options/{option_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteProductsIdOptionsOption_id
|
|
summary: Remove Options from Product
|
|
description: Remove a list of options from a product. This doesn't delete the Option, only the association between the Option and the product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: option_id
|
|
in: path
|
|
description: The product's option id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/products/{id}/options/{option_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductOptionDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/products/{id}/variants:
|
|
get:
|
|
operationId: GetProductsIdVariants
|
|
summary: List Variants
|
|
description: Retrieve a list of variants in a product. The variants can be filtered by fields like FILTER FIELDS. The variants can also be paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/products/{id}/variants' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The product's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The product's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The product's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- variants
|
|
properties:
|
|
variants:
|
|
type: array
|
|
description: The product's variants.
|
|
items:
|
|
$ref: '#/components/schemas/AdminProductVariant'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostProductsIdVariants
|
|
summary: Add Variants to Product
|
|
description: Add a list of variants to a product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- $ref: '#/components/schemas/AdminCreateProductVariant'
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/products/{id}/variants' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"title": "{value}",
|
|
"prices": []
|
|
}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/products/{id}/variants/batch:
|
|
post:
|
|
operationId: PostProductsIdVariantsBatch
|
|
summary: Add Variants to Product
|
|
description: Add a list of variants to a product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminBatchProductVariantRequest'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/products/{id}/variants/batch' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminBatchProductVariantResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: batchProductVariantsWorkflow
|
|
/admin/products/{id}/variants/inventory-items/batch:
|
|
post:
|
|
operationId: PostProductsIdVariantsInventoryItemsBatch
|
|
summary: Add Inventory Items to Product
|
|
description: Add a list of inventory items to a product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
create:
|
|
type: array
|
|
description: The product's create.
|
|
items:
|
|
type: object
|
|
description: The create's details.
|
|
required:
|
|
- required_quantity
|
|
- inventory_item_id
|
|
- variant_id
|
|
properties:
|
|
required_quantity:
|
|
type: number
|
|
title: required_quantity
|
|
description: The create's required quantity.
|
|
inventory_item_id:
|
|
type: string
|
|
title: inventory_item_id
|
|
description: The create's inventory item id.
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The create's variant id.
|
|
update:
|
|
type: array
|
|
description: The product's update.
|
|
items:
|
|
type: object
|
|
description: The update's details.
|
|
required:
|
|
- required_quantity
|
|
- inventory_item_id
|
|
- variant_id
|
|
properties:
|
|
required_quantity:
|
|
type: number
|
|
title: required_quantity
|
|
description: The update's required quantity.
|
|
inventory_item_id:
|
|
type: string
|
|
title: inventory_item_id
|
|
description: The update's inventory item id.
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The update's variant id.
|
|
delete:
|
|
type: array
|
|
description: The product's delete.
|
|
items:
|
|
type: object
|
|
description: The delete's details.
|
|
required:
|
|
- inventory_item_id
|
|
- variant_id
|
|
properties:
|
|
inventory_item_id:
|
|
type: string
|
|
title: inventory_item_id
|
|
description: The delete's inventory item id.
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The delete's variant id.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/products/{id}/variants/inventory-items/batch' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductVariantInventoryBatchResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: batchLinksWorkflow
|
|
/admin/products/{id}/variants/{variant_id}:
|
|
get:
|
|
operationId: GetProductsIdVariantsVariant_id
|
|
summary: List Variants
|
|
description: Retrieve a list of variants in a product. The variants can be filtered by fields like FILTER FIELDS. The variants can also be paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: variant_id
|
|
in: path
|
|
description: The product's variant id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/products/{id}/variants/{variant_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductVariantResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostProductsIdVariantsVariant_id
|
|
summary: Add Variants to Product
|
|
description: Add a list of variants to a product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: variant_id
|
|
in: path
|
|
description: The product's variant id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- $ref: '#/components/schemas/AdminUpdateProductVariant'
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/products/{id}/variants/{variant_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteProductsIdVariantsVariant_id
|
|
summary: Remove Variants from Product
|
|
description: Remove a list of variants from a product. This doesn't delete the Variant, only the association between the Variant and the product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: variant_id
|
|
in: path
|
|
description: The product's variant id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/products/{id}/variants/{variant_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductVariantDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/products/{id}/variants/{variant_id}/inventory-items:
|
|
post:
|
|
operationId: PostProductsIdVariantsVariant_idInventoryItems
|
|
summary: Add Inventory Items to Product
|
|
description: Add a list of inventory items to a product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: variant_id
|
|
in: path
|
|
description: The product's variant id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCreateVariantInventoryItem'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/products/{id}/variants/{variant_id}/inventory-items' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"required_quantity": 7390879820021760,
|
|
"inventory_item_id": "{value}"
|
|
}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductVariantResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/products/{id}/variants/{variant_id}/inventory-items/{inventory_item_id}:
|
|
post:
|
|
operationId: PostProductsIdVariantsVariant_idInventoryItemsInventory_item_id
|
|
summary: Add Inventory Items to Product
|
|
description: Add a list of inventory items to a product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: variant_id
|
|
in: path
|
|
description: The product's variant id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: inventory_item_id
|
|
in: path
|
|
description: The product's inventory item id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminUpdateVariantInventoryItem'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/products/{id}/variants/{variant_id}/inventory-items/{inventory_item_id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"required_quantity": 5324804697620480
|
|
}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductVariantResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteProductsIdVariantsVariant_idInventoryItemsInventory_item_id
|
|
summary: Remove Inventory Items from Product
|
|
description: Remove a list of inventory items from a product. This doesn't delete the Inventory Item, only the association between the Inventory Item and the product.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The product's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: variant_id
|
|
in: path
|
|
description: The product's variant id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: inventory_item_id
|
|
in: path
|
|
description: The product's inventory item id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/products/{id}/variants/{variant_id}/inventory-items/{inventory_item_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Products
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminProductVariantInventoryLinkDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: dismissLinksWorkflow
|
|
/admin/promotions:
|
|
get:
|
|
operationId: GetPromotions
|
|
summary: List Promotions
|
|
description: Retrieve a list of promotions. The promotions can be filtered by fields such as `id`. The promotions can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: q
|
|
in: query
|
|
description: The promotion's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The promotion's q.
|
|
- name: code
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: code
|
|
description: The promotion's code.
|
|
- type: array
|
|
description: The promotion's code.
|
|
items:
|
|
type: string
|
|
title: code
|
|
description: The code's details.
|
|
- name: campaign_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: campaign_id
|
|
description: The promotion's campaign id.
|
|
- type: array
|
|
description: The promotion's campaign id.
|
|
items:
|
|
type: string
|
|
title: campaign_id
|
|
description: The campaign id's details.
|
|
- name: application_method
|
|
in: query
|
|
description: The promotion's application method.
|
|
required: false
|
|
schema:
|
|
type: object
|
|
description: The promotion's application method.
|
|
properties:
|
|
currency_code:
|
|
oneOf:
|
|
- type: string
|
|
title: currency_code
|
|
description: The application method's currency code.
|
|
- type: array
|
|
description: The application method's currency code.
|
|
items:
|
|
type: string
|
|
title: currency_code
|
|
description: The currency code's details.
|
|
- name: created_at
|
|
in: query
|
|
description: The promotion's created at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The promotion's created at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: created_at
|
|
- name: updated_at
|
|
in: query
|
|
description: The promotion's updated at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The promotion's updated at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: updated_at
|
|
- name: deleted_at
|
|
in: query
|
|
description: The promotion's deleted at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The promotion's deleted at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: deleted_at
|
|
- name: $and
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The promotion's $and.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The promotion's $or.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/promotions' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Promotions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The promotion's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The promotion's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The promotion's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- promotions
|
|
properties:
|
|
promotions:
|
|
type: array
|
|
description: The promotion's promotions.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPromotion'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostPromotions
|
|
summary: Create Promotion
|
|
description: Create a promotion.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- code
|
|
- type
|
|
- campaign_id
|
|
- application_method
|
|
properties:
|
|
code:
|
|
type: string
|
|
title: code
|
|
description: The promotion's code.
|
|
is_automatic:
|
|
type: boolean
|
|
title: is_automatic
|
|
description: The promotion's is automatic.
|
|
type:
|
|
type: string
|
|
enum:
|
|
- standard
|
|
- buyget
|
|
campaign_id:
|
|
type: string
|
|
title: campaign_id
|
|
description: The promotion's campaign id.
|
|
campaign:
|
|
type: object
|
|
description: The promotion's campaign.
|
|
required:
|
|
- name
|
|
- campaign_identifier
|
|
- description
|
|
- budget
|
|
- starts_at
|
|
- ends_at
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The campaign's name.
|
|
campaign_identifier:
|
|
type: string
|
|
title: campaign_identifier
|
|
description: The campaign's campaign identifier.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The campaign's description.
|
|
budget:
|
|
type: object
|
|
description: The campaign's budget.
|
|
required:
|
|
- type
|
|
- limit
|
|
- currency_code
|
|
properties:
|
|
type:
|
|
type: string
|
|
enum:
|
|
- spend
|
|
- usage
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The budget's limit.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The budget's currency code.
|
|
starts_at:
|
|
type: string
|
|
title: starts_at
|
|
description: The campaign's starts at.
|
|
format: date-time
|
|
ends_at:
|
|
type: string
|
|
title: ends_at
|
|
description: The campaign's ends at.
|
|
format: date-time
|
|
promotions:
|
|
type: array
|
|
description: The campaign's promotions.
|
|
items:
|
|
type: object
|
|
description: The promotion's promotions.
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The promotion's ID.
|
|
application_method:
|
|
type: object
|
|
description: The promotion's application method.
|
|
required:
|
|
- description
|
|
- value
|
|
- currency_code
|
|
- max_quantity
|
|
- type
|
|
- target_type
|
|
- apply_to_quantity
|
|
- buy_rules_min_quantity
|
|
properties:
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The application method's description.
|
|
value:
|
|
type: number
|
|
title: value
|
|
description: The application method's value.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The application method's currency code.
|
|
max_quantity:
|
|
type: number
|
|
title: max_quantity
|
|
description: The application method's max quantity.
|
|
type:
|
|
type: string
|
|
enum:
|
|
- fixed
|
|
- percentage
|
|
target_type:
|
|
type: string
|
|
enum:
|
|
- order
|
|
- shipping_methods
|
|
- items
|
|
allocation:
|
|
type: string
|
|
enum:
|
|
- each
|
|
- across
|
|
target_rules:
|
|
type: array
|
|
description: The application method's target rules.
|
|
items:
|
|
type: object
|
|
description: The target rule's target rules.
|
|
required:
|
|
- operator
|
|
- description
|
|
- attribute
|
|
- values
|
|
properties:
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- gte
|
|
- lte
|
|
- gt
|
|
- lt
|
|
- eq
|
|
- ne
|
|
- in
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The target rule's description.
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The target rule's attribute.
|
|
values:
|
|
oneOf:
|
|
- type: string
|
|
title: values
|
|
description: The target rule's values.
|
|
- type: array
|
|
description: The target rule's values.
|
|
items:
|
|
type: string
|
|
title: values
|
|
description: The value's values.
|
|
buy_rules:
|
|
type: array
|
|
description: The application method's buy rules.
|
|
items:
|
|
type: object
|
|
description: The buy rule's buy rules.
|
|
required:
|
|
- operator
|
|
- description
|
|
- attribute
|
|
- values
|
|
properties:
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- gte
|
|
- lte
|
|
- gt
|
|
- lt
|
|
- eq
|
|
- ne
|
|
- in
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The buy rule's description.
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The buy rule's attribute.
|
|
values:
|
|
oneOf:
|
|
- type: string
|
|
title: values
|
|
description: The buy rule's values.
|
|
- type: array
|
|
description: The buy rule's values.
|
|
items:
|
|
type: string
|
|
title: values
|
|
description: The value's values.
|
|
apply_to_quantity:
|
|
type: number
|
|
title: apply_to_quantity
|
|
description: The application method's apply to quantity.
|
|
buy_rules_min_quantity:
|
|
type: number
|
|
title: buy_rules_min_quantity
|
|
description: The application method's buy rules min quantity.
|
|
rules:
|
|
type: array
|
|
description: The promotion's rules.
|
|
items:
|
|
type: object
|
|
description: The rule's rules.
|
|
required:
|
|
- operator
|
|
- description
|
|
- attribute
|
|
- values
|
|
properties:
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- gte
|
|
- lte
|
|
- gt
|
|
- lt
|
|
- eq
|
|
- ne
|
|
- in
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The rule's description.
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The rule's attribute.
|
|
values:
|
|
oneOf:
|
|
- type: string
|
|
title: values
|
|
description: The rule's values.
|
|
- type: array
|
|
description: The rule's values.
|
|
items:
|
|
type: string
|
|
title: values
|
|
description: The value's values.
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/promotions' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"code": "{value}",
|
|
"type": "{value}",
|
|
"campaign_id": "{value}",
|
|
"application_method": {
|
|
"description": "{value}",
|
|
"value": 1841223411171328,
|
|
"currency_code": "{value}",
|
|
"max_quantity": 2960098049654784,
|
|
"type": "{value}",
|
|
"target_type": "{value}",
|
|
"allocation": "{value}",
|
|
"target_rules": [],
|
|
"buy_rules": [],
|
|
"apply_to_quantity": 708643867590656,
|
|
"buy_rules_min_quantity": 3167972149428224
|
|
}
|
|
}'
|
|
tags:
|
|
- Promotions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPromotionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/promotions/rule-attribute-options/{rule_type}:
|
|
get:
|
|
operationId: GetPromotionsRuleAttributeOptionsRule_type
|
|
summary: List Rule Attribute Options
|
|
description: Retrieve a list of rule attribute options in a promotion. The rule attribute options can be filtered by fields like FILTER FIELDS. The rule attribute options can also be paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: rule_type
|
|
in: path
|
|
description: The promotion's rule type.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: promotion_type
|
|
in: query
|
|
description: The promotion's promotion type.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: promotion_type
|
|
description: The promotion's promotion type.
|
|
- name: application_method_type
|
|
in: query
|
|
description: The promotion's application method type.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: application_method_type
|
|
description: The promotion's application method type.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/promotions/rule-attribute-options/{rule_type}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Promotions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- attributes
|
|
properties:
|
|
attributes:
|
|
type: array
|
|
description: The promotion's attributes.
|
|
items:
|
|
$ref: '#/components/schemas/AdminRuleAttributeOption'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/promotions/rule-value-options/{rule_type}/{rule_attribute_id}:
|
|
get:
|
|
operationId: GetPromotionsRuleValueOptionsRule_typeRule_attribute_id
|
|
summary: 'List '
|
|
description: Retrieve a list of in a promotion. The can be filtered by fields like FILTER FIELDS. The can also be paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: rule_type
|
|
in: path
|
|
description: The promotion's rule type.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: rule_attribute_id
|
|
in: path
|
|
description: The promotion's rule attribute id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: promotion_type
|
|
in: query
|
|
description: The promotion's promotion type.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: promotion_type
|
|
description: The promotion's promotion type.
|
|
- name: application_method_type
|
|
in: query
|
|
description: The promotion's application method type.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: application_method_type
|
|
description: The promotion's application method type.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/promotions/rule-value-options/{rule_type}/{rule_attribute_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Promotions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- values
|
|
properties:
|
|
values:
|
|
type: array
|
|
description: The promotion's values.
|
|
items:
|
|
$ref: '#/components/schemas/AdminRuleValueOption'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/promotions/{id}:
|
|
get:
|
|
operationId: GetPromotionsId
|
|
summary: Get a Promotion
|
|
description: Retrieve a promotion by its ID. You can expand the promotion's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The promotion's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/promotions/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Promotions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPromotionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostPromotionsId
|
|
summary: Update a Promotion
|
|
description: Update a promotion's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The promotion's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- campaign_id
|
|
properties:
|
|
code:
|
|
type: string
|
|
title: code
|
|
description: The promotion's code.
|
|
is_automatic:
|
|
type: boolean
|
|
title: is_automatic
|
|
description: The promotion's is automatic.
|
|
type:
|
|
type: string
|
|
enum:
|
|
- standard
|
|
- buyget
|
|
campaign_id:
|
|
type: string
|
|
title: campaign_id
|
|
description: The promotion's campaign id.
|
|
campaign:
|
|
type: object
|
|
description: The promotion's campaign.
|
|
required:
|
|
- name
|
|
- campaign_identifier
|
|
- description
|
|
- budget
|
|
- starts_at
|
|
- ends_at
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The campaign's name.
|
|
campaign_identifier:
|
|
type: string
|
|
title: campaign_identifier
|
|
description: The campaign's campaign identifier.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The campaign's description.
|
|
budget:
|
|
type: object
|
|
description: The campaign's budget.
|
|
required:
|
|
- type
|
|
- limit
|
|
- currency_code
|
|
properties:
|
|
type:
|
|
type: string
|
|
enum:
|
|
- spend
|
|
- usage
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The budget's limit.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The budget's currency code.
|
|
starts_at:
|
|
type: string
|
|
title: starts_at
|
|
description: The campaign's starts at.
|
|
format: date-time
|
|
ends_at:
|
|
type: string
|
|
title: ends_at
|
|
description: The campaign's ends at.
|
|
format: date-time
|
|
promotions:
|
|
type: array
|
|
description: The campaign's promotions.
|
|
items:
|
|
type: object
|
|
description: The promotion's promotions.
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The promotion's ID.
|
|
application_method:
|
|
type: object
|
|
description: The promotion's application method.
|
|
required:
|
|
- description
|
|
- max_quantity
|
|
- currency_code
|
|
- apply_to_quantity
|
|
- buy_rules_min_quantity
|
|
properties:
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The application method's description.
|
|
value:
|
|
type: number
|
|
title: value
|
|
description: The application method's value.
|
|
max_quantity:
|
|
type: number
|
|
title: max_quantity
|
|
description: The application method's max quantity.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The application method's currency code.
|
|
type:
|
|
type: string
|
|
enum:
|
|
- fixed
|
|
- percentage
|
|
target_type:
|
|
type: string
|
|
enum:
|
|
- order
|
|
- shipping_methods
|
|
- items
|
|
allocation:
|
|
type: string
|
|
enum:
|
|
- each
|
|
- across
|
|
target_rules:
|
|
type: array
|
|
description: The application method's target rules.
|
|
items:
|
|
type: object
|
|
description: The target rule's target rules.
|
|
required:
|
|
- operator
|
|
- description
|
|
- attribute
|
|
- values
|
|
properties:
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- gte
|
|
- lte
|
|
- gt
|
|
- lt
|
|
- eq
|
|
- ne
|
|
- in
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The target rule's description.
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The target rule's attribute.
|
|
values:
|
|
oneOf:
|
|
- type: string
|
|
title: values
|
|
description: The target rule's values.
|
|
- type: array
|
|
description: The target rule's values.
|
|
items:
|
|
type: string
|
|
title: values
|
|
description: The value's values.
|
|
buy_rules:
|
|
type: array
|
|
description: The application method's buy rules.
|
|
items:
|
|
type: object
|
|
description: The buy rule's buy rules.
|
|
required:
|
|
- operator
|
|
- description
|
|
- attribute
|
|
- values
|
|
properties:
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- gte
|
|
- lte
|
|
- gt
|
|
- lt
|
|
- eq
|
|
- ne
|
|
- in
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The buy rule's description.
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The buy rule's attribute.
|
|
values:
|
|
oneOf:
|
|
- type: string
|
|
title: values
|
|
description: The buy rule's values.
|
|
- type: array
|
|
description: The buy rule's values.
|
|
items:
|
|
type: string
|
|
title: values
|
|
description: The value's values.
|
|
apply_to_quantity:
|
|
type: number
|
|
title: apply_to_quantity
|
|
description: The application method's apply to quantity.
|
|
buy_rules_min_quantity:
|
|
type: number
|
|
title: buy_rules_min_quantity
|
|
description: The application method's buy rules min quantity.
|
|
rules:
|
|
type: array
|
|
description: The promotion's rules.
|
|
items:
|
|
type: object
|
|
description: The rule's rules.
|
|
required:
|
|
- operator
|
|
- description
|
|
- attribute
|
|
- values
|
|
properties:
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- gte
|
|
- lte
|
|
- gt
|
|
- lt
|
|
- eq
|
|
- ne
|
|
- in
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The rule's description.
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The rule's attribute.
|
|
values:
|
|
oneOf:
|
|
- type: string
|
|
title: values
|
|
description: The rule's values.
|
|
- type: array
|
|
description: The rule's values.
|
|
items:
|
|
type: string
|
|
title: values
|
|
description: The value's values.
|
|
- type: object
|
|
description: SUMMARY
|
|
properties:
|
|
additional_data:
|
|
type: object
|
|
description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter.
|
|
description: SUMMARY
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/promotions/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"campaign_id": "{value}"
|
|
}'
|
|
tags:
|
|
- Promotions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPromotionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeletePromotionsId
|
|
summary: Delete a Promotion
|
|
description: Delete a promotion.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The promotion's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/promotions/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Promotions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The promotion's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The promotion's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The promotion's deleted.
|
|
parent:
|
|
type: object
|
|
description: The promotion's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/promotions/{id}/buy-rules/batch:
|
|
post:
|
|
operationId: PostPromotionsIdBuyRulesBatch
|
|
summary: Add Buy Rules to Promotion
|
|
description: Add a list of buy rules to a promotion.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The promotion's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
create:
|
|
type: array
|
|
description: The promotion's create.
|
|
items:
|
|
type: object
|
|
description: The create's details.
|
|
required:
|
|
- operator
|
|
- description
|
|
- attribute
|
|
- values
|
|
properties:
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- gte
|
|
- lte
|
|
- gt
|
|
- lt
|
|
- eq
|
|
- ne
|
|
- in
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The create's description.
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The create's attribute.
|
|
values:
|
|
oneOf:
|
|
- type: string
|
|
title: values
|
|
description: The create's values.
|
|
- type: array
|
|
description: The create's values.
|
|
items:
|
|
type: string
|
|
title: values
|
|
description: The value's values.
|
|
update:
|
|
type: array
|
|
description: The promotion's update.
|
|
items:
|
|
type: object
|
|
description: The update's details.
|
|
required:
|
|
- id
|
|
- description
|
|
- values
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The update's ID.
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- gte
|
|
- lte
|
|
- gt
|
|
- lt
|
|
- eq
|
|
- ne
|
|
- in
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The update's description.
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The update's attribute.
|
|
values:
|
|
oneOf:
|
|
- type: string
|
|
title: values
|
|
description: The update's values.
|
|
- type: array
|
|
description: The update's values.
|
|
items:
|
|
type: string
|
|
title: values
|
|
description: The value's values.
|
|
delete:
|
|
type: array
|
|
description: The promotion's delete.
|
|
items:
|
|
type: string
|
|
title: delete
|
|
description: The delete's details.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/promotions/{id}/buy-rules/batch' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Promotions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- created
|
|
- updated
|
|
- deleted
|
|
properties:
|
|
created:
|
|
type: array
|
|
description: The promotion's created.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPromotionRule'
|
|
updated:
|
|
type: array
|
|
description: The promotion's updated.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPromotionRule'
|
|
deleted:
|
|
type: object
|
|
description: The promotion's deleted.
|
|
required:
|
|
- ids
|
|
- object
|
|
- deleted
|
|
properties:
|
|
ids:
|
|
type: array
|
|
description: The deleted's ids.
|
|
items:
|
|
type: string
|
|
title: ids
|
|
description: The id's ids.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The deleted's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The deleted's details.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: batchPromotionRulesWorkflow
|
|
/admin/promotions/{id}/rules/batch:
|
|
post:
|
|
operationId: PostPromotionsIdRulesBatch
|
|
summary: Add Rules to Promotion
|
|
description: Add a list of rules to a promotion.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The promotion's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
create:
|
|
type: array
|
|
description: The promotion's create.
|
|
items:
|
|
type: object
|
|
description: The create's details.
|
|
required:
|
|
- operator
|
|
- description
|
|
- attribute
|
|
- values
|
|
properties:
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- gte
|
|
- lte
|
|
- gt
|
|
- lt
|
|
- eq
|
|
- ne
|
|
- in
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The create's description.
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The create's attribute.
|
|
values:
|
|
oneOf:
|
|
- type: string
|
|
title: values
|
|
description: The create's values.
|
|
- type: array
|
|
description: The create's values.
|
|
items:
|
|
type: string
|
|
title: values
|
|
description: The value's values.
|
|
update:
|
|
type: array
|
|
description: The promotion's update.
|
|
items:
|
|
type: object
|
|
description: The update's details.
|
|
required:
|
|
- id
|
|
- description
|
|
- values
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The update's ID.
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- gte
|
|
- lte
|
|
- gt
|
|
- lt
|
|
- eq
|
|
- ne
|
|
- in
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The update's description.
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The update's attribute.
|
|
values:
|
|
oneOf:
|
|
- type: string
|
|
title: values
|
|
description: The update's values.
|
|
- type: array
|
|
description: The update's values.
|
|
items:
|
|
type: string
|
|
title: values
|
|
description: The value's values.
|
|
delete:
|
|
type: array
|
|
description: The promotion's delete.
|
|
items:
|
|
type: string
|
|
title: delete
|
|
description: The delete's details.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/promotions/{id}/rules/batch' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Promotions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- created
|
|
- updated
|
|
- deleted
|
|
properties:
|
|
created:
|
|
type: array
|
|
description: The promotion's created.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPromotionRule'
|
|
updated:
|
|
type: array
|
|
description: The promotion's updated.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPromotionRule'
|
|
deleted:
|
|
type: object
|
|
description: The promotion's deleted.
|
|
required:
|
|
- ids
|
|
- object
|
|
- deleted
|
|
properties:
|
|
ids:
|
|
type: array
|
|
description: The deleted's ids.
|
|
items:
|
|
type: string
|
|
title: ids
|
|
description: The id's ids.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The deleted's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The deleted's details.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: batchPromotionRulesWorkflow
|
|
/admin/promotions/{id}/target-rules/batch:
|
|
post:
|
|
operationId: PostPromotionsIdTargetRulesBatch
|
|
summary: Add Target Rules to Promotion
|
|
description: Add a list of target rules to a promotion.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The promotion's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
create:
|
|
type: array
|
|
description: The promotion's create.
|
|
items:
|
|
type: object
|
|
description: The create's details.
|
|
required:
|
|
- operator
|
|
- description
|
|
- attribute
|
|
- values
|
|
properties:
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- gte
|
|
- lte
|
|
- gt
|
|
- lt
|
|
- eq
|
|
- ne
|
|
- in
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The create's description.
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The create's attribute.
|
|
values:
|
|
oneOf:
|
|
- type: string
|
|
title: values
|
|
description: The create's values.
|
|
- type: array
|
|
description: The create's values.
|
|
items:
|
|
type: string
|
|
title: values
|
|
description: The value's values.
|
|
update:
|
|
type: array
|
|
description: The promotion's update.
|
|
items:
|
|
type: object
|
|
description: The update's details.
|
|
required:
|
|
- id
|
|
- description
|
|
- values
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The update's ID.
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- gte
|
|
- lte
|
|
- gt
|
|
- lt
|
|
- eq
|
|
- ne
|
|
- in
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The update's description.
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The update's attribute.
|
|
values:
|
|
oneOf:
|
|
- type: string
|
|
title: values
|
|
description: The update's values.
|
|
- type: array
|
|
description: The update's values.
|
|
items:
|
|
type: string
|
|
title: values
|
|
description: The value's values.
|
|
delete:
|
|
type: array
|
|
description: The promotion's delete.
|
|
items:
|
|
type: string
|
|
title: delete
|
|
description: The delete's details.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/promotions/{id}/target-rules/batch' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Promotions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- created
|
|
- updated
|
|
- deleted
|
|
properties:
|
|
created:
|
|
type: array
|
|
description: The promotion's created.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPromotionRule'
|
|
updated:
|
|
type: array
|
|
description: The promotion's updated.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPromotionRule'
|
|
deleted:
|
|
type: object
|
|
description: The promotion's deleted.
|
|
required:
|
|
- ids
|
|
- object
|
|
- deleted
|
|
properties:
|
|
ids:
|
|
type: array
|
|
description: The deleted's ids.
|
|
items:
|
|
type: string
|
|
title: ids
|
|
description: The id's ids.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The deleted's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The deleted's details.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: batchPromotionRulesWorkflow
|
|
/admin/promotions/{id}/{rule_type}:
|
|
get:
|
|
operationId: GetPromotionsIdRule_type
|
|
summary: 'List '
|
|
description: Retrieve a list of in a promotion. The can be filtered by fields like FILTER FIELDS. The can also be paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The promotion's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: rule_type
|
|
in: path
|
|
description: The promotion's rule type.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/promotions/{id}/{rule_type}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Promotions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- rules
|
|
properties:
|
|
rules:
|
|
type: array
|
|
description: The promotion's rules.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPromotionRule'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/refund-reasons:
|
|
get:
|
|
operationId: GetRefundReasons
|
|
summary: List Refund Reasons
|
|
description: Retrieve a list of refund reasons. The refund reasons can be filtered by fields such as `id`. The refund reasons can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/refund-reasons' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Refund Reasons
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The refund reason's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The refund reason's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The refund reason's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- refund_reasons
|
|
properties:
|
|
refund_reasons:
|
|
type: array
|
|
description: The refund reason's refund reasons.
|
|
items:
|
|
$ref: '#/components/schemas/AdminRefundReason'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostRefundReasons
|
|
summary: Create Refund Reason
|
|
description: Create a refund reason.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- label
|
|
- description
|
|
properties:
|
|
label:
|
|
type: string
|
|
title: label
|
|
description: The refund reason's label.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The refund reason's description.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/refund-reasons' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"label": "{value}",
|
|
"description": "{value}"
|
|
}'
|
|
tags:
|
|
- Refund Reasons
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RefundReasonResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createRefundReasonsWorkflow
|
|
/admin/refund-reasons/{id}:
|
|
get:
|
|
operationId: GetRefundReasonsId
|
|
summary: Get a Refund Reason
|
|
description: Retrieve a refund reason by its ID. You can expand the refund reason's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The refund reason's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/refund-reasons/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Refund Reasons
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RefundReasonResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostRefundReasonsId
|
|
summary: Update a Refund Reason
|
|
description: Update a refund reason's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The refund reason's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- description
|
|
properties:
|
|
label:
|
|
type: string
|
|
title: label
|
|
description: The refund reason's label.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The refund reason's description.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/refund-reasons/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"description": "{value}"
|
|
}'
|
|
tags:
|
|
- Refund Reasons
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/RefundReasonResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteRefundReasonsId
|
|
summary: Delete a Refund Reason
|
|
description: Delete a refund reason.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The refund reason's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/refund-reasons/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Refund Reasons
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The refund reason's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The refund reason's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The refund reason's deleted.
|
|
parent:
|
|
type: object
|
|
description: The refund reason's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/regions:
|
|
get:
|
|
operationId: GetRegions
|
|
summary: List Regions
|
|
description: Retrieve a list of regions. The regions can be filtered by fields such as `id`. The regions can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: q
|
|
in: query
|
|
description: The region's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The region's q.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The region's ID.
|
|
- type: array
|
|
description: The region's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: code
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: code
|
|
description: The region's code.
|
|
- type: array
|
|
description: The region's code.
|
|
items:
|
|
type: string
|
|
title: code
|
|
description: The code's details.
|
|
- name: name
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: name
|
|
description: The region's name.
|
|
- type: array
|
|
description: The region's name.
|
|
items:
|
|
type: string
|
|
title: name
|
|
description: The name's details.
|
|
- name: created_at
|
|
in: query
|
|
description: The region's created at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The region's created at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: created_at
|
|
- name: updated_at
|
|
in: query
|
|
description: The region's updated at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The region's updated at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: updated_at
|
|
- name: deleted_at
|
|
in: query
|
|
description: The region's deleted at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The region's deleted at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: deleted_at
|
|
- name: $and
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The region's $and.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The region's $or.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/regions' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Regions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The region's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The region's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The region's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- regions
|
|
properties:
|
|
regions:
|
|
type: array
|
|
description: The region's regions.
|
|
items:
|
|
$ref: '#/components/schemas/AdminRegion'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostRegions
|
|
summary: Create Region
|
|
description: Create a region.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- name
|
|
- currency_code
|
|
- metadata
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The region's name.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The region's currency code.
|
|
countries:
|
|
type: array
|
|
description: The region's countries.
|
|
items:
|
|
type: string
|
|
title: countries
|
|
description: The country's countries.
|
|
automatic_taxes:
|
|
type: boolean
|
|
title: automatic_taxes
|
|
description: The region's automatic taxes.
|
|
payment_providers:
|
|
type: array
|
|
description: The region's payment providers.
|
|
items:
|
|
type: string
|
|
title: payment_providers
|
|
description: The payment provider's payment providers.
|
|
metadata:
|
|
type: object
|
|
description: The region's metadata.
|
|
is_tax_inclusive:
|
|
type: boolean
|
|
title: is_tax_inclusive
|
|
description: The region's is tax inclusive.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/regions' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"name": "Heloise",
|
|
"currency_code": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Regions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminRegionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createRegionsWorkflow
|
|
/admin/regions/{id}:
|
|
get:
|
|
operationId: GetRegionsId
|
|
summary: Get a Region
|
|
description: Retrieve a region by its ID. You can expand the region's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The region's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/regions/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Regions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminRegionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostRegionsId
|
|
summary: Update a Region
|
|
description: Update a region's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The region's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- metadata
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The region's name.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The region's currency code.
|
|
countries:
|
|
type: array
|
|
description: The region's countries.
|
|
items:
|
|
type: string
|
|
title: countries
|
|
description: The country's countries.
|
|
automatic_taxes:
|
|
type: boolean
|
|
title: automatic_taxes
|
|
description: The region's automatic taxes.
|
|
payment_providers:
|
|
type: array
|
|
description: The region's payment providers.
|
|
items:
|
|
type: string
|
|
title: payment_providers
|
|
description: The payment provider's payment providers.
|
|
metadata:
|
|
type: object
|
|
description: The region's metadata.
|
|
is_tax_inclusive:
|
|
type: boolean
|
|
title: is_tax_inclusive
|
|
description: The region's is tax inclusive.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/regions/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Regions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminRegionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateRegionsWorkflow
|
|
delete:
|
|
operationId: DeleteRegionsId
|
|
summary: Delete a Region
|
|
description: Delete a region.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The region's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/regions/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Regions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The region's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The region's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The region's deleted.
|
|
parent:
|
|
type: object
|
|
description: The region's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/reservations:
|
|
get:
|
|
operationId: GetReservations
|
|
summary: List Reservations
|
|
description: Retrieve a list of reservations. The reservations can be filtered by fields such as `id`. The reservations can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: location_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: location_id
|
|
description: The reservation's location id.
|
|
- type: array
|
|
description: The reservation's location id.
|
|
items:
|
|
type: string
|
|
title: location_id
|
|
description: The location id's details.
|
|
- name: inventory_item_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: inventory_item_id
|
|
description: The reservation's inventory item id.
|
|
- type: array
|
|
description: The reservation's inventory item id.
|
|
items:
|
|
type: string
|
|
title: inventory_item_id
|
|
description: The inventory item id's details.
|
|
- name: line_item_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: line_item_id
|
|
description: The reservation's line item id.
|
|
- type: array
|
|
description: The reservation's line item id.
|
|
items:
|
|
type: string
|
|
title: line_item_id
|
|
description: The line item id's details.
|
|
- name: created_by
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: created_by
|
|
description: The reservation's created by.
|
|
- type: array
|
|
description: The reservation's created by.
|
|
items:
|
|
type: string
|
|
title: created_by
|
|
description: The created by's details.
|
|
- name: description
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: description
|
|
description: The reservation's description.
|
|
- type: object
|
|
description: The reservation's description.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
- name: quantity
|
|
in: query
|
|
description: The reservation's quantity.
|
|
required: false
|
|
schema:
|
|
description: The reservation's quantity.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
- name: created_at
|
|
in: query
|
|
description: The reservation's created at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The reservation's created at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: created_at
|
|
- name: updated_at
|
|
in: query
|
|
description: The reservation's updated at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The reservation's updated at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: updated_at
|
|
- name: deleted_at
|
|
in: query
|
|
description: The reservation's deleted at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The reservation's deleted at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: deleted_at
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/reservations' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Reservations
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The reservation's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The reservation's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The reservation's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- reservations
|
|
properties:
|
|
reservations:
|
|
type: array
|
|
description: The reservation's reservations.
|
|
items:
|
|
$ref: '#/components/schemas/ReservationResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostReservations
|
|
summary: Create Reservation
|
|
description: Create a reservation.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- line_item_id
|
|
- location_id
|
|
- inventory_item_id
|
|
- quantity
|
|
- description
|
|
- metadata
|
|
properties:
|
|
line_item_id:
|
|
type: string
|
|
title: line_item_id
|
|
description: The reservation's line item id.
|
|
location_id:
|
|
type: string
|
|
title: location_id
|
|
description: The reservation's location id.
|
|
inventory_item_id:
|
|
type: string
|
|
title: inventory_item_id
|
|
description: The reservation's inventory item id.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The reservation's quantity.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The reservation's description.
|
|
metadata:
|
|
type: object
|
|
description: The reservation's metadata.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/reservations' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"line_item_id": "{value}",
|
|
"location_id": "{value}",
|
|
"inventory_item_id": "{value}",
|
|
"quantity": 3268935814217728,
|
|
"description": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Reservations
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReservationResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createReservationsWorkflow
|
|
/admin/reservations/{id}:
|
|
get:
|
|
operationId: GetReservationsId
|
|
summary: Get a Reservation
|
|
description: Retrieve a reservation by its ID. You can expand the reservation's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The reservation's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/reservations/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Reservations
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReservationResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostReservationsId
|
|
summary: Update a Reservation
|
|
description: Update a reservation's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The reservation's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- description
|
|
- metadata
|
|
properties:
|
|
location_id:
|
|
type: string
|
|
title: location_id
|
|
description: The reservation's location id.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The reservation's quantity.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The reservation's description.
|
|
metadata:
|
|
type: object
|
|
description: The reservation's metadata.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/reservations/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"description": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Reservations
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReservationResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteReservationsId
|
|
summary: Delete a Reservation
|
|
description: Delete a reservation.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The reservation's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/reservations/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Reservations
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The reservation's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The reservation's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The reservation's deleted.
|
|
parent:
|
|
type: object
|
|
description: The reservation's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/return-reasons:
|
|
get:
|
|
operationId: GetReturnReasons
|
|
summary: List Return Reasons
|
|
description: Retrieve a list of return reasons. The return reasons can be filtered by fields such as `id`. The return reasons can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: q
|
|
in: query
|
|
description: The return reason's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The return reason's q.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The return reason's ID.
|
|
- type: array
|
|
description: The return reason's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: value
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The return reason's value.
|
|
- type: array
|
|
description: The return reason's value.
|
|
items:
|
|
type: string
|
|
title: value
|
|
description: The value's details.
|
|
- name: label
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: label
|
|
description: The return reason's label.
|
|
- type: array
|
|
description: The return reason's label.
|
|
items:
|
|
type: string
|
|
title: label
|
|
description: The label's details.
|
|
- name: description
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: description
|
|
description: The return reason's description.
|
|
- type: array
|
|
description: The return reason's description.
|
|
items:
|
|
type: string
|
|
title: description
|
|
description: The description's details.
|
|
- name: parent_return_reason_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: parent_return_reason_id
|
|
description: The return reason's parent return reason id.
|
|
- type: array
|
|
description: The return reason's parent return reason id.
|
|
items:
|
|
type: string
|
|
title: parent_return_reason_id
|
|
description: The parent return reason id's details.
|
|
- name: created_at
|
|
in: query
|
|
description: The return reason's created at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The return reason's created at.
|
|
- name: updated_at
|
|
in: query
|
|
description: The return reason's updated at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The return reason's updated at.
|
|
- name: deleted_at
|
|
in: query
|
|
description: The return reason's deleted at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The return reason's deleted at.
|
|
- name: $and
|
|
in: query
|
|
description: The return reason's $and.
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The return reason's $and.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
description: The return reason's $or.
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The return reason's $or.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/return-reasons' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Return Reasons
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnReasonListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostReturnReasons
|
|
summary: Create Return Reason
|
|
description: Create a return reason.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/CreateOrderReturnReason'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/return-reasons' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"value": "{value}",
|
|
"label": "{value}"
|
|
}'
|
|
tags:
|
|
- Return Reasons
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnReasonResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/return-reasons/{id}:
|
|
get:
|
|
operationId: GetReturnReasonsId
|
|
summary: Get a Return Reason
|
|
description: Retrieve a return reason by its ID. You can expand the return reason's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return reason's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/return-reasons/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Return Reasons
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnReasonResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostReturnReasonsId
|
|
summary: Update a Return Reason
|
|
description: Update a return reason's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return reason's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/UpdateOrderReturnReason'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/return-reasons/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Return Reasons
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnReasonResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteReturnReasonsId
|
|
summary: Delete a Return Reason
|
|
description: Delete a return reason.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return reason's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/return-reasons/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Return Reasons
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The return reason's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The return reason's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The return reason's deleted.
|
|
parent:
|
|
type: object
|
|
description: The return reason's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/returns:
|
|
get:
|
|
operationId: GetReturns
|
|
summary: List Returns
|
|
description: Retrieve a list of returns. The returns can be filtered by fields such as `id`. The returns can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/returns' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The return's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The return's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The return's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- returns
|
|
properties:
|
|
returns:
|
|
type: array
|
|
description: The return's returns.
|
|
items:
|
|
$ref: '#/components/schemas/AdminReturn'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostReturns
|
|
summary: Create Return
|
|
description: Create a return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostReturnsReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/returns' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"order_id": "{value}",
|
|
"items": [
|
|
{
|
|
"id": "id_7DO5H2LbSN3p7IzB",
|
|
"quantity": 1357590174892032,
|
|
"reason_id": "{value}",
|
|
"note": "{value}"
|
|
}
|
|
],
|
|
"return_shipping": {
|
|
"option_id": "{value}",
|
|
"price": 5112171463704576
|
|
},
|
|
"internal_note": "{value}",
|
|
"location_id": "{value}"
|
|
}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderReturnResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/returns/{id}:
|
|
get:
|
|
operationId: GetReturnsId
|
|
summary: Get a Return
|
|
description: Retrieve a return by its ID. You can expand the return's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/returns/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostReturnsId
|
|
summary: Update a Return
|
|
description: Update a return's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostReturnsReturnReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/returns/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateReturnWorkflow
|
|
/admin/returns/{id}/cancel:
|
|
post:
|
|
operationId: PostReturnsIdCancel
|
|
summary: Add Cancels to Return
|
|
description: Add a list of cancels to a return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/returns/{id}/cancel' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostCancelReturnReqSchema'
|
|
/admin/returns/{id}/dismiss-items:
|
|
post:
|
|
operationId: PostReturnsIdDismissItems
|
|
summary: Add Dismiss Items to Return
|
|
description: Add a list of dismiss items to a return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostReturnsReceiveItemsReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/returns/{id}/dismiss-items' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: dismissItemReturnRequestWorkflow
|
|
/admin/returns/{id}/dismiss-items/{action_id}:
|
|
post:
|
|
operationId: PostReturnsIdDismissItemsAction_id
|
|
summary: Add Dismiss Items to Return
|
|
description: Add a list of dismiss items to a return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The return's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostReturnsDismissItemsActionReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/returns/{id}/dismiss-items/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateReceiveItemReturnRequestWorkflow
|
|
delete:
|
|
operationId: DeleteReturnsIdDismissItemsAction_id
|
|
summary: Remove Dismiss Items from Return
|
|
description: Remove a list of dismiss items from a return. This doesn't delete the Dismiss Item, only the association between the Dismiss Item and the return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The return's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/returns/{id}/dismiss-items/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: removeItemReturnActionWorkflow
|
|
/admin/returns/{id}/receive:
|
|
post:
|
|
operationId: PostReturnsIdReceive
|
|
summary: Add Receives to Return
|
|
description: Add a list of receives to a return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostReceiveReturnsReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/returns/{id}/receive' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"return_id": "{value}",
|
|
"items": [
|
|
{
|
|
"id": "id_qfy3t6cU7m8O5cJ5zs",
|
|
"quantity": 6429460591017984,
|
|
"reason_id": "{value}",
|
|
"note": "{value}"
|
|
}
|
|
],
|
|
"internal_note": "{value}"
|
|
}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminOrderReturnResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteReturnsIdReceive
|
|
summary: Remove Receives from Return
|
|
description: Remove a list of receives from a return. This doesn't delete the Receive, only the association between the Receive and the return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/returns/{id}/receive' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The return's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The return's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The return's deleted.
|
|
parent:
|
|
type: object
|
|
description: The return's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/returns/{id}/receive-items:
|
|
post:
|
|
operationId: PostReturnsIdReceiveItems
|
|
summary: Add Receive Items to Return
|
|
description: Add a list of receive items to a return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostReturnsReceiveItemsReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/returns/{id}/receive-items' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: receiveItemReturnRequestWorkflow
|
|
/admin/returns/{id}/receive-items/{action_id}:
|
|
post:
|
|
operationId: PostReturnsIdReceiveItemsAction_id
|
|
summary: Add Receive Items to Return
|
|
description: Add a list of receive items to a return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The return's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostReturnsReceiveItemsActionReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/returns/{id}/receive-items/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateReceiveItemReturnRequestWorkflow
|
|
delete:
|
|
operationId: DeleteReturnsIdReceiveItemsAction_id
|
|
summary: Remove Receive Items from Return
|
|
description: Remove a list of receive items from a return. This doesn't delete the Receive Item, only the association between the Receive Item and the return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The return's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/returns/{id}/receive-items/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: removeItemReceiveReturnActionWorkflow
|
|
/admin/returns/{id}/receive/confirm:
|
|
post:
|
|
operationId: PostReturnsIdReceiveConfirm
|
|
summary: Add Confirms to Return
|
|
description: Add a list of confirms to a return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostReturnsConfirmRequestReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/returns/{id}/receive/confirm' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: confirmReturnReceiveWorkflow
|
|
/admin/returns/{id}/request:
|
|
post:
|
|
operationId: PostReturnsIdRequest
|
|
summary: Add Requests to Return
|
|
description: Add a list of requests to a return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostReturnsConfirmRequestReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/returns/{id}/request' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: confirmReturnRequestWorkflow
|
|
delete:
|
|
operationId: DeleteReturnsIdRequest
|
|
summary: Remove Requests from Return
|
|
description: Remove a list of requests from a return. This doesn't delete the Request, only the association between the Request and the return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/returns/{id}/request' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The return's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The return's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The return's deleted.
|
|
parent:
|
|
type: object
|
|
description: The return's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/returns/{id}/request-items:
|
|
post:
|
|
operationId: PostReturnsIdRequestItems
|
|
summary: Add Request Items to Return
|
|
description: Add a list of request items to a return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostReturnsRequestItemsReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/returns/{id}/request-items' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: requestItemReturnWorkflow
|
|
/admin/returns/{id}/request-items/{action_id}:
|
|
post:
|
|
operationId: PostReturnsIdRequestItemsAction_id
|
|
summary: Add Request Items to Return
|
|
description: Add a list of request items to a return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The return's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostReturnsRequestItemsActionReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/returns/{id}/request-items/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateRequestItemReturnWorkflow
|
|
delete:
|
|
operationId: DeleteReturnsIdRequestItemsAction_id
|
|
summary: Remove Request Items from Return
|
|
description: Remove a list of request items from a return. This doesn't delete the Request Item, only the association between the Request Item and the return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The return's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/returns/{id}/request-items/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: removeItemReturnActionWorkflow
|
|
/admin/returns/{id}/shipping-method:
|
|
post:
|
|
operationId: PostReturnsIdShippingMethod
|
|
summary: Add Shipping Methods to Return
|
|
description: Add a list of shipping methods to a return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostReturnsShippingReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/returns/{id}/shipping-method' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"shipping_option_id": "{value}"
|
|
}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createReturnShippingMethodWorkflow
|
|
/admin/returns/{id}/shipping-method/{action_id}:
|
|
post:
|
|
operationId: PostReturnsIdShippingMethodAction_id
|
|
summary: Add Shipping Methods to Return
|
|
description: Add a list of shipping methods to a return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The return's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminPostReturnsShippingActionReqSchema'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/returns/{id}/shipping-method/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateReturnShippingMethodWorkflow
|
|
delete:
|
|
operationId: DeleteReturnsIdShippingMethodAction_id
|
|
summary: Remove Shipping Methods from Return
|
|
description: Remove a list of shipping methods from a return. This doesn't delete the Shipping Method, only the association between the Shipping Method and the return.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The return's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: action_id
|
|
in: path
|
|
description: The return's action id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/returns/{id}/shipping-method/{action_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Returns
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminReturnPreviewResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: removeReturnShippingMethodWorkflow
|
|
/admin/sales-channels:
|
|
get:
|
|
operationId: GetSalesChannels
|
|
summary: List Sales Channels
|
|
description: Retrieve a list of sales channels. The sales channels can be filtered by fields such as `id`. The sales channels can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: q
|
|
in: query
|
|
description: The sales channel's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The sales channel's q.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The sales channel's ID.
|
|
- type: array
|
|
description: The sales channel's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: name
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: name
|
|
description: The sales channel's name.
|
|
- type: array
|
|
description: The sales channel's name.
|
|
items:
|
|
type: string
|
|
title: name
|
|
description: The name's details.
|
|
- name: description
|
|
in: query
|
|
description: The sales channel's description.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: description
|
|
description: The sales channel's description.
|
|
- name: is_disabled
|
|
in: query
|
|
description: The sales channel's is disabled.
|
|
required: true
|
|
schema:
|
|
type: boolean
|
|
title: is_disabled
|
|
description: The sales channel's is disabled.
|
|
- name: created_at
|
|
in: query
|
|
description: The sales channel's created at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The sales channel's created at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: created_at
|
|
- name: updated_at
|
|
in: query
|
|
description: The sales channel's updated at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The sales channel's updated at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: updated_at
|
|
- name: deleted_at
|
|
in: query
|
|
description: The sales channel's deleted at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The sales channel's deleted at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: deleted_at
|
|
- name: location_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: location_id
|
|
description: The sales channel's location id.
|
|
- type: array
|
|
description: The sales channel's location id.
|
|
items:
|
|
type: string
|
|
title: location_id
|
|
description: The location id's details.
|
|
- name: publishable_key_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: publishable_key_id
|
|
description: The sales channel's publishable key id.
|
|
- type: array
|
|
description: The sales channel's publishable key id.
|
|
items:
|
|
type: string
|
|
title: publishable_key_id
|
|
description: The publishable key id's details.
|
|
- name: $and
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The sales channel's $and.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The sales channel's $or.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/sales-channels' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Sales Channels
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The sales channel's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The sales channel's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The sales channel's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- sales_channels
|
|
properties:
|
|
sales_channels:
|
|
type: array
|
|
description: The sales channel's sales channels.
|
|
items:
|
|
$ref: '#/components/schemas/AdminSalesChannel'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostSalesChannels
|
|
summary: Create Sales Channel
|
|
description: Create a sales channel.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCreateSalesChannel'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/sales-channels' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"name": "Linnea",
|
|
"description": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Sales Channels
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminSalesChannelResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createSalesChannelsWorkflow
|
|
/admin/sales-channels/{id}:
|
|
get:
|
|
operationId: GetSalesChannelsId
|
|
summary: Get a Sales Channel
|
|
description: Retrieve a sales channel by its ID. You can expand the sales channel's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The sales channel's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/sales-channels/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Sales Channels
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminSalesChannelResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostSalesChannelsId
|
|
summary: Update a Sales Channel
|
|
description: Update a sales channel's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The sales channel's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminUpdateSalesChannel'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/sales-channels/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"description": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Sales Channels
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminSalesChannelResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteSalesChannelsId
|
|
summary: Delete a Sales Channel
|
|
description: Delete a sales channel.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The sales channel's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/sales-channels/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Sales Channels
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminSalesChannelDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/sales-channels/{id}/products:
|
|
post:
|
|
operationId: PostSalesChannelsIdProducts
|
|
summary: Add Products to Sales Channel
|
|
description: Add a list of products to a sales channel.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The sales channel's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
add:
|
|
type: array
|
|
description: The sales channel's add.
|
|
items:
|
|
type: string
|
|
title: add
|
|
description: The add's details.
|
|
remove:
|
|
type: array
|
|
description: The sales channel's remove.
|
|
items:
|
|
type: string
|
|
title: remove
|
|
description: The remove's details.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/sales-channels/{id}/products' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Sales Channels
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminSalesChannelResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/shipping-options:
|
|
get:
|
|
operationId: GetShippingOptions
|
|
summary: List Shipping Options
|
|
description: Retrieve a list of shipping options. The shipping options can be filtered by fields such as `id`. The shipping options can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The shipping option's ID.
|
|
- type: array
|
|
description: The shipping option's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: q
|
|
in: query
|
|
description: The shipping option's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The shipping option's q.
|
|
- name: service_zone_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: service_zone_id
|
|
description: The shipping option's service zone id.
|
|
- type: array
|
|
description: The shipping option's service zone id.
|
|
items:
|
|
type: string
|
|
title: service_zone_id
|
|
description: The service zone id's details.
|
|
- name: shipping_profile_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: shipping_profile_id
|
|
description: The shipping option's shipping profile id.
|
|
- type: array
|
|
description: The shipping option's shipping profile id.
|
|
items:
|
|
type: string
|
|
title: shipping_profile_id
|
|
description: The shipping profile id's details.
|
|
- name: provider_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: provider_id
|
|
description: The shipping option's provider id.
|
|
- type: array
|
|
description: The shipping option's provider id.
|
|
items:
|
|
type: string
|
|
title: provider_id
|
|
description: The provider id's details.
|
|
- name: shipping_option_type_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: shipping_option_type_id
|
|
description: The shipping option's shipping option type id.
|
|
- type: array
|
|
description: The shipping option's shipping option type id.
|
|
items:
|
|
type: string
|
|
title: shipping_option_type_id
|
|
description: The shipping option type id's details.
|
|
- name: created_at
|
|
in: query
|
|
description: The shipping option's created at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The shipping option's created at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: created_at
|
|
- name: updated_at
|
|
in: query
|
|
description: The shipping option's updated at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The shipping option's updated at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: updated_at
|
|
- name: deleted_at
|
|
in: query
|
|
description: The shipping option's deleted at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The shipping option's deleted at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: deleted_at
|
|
- name: stock_location_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: stock_location_id
|
|
description: The shipping option's stock location id.
|
|
- type: array
|
|
description: The shipping option's stock location id.
|
|
items:
|
|
type: string
|
|
title: stock_location_id
|
|
description: The stock location id's details.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/shipping-options' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Shipping Options
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The shipping option's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The shipping option's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The shipping option's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- shipping_options
|
|
properties:
|
|
shipping_options:
|
|
type: array
|
|
description: The shipping option's shipping options.
|
|
items:
|
|
type: object
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostShippingOptions
|
|
summary: Create Shipping Option
|
|
description: Create a shipping option.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- name
|
|
- service_zone_id
|
|
- shipping_profile_id
|
|
- price_type
|
|
- provider_id
|
|
- type
|
|
- prices
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The shipping option's name.
|
|
service_zone_id:
|
|
type: string
|
|
title: service_zone_id
|
|
description: The shipping option's service zone id.
|
|
shipping_profile_id:
|
|
type: string
|
|
title: shipping_profile_id
|
|
description: The shipping option's shipping profile id.
|
|
data:
|
|
type: object
|
|
description: The shipping option's data.
|
|
price_type:
|
|
type: string
|
|
enum:
|
|
- calculated
|
|
- flat
|
|
provider_id:
|
|
type: string
|
|
title: provider_id
|
|
description: The shipping option's provider id.
|
|
type:
|
|
type: object
|
|
description: The shipping option's type.
|
|
required:
|
|
- label
|
|
- description
|
|
- code
|
|
properties:
|
|
label:
|
|
type: string
|
|
title: label
|
|
description: The type's label.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The type's description.
|
|
code:
|
|
type: string
|
|
title: code
|
|
description: The type's code.
|
|
prices:
|
|
type: array
|
|
description: The shipping option's prices.
|
|
items:
|
|
oneOf:
|
|
- type: object
|
|
description: The price's prices.
|
|
required:
|
|
- currency_code
|
|
- amount
|
|
properties:
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The price's currency code.
|
|
amount:
|
|
type: number
|
|
title: amount
|
|
description: The price's amount.
|
|
- type: object
|
|
description: The price's prices.
|
|
required:
|
|
- region_id
|
|
- amount
|
|
properties:
|
|
region_id:
|
|
type: string
|
|
title: region_id
|
|
description: The price's region id.
|
|
amount:
|
|
type: number
|
|
title: amount
|
|
description: The price's amount.
|
|
rules:
|
|
type: array
|
|
description: The shipping option's rules.
|
|
items:
|
|
type: object
|
|
description: The rule's rules.
|
|
required:
|
|
- operator
|
|
- attribute
|
|
- value
|
|
properties:
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- in
|
|
- eq
|
|
- ne
|
|
- gt
|
|
- gte
|
|
- lt
|
|
- lte
|
|
- nin
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The rule's attribute.
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The rule's value.
|
|
- type: array
|
|
description: The rule's value.
|
|
items:
|
|
type: string
|
|
title: value
|
|
description: The value's details.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/shipping-options' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"name": "Julie",
|
|
"service_zone_id": "{value}",
|
|
"shipping_profile_id": "{value}",
|
|
"price_type": "{value}",
|
|
"provider_id": "{value}",
|
|
"type": {
|
|
"label": "{value}",
|
|
"description": "{value}",
|
|
"code": "{value}"
|
|
},
|
|
"prices": []
|
|
}'
|
|
tags:
|
|
- Shipping Options
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminShippingOptionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/shipping-options/{id}:
|
|
post:
|
|
operationId: PostShippingOptionsId
|
|
summary: Update a Shipping Option
|
|
description: Update a shipping option's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The shipping option's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The shipping option's name.
|
|
data:
|
|
type: object
|
|
description: The shipping option's data.
|
|
price_type:
|
|
type: string
|
|
enum:
|
|
- calculated
|
|
- flat
|
|
provider_id:
|
|
type: string
|
|
title: provider_id
|
|
description: The shipping option's provider id.
|
|
shipping_profile_id:
|
|
type: string
|
|
title: shipping_profile_id
|
|
description: The shipping option's shipping profile id.
|
|
type:
|
|
type: object
|
|
description: The shipping option's type.
|
|
required:
|
|
- label
|
|
- description
|
|
- code
|
|
properties:
|
|
label:
|
|
type: string
|
|
title: label
|
|
description: The type's label.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The type's description.
|
|
code:
|
|
type: string
|
|
title: code
|
|
description: The type's code.
|
|
prices:
|
|
type: array
|
|
description: The shipping option's prices.
|
|
items:
|
|
oneOf:
|
|
- type: object
|
|
description: The price's prices.
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The price's ID.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The price's currency code.
|
|
amount:
|
|
type: number
|
|
title: amount
|
|
description: The price's amount.
|
|
- type: object
|
|
description: The price's prices.
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The price's ID.
|
|
region_id:
|
|
type: string
|
|
title: region_id
|
|
description: The price's region id.
|
|
amount:
|
|
type: number
|
|
title: amount
|
|
description: The price's amount.
|
|
rules:
|
|
type: array
|
|
description: The shipping option's rules.
|
|
items:
|
|
oneOf:
|
|
- type: object
|
|
description: The rule's rules.
|
|
required:
|
|
- operator
|
|
- attribute
|
|
- value
|
|
properties:
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- in
|
|
- eq
|
|
- ne
|
|
- gt
|
|
- gte
|
|
- lt
|
|
- lte
|
|
- nin
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The rule's attribute.
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The rule's value.
|
|
- type: array
|
|
description: The rule's value.
|
|
items:
|
|
type: string
|
|
title: value
|
|
description: The value's details.
|
|
- type: object
|
|
description: The rule's rules.
|
|
required:
|
|
- id
|
|
- operator
|
|
- attribute
|
|
- value
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The rule's ID.
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- in
|
|
- eq
|
|
- ne
|
|
- gt
|
|
- gte
|
|
- lt
|
|
- lte
|
|
- nin
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The rule's attribute.
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The rule's value.
|
|
- type: array
|
|
description: The rule's value.
|
|
items:
|
|
type: string
|
|
title: value
|
|
description: The value's details.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/shipping-options/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Shipping Options
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminShippingOptionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteShippingOptionsId
|
|
summary: Delete a Shipping Option
|
|
description: Delete a shipping option.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The shipping option's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/shipping-options/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Shipping Options
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminShippingOptionDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/shipping-options/{id}/rules/batch:
|
|
post:
|
|
operationId: PostShippingOptionsIdRulesBatch
|
|
summary: Add Rules to Shipping Option
|
|
description: Add a list of rules to a shipping option.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The shipping option's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
create:
|
|
type: array
|
|
description: The shipping option's create.
|
|
items:
|
|
type: object
|
|
description: The create's details.
|
|
required:
|
|
- operator
|
|
- attribute
|
|
- value
|
|
properties:
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- in
|
|
- eq
|
|
- ne
|
|
- gt
|
|
- gte
|
|
- lt
|
|
- lte
|
|
- nin
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The create's attribute.
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The create's value.
|
|
- type: array
|
|
description: The create's value.
|
|
items:
|
|
type: string
|
|
title: value
|
|
description: The value's details.
|
|
update:
|
|
type: array
|
|
description: The shipping option's update.
|
|
items:
|
|
type: object
|
|
description: The update's details.
|
|
required:
|
|
- id
|
|
- operator
|
|
- attribute
|
|
- value
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The update's ID.
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- in
|
|
- eq
|
|
- ne
|
|
- gt
|
|
- gte
|
|
- lt
|
|
- lte
|
|
- nin
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The update's attribute.
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The update's value.
|
|
- type: array
|
|
description: The update's value.
|
|
items:
|
|
type: string
|
|
title: value
|
|
description: The value's details.
|
|
delete:
|
|
type: array
|
|
description: The shipping option's delete.
|
|
items:
|
|
type: string
|
|
title: delete
|
|
description: The delete's details.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/shipping-options/{id}/rules/batch' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Shipping Options
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- created
|
|
- updated
|
|
- deleted
|
|
properties:
|
|
created:
|
|
type: array
|
|
description: The shipping option's created.
|
|
items:
|
|
$ref: '#/components/schemas/AdminShippingOptionRule'
|
|
updated:
|
|
type: array
|
|
description: The shipping option's updated.
|
|
items:
|
|
$ref: '#/components/schemas/AdminShippingOptionRule'
|
|
deleted:
|
|
type: object
|
|
description: The shipping option's deleted.
|
|
required:
|
|
- ids
|
|
- object
|
|
- deleted
|
|
properties:
|
|
ids:
|
|
type: array
|
|
description: The deleted's ids.
|
|
items:
|
|
type: string
|
|
title: ids
|
|
description: The id's ids.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The deleted's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The deleted's details.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: batchShippingOptionRulesWorkflow
|
|
/admin/shipping-profiles:
|
|
get:
|
|
operationId: GetShippingProfiles
|
|
summary: List Shipping Profiles
|
|
description: Retrieve a list of shipping profiles. The shipping profiles can be filtered by fields such as `id`. The shipping profiles can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The shipping profile's ID.
|
|
- type: array
|
|
description: The shipping profile's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: q
|
|
in: query
|
|
description: The shipping profile's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The shipping profile's q.
|
|
- name: type
|
|
in: query
|
|
description: The shipping profile's type.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: type
|
|
description: The shipping profile's type.
|
|
- name: name
|
|
in: query
|
|
description: The shipping profile's name.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: name
|
|
description: The shipping profile's name.
|
|
- name: created_at
|
|
in: query
|
|
description: The shipping profile's created at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The shipping profile's created at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: created_at
|
|
- name: updated_at
|
|
in: query
|
|
description: The shipping profile's updated at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The shipping profile's updated at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: updated_at
|
|
- name: deleted_at
|
|
in: query
|
|
description: The shipping profile's deleted at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The shipping profile's deleted at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: deleted_at
|
|
- name: $and
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The shipping profile's $and.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The shipping profile's $or.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/shipping-profiles' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Shipping Profiles
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The shipping profile's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The shipping profile's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The shipping profile's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- shipping_profiles
|
|
properties:
|
|
shipping_profiles:
|
|
type: array
|
|
description: The shipping profile's shipping profiles.
|
|
items:
|
|
$ref: '#/components/schemas/AdminShippingProfile'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostShippingProfiles
|
|
summary: Create Shipping Profile
|
|
description: Create a shipping profile.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- name
|
|
- type
|
|
- metadata
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The shipping profile's name.
|
|
type:
|
|
type: string
|
|
title: type
|
|
description: The shipping profile's type.
|
|
metadata:
|
|
type: object
|
|
description: The shipping profile's metadata.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/shipping-profiles' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"name": "Percy",
|
|
"type": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Shipping Profiles
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminShippingProfileResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createShippingProfilesWorkflow
|
|
/admin/shipping-profiles/{id}:
|
|
get:
|
|
operationId: GetShippingProfilesId
|
|
summary: Get a Shipping Profile
|
|
description: Retrieve a shipping profile by its ID. You can expand the shipping profile's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The shipping profile's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/shipping-profiles/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Shipping Profiles
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminShippingProfileResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostShippingProfilesId
|
|
summary: Update a Shipping Profile
|
|
description: Update a shipping profile's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The shipping profile's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- metadata
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The shipping profile's name.
|
|
type:
|
|
type: string
|
|
title: type
|
|
description: The shipping profile's type.
|
|
metadata:
|
|
type: object
|
|
description: The shipping profile's metadata.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/shipping-profiles/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Shipping Profiles
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminShippingProfileResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteShippingProfilesId
|
|
summary: Delete a Shipping Profile
|
|
description: Delete a shipping profile.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The shipping profile's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/shipping-profiles/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Shipping Profiles
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminShippingProfileDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/stock-locations:
|
|
get:
|
|
operationId: GetStockLocations
|
|
summary: List Stock Locations
|
|
description: Retrieve a list of stock locations. The stock locations can be filtered by fields such as `id`. The stock locations can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: q
|
|
in: query
|
|
description: The stock location's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The stock location's q.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The stock location's ID.
|
|
- type: array
|
|
description: The stock location's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: name
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: name
|
|
description: The stock location's name.
|
|
- type: array
|
|
description: The stock location's name.
|
|
items:
|
|
type: string
|
|
title: name
|
|
description: The name's details.
|
|
- name: address_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: address_id
|
|
description: The stock location's address id.
|
|
- type: array
|
|
description: The stock location's address id.
|
|
items:
|
|
type: string
|
|
title: address_id
|
|
description: The address id's details.
|
|
- name: sales_channel_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: sales_channel_id
|
|
description: The stock location's sales channel id.
|
|
- type: array
|
|
description: The stock location's sales channel id.
|
|
items:
|
|
type: string
|
|
title: sales_channel_id
|
|
description: The sales channel id's details.
|
|
- name: created_at
|
|
in: query
|
|
description: The stock location's created at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The stock location's created at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: created_at
|
|
- name: updated_at
|
|
in: query
|
|
description: The stock location's updated at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The stock location's updated at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: updated_at
|
|
- name: deleted_at
|
|
in: query
|
|
description: The stock location's deleted at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The stock location's deleted at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: deleted_at
|
|
- name: $and
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The stock location's $and.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The stock location's $or.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/stock-locations' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Stock Locations
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminStockLocationListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostStockLocations
|
|
summary: Create Stock Location
|
|
description: Create a stock location.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCreateStockLocation'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/stock-locations' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"name": "Maryam",
|
|
"address_id": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Stock Locations
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminStockLocationResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createStockLocationsWorkflow
|
|
/admin/stock-locations/{id}:
|
|
get:
|
|
operationId: GetStockLocationsId
|
|
summary: Get a Stock Location
|
|
description: Retrieve a stock location by its ID. You can expand the stock location's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The stock location's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/stock-locations/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Stock Locations
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminStockLocationResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostStockLocationsId
|
|
summary: Update a Stock Location
|
|
description: Update a stock location's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The stock location's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminUpdateStockLocation'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/stock-locations/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"address_id": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Stock Locations
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminStockLocationResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteStockLocationsId
|
|
summary: Delete a Stock Location
|
|
description: Delete a stock location.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The stock location's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/stock-locations/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Stock Locations
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminStockLocationDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/stock-locations/{id}/fulfillment-providers:
|
|
post:
|
|
operationId: PostStockLocationsIdFulfillmentProviders
|
|
summary: Add Fulfillment Providers to Stock Location
|
|
description: Add a list of fulfillment providers to a stock location.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The stock location's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
add:
|
|
type: array
|
|
description: The stock location's add.
|
|
items:
|
|
type: string
|
|
title: add
|
|
description: The add's details.
|
|
remove:
|
|
type: array
|
|
description: The stock location's remove.
|
|
items:
|
|
type: string
|
|
title: remove
|
|
description: The remove's details.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/stock-locations/{id}/fulfillment-providers' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Stock Locations
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminStockLocationResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/stock-locations/{id}/fulfillment-sets:
|
|
post:
|
|
operationId: PostStockLocationsIdFulfillmentSets
|
|
summary: Add Fulfillment Sets to Stock Location
|
|
description: Add a list of fulfillment sets to a stock location.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The stock location's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- name
|
|
- type
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The stock location's name.
|
|
type:
|
|
type: string
|
|
title: type
|
|
description: The stock location's type.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/stock-locations/{id}/fulfillment-sets' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"name": "Helene",
|
|
"type": "{value}"
|
|
}'
|
|
tags:
|
|
- Stock Locations
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminStockLocationResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/stock-locations/{id}/sales-channels:
|
|
post:
|
|
operationId: PostStockLocationsIdSalesChannels
|
|
summary: Add Sales Channels to Stock Location
|
|
description: Add a list of sales channels to a stock location.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The stock location's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
properties:
|
|
add:
|
|
type: array
|
|
description: The stock location's add.
|
|
items:
|
|
type: string
|
|
title: add
|
|
description: The add's details.
|
|
remove:
|
|
type: array
|
|
description: The stock location's remove.
|
|
items:
|
|
type: string
|
|
title: remove
|
|
description: The remove's details.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/stock-locations/{id}/sales-channels' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Stock Locations
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminStockLocationResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/stores:
|
|
get:
|
|
operationId: GetStores
|
|
summary: List Stores
|
|
description: Retrieve a list of stores. The stores can be filtered by fields such as `id`. The stores can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: q
|
|
in: query
|
|
description: The store's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The store's q.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The store's ID.
|
|
- type: array
|
|
description: The store's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: name
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: name
|
|
description: The store's name.
|
|
- type: array
|
|
description: The store's name.
|
|
items:
|
|
type: string
|
|
title: name
|
|
description: The name's details.
|
|
- name: $and
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The store's $and.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The store's $or.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/stores' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Stores
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminStoreListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/stores/{id}:
|
|
get:
|
|
operationId: GetStoresId
|
|
summary: Get a Store
|
|
description: Retrieve a store by its ID. You can expand the store's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The store's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/stores/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Stores
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminStoreResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostStoresId
|
|
summary: Update a Store
|
|
description: Update a store's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The store's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminUpdateStore'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/stores/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"name": "Melvina",
|
|
"default_sales_channel_id": "{value}",
|
|
"default_region_id": "{value}",
|
|
"default_location_id": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Stores
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminStoreResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: updateStoresWorkflow
|
|
/admin/tax-rates:
|
|
get:
|
|
operationId: GetTaxRates
|
|
summary: List Tax Rates
|
|
description: Retrieve a list of tax rates. The tax rates can be filtered by fields such as `id`. The tax rates can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: q
|
|
in: query
|
|
description: The tax rate's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The tax rate's q.
|
|
- name: tax_region_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: tax_region_id
|
|
description: The tax rate's tax region id.
|
|
- type: array
|
|
description: The tax rate's tax region id.
|
|
items:
|
|
type: string
|
|
title: tax_region_id
|
|
description: The tax region id's details.
|
|
- type: object
|
|
description: The tax rate's tax region id.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
- name: is_default
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: string
|
|
enum:
|
|
- 'true'
|
|
- 'false'
|
|
- name: created_at
|
|
in: query
|
|
description: The tax rate's created at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The tax rate's created at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: created_at
|
|
- name: updated_at
|
|
in: query
|
|
description: The tax rate's updated at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The tax rate's updated at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: updated_at
|
|
- name: deleted_at
|
|
in: query
|
|
description: The tax rate's deleted at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The tax rate's deleted at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: deleted_at
|
|
- name: $and
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The tax rate's $and.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The tax rate's $or.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/tax-rates' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Tax Rates
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The tax rate's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The tax rate's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The tax rate's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- tax_rates
|
|
properties:
|
|
tax_rates:
|
|
type: array
|
|
description: The tax rate's tax rates.
|
|
items:
|
|
$ref: '#/components/schemas/AdminTaxRate'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostTaxRates
|
|
summary: Create Tax Rate
|
|
description: Create a tax rate.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCreateTaxRate'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/tax-rates' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"name": "Kaylin",
|
|
"tax_region_id": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Tax Rates
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminTaxRateResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createTaxRatesWorkflow
|
|
/admin/tax-rates/{id}:
|
|
get:
|
|
operationId: GetTaxRatesId
|
|
summary: Get a Tax Rate
|
|
description: Retrieve a tax rate by its ID. You can expand the tax rate's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The tax rate's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/tax-rates/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Tax Rates
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminTaxRateResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostTaxRatesId
|
|
summary: Update a Tax Rate
|
|
description: Update a tax rate's details.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The tax rate's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminUpdateTaxRate'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/tax-rates/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Tax Rates
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminTaxRateResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteTaxRatesId
|
|
summary: Delete a Tax Rate
|
|
description: Delete a tax rate.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The tax rate's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/tax-rates/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Tax Rates
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminTaxRateDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/tax-rates/{id}/rules:
|
|
post:
|
|
operationId: PostTaxRatesIdRules
|
|
summary: Add Rules to Tax Rate
|
|
description: Add a list of rules to a tax rate.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The tax rate's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCreateTaxRateRule'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/tax-rates/{id}/rules' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"reference": "{value}",
|
|
"reference_id": "{value}"
|
|
}'
|
|
tags:
|
|
- Tax Rates
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminTaxRateResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/tax-rates/{id}/rules/{rule_id}:
|
|
delete:
|
|
operationId: DeleteTaxRatesIdRulesRule_id
|
|
summary: Remove Rules from Tax Rate
|
|
description: Remove a list of rules from a tax rate. This doesn't delete the Rule, only the association between the Rule and the tax rate.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The tax rate's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: rule_id
|
|
in: path
|
|
description: The tax rate's rule id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/tax-rates/{id}/rules/{rule_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Tax Rates
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The tax rate's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The tax rate's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The tax rate's deleted.
|
|
parent:
|
|
type: object
|
|
description: The tax rate's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/tax-regions:
|
|
get:
|
|
operationId: GetTaxRegions
|
|
summary: List Tax Regions
|
|
description: Retrieve a list of tax regions. The tax regions can be filtered by fields such as `id`. The tax regions can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: q
|
|
in: query
|
|
description: The tax region's q.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: q
|
|
description: The tax region's q.
|
|
- name: id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The tax region's ID.
|
|
- type: array
|
|
description: The tax region's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
- name: country_code
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: country_code
|
|
description: The tax region's country code.
|
|
- type: array
|
|
description: The tax region's country code.
|
|
items:
|
|
type: string
|
|
title: country_code
|
|
description: The country code's details.
|
|
- type: object
|
|
description: The tax region's country code.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
- name: province_code
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: province_code
|
|
description: The tax region's province code.
|
|
- type: array
|
|
description: The tax region's province code.
|
|
items:
|
|
type: string
|
|
title: province_code
|
|
description: The province code's details.
|
|
- type: object
|
|
description: The tax region's province code.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
- name: parent_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: parent_id
|
|
description: The tax region's parent id.
|
|
- type: array
|
|
description: The tax region's parent id.
|
|
items:
|
|
type: string
|
|
title: parent_id
|
|
description: The parent id's details.
|
|
- type: object
|
|
description: The tax region's parent id.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
- name: created_by
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: created_by
|
|
description: The tax region's created by.
|
|
- type: array
|
|
description: The tax region's created by.
|
|
items:
|
|
type: string
|
|
title: created_by
|
|
description: The created by's details.
|
|
- name: created_at
|
|
in: query
|
|
description: The tax region's created at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The tax region's created at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: created_at
|
|
- name: updated_at
|
|
in: query
|
|
description: The tax region's updated at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The tax region's updated at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: updated_at
|
|
- name: deleted_at
|
|
in: query
|
|
description: The tax region's deleted at.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
description: The tax region's deleted at.
|
|
required:
|
|
- $eq
|
|
- $ne
|
|
- $in
|
|
- $nin
|
|
- $like
|
|
- $ilike
|
|
- $re
|
|
- $contains
|
|
- $gt
|
|
- $gte
|
|
- $lt
|
|
- $lte
|
|
properties:
|
|
$eq: {}
|
|
$ne: {}
|
|
$in: {}
|
|
$nin: {}
|
|
$like: {}
|
|
$ilike: {}
|
|
$re: {}
|
|
$contains: {}
|
|
$gt: {}
|
|
$gte: {}
|
|
$lt: {}
|
|
$lte: {}
|
|
title: deleted_at
|
|
- name: $and
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The tax region's $and.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
- name: $or
|
|
in: query
|
|
required: false
|
|
schema:
|
|
type: array
|
|
description: The tax region's $or.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/tax-regions' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Tax Regions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The tax region's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The tax region's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The tax region's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- tax_regions
|
|
properties:
|
|
tax_regions:
|
|
type: array
|
|
description: The tax region's tax regions.
|
|
items:
|
|
type: object
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostTaxRegions
|
|
summary: Create Tax Region
|
|
description: Create a tax region.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCreateTaxRegion'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/tax-regions' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"country_code": "{value}",
|
|
"province_code": "{value}",
|
|
"parent_id": "{value}",
|
|
"metadata": {}
|
|
}'
|
|
tags:
|
|
- Tax Regions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminTaxRegionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: createTaxRegionsWorkflow
|
|
/admin/tax-regions/{id}:
|
|
get:
|
|
operationId: GetTaxRegionsId
|
|
summary: Get a Tax Region
|
|
description: Retrieve a tax region by its ID. You can expand the tax region's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The tax region's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/tax-regions/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Tax Regions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminTaxRegionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteTaxRegionsId
|
|
summary: Delete a Tax Region
|
|
description: Delete a tax region.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The tax region's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/tax-regions/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Tax Regions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminTaxRegionDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/uploads:
|
|
post:
|
|
operationId: PostUploads
|
|
summary: Create Upload
|
|
description: Create a upload.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminGetUploadParams'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/uploads' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Uploads
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminFileListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
x-workflow: uploadFilesWorkflow
|
|
/admin/uploads/{id}:
|
|
get:
|
|
operationId: GetUploadsId
|
|
summary: Get a Upload
|
|
description: Retrieve a upload by its ID. You can expand the upload's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The upload's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/uploads/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Uploads
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminFileResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteUploadsId
|
|
summary: Delete a Upload
|
|
description: Delete a upload.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The upload's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/admin/uploads/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Uploads
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The upload's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The upload's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The upload's deleted.
|
|
parent:
|
|
type: object
|
|
description: The upload's parent.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/users:
|
|
get:
|
|
operationId: GetUsers
|
|
summary: List Users
|
|
description: Retrieve a list of users. The users can be filtered by fields such as `id`. The users can also be sorted or paginated.
|
|
x-authenticated: false
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: curl '{backend_url}/admin/users'
|
|
tags:
|
|
- Users
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminUserListResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/users/me:
|
|
get:
|
|
operationId: GetUsersMe
|
|
summary: List Users
|
|
description: Retrieve a list of users. The users can be filtered by fields such as `id`. The users can also be sorted or paginated.
|
|
x-authenticated: false
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: curl '{backend_url}/admin/users/me'
|
|
tags:
|
|
- Users
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminUserResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/users/{id}:
|
|
get:
|
|
operationId: GetUsersId
|
|
summary: Get a User
|
|
description: Retrieve a user by its ID. You can expand the user's relations or select the fields that should be returned.
|
|
x-authenticated: false
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The user's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: curl '{backend_url}/admin/users/{id}'
|
|
tags:
|
|
- Users
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminUserResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
post:
|
|
operationId: PostUsersId
|
|
summary: Update a User
|
|
description: Update a user's details.
|
|
x-authenticated: false
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The user's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminUpdateUser'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/users/{id}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"first_name": "{value}",
|
|
"last_name": "{value}",
|
|
"avatar_url": "{value}"
|
|
}'
|
|
tags:
|
|
- Users
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminUserResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
delete:
|
|
operationId: DeleteUsersId
|
|
summary: Delete a User
|
|
description: Delete a user.
|
|
x-authenticated: false
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The user's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: curl -X DELETE '{backend_url}/admin/users/{id}'
|
|
tags:
|
|
- Users
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminUserDeleteResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/workflows-executions:
|
|
get:
|
|
operationId: GetWorkflowsExecutions
|
|
summary: List Workflows Executions
|
|
description: Retrieve a list of workflows executions. The workflows executions can be filtered by fields such as `id`. The workflows executions can also be sorted or paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
- name: transaction_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: transaction_id
|
|
description: The workflows execution's transaction id.
|
|
- type: array
|
|
description: The workflows execution's transaction id.
|
|
items:
|
|
type: string
|
|
title: transaction_id
|
|
description: The transaction id's details.
|
|
- name: workflow_id
|
|
in: query
|
|
required: false
|
|
schema:
|
|
oneOf:
|
|
- type: string
|
|
title: workflow_id
|
|
description: The workflows execution's workflow id.
|
|
- type: array
|
|
description: The workflows execution's workflow id.
|
|
items:
|
|
type: string
|
|
title: workflow_id
|
|
description: The workflow id's details.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/workflows-executions' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Workflows Executions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
allOf:
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The workflows execution's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The workflows execution's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The workflows execution's count.
|
|
- type: object
|
|
description: SUMMARY
|
|
required:
|
|
- workflow_executions
|
|
properties:
|
|
workflow_executions:
|
|
type: array
|
|
description: The workflows execution's workflow executions.
|
|
items:
|
|
$ref: '#/components/schemas/AdminWorkflowExecution'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/workflows-executions/{id}:
|
|
get:
|
|
operationId: GetWorkflowsExecutionsId
|
|
summary: Get a Workflows Execution
|
|
description: Retrieve a workflows execution by its ID. You can expand the workflows execution's relations or select the fields that should be returned.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: id
|
|
in: path
|
|
description: The workflows execution's ID.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/workflows-executions/{id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Workflows Executions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminWorkflowExecutionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/workflows-executions/{workflow_id}/run:
|
|
post:
|
|
operationId: PostWorkflowsExecutionsWorkflow_idRun
|
|
summary: Add Runs to Workflows Execution
|
|
description: Add a list of runs to a workflows execution.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: workflow_id
|
|
in: path
|
|
description: The workflows execution's workflow id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCreateWorkflowsRun'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/workflows-executions/{workflow_id}/run' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Workflows Executions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- acknowledgement
|
|
properties:
|
|
acknowledgement: {}
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/workflows-executions/{workflow_id}/steps/failure:
|
|
post:
|
|
operationId: PostWorkflowsExecutionsWorkflow_idStepsFailure
|
|
summary: Add Failures to Workflows Execution
|
|
description: Add a list of failures to a workflows execution.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: workflow_id
|
|
in: path
|
|
description: The workflows execution's workflow id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCreateWorkflowsAsyncResponse'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/workflows-executions/{workflow_id}/steps/failure' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"transaction_id": "{value}",
|
|
"step_id": "{value}"
|
|
}'
|
|
tags:
|
|
- Workflows Executions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- success
|
|
properties:
|
|
success:
|
|
type: boolean
|
|
title: success
|
|
description: The workflows execution's success.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/workflows-executions/{workflow_id}/steps/success:
|
|
post:
|
|
operationId: PostWorkflowsExecutionsWorkflow_idStepsSuccess
|
|
summary: Add Successes to Workflows Execution
|
|
description: Add a list of successes to a workflows execution.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: workflow_id
|
|
in: path
|
|
description: The workflows execution's workflow id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminCreateWorkflowsAsyncResponse'
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/admin/workflows-executions/{workflow_id}/steps/success' \
|
|
-H 'x-medusa-access-token: {api_token}' \
|
|
-H 'Content-Type: application/json' \
|
|
--data-raw '{
|
|
"transaction_id": "{value}",
|
|
"step_id": "{value}"
|
|
}'
|
|
tags:
|
|
- Workflows Executions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- success
|
|
properties:
|
|
success:
|
|
type: boolean
|
|
title: success
|
|
description: The workflows execution's success.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/workflows-executions/{workflow_id}/subscribe:
|
|
get:
|
|
operationId: GetWorkflowsExecutionsWorkflow_idSubscribe
|
|
summary: List Subscribes
|
|
description: Retrieve a list of subscribes in a workflows execution. The subscribes can be filtered by fields like FILTER FIELDS. The subscribes can also be paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: workflow_id
|
|
in: path
|
|
description: The workflows execution's workflow id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/workflows-executions/{workflow_id}/subscribe' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Workflows Executions
|
|
responses:
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/workflows-executions/{workflow_id}/{transaction_id}:
|
|
get:
|
|
operationId: GetWorkflowsExecutionsWorkflow_idTransaction_id
|
|
summary: 'List '
|
|
description: Retrieve a list of in a workflows execution. The can be filtered by fields like FILTER FIELDS. The can also be paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: workflow_id
|
|
in: path
|
|
description: The workflows execution's workflow id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: transaction_id
|
|
in: path
|
|
description: The workflows execution's transaction id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/workflows-executions/{workflow_id}/{transaction_id}' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Workflows Executions
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AdminWorkflowExecutionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/admin/workflows-executions/{workflow_id}/{transaction_id}/{step_id}/subscribe:
|
|
get:
|
|
operationId: GetWorkflowsExecutionsWorkflow_idTransaction_idStep_idSubscribe
|
|
summary: List Subscribes
|
|
description: Retrieve a list of subscribes in a workflows execution. The subscribes can be filtered by fields like FILTER FIELDS. The subscribes can also be paginated.
|
|
x-authenticated: true
|
|
parameters:
|
|
- name: workflow_id
|
|
in: path
|
|
description: The workflows execution's workflow id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: transaction_id
|
|
in: path
|
|
description: The workflows execution's transaction id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: step_id
|
|
in: path
|
|
description: The workflows execution's step id.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: expand
|
|
in: query
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: expand
|
|
description: Comma-separated relations that should be expanded in the returned data.
|
|
- name: fields
|
|
in: query
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: fields
|
|
description: Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.
|
|
- name: offset
|
|
in: query
|
|
description: The number of items to skip when retrieving a list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: offset
|
|
description: The number of items to skip when retrieving a list.
|
|
- name: limit
|
|
in: query
|
|
description: Limit the number of items returned in the list.
|
|
required: false
|
|
schema:
|
|
type: number
|
|
title: limit
|
|
description: Limit the number of items returned in the list.
|
|
- name: order
|
|
in: query
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
required: false
|
|
schema:
|
|
type: string
|
|
title: order
|
|
description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.
|
|
security:
|
|
- api_token: []
|
|
- cookie_auth: []
|
|
- jwt_token: []
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl '{backend_url}/admin/workflows-executions/{workflow_id}/{transaction_id}/{step_id}/subscribe' \
|
|
-H 'x-medusa-access-token: {api_token}'
|
|
tags:
|
|
- Workflows Executions
|
|
responses:
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/auth/session:
|
|
post:
|
|
operationId: PostSession
|
|
summary: Set Authentication Session
|
|
description: Set the cookie session ID of an admin user. The admin must be previously authenticated with the `/auth/user/{provider}` API route first, as the JWT token is required in the header of the request.
|
|
x-authenticated: true
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X POST '{backend_url}/auth/session' \
|
|
-H 'Authorization: Bearer {jwt_token}'
|
|
tags:
|
|
- Auth
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AuthAdminSessionResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/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: DeleteSession
|
|
summary: Delete Authentication Session
|
|
description: Deletes the cookie session ID previously set for authentication.
|
|
x-authenticated: true
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: |-
|
|
curl -X DELETE '{backend_url}/auth/session' \
|
|
-H 'Cookie: connect.sid={sid}'
|
|
tags:
|
|
- Auth
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
description: SUMMARY
|
|
required:
|
|
- success
|
|
properties:
|
|
success:
|
|
type: boolean
|
|
title: success
|
|
description: Whether the session was deleted successfully.
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/auth/user/{auth_provider}:
|
|
post:
|
|
operationId: PostActor_typeAuth_provider
|
|
summary: Authenticate User
|
|
description: Authenticate an admin user and receive the JWT token to be used in the header of subsequent requests.
|
|
x-authenticated: false
|
|
parameters:
|
|
- name: auth_provider
|
|
in: path
|
|
description: The provider used for authentication.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
example: emailpass
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: curl -X POST '{backend_url}/auth/user/{auth_provider}'
|
|
tags:
|
|
- Auth
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AuthResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/auth/user/{auth_provider}/callback:
|
|
post:
|
|
operationId: PostActor_typeAuth_providerCallback
|
|
summary: Validate Authentication Callback
|
|
description: Third-party authentication providers, such as Google, require an API route to call once authentication with the third-party provider is finished. This API route validates callback for admin users logged-in with third-party providers.
|
|
x-authenticated: false
|
|
parameters:
|
|
- name: auth_provider
|
|
in: path
|
|
description: The provider used for authentication.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
example: google
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: curl -X POST '{backend_url}/auth/user/{auth_provider}/callback'
|
|
tags:
|
|
- Auth
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AuthResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
/auth/user/{auth_provider}/register:
|
|
post:
|
|
operationId: PostActor_typeAuth_provider_register
|
|
summary: Retrieve Registration JWT Token
|
|
description: A registration JWT token is used in the header of requests that create a user, such as the accept invitation request. This API route retrieves the JWT token of a user that hasn't been registered yet.
|
|
x-authenticated: false
|
|
parameters:
|
|
- name: auth_provider
|
|
in: path
|
|
description: The provider used for authentication.
|
|
required: true
|
|
schema:
|
|
type: string
|
|
example: emailpass
|
|
x-codeSamples:
|
|
- lang: Shell
|
|
label: cURL
|
|
source: curl -X POST '{backend_url}/auth/user/{auth_provider}/register'
|
|
tags:
|
|
- Auth
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/AuthResponse'
|
|
'400':
|
|
$ref: '#/components/responses/400_error'
|
|
'401':
|
|
$ref: '#/components/responses/unauthorized'
|
|
'404':
|
|
$ref: '#/components/responses/not_found_error'
|
|
'409':
|
|
$ref: '#/components/responses/invalid_state_error'
|
|
'422':
|
|
$ref: '#/components/responses/invalid_request_error'
|
|
'500':
|
|
$ref: '#/components/responses/500_error'
|
|
components:
|
|
schemas:
|
|
AdminApiKeyResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminApiKeyResponse
|
|
required:
|
|
- api_key
|
|
properties:
|
|
api_key:
|
|
$ref: '#/components/schemas/ApiKeyResponse'
|
|
AdminArchiveOrder:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminArchiveOrder
|
|
required:
|
|
- order_id
|
|
properties:
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The order's order id.
|
|
AdminBatchProductRequest:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminBatchProductRequest
|
|
properties:
|
|
create:
|
|
type: array
|
|
description: The product's create.
|
|
items:
|
|
$ref: '#/components/schemas/AdminCreateProduct'
|
|
update:
|
|
type: array
|
|
description: The product's update.
|
|
items:
|
|
$ref: '#/components/schemas/AdminUpdateProduct'
|
|
delete:
|
|
type: array
|
|
description: The product's delete.
|
|
items:
|
|
type: string
|
|
title: delete
|
|
description: The delete's details.
|
|
AdminBatchProductResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminBatchProductResponse
|
|
required:
|
|
- created
|
|
- updated
|
|
- deleted
|
|
properties:
|
|
created:
|
|
type: array
|
|
description: The product's created.
|
|
items:
|
|
$ref: '#/components/schemas/AdminProduct'
|
|
updated:
|
|
type: array
|
|
description: The product's updated.
|
|
items:
|
|
$ref: '#/components/schemas/AdminProduct'
|
|
deleted:
|
|
type: object
|
|
description: The product's deleted.
|
|
required:
|
|
- ids
|
|
- object
|
|
- deleted
|
|
properties:
|
|
ids:
|
|
type: array
|
|
description: The deleted's ids.
|
|
items:
|
|
type: string
|
|
title: ids
|
|
description: The id's ids.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The deleted's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The deleted's details.
|
|
AdminBatchProductVariantRequest:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminBatchProductVariantRequest
|
|
properties:
|
|
create:
|
|
type: array
|
|
description: The product's create.
|
|
items:
|
|
$ref: '#/components/schemas/AdminCreateProductVariant'
|
|
update:
|
|
type: array
|
|
description: The product's update.
|
|
items:
|
|
$ref: '#/components/schemas/AdminUpdateProductVariant'
|
|
delete:
|
|
type: array
|
|
description: The product's delete.
|
|
items:
|
|
type: string
|
|
title: delete
|
|
description: The delete's details.
|
|
AdminBatchProductVariantResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminBatchProductVariantResponse
|
|
required:
|
|
- created
|
|
- updated
|
|
- deleted
|
|
properties:
|
|
created:
|
|
type: array
|
|
description: The product's created.
|
|
items:
|
|
$ref: '#/components/schemas/AdminProductVariant'
|
|
updated:
|
|
type: array
|
|
description: The product's updated.
|
|
items:
|
|
$ref: '#/components/schemas/AdminProductVariant'
|
|
deleted:
|
|
type: object
|
|
description: The product's deleted.
|
|
required:
|
|
- ids
|
|
- object
|
|
- deleted
|
|
properties:
|
|
ids:
|
|
type: array
|
|
description: The deleted's ids.
|
|
items:
|
|
type: string
|
|
title: ids
|
|
description: The id's ids.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The deleted's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The deleted's details.
|
|
AdminCampaignResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCampaignResponse
|
|
required:
|
|
- campaign
|
|
properties:
|
|
campaign:
|
|
$ref: '#/components/schemas/CampaignResponse'
|
|
AdminCancelFulfillment:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCancelFulfillment
|
|
AdminClaim:
|
|
type: object
|
|
description: The claim's details.
|
|
x-schemaName: AdminClaim
|
|
required:
|
|
- order_id
|
|
- claim_items
|
|
- additional_items
|
|
- currency_code
|
|
- id
|
|
- region_id
|
|
- customer_id
|
|
- sales_channel_id
|
|
- email
|
|
- shipping_methods
|
|
- payment_status
|
|
- fulfillment_status
|
|
- summary
|
|
- metadata
|
|
- created_at
|
|
- updated_at
|
|
- original_item_total
|
|
- original_item_subtotal
|
|
- original_item_tax_total
|
|
- item_total
|
|
- item_subtotal
|
|
- item_tax_total
|
|
- original_total
|
|
- original_subtotal
|
|
- original_tax_total
|
|
- total
|
|
- subtotal
|
|
- tax_total
|
|
- discount_total
|
|
- discount_tax_total
|
|
- gift_card_total
|
|
- gift_card_tax_total
|
|
- shipping_total
|
|
- shipping_subtotal
|
|
- shipping_tax_total
|
|
- original_shipping_total
|
|
- original_shipping_subtotal
|
|
- original_shipping_tax_total
|
|
properties:
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The claim's order id.
|
|
claim_items:
|
|
type: array
|
|
description: The claim's claim items.
|
|
items:
|
|
$ref: '#/components/schemas/BaseClaimItem'
|
|
additional_items:
|
|
type: array
|
|
description: The claim's additional items.
|
|
items: {}
|
|
return:
|
|
$ref: '#/components/schemas/Return'
|
|
return_id:
|
|
type: string
|
|
title: return_id
|
|
description: The claim's return id.
|
|
no_notification:
|
|
type: boolean
|
|
title: no_notification
|
|
description: The claim's no notification.
|
|
refund_amount:
|
|
type: number
|
|
title: refund_amount
|
|
description: The claim's refund amount.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The claim's currency code.
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The claim's ID.
|
|
region_id:
|
|
type: string
|
|
title: region_id
|
|
description: The claim's region id.
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The claim's customer id.
|
|
sales_channel_id:
|
|
type: string
|
|
title: sales_channel_id
|
|
description: The claim's sales channel id.
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The claim's email.
|
|
format: email
|
|
display_id:
|
|
type: string
|
|
title: display_id
|
|
description: The claim's display id.
|
|
shipping_address:
|
|
$ref: '#/components/schemas/BaseOrderAddress'
|
|
billing_address:
|
|
$ref: '#/components/schemas/BaseOrderAddress'
|
|
shipping_methods:
|
|
type: array
|
|
description: The claim's shipping methods.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderShippingMethod'
|
|
payment_collections:
|
|
type: array
|
|
description: The claim's payment collections.
|
|
items:
|
|
$ref: '#/components/schemas/BasePaymentCollection'
|
|
payment_status:
|
|
type: string
|
|
enum:
|
|
- canceled
|
|
- not_paid
|
|
- awaiting
|
|
- authorized
|
|
- partially_authorized
|
|
- captured
|
|
- partially_captured
|
|
- partially_refunded
|
|
- refunded
|
|
- requires_action
|
|
fulfillments:
|
|
type: array
|
|
description: The claim's fulfillments.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderFulfillment'
|
|
fulfillment_status:
|
|
type: string
|
|
enum:
|
|
- canceled
|
|
- not_fulfilled
|
|
- partially_fulfilled
|
|
- fulfilled
|
|
- partially_shipped
|
|
- shipped
|
|
- partially_delivered
|
|
- delivered
|
|
transactions:
|
|
type: array
|
|
description: The claim's transactions.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderTransaction'
|
|
summary:
|
|
$ref: '#/components/schemas/BaseOrderSummary'
|
|
metadata:
|
|
type: object
|
|
description: The claim's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The claim's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The claim's updated at.
|
|
original_item_total:
|
|
type: number
|
|
title: original_item_total
|
|
description: The claim's original item total.
|
|
original_item_subtotal:
|
|
type: number
|
|
title: original_item_subtotal
|
|
description: The claim's original item subtotal.
|
|
original_item_tax_total:
|
|
type: number
|
|
title: original_item_tax_total
|
|
description: The claim's original item tax total.
|
|
item_total:
|
|
type: number
|
|
title: item_total
|
|
description: The claim's item total.
|
|
item_subtotal:
|
|
type: number
|
|
title: item_subtotal
|
|
description: The claim's item subtotal.
|
|
item_tax_total:
|
|
type: number
|
|
title: item_tax_total
|
|
description: The claim's item tax total.
|
|
original_total:
|
|
type: number
|
|
title: original_total
|
|
description: The claim's original total.
|
|
original_subtotal:
|
|
type: number
|
|
title: original_subtotal
|
|
description: The claim's original subtotal.
|
|
original_tax_total:
|
|
type: number
|
|
title: original_tax_total
|
|
description: The claim's original tax total.
|
|
total:
|
|
type: number
|
|
title: total
|
|
description: The claim's total.
|
|
subtotal:
|
|
type: number
|
|
title: subtotal
|
|
description: The claim's subtotal.
|
|
tax_total:
|
|
type: number
|
|
title: tax_total
|
|
description: The claim's tax total.
|
|
discount_total:
|
|
type: number
|
|
title: discount_total
|
|
description: The claim's discount total.
|
|
discount_tax_total:
|
|
type: number
|
|
title: discount_tax_total
|
|
description: The claim's discount tax total.
|
|
gift_card_total:
|
|
type: number
|
|
title: gift_card_total
|
|
description: The claim's gift card total.
|
|
gift_card_tax_total:
|
|
type: number
|
|
title: gift_card_tax_total
|
|
description: The claim's gift card tax total.
|
|
shipping_total:
|
|
type: number
|
|
title: shipping_total
|
|
description: The claim's shipping total.
|
|
shipping_subtotal:
|
|
type: number
|
|
title: shipping_subtotal
|
|
description: The claim's shipping subtotal.
|
|
shipping_tax_total:
|
|
type: number
|
|
title: shipping_tax_total
|
|
description: The claim's shipping tax total.
|
|
original_shipping_total:
|
|
type: number
|
|
title: original_shipping_total
|
|
description: The claim's original shipping total.
|
|
original_shipping_subtotal:
|
|
type: number
|
|
title: original_shipping_subtotal
|
|
description: The claim's original shipping subtotal.
|
|
original_shipping_tax_total:
|
|
type: number
|
|
title: original_shipping_tax_total
|
|
description: The claim's original shipping tax total.
|
|
AdminClaimDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminClaimDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The claim's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The claim's object.
|
|
default: claim
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The claim's deleted.
|
|
parent:
|
|
type: object
|
|
description: The claim's parent.
|
|
AdminClaimListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminClaimListResponse
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
- claims
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The claim's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The claim's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The claim's count.
|
|
claims:
|
|
type: array
|
|
description: The claim's claims.
|
|
items:
|
|
$ref: '#/components/schemas/AdminClaim'
|
|
AdminClaimOrderResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminClaimOrderResponse
|
|
required:
|
|
- order
|
|
- claim
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/Order'
|
|
claim:
|
|
$ref: '#/components/schemas/AdminClaim'
|
|
AdminClaimPreviewResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminClaimPreviewResponse
|
|
required:
|
|
- order_preview
|
|
- claim
|
|
properties:
|
|
order_preview:
|
|
$ref: '#/components/schemas/OrderPreview'
|
|
claim:
|
|
$ref: '#/components/schemas/AdminClaim'
|
|
AdminClaimRequestResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminClaimRequestResponse
|
|
required:
|
|
- return
|
|
- order_preview
|
|
- claim
|
|
properties:
|
|
return:
|
|
$ref: '#/components/schemas/AdminReturn'
|
|
order_preview:
|
|
$ref: '#/components/schemas/OrderPreview'
|
|
claim:
|
|
$ref: '#/components/schemas/AdminClaim'
|
|
AdminClaimResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminClaimResponse
|
|
required:
|
|
- claim
|
|
properties:
|
|
claim:
|
|
$ref: '#/components/schemas/AdminClaim'
|
|
AdminClaimReturnPreviewResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminClaimReturnPreviewResponse
|
|
required:
|
|
- order_preview
|
|
- return
|
|
properties:
|
|
order_preview:
|
|
$ref: '#/components/schemas/OrderPreview'
|
|
return:
|
|
$ref: '#/components/schemas/AdminReturn'
|
|
AdminCollection:
|
|
type: object
|
|
description: The parent's collection.
|
|
x-schemaName: AdminCollection
|
|
required:
|
|
- id
|
|
- title
|
|
- handle
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
- metadata
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The collection's ID.
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The collection's title.
|
|
handle:
|
|
type: string
|
|
title: handle
|
|
description: The collection's handle.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The collection's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The collection's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The collection's deleted at.
|
|
products:
|
|
type: array
|
|
description: The collection's products.
|
|
items:
|
|
type: object
|
|
metadata:
|
|
type: object
|
|
description: The collection's metadata.
|
|
AdminCollectionDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCollectionDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The collection's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The collection's object.
|
|
default: collection
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The collection's deleted.
|
|
parent:
|
|
type: object
|
|
description: The collection's parent.
|
|
AdminCollectionListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCollectionListResponse
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
- collections
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The collection's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The collection's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The collection's count.
|
|
collections:
|
|
type: array
|
|
description: The collection's collections.
|
|
items:
|
|
$ref: '#/components/schemas/AdminCollection'
|
|
AdminCollectionResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCollectionResponse
|
|
required:
|
|
- collection
|
|
properties:
|
|
collection:
|
|
$ref: '#/components/schemas/AdminCollection'
|
|
AdminCreateApiKey:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCreateApiKey
|
|
required:
|
|
- title
|
|
- type
|
|
properties:
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The api key's title.
|
|
type:
|
|
type: string
|
|
enum:
|
|
- publishable
|
|
- secret
|
|
AdminCreateCollection:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCreateCollection
|
|
required:
|
|
- title
|
|
- metadata
|
|
properties:
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The collection's title.
|
|
handle:
|
|
type: string
|
|
title: handle
|
|
description: The collection's handle.
|
|
metadata:
|
|
type: object
|
|
description: The collection's metadata.
|
|
AdminCreateCustomerGroup:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCreateCustomerGroup
|
|
required:
|
|
- name
|
|
- metadata
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The customer group's name.
|
|
metadata:
|
|
type: object
|
|
description: The customer group's metadata.
|
|
AdminCreateFulfillment:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCreateFulfillment
|
|
required:
|
|
- location_id
|
|
- provider_id
|
|
- delivery_address
|
|
- items
|
|
- labels
|
|
- order
|
|
- order_id
|
|
- shipping_option_id
|
|
- data
|
|
- packed_at
|
|
- shipped_at
|
|
- delivered_at
|
|
- canceled_at
|
|
- metadata
|
|
properties:
|
|
location_id:
|
|
type: string
|
|
title: location_id
|
|
description: The fulfillment's location id.
|
|
provider_id:
|
|
type: string
|
|
title: provider_id
|
|
description: The fulfillment's provider id.
|
|
delivery_address:
|
|
type: object
|
|
description: The fulfillment's delivery address.
|
|
required:
|
|
- first_name
|
|
- last_name
|
|
- phone
|
|
- company
|
|
- address_1
|
|
- address_2
|
|
- city
|
|
- country_code
|
|
- province
|
|
- postal_code
|
|
- metadata
|
|
properties:
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The delivery address's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The delivery address's last name.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The delivery address's phone.
|
|
company:
|
|
type: string
|
|
title: company
|
|
description: The delivery address's company.
|
|
address_1:
|
|
type: string
|
|
title: address_1
|
|
description: The delivery address's address 1.
|
|
address_2:
|
|
type: string
|
|
title: address_2
|
|
description: The delivery address's address 2.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The delivery address's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The delivery address's country code.
|
|
province:
|
|
type: string
|
|
title: province
|
|
description: The delivery address's province.
|
|
postal_code:
|
|
type: string
|
|
title: postal_code
|
|
description: The delivery address's postal code.
|
|
metadata:
|
|
type: object
|
|
description: The delivery address's metadata.
|
|
items:
|
|
type: array
|
|
description: The fulfillment's items.
|
|
items:
|
|
type: object
|
|
description: The item's items.
|
|
required:
|
|
- title
|
|
- sku
|
|
- quantity
|
|
- barcode
|
|
- line_item_id
|
|
- inventory_item_id
|
|
properties:
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The item's title.
|
|
sku:
|
|
type: string
|
|
title: sku
|
|
description: The item's sku.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The item's quantity.
|
|
barcode:
|
|
type: string
|
|
title: barcode
|
|
description: The item's barcode.
|
|
line_item_id:
|
|
type: string
|
|
title: line_item_id
|
|
description: The item's line item id.
|
|
inventory_item_id:
|
|
type: string
|
|
title: inventory_item_id
|
|
description: The item's inventory item id.
|
|
labels:
|
|
type: array
|
|
description: The fulfillment's labels.
|
|
items:
|
|
type: object
|
|
description: The label's labels.
|
|
required:
|
|
- tracking_number
|
|
- tracking_url
|
|
- label_url
|
|
properties:
|
|
tracking_number:
|
|
type: string
|
|
title: tracking_number
|
|
description: The label's tracking number.
|
|
tracking_url:
|
|
type: string
|
|
title: tracking_url
|
|
description: The label's tracking url.
|
|
label_url:
|
|
type: string
|
|
title: label_url
|
|
description: The label's label url.
|
|
order:
|
|
type: object
|
|
description: The fulfillment's order.
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The fulfillment's order id.
|
|
shipping_option_id:
|
|
type: string
|
|
title: shipping_option_id
|
|
description: The fulfillment's shipping option id.
|
|
data:
|
|
type: object
|
|
description: The fulfillment's data.
|
|
packed_at:
|
|
type: string
|
|
title: packed_at
|
|
description: The fulfillment's packed at.
|
|
format: date-time
|
|
shipped_at:
|
|
type: string
|
|
title: shipped_at
|
|
description: The fulfillment's shipped at.
|
|
format: date-time
|
|
delivered_at:
|
|
type: string
|
|
title: delivered_at
|
|
description: The fulfillment's delivered at.
|
|
format: date-time
|
|
canceled_at:
|
|
type: string
|
|
title: canceled_at
|
|
description: The fulfillment's canceled at.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: The fulfillment's metadata.
|
|
AdminCreatePriceList:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCreatePriceList
|
|
required:
|
|
- title
|
|
- description
|
|
- starts_at
|
|
- ends_at
|
|
properties:
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The price list's title.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The price list's description.
|
|
starts_at:
|
|
type: string
|
|
title: starts_at
|
|
description: The price list's starts at.
|
|
ends_at:
|
|
type: string
|
|
title: ends_at
|
|
description: The price list's ends at.
|
|
status:
|
|
type: string
|
|
enum:
|
|
- active
|
|
- draft
|
|
type:
|
|
type: string
|
|
enum:
|
|
- sale
|
|
- override
|
|
rules:
|
|
type: object
|
|
description: The price list's rules.
|
|
prices:
|
|
type: array
|
|
description: The price list's prices.
|
|
items:
|
|
type: object
|
|
description: The price's prices.
|
|
required:
|
|
- currency_code
|
|
- amount
|
|
- variant_id
|
|
- min_quantity
|
|
- max_quantity
|
|
properties:
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The price's currency code.
|
|
amount:
|
|
type: number
|
|
title: amount
|
|
description: The price's amount.
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The price's variant id.
|
|
min_quantity:
|
|
type: number
|
|
title: min_quantity
|
|
description: The price's min quantity.
|
|
max_quantity:
|
|
type: number
|
|
title: max_quantity
|
|
description: The price's max quantity.
|
|
rules:
|
|
type: object
|
|
description: The price's rules.
|
|
AdminCreatePricePreference:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCreatePricePreference
|
|
properties:
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The price preference's attribute.
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The price preference's value.
|
|
is_tax_inclusive:
|
|
type: boolean
|
|
title: is_tax_inclusive
|
|
description: The price preference's is tax inclusive.
|
|
AdminCreateProduct:
|
|
type: object
|
|
description: The create's details.
|
|
x-schemaName: AdminCreateProduct
|
|
required:
|
|
- title
|
|
properties:
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The create's title.
|
|
subtitle:
|
|
type: string
|
|
title: subtitle
|
|
description: The create's subtitle.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The create's description.
|
|
is_giftcard:
|
|
type: boolean
|
|
title: is_giftcard
|
|
description: The create's is giftcard.
|
|
discountable:
|
|
type: boolean
|
|
title: discountable
|
|
description: The create's discountable.
|
|
images:
|
|
type: array
|
|
description: The create's images.
|
|
items:
|
|
type: object
|
|
description: The image's images.
|
|
required:
|
|
- url
|
|
properties:
|
|
url:
|
|
type: string
|
|
title: url
|
|
description: The image's url.
|
|
thumbnail:
|
|
type: string
|
|
title: thumbnail
|
|
description: The create's thumbnail.
|
|
handle:
|
|
type: string
|
|
title: handle
|
|
description: The create's handle.
|
|
status:
|
|
type: string
|
|
enum:
|
|
- draft
|
|
- proposed
|
|
- published
|
|
- rejected
|
|
type_id:
|
|
type: string
|
|
title: type_id
|
|
description: The create's type id.
|
|
collection_id:
|
|
type: string
|
|
title: collection_id
|
|
description: The create's collection id.
|
|
categories:
|
|
type: array
|
|
description: The create's categories.
|
|
items:
|
|
type: object
|
|
description: The category's categories.
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The category's ID.
|
|
tags:
|
|
type: array
|
|
description: The create's tags.
|
|
items:
|
|
type: object
|
|
description: The tag's tags.
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The tag's ID.
|
|
options:
|
|
type: array
|
|
description: The create's options.
|
|
items:
|
|
$ref: '#/components/schemas/AdminCreateProductOption'
|
|
variants:
|
|
type: array
|
|
description: The create's variants.
|
|
items:
|
|
$ref: '#/components/schemas/AdminCreateProductVariant'
|
|
sales_channels:
|
|
type: array
|
|
description: The create's sales channels.
|
|
items:
|
|
type: object
|
|
description: The sales channel's sales channels.
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The sales channel's ID.
|
|
weight:
|
|
type: number
|
|
title: weight
|
|
description: The create's weight.
|
|
length:
|
|
type: number
|
|
title: length
|
|
description: The create's length.
|
|
height:
|
|
type: number
|
|
title: height
|
|
description: The create's height.
|
|
width:
|
|
type: number
|
|
title: width
|
|
description: The create's width.
|
|
hs_code:
|
|
type: string
|
|
title: hs_code
|
|
description: The create's hs code.
|
|
mid_code:
|
|
type: string
|
|
title: mid_code
|
|
description: The create's mid code.
|
|
origin_country:
|
|
type: string
|
|
title: origin_country
|
|
description: The create's origin country.
|
|
material:
|
|
type: string
|
|
title: material
|
|
description: The create's material.
|
|
metadata:
|
|
type: object
|
|
description: The create's metadata.
|
|
AdminCreateProductOption:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCreateProductOption
|
|
required:
|
|
- title
|
|
- values
|
|
properties:
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The product's title.
|
|
values:
|
|
type: array
|
|
description: The product's values.
|
|
items:
|
|
type: string
|
|
title: values
|
|
description: The value's values.
|
|
AdminCreateProductVariant:
|
|
type: object
|
|
description: The create's details.
|
|
x-schemaName: AdminCreateProductVariant
|
|
required:
|
|
- title
|
|
- prices
|
|
properties:
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The create's title.
|
|
sku:
|
|
type: string
|
|
title: sku
|
|
description: The create's sku.
|
|
ean:
|
|
type: string
|
|
title: ean
|
|
description: The create's ean.
|
|
upc:
|
|
type: string
|
|
title: upc
|
|
description: The create's upc.
|
|
barcode:
|
|
type: string
|
|
title: barcode
|
|
description: The create's barcode.
|
|
hs_code:
|
|
type: string
|
|
title: hs_code
|
|
description: The create's hs code.
|
|
mid_code:
|
|
type: string
|
|
title: mid_code
|
|
description: The create's mid code.
|
|
allow_backorder:
|
|
type: boolean
|
|
title: allow_backorder
|
|
description: The create's allow backorder.
|
|
manage_inventory:
|
|
type: boolean
|
|
title: manage_inventory
|
|
description: The create's manage inventory.
|
|
variant_rank:
|
|
type: number
|
|
title: variant_rank
|
|
description: The create's variant rank.
|
|
weight:
|
|
type: number
|
|
title: weight
|
|
description: The create's weight.
|
|
length:
|
|
type: number
|
|
title: length
|
|
description: The create's length.
|
|
height:
|
|
type: number
|
|
title: height
|
|
description: The create's height.
|
|
width:
|
|
type: number
|
|
title: width
|
|
description: The create's width.
|
|
origin_country:
|
|
type: string
|
|
title: origin_country
|
|
description: The create's origin country.
|
|
material:
|
|
type: string
|
|
title: material
|
|
description: The create's material.
|
|
metadata:
|
|
type: object
|
|
description: The create's metadata.
|
|
prices:
|
|
type: array
|
|
description: The create's prices.
|
|
items:
|
|
$ref: '#/components/schemas/AdminCreateProductVariantPrice'
|
|
options:
|
|
type: object
|
|
description: The create's options.
|
|
AdminCreateProductVariantPrice:
|
|
type: object
|
|
description: The price's prices.
|
|
x-schemaName: AdminCreateProductVariantPrice
|
|
required:
|
|
- currency_code
|
|
- amount
|
|
properties:
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The price's currency code.
|
|
amount:
|
|
type: number
|
|
title: amount
|
|
description: The price's amount.
|
|
min_quantity:
|
|
type: number
|
|
title: min_quantity
|
|
description: The price's min quantity.
|
|
max_quantity:
|
|
type: number
|
|
title: max_quantity
|
|
description: The price's max quantity.
|
|
rules:
|
|
type: object
|
|
description: The price's rules.
|
|
AdminCreateSalesChannel:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCreateSalesChannel
|
|
required:
|
|
- name
|
|
- description
|
|
- metadata
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The sales channel's name.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The sales channel's description.
|
|
is_disabled:
|
|
type: boolean
|
|
title: is_disabled
|
|
description: The sales channel's is disabled.
|
|
metadata:
|
|
type: object
|
|
description: The sales channel's metadata.
|
|
AdminCreateShipment:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCreateShipment
|
|
required:
|
|
- labels
|
|
properties:
|
|
labels:
|
|
type: array
|
|
description: The fulfillment's labels.
|
|
items:
|
|
type: object
|
|
description: The label's labels.
|
|
required:
|
|
- tracking_number
|
|
- tracking_url
|
|
- label_url
|
|
properties:
|
|
tracking_number:
|
|
type: string
|
|
title: tracking_number
|
|
description: The label's tracking number.
|
|
tracking_url:
|
|
type: string
|
|
title: tracking_url
|
|
description: The label's tracking url.
|
|
label_url:
|
|
type: string
|
|
title: label_url
|
|
description: The label's label url.
|
|
AdminCreateStockLocation:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCreateStockLocation
|
|
required:
|
|
- name
|
|
- address_id
|
|
- metadata
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The stock location's name.
|
|
address:
|
|
type: object
|
|
description: The stock location's address.
|
|
required:
|
|
- address_1
|
|
- address_2
|
|
- company
|
|
- city
|
|
- country_code
|
|
- phone
|
|
- postal_code
|
|
- province
|
|
properties:
|
|
address_1:
|
|
type: string
|
|
title: address_1
|
|
description: The address's address 1.
|
|
address_2:
|
|
type: string
|
|
title: address_2
|
|
description: The address's address 2.
|
|
company:
|
|
type: string
|
|
title: company
|
|
description: The address's company.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The address's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The address's country code.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The address's phone.
|
|
postal_code:
|
|
type: string
|
|
title: postal_code
|
|
description: The address's postal code.
|
|
province:
|
|
type: string
|
|
title: province
|
|
description: The address's province.
|
|
address_id:
|
|
type: string
|
|
title: address_id
|
|
description: The stock location's address id.
|
|
metadata:
|
|
type: object
|
|
description: The stock location's metadata.
|
|
AdminCreateTaxRate:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCreateTaxRate
|
|
required:
|
|
- name
|
|
- tax_region_id
|
|
- metadata
|
|
properties:
|
|
rate:
|
|
type: number
|
|
title: rate
|
|
description: The tax rate's rate.
|
|
code:
|
|
type: string
|
|
title: code
|
|
description: The tax rate's code.
|
|
rules:
|
|
type: array
|
|
description: The tax rate's rules.
|
|
items:
|
|
type: object
|
|
description: The rule's rules.
|
|
required:
|
|
- reference
|
|
- reference_id
|
|
properties:
|
|
reference:
|
|
type: string
|
|
title: reference
|
|
description: The rule's reference.
|
|
reference_id:
|
|
type: string
|
|
title: reference_id
|
|
description: The rule's reference id.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The tax rate's name.
|
|
is_default:
|
|
type: boolean
|
|
title: is_default
|
|
description: The tax rate's is default.
|
|
is_combinable:
|
|
type: boolean
|
|
title: is_combinable
|
|
description: The tax rate's is combinable.
|
|
tax_region_id:
|
|
type: string
|
|
title: tax_region_id
|
|
description: The tax rate's tax region id.
|
|
metadata:
|
|
type: object
|
|
description: The tax rate's metadata.
|
|
AdminCreateTaxRateRule:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCreateTaxRateRule
|
|
required:
|
|
- reference
|
|
- reference_id
|
|
properties:
|
|
reference:
|
|
type: string
|
|
title: reference
|
|
description: The tax rate's reference.
|
|
reference_id:
|
|
type: string
|
|
title: reference_id
|
|
description: The tax rate's reference id.
|
|
AdminCreateTaxRegion:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCreateTaxRegion
|
|
required:
|
|
- country_code
|
|
- province_code
|
|
- parent_id
|
|
- metadata
|
|
properties:
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The tax region's country code.
|
|
province_code:
|
|
type: string
|
|
title: province_code
|
|
description: The tax region's province code.
|
|
parent_id:
|
|
type: string
|
|
title: parent_id
|
|
description: The tax region's parent id.
|
|
default_tax_rate:
|
|
type: object
|
|
description: The tax region's default tax rate.
|
|
required:
|
|
- name
|
|
- metadata
|
|
properties:
|
|
rate:
|
|
type: number
|
|
title: rate
|
|
description: The default tax rate's rate.
|
|
code:
|
|
type: string
|
|
title: code
|
|
description: The default tax rate's code.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The default tax rate's name.
|
|
is_combinable:
|
|
type: boolean
|
|
title: is_combinable
|
|
description: The default tax rate's is combinable.
|
|
metadata:
|
|
type: object
|
|
description: The default tax rate's metadata.
|
|
metadata:
|
|
type: object
|
|
description: The tax region's metadata.
|
|
AdminCreateVariantInventoryItem:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCreateVariantInventoryItem
|
|
required:
|
|
- required_quantity
|
|
- inventory_item_id
|
|
properties:
|
|
required_quantity:
|
|
type: number
|
|
title: required_quantity
|
|
description: The product's required quantity.
|
|
inventory_item_id:
|
|
type: string
|
|
title: inventory_item_id
|
|
description: The product's inventory item id.
|
|
AdminCreateWorkflowsAsyncResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCreateWorkflowsAsyncResponse
|
|
required:
|
|
- transaction_id
|
|
- step_id
|
|
properties:
|
|
transaction_id:
|
|
type: string
|
|
title: transaction_id
|
|
description: The workflows execution's transaction id.
|
|
step_id:
|
|
type: string
|
|
title: step_id
|
|
description: The workflows execution's step id.
|
|
response: {}
|
|
compensate_input: {}
|
|
action:
|
|
type: string
|
|
enum:
|
|
- invoke
|
|
- compensate
|
|
AdminCreateWorkflowsRun:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCreateWorkflowsRun
|
|
properties:
|
|
input: {}
|
|
transaction_id:
|
|
type: string
|
|
title: transaction_id
|
|
description: The workflows execution's transaction id.
|
|
AdminCurrency:
|
|
type: object
|
|
description: The supported currency's currency.
|
|
x-schemaName: AdminCurrency
|
|
AdminCurrencyListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCurrencyListResponse
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
- currencies
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The currency's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The currency's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The currency's count.
|
|
currencies:
|
|
type: array
|
|
description: The currency's currencies.
|
|
items:
|
|
$ref: '#/components/schemas/AdminCurrency'
|
|
AdminCurrencyResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCurrencyResponse
|
|
required:
|
|
- currency
|
|
properties:
|
|
currency:
|
|
$ref: '#/components/schemas/AdminCurrency'
|
|
AdminCustomer:
|
|
type: object
|
|
description: The customer's details.
|
|
x-schemaName: AdminCustomer
|
|
required:
|
|
- has_account
|
|
- id
|
|
- email
|
|
- default_billing_address_id
|
|
- default_shipping_address_id
|
|
- company_name
|
|
- first_name
|
|
- last_name
|
|
- addresses
|
|
properties:
|
|
has_account:
|
|
type: boolean
|
|
title: has_account
|
|
description: The customer's has account.
|
|
groups:
|
|
type: array
|
|
description: The customer's groups.
|
|
items:
|
|
$ref: '#/components/schemas/AdminCustomerGroup'
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The customer's ID.
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The customer's email.
|
|
format: email
|
|
default_billing_address_id:
|
|
type: string
|
|
title: default_billing_address_id
|
|
description: The customer's default billing address id.
|
|
default_shipping_address_id:
|
|
type: string
|
|
title: default_shipping_address_id
|
|
description: The customer's default shipping address id.
|
|
company_name:
|
|
type: string
|
|
title: company_name
|
|
description: The customer's company name.
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The customer's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The customer's last name.
|
|
addresses:
|
|
type: array
|
|
description: The customer's addresses.
|
|
items:
|
|
$ref: '#/components/schemas/BaseCustomerAddress'
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The customer's phone.
|
|
metadata:
|
|
type: object
|
|
description: The customer's metadata.
|
|
created_by:
|
|
type: string
|
|
title: created_by
|
|
description: The customer's created by.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The customer's deleted at.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The customer's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The customer's updated at.
|
|
AdminCustomerAddress:
|
|
type: object
|
|
description: The customer's address.
|
|
x-schemaName: AdminCustomerAddress
|
|
required:
|
|
- id
|
|
- address_name
|
|
- is_default_shipping
|
|
- is_default_billing
|
|
- customer_id
|
|
- company
|
|
- first_name
|
|
- last_name
|
|
- address_1
|
|
- address_2
|
|
- city
|
|
- country_code
|
|
- province
|
|
- postal_code
|
|
- phone
|
|
- metadata
|
|
- created_at
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The address's ID.
|
|
address_name:
|
|
type: string
|
|
title: address_name
|
|
description: The address's address name.
|
|
is_default_shipping:
|
|
type: boolean
|
|
title: is_default_shipping
|
|
description: The address's is default shipping.
|
|
is_default_billing:
|
|
type: boolean
|
|
title: is_default_billing
|
|
description: The address's is default billing.
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The address's customer id.
|
|
company:
|
|
type: string
|
|
title: company
|
|
description: The address's company.
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The address's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The address's last name.
|
|
address_1:
|
|
type: string
|
|
title: address_1
|
|
description: The address's address 1.
|
|
address_2:
|
|
type: string
|
|
title: address_2
|
|
description: The address's address 2.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The address's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The address's country code.
|
|
province:
|
|
type: string
|
|
title: province
|
|
description: The address's province.
|
|
postal_code:
|
|
type: string
|
|
title: postal_code
|
|
description: The address's postal code.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The address's phone.
|
|
metadata:
|
|
type: object
|
|
description: The address's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The address's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The address's updated at.
|
|
AdminCustomerAddressResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCustomerAddressResponse
|
|
required:
|
|
- address
|
|
properties:
|
|
address:
|
|
$ref: '#/components/schemas/AdminCustomerAddress'
|
|
AdminCustomerGroup:
|
|
type: object
|
|
description: The group's groups.
|
|
x-schemaName: AdminCustomerGroup
|
|
required:
|
|
- id
|
|
- name
|
|
- customers
|
|
- metadata
|
|
- created_at
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The group's ID.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The group's name.
|
|
customers:
|
|
type: array
|
|
description: The group's customers.
|
|
items:
|
|
$ref: '#/components/schemas/BaseCustomer'
|
|
metadata:
|
|
type: object
|
|
description: The group's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The group's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The group's updated at.
|
|
AdminCustomerGroupResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCustomerGroupResponse
|
|
required:
|
|
- customer_group
|
|
properties:
|
|
customer_group:
|
|
$ref: '#/components/schemas/AdminCustomerGroup'
|
|
AdminCustomerResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminCustomerResponse
|
|
required:
|
|
- customer
|
|
properties:
|
|
customer:
|
|
$ref: '#/components/schemas/AdminCustomer'
|
|
AdminDraftOrderResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminDraftOrderResponse
|
|
required:
|
|
- draft_order
|
|
properties:
|
|
draft_order:
|
|
$ref: '#/components/schemas/AdminOrder'
|
|
AdminExchange:
|
|
type: object
|
|
description: The exchange's details.
|
|
x-schemaName: AdminExchange
|
|
required:
|
|
- order_id
|
|
- return_items
|
|
- additional_items
|
|
- currency_code
|
|
- id
|
|
- region_id
|
|
- customer_id
|
|
- sales_channel_id
|
|
- email
|
|
- shipping_methods
|
|
- payment_status
|
|
- fulfillment_status
|
|
- summary
|
|
- metadata
|
|
- created_at
|
|
- updated_at
|
|
- original_item_total
|
|
- original_item_subtotal
|
|
- original_item_tax_total
|
|
- item_total
|
|
- item_subtotal
|
|
- item_tax_total
|
|
- original_total
|
|
- original_subtotal
|
|
- original_tax_total
|
|
- total
|
|
- subtotal
|
|
- tax_total
|
|
- discount_total
|
|
- discount_tax_total
|
|
- gift_card_total
|
|
- gift_card_tax_total
|
|
- shipping_total
|
|
- shipping_subtotal
|
|
- shipping_tax_total
|
|
- original_shipping_total
|
|
- original_shipping_subtotal
|
|
- original_shipping_tax_total
|
|
properties:
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The exchange's order id.
|
|
return_items:
|
|
type: array
|
|
description: The exchange's return items.
|
|
items:
|
|
$ref: '#/components/schemas/AdminReturnItem'
|
|
additional_items:
|
|
type: array
|
|
description: The exchange's additional items.
|
|
items:
|
|
$ref: '#/components/schemas/BaseExchangeItem'
|
|
no_notification:
|
|
type: boolean
|
|
title: no_notification
|
|
description: The exchange's no notification.
|
|
difference_due:
|
|
type: number
|
|
title: difference_due
|
|
description: The exchange's difference due.
|
|
return:
|
|
$ref: '#/components/schemas/AdminReturn'
|
|
return_id:
|
|
type: string
|
|
title: return_id
|
|
description: The exchange's return id.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The exchange's currency code.
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The exchange's ID.
|
|
region_id:
|
|
type: string
|
|
title: region_id
|
|
description: The exchange's region id.
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The exchange's customer id.
|
|
sales_channel_id:
|
|
type: string
|
|
title: sales_channel_id
|
|
description: The exchange's sales channel id.
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The exchange's email.
|
|
format: email
|
|
display_id:
|
|
type: string
|
|
title: display_id
|
|
description: The exchange's display id.
|
|
shipping_address:
|
|
$ref: '#/components/schemas/BaseOrderAddress'
|
|
billing_address:
|
|
$ref: '#/components/schemas/BaseOrderAddress'
|
|
shipping_methods:
|
|
type: array
|
|
description: The exchange's shipping methods.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderShippingMethod'
|
|
payment_collections:
|
|
type: array
|
|
description: The exchange's payment collections.
|
|
items:
|
|
$ref: '#/components/schemas/BasePaymentCollection'
|
|
payment_status:
|
|
type: string
|
|
enum:
|
|
- canceled
|
|
- not_paid
|
|
- awaiting
|
|
- authorized
|
|
- partially_authorized
|
|
- captured
|
|
- partially_captured
|
|
- partially_refunded
|
|
- refunded
|
|
- requires_action
|
|
fulfillments:
|
|
type: array
|
|
description: The exchange's fulfillments.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderFulfillment'
|
|
fulfillment_status:
|
|
type: string
|
|
enum:
|
|
- canceled
|
|
- not_fulfilled
|
|
- partially_fulfilled
|
|
- fulfilled
|
|
- partially_shipped
|
|
- shipped
|
|
- partially_delivered
|
|
- delivered
|
|
transactions:
|
|
type: array
|
|
description: The exchange's transactions.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderTransaction'
|
|
summary:
|
|
$ref: '#/components/schemas/BaseOrderSummary'
|
|
metadata:
|
|
type: object
|
|
description: The exchange's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The exchange's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The exchange's updated at.
|
|
original_item_total:
|
|
type: number
|
|
title: original_item_total
|
|
description: The exchange's original item total.
|
|
original_item_subtotal:
|
|
type: number
|
|
title: original_item_subtotal
|
|
description: The exchange's original item subtotal.
|
|
original_item_tax_total:
|
|
type: number
|
|
title: original_item_tax_total
|
|
description: The exchange's original item tax total.
|
|
item_total:
|
|
type: number
|
|
title: item_total
|
|
description: The exchange's item total.
|
|
item_subtotal:
|
|
type: number
|
|
title: item_subtotal
|
|
description: The exchange's item subtotal.
|
|
item_tax_total:
|
|
type: number
|
|
title: item_tax_total
|
|
description: The exchange's item tax total.
|
|
original_total:
|
|
type: number
|
|
title: original_total
|
|
description: The exchange's original total.
|
|
original_subtotal:
|
|
type: number
|
|
title: original_subtotal
|
|
description: The exchange's original subtotal.
|
|
original_tax_total:
|
|
type: number
|
|
title: original_tax_total
|
|
description: The exchange's original tax total.
|
|
total:
|
|
type: number
|
|
title: total
|
|
description: The exchange's total.
|
|
subtotal:
|
|
type: number
|
|
title: subtotal
|
|
description: The exchange's subtotal.
|
|
tax_total:
|
|
type: number
|
|
title: tax_total
|
|
description: The exchange's tax total.
|
|
discount_total:
|
|
type: number
|
|
title: discount_total
|
|
description: The exchange's discount total.
|
|
discount_tax_total:
|
|
type: number
|
|
title: discount_tax_total
|
|
description: The exchange's discount tax total.
|
|
gift_card_total:
|
|
type: number
|
|
title: gift_card_total
|
|
description: The exchange's gift card total.
|
|
gift_card_tax_total:
|
|
type: number
|
|
title: gift_card_tax_total
|
|
description: The exchange's gift card tax total.
|
|
shipping_total:
|
|
type: number
|
|
title: shipping_total
|
|
description: The exchange's shipping total.
|
|
shipping_subtotal:
|
|
type: number
|
|
title: shipping_subtotal
|
|
description: The exchange's shipping subtotal.
|
|
shipping_tax_total:
|
|
type: number
|
|
title: shipping_tax_total
|
|
description: The exchange's shipping tax total.
|
|
original_shipping_total:
|
|
type: number
|
|
title: original_shipping_total
|
|
description: The exchange's original shipping total.
|
|
original_shipping_subtotal:
|
|
type: number
|
|
title: original_shipping_subtotal
|
|
description: The exchange's original shipping subtotal.
|
|
original_shipping_tax_total:
|
|
type: number
|
|
title: original_shipping_tax_total
|
|
description: The exchange's original shipping tax total.
|
|
AdminExchangeOrderResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminExchangeOrderResponse
|
|
required:
|
|
- order
|
|
- exchange
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/Order'
|
|
exchange:
|
|
$ref: '#/components/schemas/AdminExchange'
|
|
AdminExchangePreviewResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminExchangePreviewResponse
|
|
required:
|
|
- order_preview
|
|
- exchange
|
|
properties:
|
|
order_preview:
|
|
$ref: '#/components/schemas/OrderPreview'
|
|
exchange:
|
|
$ref: '#/components/schemas/AdminExchange'
|
|
AdminExchangeRequestResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminExchangeRequestResponse
|
|
required:
|
|
- return
|
|
- order_preview
|
|
- exchange
|
|
properties:
|
|
return:
|
|
$ref: '#/components/schemas/AdminReturn'
|
|
order_preview:
|
|
$ref: '#/components/schemas/OrderPreview'
|
|
exchange:
|
|
$ref: '#/components/schemas/AdminExchange'
|
|
AdminExchangeResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminExchangeResponse
|
|
required:
|
|
- exchange
|
|
properties:
|
|
exchange:
|
|
$ref: '#/components/schemas/AdminExchange'
|
|
AdminExchangeReturnResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminExchangeReturnResponse
|
|
required:
|
|
- order_preview
|
|
- return
|
|
properties:
|
|
order_preview:
|
|
$ref: '#/components/schemas/OrderPreview'
|
|
return:
|
|
$ref: '#/components/schemas/AdminReturn'
|
|
AdminExportProductRequest:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminExportProductRequest
|
|
AdminExportProductResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminExportProductResponse
|
|
required:
|
|
- transaction_id
|
|
properties:
|
|
transaction_id:
|
|
type: string
|
|
title: transaction_id
|
|
description: The product's transaction id.
|
|
AdminFile:
|
|
type: object
|
|
description: The upload's file.
|
|
x-schemaName: AdminFile
|
|
required:
|
|
- id
|
|
- url
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The file's ID.
|
|
url:
|
|
type: string
|
|
title: url
|
|
description: The file's url.
|
|
AdminFileListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminFileListResponse
|
|
required:
|
|
- files
|
|
properties:
|
|
files:
|
|
type: array
|
|
description: The upload's files.
|
|
items:
|
|
$ref: '#/components/schemas/AdminFile'
|
|
AdminFileResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminFileResponse
|
|
required:
|
|
- file
|
|
properties:
|
|
file:
|
|
$ref: '#/components/schemas/AdminFile'
|
|
AdminFulfillment:
|
|
type: object
|
|
description: The fulfillment's details.
|
|
x-schemaName: AdminFulfillment
|
|
required:
|
|
- id
|
|
- location_id
|
|
- provider_id
|
|
- shipping_option_id
|
|
- provider
|
|
- delivery_address
|
|
- items
|
|
- labels
|
|
- packed_at
|
|
- shipped_at
|
|
- delivered_at
|
|
- canceled_at
|
|
- data
|
|
- metadata
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The fulfillment's ID.
|
|
location_id:
|
|
type: string
|
|
title: location_id
|
|
description: The fulfillment's location id.
|
|
provider_id:
|
|
type: string
|
|
title: provider_id
|
|
description: The fulfillment's provider id.
|
|
shipping_option_id:
|
|
type: string
|
|
title: shipping_option_id
|
|
description: The fulfillment's shipping option id.
|
|
provider:
|
|
$ref: '#/components/schemas/AdminFulfillmentProvider'
|
|
delivery_address:
|
|
$ref: '#/components/schemas/AdminFulfillmentAddress'
|
|
items:
|
|
type: array
|
|
description: The fulfillment's items.
|
|
items:
|
|
$ref: '#/components/schemas/AdminFulfillmentItem'
|
|
labels:
|
|
type: array
|
|
description: The fulfillment's labels.
|
|
items:
|
|
$ref: '#/components/schemas/AdminFulfillmentLabel'
|
|
packed_at:
|
|
type: string
|
|
title: packed_at
|
|
description: The fulfillment's packed at.
|
|
shipped_at:
|
|
type: string
|
|
title: shipped_at
|
|
description: The fulfillment's shipped at.
|
|
delivered_at:
|
|
type: string
|
|
title: delivered_at
|
|
description: The fulfillment's delivered at.
|
|
canceled_at:
|
|
type: string
|
|
title: canceled_at
|
|
description: The fulfillment's canceled at.
|
|
data:
|
|
type: object
|
|
description: The fulfillment's data.
|
|
metadata:
|
|
type: object
|
|
description: The fulfillment's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The fulfillment's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The fulfillment's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The fulfillment's deleted at.
|
|
AdminFulfillmentAddress:
|
|
type: object
|
|
description: The fulfillment's delivery address.
|
|
x-schemaName: AdminFulfillmentAddress
|
|
required:
|
|
- id
|
|
- fulfillment_id
|
|
- company
|
|
- first_name
|
|
- last_name
|
|
- address_1
|
|
- address_2
|
|
- city
|
|
- country_code
|
|
- province
|
|
- postal_code
|
|
- phone
|
|
- metadata
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The delivery address's ID.
|
|
fulfillment_id:
|
|
type: string
|
|
title: fulfillment_id
|
|
description: The delivery address's fulfillment id.
|
|
company:
|
|
type: string
|
|
title: company
|
|
description: The delivery address's company.
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The delivery address's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The delivery address's last name.
|
|
address_1:
|
|
type: string
|
|
title: address_1
|
|
description: The delivery address's address 1.
|
|
address_2:
|
|
type: string
|
|
title: address_2
|
|
description: The delivery address's address 2.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The delivery address's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The delivery address's country code.
|
|
province:
|
|
type: string
|
|
title: province
|
|
description: The delivery address's province.
|
|
postal_code:
|
|
type: string
|
|
title: postal_code
|
|
description: The delivery address's postal code.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The delivery address's phone.
|
|
metadata:
|
|
type: object
|
|
description: The delivery address's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The delivery address's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The delivery address's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The delivery address's deleted at.
|
|
AdminFulfillmentItem:
|
|
type: object
|
|
description: The item's items.
|
|
x-schemaName: AdminFulfillmentItem
|
|
required:
|
|
- id
|
|
- title
|
|
- quantity
|
|
- sku
|
|
- barcode
|
|
- line_item_id
|
|
- inventory_item_id
|
|
- fulfillment_id
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The item's ID.
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The item's title.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The item's quantity.
|
|
sku:
|
|
type: string
|
|
title: sku
|
|
description: The item's sku.
|
|
barcode:
|
|
type: string
|
|
title: barcode
|
|
description: The item's barcode.
|
|
line_item_id:
|
|
type: string
|
|
title: line_item_id
|
|
description: The item's line item id.
|
|
inventory_item_id:
|
|
type: string
|
|
title: inventory_item_id
|
|
description: The item's inventory item id.
|
|
fulfillment_id:
|
|
type: string
|
|
title: fulfillment_id
|
|
description: The item's fulfillment id.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The item's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The item's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The item's deleted at.
|
|
AdminFulfillmentLabel:
|
|
type: object
|
|
description: The label's labels.
|
|
x-schemaName: AdminFulfillmentLabel
|
|
required:
|
|
- id
|
|
- tracking_number
|
|
- tracking_url
|
|
- label_url
|
|
- fulfillment_id
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The label's ID.
|
|
tracking_number:
|
|
type: string
|
|
title: tracking_number
|
|
description: The label's tracking number.
|
|
tracking_url:
|
|
type: string
|
|
title: tracking_url
|
|
description: The label's tracking url.
|
|
label_url:
|
|
type: string
|
|
title: label_url
|
|
description: The label's label url.
|
|
fulfillment_id:
|
|
type: string
|
|
title: fulfillment_id
|
|
description: The label's fulfillment id.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The label's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The label's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The label's deleted at.
|
|
AdminFulfillmentProvider:
|
|
type: object
|
|
description: The fulfillment provider's fulfillment providers.
|
|
x-schemaName: AdminFulfillmentProvider
|
|
AdminFulfillmentProviderListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminFulfillmentProviderListResponse
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
- fulfillment_providers
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The fulfillment provider's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The fulfillment provider's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The fulfillment provider's count.
|
|
fulfillment_providers:
|
|
type: array
|
|
description: The fulfillment provider's fulfillment providers.
|
|
items:
|
|
$ref: '#/components/schemas/AdminFulfillmentProvider'
|
|
AdminFulfillmentResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminFulfillmentResponse
|
|
required:
|
|
- fulfillment
|
|
properties:
|
|
fulfillment:
|
|
$ref: '#/components/schemas/AdminFulfillment'
|
|
AdminFulfillmentSet:
|
|
type: object
|
|
description: The fulfillment set's details.
|
|
x-schemaName: AdminFulfillmentSet
|
|
required:
|
|
- id
|
|
- name
|
|
- type
|
|
- location
|
|
- service_zones
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The fulfillment set's ID.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The fulfillment set's name.
|
|
type:
|
|
type: string
|
|
title: type
|
|
description: The fulfillment set's type.
|
|
location:
|
|
$ref: '#/components/schemas/AdminStockLocation'
|
|
service_zones:
|
|
type: array
|
|
description: The fulfillment set's service zones.
|
|
items:
|
|
$ref: '#/components/schemas/AdminServiceZone'
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The fulfillment set's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The fulfillment set's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The fulfillment set's deleted at.
|
|
AdminFulfillmentSetDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminFulfillmentSetDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The fulfillment set's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The fulfillment set's object.
|
|
default: fulfillment_set
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The fulfillment set's deleted.
|
|
parent:
|
|
type: object
|
|
description: The fulfillment set's parent.
|
|
AdminFulfillmentSetResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminFulfillmentSetResponse
|
|
required:
|
|
- fulfillment_set
|
|
properties:
|
|
fulfillment_set:
|
|
$ref: '#/components/schemas/AdminFulfillmentSet'
|
|
AdminGeoZone:
|
|
type: object
|
|
description: The geo zone's geo zones.
|
|
x-schemaName: AdminGeoZone
|
|
AdminGetUploadParams:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminGetUploadParams
|
|
properties:
|
|
fields:
|
|
type: string
|
|
title: fields
|
|
description: The upload's fields.
|
|
AdminImportProductRequest:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminImportProductRequest
|
|
required:
|
|
- file
|
|
properties:
|
|
file:
|
|
$ref: '#/components/schemas/File'
|
|
AdminImportProductResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminImportProductResponse
|
|
required:
|
|
- transaction_id
|
|
- summary
|
|
properties:
|
|
transaction_id:
|
|
type: string
|
|
title: transaction_id
|
|
description: The product's transaction id.
|
|
summary:
|
|
type: object
|
|
description: The product's summary.
|
|
required:
|
|
- toCreate
|
|
- toUpdate
|
|
properties:
|
|
toCreate:
|
|
type: number
|
|
title: toCreate
|
|
description: The summary's tocreate.
|
|
toUpdate:
|
|
type: number
|
|
title: toUpdate
|
|
description: The summary's toupdate.
|
|
AdminInventoryItem:
|
|
type: object
|
|
description: The inventory item's details.
|
|
x-schemaName: AdminInventoryItem
|
|
required:
|
|
- id
|
|
- requires_shipping
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The inventory item's ID.
|
|
sku:
|
|
type: string
|
|
title: sku
|
|
description: The inventory item's sku.
|
|
origin_country:
|
|
type: string
|
|
title: origin_country
|
|
description: The inventory item's origin country.
|
|
hs_code:
|
|
type: string
|
|
title: hs_code
|
|
description: The inventory item's hs code.
|
|
requires_shipping:
|
|
type: boolean
|
|
title: requires_shipping
|
|
description: The inventory item's requires shipping.
|
|
mid_code:
|
|
type: string
|
|
title: mid_code
|
|
description: The inventory item's mid code.
|
|
material:
|
|
type: string
|
|
title: material
|
|
description: The inventory item's material.
|
|
weight:
|
|
type: number
|
|
title: weight
|
|
description: The inventory item's weight.
|
|
length:
|
|
type: number
|
|
title: length
|
|
description: The inventory item's length.
|
|
height:
|
|
type: number
|
|
title: height
|
|
description: The inventory item's height.
|
|
width:
|
|
type: number
|
|
title: width
|
|
description: The inventory item's width.
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The inventory item's title.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The inventory item's description.
|
|
thumbnail:
|
|
type: string
|
|
title: thumbnail
|
|
description: The inventory item's thumbnail.
|
|
metadata:
|
|
type: object
|
|
description: The inventory item's metadata.
|
|
AdminInventoryItemResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminInventoryItemResponse
|
|
required:
|
|
- inventory_item
|
|
properties:
|
|
inventory_item:
|
|
$ref: '#/components/schemas/AdminInventoryItem'
|
|
AdminInvite:
|
|
type: object
|
|
description: The invite's details.
|
|
x-schemaName: AdminInvite
|
|
required:
|
|
- id
|
|
- email
|
|
- accepted
|
|
- token
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The invite's ID.
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The invite's email.
|
|
format: email
|
|
accepted:
|
|
type: boolean
|
|
title: accepted
|
|
description: The invite's accepted.
|
|
token:
|
|
type: string
|
|
title: token
|
|
description: The invite's token.
|
|
expires_at:
|
|
type: string
|
|
title: expires_at
|
|
description: The invite's expires at.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: The invite's metadata.
|
|
created_at:
|
|
type: string
|
|
title: created_at
|
|
description: The invite's created at.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
title: updated_at
|
|
description: The invite's updated at.
|
|
format: date-time
|
|
AdminInviteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminInviteResponse
|
|
required:
|
|
- invite
|
|
properties:
|
|
invite:
|
|
$ref: '#/components/schemas/AdminInvite'
|
|
AdminNotification:
|
|
type: object
|
|
description: The notification's details.
|
|
x-schemaName: AdminNotification
|
|
required:
|
|
- id
|
|
- to
|
|
- channel
|
|
- template
|
|
- provider_id
|
|
- created_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The notification's ID.
|
|
to:
|
|
type: string
|
|
title: to
|
|
description: The notification's to.
|
|
channel:
|
|
type: string
|
|
title: channel
|
|
description: The notification's channel.
|
|
template:
|
|
type: string
|
|
title: template
|
|
description: The notification's template.
|
|
data:
|
|
type: object
|
|
description: The notification's data.
|
|
trigger_type:
|
|
type: string
|
|
title: trigger_type
|
|
description: The notification's trigger type.
|
|
resource_id:
|
|
type: string
|
|
title: resource_id
|
|
description: The notification's resource id.
|
|
resource_type:
|
|
type: string
|
|
title: resource_type
|
|
description: The notification's resource type.
|
|
receiver_id:
|
|
type: string
|
|
title: receiver_id
|
|
description: The notification's receiver id.
|
|
original_notification_id:
|
|
type: string
|
|
title: original_notification_id
|
|
description: The notification's original notification id.
|
|
external_id:
|
|
type: string
|
|
title: external_id
|
|
description: The notification's external id.
|
|
provider_id:
|
|
type: string
|
|
title: provider_id
|
|
description: The notification's provider id.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The notification's created at.
|
|
AdminNotificationListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminNotificationListResponse
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
- notifications
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The notification's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The notification's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The notification's count.
|
|
notifications:
|
|
type: array
|
|
description: The notification's notifications.
|
|
items:
|
|
$ref: '#/components/schemas/AdminNotification'
|
|
AdminNotificationResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminNotificationResponse
|
|
required:
|
|
- notification
|
|
properties:
|
|
notification:
|
|
$ref: '#/components/schemas/AdminNotification'
|
|
AdminOrder:
|
|
type: object
|
|
description: The order's details.
|
|
x-schemaName: AdminOrder
|
|
required:
|
|
- payment_collections
|
|
- id
|
|
- version
|
|
- region_id
|
|
- customer_id
|
|
- sales_channel_id
|
|
- email
|
|
- currency_code
|
|
- items
|
|
- shipping_methods
|
|
- payment_status
|
|
- fulfillment_status
|
|
- summary
|
|
- metadata
|
|
- created_at
|
|
- updated_at
|
|
- original_item_total
|
|
- original_item_subtotal
|
|
- original_item_tax_total
|
|
- item_total
|
|
- item_subtotal
|
|
- item_tax_total
|
|
- original_total
|
|
- original_subtotal
|
|
- original_tax_total
|
|
- total
|
|
- subtotal
|
|
- tax_total
|
|
- discount_total
|
|
- discount_tax_total
|
|
- gift_card_total
|
|
- gift_card_tax_total
|
|
- shipping_total
|
|
- shipping_subtotal
|
|
- shipping_tax_total
|
|
- original_shipping_total
|
|
- original_shipping_subtotal
|
|
- original_shipping_tax_total
|
|
properties:
|
|
payment_collections:
|
|
type: array
|
|
description: The order's payment collections.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPaymentCollection'
|
|
fulfillments:
|
|
type: array
|
|
description: The order's fulfillments.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderFulfillment'
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The order's ID.
|
|
version:
|
|
type: number
|
|
title: version
|
|
description: The order's version.
|
|
region_id:
|
|
type: string
|
|
title: region_id
|
|
description: The order's region id.
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The order's customer id.
|
|
sales_channel_id:
|
|
type: string
|
|
title: sales_channel_id
|
|
description: The order's sales channel id.
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The order's email.
|
|
format: email
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The order's currency code.
|
|
display_id:
|
|
type: string
|
|
title: display_id
|
|
description: The order's display id.
|
|
shipping_address:
|
|
$ref: '#/components/schemas/BaseOrderAddress'
|
|
billing_address:
|
|
$ref: '#/components/schemas/BaseOrderAddress'
|
|
items:
|
|
type: array
|
|
description: The order's items.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderLineItem'
|
|
shipping_methods:
|
|
type: array
|
|
description: The order's shipping methods.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderShippingMethod'
|
|
payment_status:
|
|
type: string
|
|
enum:
|
|
- canceled
|
|
- not_paid
|
|
- awaiting
|
|
- authorized
|
|
- partially_authorized
|
|
- captured
|
|
- partially_captured
|
|
- partially_refunded
|
|
- refunded
|
|
- requires_action
|
|
fulfillment_status:
|
|
type: string
|
|
enum:
|
|
- canceled
|
|
- not_fulfilled
|
|
- partially_fulfilled
|
|
- fulfilled
|
|
- partially_shipped
|
|
- shipped
|
|
- partially_delivered
|
|
- delivered
|
|
transactions:
|
|
type: array
|
|
description: The order's transactions.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderTransaction'
|
|
summary:
|
|
$ref: '#/components/schemas/BaseOrderSummary'
|
|
metadata:
|
|
type: object
|
|
description: The order's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The order's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The order's updated at.
|
|
original_item_total:
|
|
type: number
|
|
title: original_item_total
|
|
description: The order's original item total.
|
|
original_item_subtotal:
|
|
type: number
|
|
title: original_item_subtotal
|
|
description: The order's original item subtotal.
|
|
original_item_tax_total:
|
|
type: number
|
|
title: original_item_tax_total
|
|
description: The order's original item tax total.
|
|
item_total:
|
|
type: number
|
|
title: item_total
|
|
description: The order's item total.
|
|
item_subtotal:
|
|
type: number
|
|
title: item_subtotal
|
|
description: The order's item subtotal.
|
|
item_tax_total:
|
|
type: number
|
|
title: item_tax_total
|
|
description: The order's item tax total.
|
|
original_total:
|
|
type: number
|
|
title: original_total
|
|
description: The order's original total.
|
|
original_subtotal:
|
|
type: number
|
|
title: original_subtotal
|
|
description: The order's original subtotal.
|
|
original_tax_total:
|
|
type: number
|
|
title: original_tax_total
|
|
description: The order's original tax total.
|
|
total:
|
|
type: number
|
|
title: total
|
|
description: The order's total.
|
|
subtotal:
|
|
type: number
|
|
title: subtotal
|
|
description: The order's subtotal.
|
|
tax_total:
|
|
type: number
|
|
title: tax_total
|
|
description: The order's tax total.
|
|
discount_total:
|
|
type: number
|
|
title: discount_total
|
|
description: The order's discount total.
|
|
discount_tax_total:
|
|
type: number
|
|
title: discount_tax_total
|
|
description: The order's discount tax total.
|
|
gift_card_total:
|
|
type: number
|
|
title: gift_card_total
|
|
description: The order's gift card total.
|
|
gift_card_tax_total:
|
|
type: number
|
|
title: gift_card_tax_total
|
|
description: The order's gift card tax total.
|
|
shipping_total:
|
|
type: number
|
|
title: shipping_total
|
|
description: The order's shipping total.
|
|
shipping_subtotal:
|
|
type: number
|
|
title: shipping_subtotal
|
|
description: The order's shipping subtotal.
|
|
shipping_tax_total:
|
|
type: number
|
|
title: shipping_tax_total
|
|
description: The order's shipping tax total.
|
|
original_shipping_total:
|
|
type: number
|
|
title: original_shipping_total
|
|
description: The order's original shipping total.
|
|
original_shipping_subtotal:
|
|
type: number
|
|
title: original_shipping_subtotal
|
|
description: The order's original shipping subtotal.
|
|
original_shipping_tax_total:
|
|
type: number
|
|
title: original_shipping_tax_total
|
|
description: The order's original shipping tax total.
|
|
AdminOrderEditPreviewResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminOrderEditPreviewResponse
|
|
required:
|
|
- order_preview
|
|
properties:
|
|
order_preview:
|
|
$ref: '#/components/schemas/OrderPreview'
|
|
AdminOrderEditResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminOrderEditResponse
|
|
required:
|
|
- order_change
|
|
properties:
|
|
order_change:
|
|
$ref: '#/components/schemas/OrderChange'
|
|
AdminOrderPreview:
|
|
type: object
|
|
description: The return's order preview.
|
|
x-schemaName: AdminOrderPreview
|
|
required:
|
|
- return_requested_total
|
|
- order_change
|
|
- currency_code
|
|
- id
|
|
- version
|
|
- region_id
|
|
- customer_id
|
|
- sales_channel_id
|
|
- email
|
|
- payment_collections
|
|
- payment_status
|
|
- fulfillment_status
|
|
- summary
|
|
- metadata
|
|
- created_at
|
|
- updated_at
|
|
- original_item_total
|
|
- original_item_subtotal
|
|
- original_item_tax_total
|
|
- item_total
|
|
- item_subtotal
|
|
- item_tax_total
|
|
- original_total
|
|
- original_subtotal
|
|
- original_tax_total
|
|
- total
|
|
- subtotal
|
|
- tax_total
|
|
- discount_total
|
|
- discount_tax_total
|
|
- gift_card_total
|
|
- gift_card_tax_total
|
|
- shipping_total
|
|
- shipping_subtotal
|
|
- shipping_tax_total
|
|
- original_shipping_total
|
|
- original_shipping_subtotal
|
|
- original_shipping_tax_total
|
|
properties:
|
|
return_requested_total:
|
|
type: number
|
|
title: return_requested_total
|
|
description: The order preview's return requested total.
|
|
order_change:
|
|
$ref: '#/components/schemas/BaseOrderChange'
|
|
items:
|
|
type: array
|
|
description: The order preview's items.
|
|
items:
|
|
allOf:
|
|
- type: object
|
|
description: The item's items.
|
|
x-schemaName: BaseOrderLineItem
|
|
required:
|
|
- id
|
|
- title
|
|
- subtitle
|
|
- thumbnail
|
|
- variant_id
|
|
- product_id
|
|
- product_title
|
|
- product_description
|
|
- product_subtitle
|
|
- product_type
|
|
- product_collection
|
|
- product_handle
|
|
- variant_sku
|
|
- variant_barcode
|
|
- variant_title
|
|
- variant_option_values
|
|
- requires_shipping
|
|
- is_discountable
|
|
- is_tax_inclusive
|
|
- unit_price
|
|
- quantity
|
|
- detail
|
|
- created_at
|
|
- updated_at
|
|
- metadata
|
|
- original_total
|
|
- original_subtotal
|
|
- original_tax_total
|
|
- item_total
|
|
- item_subtotal
|
|
- item_tax_total
|
|
- total
|
|
- subtotal
|
|
- tax_total
|
|
- discount_total
|
|
- discount_tax_total
|
|
- refundable_total
|
|
- refundable_total_per_unit
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The item's ID.
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The item's title.
|
|
subtitle:
|
|
type: string
|
|
title: subtitle
|
|
description: The item's subtitle.
|
|
thumbnail:
|
|
type: string
|
|
title: thumbnail
|
|
description: The item's thumbnail.
|
|
variant:
|
|
$ref: '#/components/schemas/BaseProductVariant'
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The item's variant id.
|
|
product:
|
|
$ref: '#/components/schemas/BaseProduct'
|
|
product_id:
|
|
type: string
|
|
title: product_id
|
|
description: The item's product id.
|
|
product_title:
|
|
type: string
|
|
title: product_title
|
|
description: The item's product title.
|
|
product_description:
|
|
type: string
|
|
title: product_description
|
|
description: The item's product description.
|
|
product_subtitle:
|
|
type: string
|
|
title: product_subtitle
|
|
description: The item's product subtitle.
|
|
product_type:
|
|
type: string
|
|
title: product_type
|
|
description: The item's product type.
|
|
product_collection:
|
|
type: string
|
|
title: product_collection
|
|
description: The item's product collection.
|
|
product_handle:
|
|
type: string
|
|
title: product_handle
|
|
description: The item's product handle.
|
|
variant_sku:
|
|
type: string
|
|
title: variant_sku
|
|
description: The item's variant sku.
|
|
variant_barcode:
|
|
type: string
|
|
title: variant_barcode
|
|
description: The item's variant barcode.
|
|
variant_title:
|
|
type: string
|
|
title: variant_title
|
|
description: The item's variant title.
|
|
variant_option_values:
|
|
type: object
|
|
description: The item's variant option values.
|
|
requires_shipping:
|
|
type: boolean
|
|
title: requires_shipping
|
|
description: The item's requires shipping.
|
|
is_discountable:
|
|
type: boolean
|
|
title: is_discountable
|
|
description: The item's is discountable.
|
|
is_tax_inclusive:
|
|
type: boolean
|
|
title: is_tax_inclusive
|
|
description: The item's is tax inclusive.
|
|
compare_at_unit_price:
|
|
type: number
|
|
title: compare_at_unit_price
|
|
description: The item's compare at unit price.
|
|
unit_price:
|
|
type: number
|
|
title: unit_price
|
|
description: The item's unit price.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The item's quantity.
|
|
tax_lines:
|
|
type: array
|
|
description: The item's tax lines.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderLineItemTaxLine'
|
|
adjustments:
|
|
type: array
|
|
description: The item's adjustments.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderLineItemAdjustment'
|
|
detail:
|
|
$ref: '#/components/schemas/BaseOrderItemDetail'
|
|
created_at:
|
|
type: string
|
|
title: created_at
|
|
description: The item's created at.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
title: updated_at
|
|
description: The item's updated at.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: The item's metadata.
|
|
original_total:
|
|
type: number
|
|
title: original_total
|
|
description: The item's original total.
|
|
original_subtotal:
|
|
type: number
|
|
title: original_subtotal
|
|
description: The item's original subtotal.
|
|
original_tax_total:
|
|
type: number
|
|
title: original_tax_total
|
|
description: The item's original tax total.
|
|
item_total:
|
|
type: number
|
|
title: item_total
|
|
description: The item's item total.
|
|
item_subtotal:
|
|
type: number
|
|
title: item_subtotal
|
|
description: The item's item subtotal.
|
|
item_tax_total:
|
|
type: number
|
|
title: item_tax_total
|
|
description: The item's item tax total.
|
|
total:
|
|
type: number
|
|
title: total
|
|
description: The item's total.
|
|
subtotal:
|
|
type: number
|
|
title: subtotal
|
|
description: The item's subtotal.
|
|
tax_total:
|
|
type: number
|
|
title: tax_total
|
|
description: The item's tax total.
|
|
discount_total:
|
|
type: number
|
|
title: discount_total
|
|
description: The item's discount total.
|
|
discount_tax_total:
|
|
type: number
|
|
title: discount_tax_total
|
|
description: The item's discount tax total.
|
|
refundable_total:
|
|
type: number
|
|
title: refundable_total
|
|
description: The item's refundable total.
|
|
refundable_total_per_unit:
|
|
type: number
|
|
title: refundable_total_per_unit
|
|
description: The item's refundable total per unit.
|
|
- type: object
|
|
description: The item's items.
|
|
properties:
|
|
actions:
|
|
type: array
|
|
description: The item's actions.
|
|
items:
|
|
type: object
|
|
description: The action's actions.
|
|
x-schemaName: BaseOrderChangeAction
|
|
shipping_methods:
|
|
type: array
|
|
description: The order preview's shipping methods.
|
|
items:
|
|
allOf:
|
|
- type: object
|
|
description: The shipping method's shipping methods.
|
|
x-schemaName: BaseOrderShippingMethod
|
|
required:
|
|
- id
|
|
- order_id
|
|
- name
|
|
- amount
|
|
- is_tax_inclusive
|
|
- shipping_option_id
|
|
- data
|
|
- metadata
|
|
- original_total
|
|
- original_subtotal
|
|
- original_tax_total
|
|
- total
|
|
- subtotal
|
|
- tax_total
|
|
- discount_total
|
|
- discount_tax_total
|
|
- created_at
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The shipping method's ID.
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The shipping method's order id.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The shipping method's name.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The shipping method's description.
|
|
amount:
|
|
type: number
|
|
title: amount
|
|
description: The shipping method's amount.
|
|
is_tax_inclusive:
|
|
type: boolean
|
|
title: is_tax_inclusive
|
|
description: The shipping method's is tax inclusive.
|
|
shipping_option_id:
|
|
type: string
|
|
title: shipping_option_id
|
|
description: The shipping method's shipping option id.
|
|
data:
|
|
type: object
|
|
description: The shipping method's data.
|
|
metadata:
|
|
type: object
|
|
description: The shipping method's metadata.
|
|
tax_lines:
|
|
type: array
|
|
description: The shipping method's tax lines.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderShippingMethodTaxLine'
|
|
adjustments:
|
|
type: array
|
|
description: The shipping method's adjustments.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderShippingMethodAdjustment'
|
|
original_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_total
|
|
description: The shipping method's original total.
|
|
- type: number
|
|
title: original_total
|
|
description: The shipping method's original total.
|
|
- type: string
|
|
title: original_total
|
|
description: The shipping method's original total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: original_subtotal
|
|
description: The shipping method's original subtotal.
|
|
- type: number
|
|
title: original_subtotal
|
|
description: The shipping method's original subtotal.
|
|
- type: string
|
|
title: original_subtotal
|
|
description: The shipping method's original subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_tax_total
|
|
description: The shipping method's original tax total.
|
|
- type: number
|
|
title: original_tax_total
|
|
description: The shipping method's original tax total.
|
|
- type: string
|
|
title: original_tax_total
|
|
description: The shipping method's original tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
total:
|
|
oneOf:
|
|
- type: string
|
|
title: total
|
|
description: The shipping method's total.
|
|
- type: number
|
|
title: total
|
|
description: The shipping method's total.
|
|
- type: string
|
|
title: total
|
|
description: The shipping method's total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: subtotal
|
|
description: The shipping method's subtotal.
|
|
- type: number
|
|
title: subtotal
|
|
description: The shipping method's subtotal.
|
|
- type: string
|
|
title: subtotal
|
|
description: The shipping method's subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: tax_total
|
|
description: The shipping method's tax total.
|
|
- type: number
|
|
title: tax_total
|
|
description: The shipping method's tax total.
|
|
- type: string
|
|
title: tax_total
|
|
description: The shipping method's tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
discount_total:
|
|
oneOf:
|
|
- type: string
|
|
title: discount_total
|
|
description: The shipping method's discount total.
|
|
- type: number
|
|
title: discount_total
|
|
description: The shipping method's discount total.
|
|
- type: string
|
|
title: discount_total
|
|
description: The shipping method's discount total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
discount_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: discount_tax_total
|
|
description: The shipping method's discount tax total.
|
|
- type: number
|
|
title: discount_tax_total
|
|
description: The shipping method's discount tax total.
|
|
- type: string
|
|
title: discount_tax_total
|
|
description: The shipping method's discount tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The shipping method's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The shipping method's updated at.
|
|
- type: object
|
|
description: The shipping method's shipping methods.
|
|
properties:
|
|
actions:
|
|
type: array
|
|
description: The shipping method's actions.
|
|
items:
|
|
type: object
|
|
description: The action's actions.
|
|
x-schemaName: BaseOrderChangeAction
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The order preview's currency code.
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The order preview's ID.
|
|
version:
|
|
type: number
|
|
title: version
|
|
description: The order preview's version.
|
|
region_id:
|
|
type: string
|
|
title: region_id
|
|
description: The order preview's region id.
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The order preview's customer id.
|
|
sales_channel_id:
|
|
type: string
|
|
title: sales_channel_id
|
|
description: The order preview's sales channel id.
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The order preview's email.
|
|
format: email
|
|
display_id:
|
|
type: string
|
|
title: display_id
|
|
description: The order preview's display id.
|
|
shipping_address:
|
|
$ref: '#/components/schemas/BaseOrderAddress'
|
|
billing_address:
|
|
$ref: '#/components/schemas/BaseOrderAddress'
|
|
payment_collections:
|
|
type: array
|
|
description: The order preview's payment collections.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPaymentCollection'
|
|
payment_status:
|
|
type: string
|
|
enum:
|
|
- canceled
|
|
- not_paid
|
|
- awaiting
|
|
- authorized
|
|
- partially_authorized
|
|
- captured
|
|
- partially_captured
|
|
- partially_refunded
|
|
- refunded
|
|
- requires_action
|
|
fulfillments:
|
|
type: array
|
|
description: The order preview's fulfillments.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderFulfillment'
|
|
fulfillment_status:
|
|
type: string
|
|
enum:
|
|
- canceled
|
|
- not_fulfilled
|
|
- partially_fulfilled
|
|
- fulfilled
|
|
- partially_shipped
|
|
- shipped
|
|
- partially_delivered
|
|
- delivered
|
|
transactions:
|
|
type: array
|
|
description: The order preview's transactions.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderTransaction'
|
|
summary:
|
|
$ref: '#/components/schemas/BaseOrderSummary'
|
|
metadata:
|
|
type: object
|
|
description: The order preview's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The order preview's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The order preview's updated at.
|
|
original_item_total:
|
|
type: number
|
|
title: original_item_total
|
|
description: The order preview's original item total.
|
|
original_item_subtotal:
|
|
type: number
|
|
title: original_item_subtotal
|
|
description: The order preview's original item subtotal.
|
|
original_item_tax_total:
|
|
type: number
|
|
title: original_item_tax_total
|
|
description: The order preview's original item tax total.
|
|
item_total:
|
|
type: number
|
|
title: item_total
|
|
description: The order preview's item total.
|
|
item_subtotal:
|
|
type: number
|
|
title: item_subtotal
|
|
description: The order preview's item subtotal.
|
|
item_tax_total:
|
|
type: number
|
|
title: item_tax_total
|
|
description: The order preview's item tax total.
|
|
original_total:
|
|
type: number
|
|
title: original_total
|
|
description: The order preview's original total.
|
|
original_subtotal:
|
|
type: number
|
|
title: original_subtotal
|
|
description: The order preview's original subtotal.
|
|
original_tax_total:
|
|
type: number
|
|
title: original_tax_total
|
|
description: The order preview's original tax total.
|
|
total:
|
|
type: number
|
|
title: total
|
|
description: The order preview's total.
|
|
subtotal:
|
|
type: number
|
|
title: subtotal
|
|
description: The order preview's subtotal.
|
|
tax_total:
|
|
type: number
|
|
title: tax_total
|
|
description: The order preview's tax total.
|
|
discount_total:
|
|
type: number
|
|
title: discount_total
|
|
description: The order preview's discount total.
|
|
discount_tax_total:
|
|
type: number
|
|
title: discount_tax_total
|
|
description: The order preview's discount tax total.
|
|
gift_card_total:
|
|
type: number
|
|
title: gift_card_total
|
|
description: The order preview's gift card total.
|
|
gift_card_tax_total:
|
|
type: number
|
|
title: gift_card_tax_total
|
|
description: The order preview's gift card tax total.
|
|
shipping_total:
|
|
type: number
|
|
title: shipping_total
|
|
description: The order preview's shipping total.
|
|
shipping_subtotal:
|
|
type: number
|
|
title: shipping_subtotal
|
|
description: The order preview's shipping subtotal.
|
|
shipping_tax_total:
|
|
type: number
|
|
title: shipping_tax_total
|
|
description: The order preview's shipping tax total.
|
|
original_shipping_total:
|
|
type: number
|
|
title: original_shipping_total
|
|
description: The order preview's original shipping total.
|
|
original_shipping_subtotal:
|
|
type: number
|
|
title: original_shipping_subtotal
|
|
description: The order preview's original shipping subtotal.
|
|
original_shipping_tax_total:
|
|
type: number
|
|
title: original_shipping_tax_total
|
|
description: The order preview's original shipping tax total.
|
|
AdminOrderPreviewResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminOrderPreviewResponse
|
|
required:
|
|
- order
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/AdminOrderPreview'
|
|
AdminOrderResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminOrderResponse
|
|
required:
|
|
- order
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/AdminOrder'
|
|
AdminOrderReturnResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminOrderReturnResponse
|
|
required:
|
|
- order
|
|
- return
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/Order'
|
|
return:
|
|
$ref: '#/components/schemas/AdminReturn'
|
|
AdminPayment:
|
|
type: object
|
|
description: The payment's details.
|
|
x-schemaName: AdminPayment
|
|
required:
|
|
- id
|
|
- amount
|
|
- currency_code
|
|
- provider_id
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The payment's ID.
|
|
amount:
|
|
oneOf:
|
|
- type: string
|
|
title: amount
|
|
description: The payment's amount.
|
|
- type: number
|
|
title: amount
|
|
description: The payment's amount.
|
|
- type: string
|
|
title: amount
|
|
description: The payment's amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
authorized_amount:
|
|
oneOf:
|
|
- type: string
|
|
title: authorized_amount
|
|
description: The payment's authorized amount.
|
|
- type: number
|
|
title: authorized_amount
|
|
description: The payment's authorized amount.
|
|
- type: string
|
|
title: authorized_amount
|
|
description: The payment's authorized amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The payment's currency code.
|
|
provider_id:
|
|
type: string
|
|
title: provider_id
|
|
description: The payment's provider id.
|
|
cart_id:
|
|
type: string
|
|
title: cart_id
|
|
description: The payment's cart id.
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The payment's order id.
|
|
order_edit_id:
|
|
type: string
|
|
title: order_edit_id
|
|
description: The payment's order edit id.
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The payment's customer id.
|
|
data:
|
|
type: object
|
|
description: The payment's data.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The payment's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The payment's updated at.
|
|
captured_at:
|
|
oneOf:
|
|
- type: string
|
|
title: captured_at
|
|
description: The payment's captured at.
|
|
- type: string
|
|
title: captured_at
|
|
description: The payment's captured at.
|
|
format: date-time
|
|
canceled_at:
|
|
oneOf:
|
|
- type: string
|
|
title: canceled_at
|
|
description: The payment's canceled at.
|
|
- type: string
|
|
title: canceled_at
|
|
description: The payment's canceled at.
|
|
format: date-time
|
|
captured_amount:
|
|
oneOf:
|
|
- type: string
|
|
title: captured_amount
|
|
description: The payment's captured amount.
|
|
- type: number
|
|
title: captured_amount
|
|
description: The payment's captured amount.
|
|
- type: string
|
|
title: captured_amount
|
|
description: The payment's captured amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
refunded_amount:
|
|
oneOf:
|
|
- type: string
|
|
title: refunded_amount
|
|
description: The payment's refunded amount.
|
|
- type: number
|
|
title: refunded_amount
|
|
description: The payment's refunded amount.
|
|
- type: string
|
|
title: refunded_amount
|
|
description: The payment's refunded amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
captures:
|
|
type: array
|
|
description: The payment's captures.
|
|
items:
|
|
$ref: '#/components/schemas/BaseCapture'
|
|
refunds:
|
|
type: array
|
|
description: The payment's refunds.
|
|
items:
|
|
$ref: '#/components/schemas/BaseRefund'
|
|
payment_collection:
|
|
$ref: '#/components/schemas/BasePaymentCollection'
|
|
payment_session:
|
|
$ref: '#/components/schemas/BasePaymentSession'
|
|
AdminPaymentCollection:
|
|
type: object
|
|
description: The payment collection's payment collections.
|
|
x-schemaName: AdminPaymentCollection
|
|
required:
|
|
- id
|
|
- currency_code
|
|
- region_id
|
|
- amount
|
|
- status
|
|
- payment_providers
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The payment collection's ID.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The payment collection's currency code.
|
|
region_id:
|
|
type: string
|
|
title: region_id
|
|
description: The payment collection's region id.
|
|
amount:
|
|
oneOf:
|
|
- type: string
|
|
title: amount
|
|
description: The payment collection's amount.
|
|
- type: number
|
|
title: amount
|
|
description: The payment collection's amount.
|
|
- type: string
|
|
title: amount
|
|
description: The payment collection's amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
authorized_amount:
|
|
oneOf:
|
|
- type: string
|
|
title: authorized_amount
|
|
description: The payment collection's authorized amount.
|
|
- type: number
|
|
title: authorized_amount
|
|
description: The payment collection's authorized amount.
|
|
- type: string
|
|
title: authorized_amount
|
|
description: The payment collection's authorized amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
captured_amount:
|
|
oneOf:
|
|
- type: string
|
|
title: captured_amount
|
|
description: The payment collection's captured amount.
|
|
- type: number
|
|
title: captured_amount
|
|
description: The payment collection's captured amount.
|
|
- type: string
|
|
title: captured_amount
|
|
description: The payment collection's captured amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
refunded_amount:
|
|
oneOf:
|
|
- type: string
|
|
title: refunded_amount
|
|
description: The payment collection's refunded amount.
|
|
- type: number
|
|
title: refunded_amount
|
|
description: The payment collection's refunded amount.
|
|
- type: string
|
|
title: refunded_amount
|
|
description: The payment collection's refunded amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
completed_at:
|
|
oneOf:
|
|
- type: string
|
|
title: completed_at
|
|
description: The payment collection's completed at.
|
|
- type: string
|
|
title: completed_at
|
|
description: The payment collection's completed at.
|
|
format: date-time
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The payment collection's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The payment collection's updated at.
|
|
metadata:
|
|
type: object
|
|
description: The payment collection's metadata.
|
|
status:
|
|
type: string
|
|
enum:
|
|
- canceled
|
|
- not_paid
|
|
- awaiting
|
|
- authorized
|
|
- partially_authorized
|
|
payment_providers:
|
|
type: array
|
|
description: The payment collection's payment providers.
|
|
items:
|
|
$ref: '#/components/schemas/BasePaymentProvider'
|
|
payment_sessions:
|
|
type: array
|
|
description: The payment collection's payment sessions.
|
|
items:
|
|
$ref: '#/components/schemas/BasePaymentSession'
|
|
payments:
|
|
type: array
|
|
description: The payment collection's payments.
|
|
items:
|
|
$ref: '#/components/schemas/BasePayment'
|
|
AdminPaymentCollectionResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPaymentCollectionResponse
|
|
required:
|
|
- payment_collection
|
|
properties:
|
|
payment_collection:
|
|
$ref: '#/components/schemas/AdminPaymentCollection'
|
|
AdminPaymentProvider:
|
|
type: object
|
|
description: The payment provider's payment providers.
|
|
x-schemaName: AdminPaymentProvider
|
|
AdminPaymentResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPaymentResponse
|
|
required:
|
|
- payment
|
|
properties:
|
|
payment:
|
|
$ref: '#/components/schemas/AdminPayment'
|
|
AdminPostCancelClaimReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostCancelClaimReqSchema
|
|
properties:
|
|
no_notification:
|
|
type: boolean
|
|
title: no_notification
|
|
description: The claim's no notification.
|
|
AdminPostCancelExchangeReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostCancelExchangeReqSchema
|
|
properties:
|
|
no_notification:
|
|
type: boolean
|
|
title: no_notification
|
|
description: The exchange's no notification.
|
|
AdminPostCancelReturnReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostCancelReturnReqSchema
|
|
properties:
|
|
no_notification:
|
|
type: boolean
|
|
title: no_notification
|
|
description: The return's no notification.
|
|
AdminPostClaimItemsReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostClaimItemsReqSchema
|
|
properties:
|
|
items:
|
|
type: array
|
|
description: The claim's items.
|
|
items:
|
|
type: object
|
|
description: The item's items.
|
|
required:
|
|
- id
|
|
- quantity
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The item's ID.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The item's quantity.
|
|
reason:
|
|
type: string
|
|
enum:
|
|
- missing_item
|
|
- wrong_item
|
|
- production_failure
|
|
- other
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The item's description.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The item's internal note.
|
|
AdminPostClaimsAddItemsReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostClaimsAddItemsReqSchema
|
|
properties:
|
|
items:
|
|
type: array
|
|
description: The claim's items.
|
|
items:
|
|
type: object
|
|
description: The item's items.
|
|
required:
|
|
- variant_id
|
|
- quantity
|
|
properties:
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The item's variant id.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The item's quantity.
|
|
unit_price:
|
|
type: number
|
|
title: unit_price
|
|
description: The item's unit price.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The item's internal note.
|
|
metadata:
|
|
type: object
|
|
description: The item's metadata.
|
|
AdminPostClaimsItemsActionReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostClaimsItemsActionReqSchema
|
|
required:
|
|
- reason_id
|
|
properties:
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The claim's quantity.
|
|
reason_id:
|
|
type: string
|
|
title: reason_id
|
|
description: The claim's reason id.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The claim's internal note.
|
|
AdminPostClaimsShippingActionReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostClaimsShippingActionReqSchema
|
|
properties:
|
|
custom_price:
|
|
type: number
|
|
title: custom_price
|
|
description: The claim's custom price.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The claim's internal note.
|
|
metadata:
|
|
type: object
|
|
description: The claim's metadata.
|
|
AdminPostClaimsShippingReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostClaimsShippingReqSchema
|
|
required:
|
|
- shipping_option_id
|
|
properties:
|
|
shipping_option_id:
|
|
type: string
|
|
title: shipping_option_id
|
|
description: The claim's shipping option id.
|
|
custom_price:
|
|
type: number
|
|
title: custom_price
|
|
description: The claim's custom price.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The claim's description.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The claim's internal note.
|
|
metadata:
|
|
type: object
|
|
description: The claim's metadata.
|
|
AdminPostExchangesAddItemsReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostExchangesAddItemsReqSchema
|
|
properties:
|
|
items:
|
|
type: array
|
|
description: The exchange's items.
|
|
items:
|
|
type: object
|
|
description: The item's items.
|
|
required:
|
|
- variant_id
|
|
- quantity
|
|
properties:
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The item's variant id.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The item's quantity.
|
|
unit_price:
|
|
type: number
|
|
title: unit_price
|
|
description: The item's unit price.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The item's internal note.
|
|
allow_backorder:
|
|
type: boolean
|
|
title: allow_backorder
|
|
description: The item's allow backorder.
|
|
metadata:
|
|
type: object
|
|
description: The item's metadata.
|
|
AdminPostExchangesItemsActionReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostExchangesItemsActionReqSchema
|
|
properties:
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The exchange's quantity.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The exchange's internal note.
|
|
AdminPostExchangesRequestItemsReturnActionReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostExchangesRequestItemsReturnActionReqSchema
|
|
properties:
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The exchange's quantity.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The exchange's internal note.
|
|
reason_id:
|
|
type: string
|
|
title: reason_id
|
|
description: The exchange's reason id.
|
|
metadata:
|
|
type: object
|
|
description: The exchange's metadata.
|
|
AdminPostExchangesReturnRequestItemsReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostExchangesReturnRequestItemsReqSchema
|
|
properties:
|
|
items:
|
|
type: array
|
|
description: The exchange's items.
|
|
items:
|
|
type: object
|
|
description: The item's items.
|
|
required:
|
|
- id
|
|
- quantity
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The item's ID.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The item's quantity.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The item's description.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The item's internal note.
|
|
reason_id:
|
|
type: string
|
|
title: reason_id
|
|
description: The item's reason id.
|
|
metadata:
|
|
type: object
|
|
description: The item's metadata.
|
|
AdminPostExchangesShippingActionReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostExchangesShippingActionReqSchema
|
|
properties:
|
|
custom_price:
|
|
type: number
|
|
title: custom_price
|
|
description: The exchange's custom price.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The exchange's internal note.
|
|
metadata:
|
|
type: object
|
|
description: The exchange's metadata.
|
|
AdminPostExchangesShippingReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostExchangesShippingReqSchema
|
|
required:
|
|
- shipping_option_id
|
|
properties:
|
|
shipping_option_id:
|
|
type: string
|
|
title: shipping_option_id
|
|
description: The exchange's shipping option id.
|
|
custom_price:
|
|
type: number
|
|
title: custom_price
|
|
description: The exchange's custom price.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The exchange's description.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The exchange's internal note.
|
|
metadata:
|
|
type: object
|
|
description: The exchange's metadata.
|
|
AdminPostOrderClaimsReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostOrderClaimsReqSchema
|
|
required:
|
|
- type
|
|
- order_id
|
|
- reason_id
|
|
- metadata
|
|
properties:
|
|
type:
|
|
type: string
|
|
enum:
|
|
- refund
|
|
- replace
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The claim's order id.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The claim's description.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The claim's internal note.
|
|
reason_id:
|
|
type: string
|
|
title: reason_id
|
|
description: The claim's reason id.
|
|
metadata:
|
|
type: object
|
|
description: The claim's metadata.
|
|
AdminPostOrderEditsAddItemsReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostOrderEditsAddItemsReqSchema
|
|
properties:
|
|
items:
|
|
type: array
|
|
description: The order edit's items.
|
|
items:
|
|
type: object
|
|
description: The item's items.
|
|
required:
|
|
- variant_id
|
|
- quantity
|
|
properties:
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The item's variant id.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The item's quantity.
|
|
unit_price:
|
|
type: number
|
|
title: unit_price
|
|
description: The item's unit price.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The item's internal note.
|
|
allow_backorder:
|
|
type: boolean
|
|
title: allow_backorder
|
|
description: The item's allow backorder.
|
|
metadata:
|
|
type: object
|
|
description: The item's metadata.
|
|
AdminPostOrderEditsItemsActionReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostOrderEditsItemsActionReqSchema
|
|
properties:
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The order edit's quantity.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The order edit's internal note.
|
|
AdminPostOrderEditsReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostOrderEditsReqSchema
|
|
required:
|
|
- order_id
|
|
- metadata
|
|
properties:
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The order edit's order id.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The order edit's description.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The order edit's internal note.
|
|
metadata:
|
|
type: object
|
|
description: The order edit's metadata.
|
|
AdminPostOrderEditsShippingActionReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostOrderEditsShippingActionReqSchema
|
|
properties:
|
|
custom_price:
|
|
type: number
|
|
title: custom_price
|
|
description: The order edit's custom price.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The order edit's internal note.
|
|
metadata:
|
|
type: object
|
|
description: The order edit's metadata.
|
|
AdminPostOrderEditsShippingReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostOrderEditsShippingReqSchema
|
|
required:
|
|
- shipping_option_id
|
|
properties:
|
|
shipping_option_id:
|
|
type: string
|
|
title: shipping_option_id
|
|
description: The order edit's shipping option id.
|
|
custom_price:
|
|
type: number
|
|
title: custom_price
|
|
description: The order edit's custom price.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The order edit's description.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The order edit's internal note.
|
|
metadata:
|
|
type: object
|
|
description: The order edit's metadata.
|
|
AdminPostOrderEditsUpdateItemQuantityReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostOrderEditsUpdateItemQuantityReqSchema
|
|
required:
|
|
- quantity
|
|
properties:
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The order edit's quantity.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The order edit's internal note.
|
|
AdminPostOrderExchangesReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostOrderExchangesReqSchema
|
|
required:
|
|
- order_id
|
|
- metadata
|
|
properties:
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The exchange's order id.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The exchange's description.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The exchange's internal note.
|
|
metadata:
|
|
type: object
|
|
description: The exchange's metadata.
|
|
AdminPostReceiveReturnsReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostReceiveReturnsReqSchema
|
|
required:
|
|
- metadata
|
|
properties:
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The return's internal note.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The return's description.
|
|
metadata:
|
|
type: object
|
|
description: The return's metadata.
|
|
AdminPostReturnsConfirmRequestReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostReturnsConfirmRequestReqSchema
|
|
properties:
|
|
no_notification:
|
|
type: boolean
|
|
title: no_notification
|
|
description: The return's no notification.
|
|
AdminPostReturnsDismissItemsActionReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostReturnsDismissItemsActionReqSchema
|
|
properties:
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The return's quantity.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The return's internal note.
|
|
AdminPostReturnsReceiveItemsActionReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostReturnsReceiveItemsActionReqSchema
|
|
properties:
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The return's quantity.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The return's internal note.
|
|
AdminPostReturnsReceiveItemsReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostReturnsReceiveItemsReqSchema
|
|
properties:
|
|
items:
|
|
type: array
|
|
description: The return's items.
|
|
items:
|
|
type: object
|
|
description: The item's items.
|
|
required:
|
|
- id
|
|
- quantity
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The item's ID.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The item's quantity.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The item's description.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The item's internal note.
|
|
AdminPostReturnsReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostReturnsReqSchema
|
|
required:
|
|
- order_id
|
|
- metadata
|
|
properties:
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The return's order id.
|
|
location_id:
|
|
type: string
|
|
title: location_id
|
|
description: The return's location id.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The return's description.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The return's internal note.
|
|
no_notification:
|
|
type: boolean
|
|
title: no_notification
|
|
description: The return's no notification.
|
|
metadata:
|
|
type: object
|
|
description: The return's metadata.
|
|
AdminPostReturnsRequestItemsActionReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostReturnsRequestItemsActionReqSchema
|
|
properties:
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The claim's quantity.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The claim's internal note.
|
|
reason_id:
|
|
type: string
|
|
title: reason_id
|
|
description: The claim's reason id.
|
|
metadata:
|
|
type: object
|
|
description: The claim's metadata.
|
|
AdminPostReturnsRequestItemsReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostReturnsRequestItemsReqSchema
|
|
properties:
|
|
items:
|
|
type: array
|
|
description: The claim's items.
|
|
items:
|
|
type: object
|
|
description: The item's items.
|
|
required:
|
|
- id
|
|
- quantity
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The item's ID.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The item's quantity.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The item's description.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The item's internal note.
|
|
reason_id:
|
|
type: string
|
|
title: reason_id
|
|
description: The item's reason id.
|
|
metadata:
|
|
type: object
|
|
description: The item's metadata.
|
|
AdminPostReturnsReturnReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostReturnsReturnReqSchema
|
|
required:
|
|
- metadata
|
|
properties:
|
|
location_id:
|
|
type: string
|
|
title: location_id
|
|
description: The return's location id.
|
|
no_notification:
|
|
type: boolean
|
|
title: no_notification
|
|
description: The return's no notification.
|
|
metadata:
|
|
type: object
|
|
description: The return's metadata.
|
|
AdminPostReturnsShippingActionReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostReturnsShippingActionReqSchema
|
|
properties:
|
|
custom_price:
|
|
type: number
|
|
title: custom_price
|
|
description: The return's custom price.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The return's internal note.
|
|
metadata:
|
|
type: object
|
|
description: The return's metadata.
|
|
AdminPostReturnsShippingReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPostReturnsShippingReqSchema
|
|
required:
|
|
- shipping_option_id
|
|
properties:
|
|
shipping_option_id:
|
|
type: string
|
|
title: shipping_option_id
|
|
description: The exchange's shipping option id.
|
|
custom_price:
|
|
type: number
|
|
title: custom_price
|
|
description: The exchange's custom price.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The exchange's description.
|
|
internal_note:
|
|
type: string
|
|
title: internal_note
|
|
description: The exchange's internal note.
|
|
metadata:
|
|
type: object
|
|
description: The exchange's metadata.
|
|
AdminPrice:
|
|
type: object
|
|
description: The price's prices.
|
|
x-schemaName: AdminPrice
|
|
required:
|
|
- id
|
|
- title
|
|
- currency_code
|
|
- amount
|
|
- raw_amount
|
|
- min_quantity
|
|
- max_quantity
|
|
- price_set_id
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The price's ID.
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The price's title.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The price's currency code.
|
|
amount:
|
|
type: number
|
|
title: amount
|
|
description: The price's amount.
|
|
raw_amount:
|
|
type: object
|
|
description: The price's raw amount.
|
|
min_quantity:
|
|
type: number
|
|
title: min_quantity
|
|
description: The price's min quantity.
|
|
max_quantity:
|
|
type: number
|
|
title: max_quantity
|
|
description: The price's max quantity.
|
|
price_set_id:
|
|
type: string
|
|
title: price_set_id
|
|
description: The price's price set id.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The price's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The price's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The price's deleted at.
|
|
AdminPriceList:
|
|
type: object
|
|
description: The price list's details.
|
|
x-schemaName: AdminPriceList
|
|
required:
|
|
- id
|
|
- title
|
|
- description
|
|
- rules
|
|
- starts_at
|
|
- ends_at
|
|
- status
|
|
- type
|
|
- prices
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The price list's ID.
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The price list's title.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The price list's description.
|
|
rules:
|
|
type: object
|
|
description: The price list's rules.
|
|
starts_at:
|
|
type: string
|
|
title: starts_at
|
|
description: The price list's starts at.
|
|
ends_at:
|
|
type: string
|
|
title: ends_at
|
|
description: The price list's ends at.
|
|
status:
|
|
type: string
|
|
enum:
|
|
- draft
|
|
- active
|
|
type:
|
|
type: string
|
|
enum:
|
|
- sale
|
|
- override
|
|
prices:
|
|
type: array
|
|
description: The price list's prices.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPriceListPrice'
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The price list's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The price list's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The price list's deleted at.
|
|
AdminPriceListBatchResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPriceListBatchResponse
|
|
required:
|
|
- created
|
|
- updated
|
|
- deleted
|
|
properties:
|
|
created:
|
|
type: array
|
|
description: The price list's created.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPrice'
|
|
updated:
|
|
type: array
|
|
description: The price list's updated.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPrice'
|
|
deleted:
|
|
type: object
|
|
description: The price list's deleted.
|
|
required:
|
|
- ids
|
|
- object
|
|
- deleted
|
|
properties:
|
|
ids:
|
|
type: array
|
|
description: The deleted's ids.
|
|
items:
|
|
type: string
|
|
title: ids
|
|
description: The id's ids.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The deleted's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The deleted's details.
|
|
AdminPriceListDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPriceListDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The price list's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The price list's object.
|
|
default: price_list
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The price list's deleted.
|
|
parent:
|
|
type: object
|
|
description: The price list's parent.
|
|
AdminPriceListListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPriceListListResponse
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
- price_lists
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The price list's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The price list's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The price list's count.
|
|
price_lists:
|
|
type: array
|
|
description: The price list's price lists.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPriceList'
|
|
AdminPriceListPrice:
|
|
type: object
|
|
description: The price's prices.
|
|
x-schemaName: AdminPriceListPrice
|
|
required:
|
|
- variant_id
|
|
- rules
|
|
- id
|
|
- title
|
|
- currency_code
|
|
- amount
|
|
- raw_amount
|
|
- min_quantity
|
|
- max_quantity
|
|
- price_set_id
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The price's variant id.
|
|
rules:
|
|
type: object
|
|
description: The price's rules.
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The price's ID.
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The price's title.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The price's currency code.
|
|
amount:
|
|
type: number
|
|
title: amount
|
|
description: The price's amount.
|
|
raw_amount:
|
|
type: object
|
|
description: The price's raw amount.
|
|
min_quantity:
|
|
type: number
|
|
title: min_quantity
|
|
description: The price's min quantity.
|
|
max_quantity:
|
|
type: number
|
|
title: max_quantity
|
|
description: The price's max quantity.
|
|
price_set_id:
|
|
type: string
|
|
title: price_set_id
|
|
description: The price's price set id.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The price's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The price's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The price's deleted at.
|
|
AdminPriceListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPriceListResponse
|
|
required:
|
|
- price_list
|
|
properties:
|
|
price_list:
|
|
$ref: '#/components/schemas/AdminPriceList'
|
|
AdminPricePreference:
|
|
type: object
|
|
description: The price preference's details.
|
|
x-schemaName: AdminPricePreference
|
|
required:
|
|
- id
|
|
- attribute
|
|
- value
|
|
- is_tax_inclusive
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The price preference's ID.
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The price preference's attribute.
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The price preference's value.
|
|
is_tax_inclusive:
|
|
type: boolean
|
|
title: is_tax_inclusive
|
|
description: The price preference's is tax inclusive.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The price preference's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The price preference's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The price preference's deleted at.
|
|
AdminPricePreferenceDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPricePreferenceDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The price preference's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The price preference's object.
|
|
default: price_preference
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The price preference's deleted.
|
|
parent:
|
|
type: object
|
|
description: The price preference's parent.
|
|
AdminPricePreferenceListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPricePreferenceListResponse
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
- price_preferences
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The price preference's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The price preference's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The price preference's count.
|
|
price_preferences:
|
|
type: array
|
|
description: The price preference's price preferences.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPricePreference'
|
|
AdminPricePreferenceResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPricePreferenceResponse
|
|
required:
|
|
- price_preference
|
|
properties:
|
|
price_preference:
|
|
$ref: '#/components/schemas/AdminPricePreference'
|
|
AdminProduct:
|
|
type: object
|
|
description: The product's parent.
|
|
x-schemaName: AdminProduct
|
|
required:
|
|
- type
|
|
- title
|
|
- status
|
|
- length
|
|
- options
|
|
- description
|
|
- id
|
|
- created_at
|
|
- updated_at
|
|
- handle
|
|
- subtitle
|
|
- is_giftcard
|
|
- thumbnail
|
|
- width
|
|
- weight
|
|
- height
|
|
- origin_country
|
|
- hs_code
|
|
- mid_code
|
|
- material
|
|
- collection_id
|
|
- type_id
|
|
- images
|
|
- discountable
|
|
- external_id
|
|
- deleted_at
|
|
properties:
|
|
collection:
|
|
$ref: '#/components/schemas/AdminCollection'
|
|
categories:
|
|
type: array
|
|
description: The parent's categories.
|
|
items:
|
|
$ref: '#/components/schemas/AdminProductCategory'
|
|
sales_channels:
|
|
type: array
|
|
description: The parent's sales channels.
|
|
items:
|
|
$ref: '#/components/schemas/AdminSalesChannel'
|
|
variants:
|
|
type: array
|
|
description: The parent's variants.
|
|
items:
|
|
$ref: '#/components/schemas/AdminProductVariant'
|
|
type:
|
|
type: object
|
|
tags:
|
|
type: array
|
|
description: The parent's tags.
|
|
items:
|
|
$ref: '#/components/schemas/AdminProductTag'
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The parent's title.
|
|
status:
|
|
type: string
|
|
enum:
|
|
- draft
|
|
- proposed
|
|
- published
|
|
- rejected
|
|
length:
|
|
type: number
|
|
title: length
|
|
description: The parent's length.
|
|
options:
|
|
type: array
|
|
description: The parent's options.
|
|
items:
|
|
$ref: '#/components/schemas/BaseProductOption'
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The parent's description.
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The parent's ID.
|
|
metadata:
|
|
type: object
|
|
description: The parent's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The parent's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The parent's updated at.
|
|
handle:
|
|
type: string
|
|
title: handle
|
|
description: The parent's handle.
|
|
subtitle:
|
|
type: string
|
|
title: subtitle
|
|
description: The parent's subtitle.
|
|
is_giftcard:
|
|
type: boolean
|
|
title: is_giftcard
|
|
description: The parent's is giftcard.
|
|
thumbnail:
|
|
type: string
|
|
title: thumbnail
|
|
description: The parent's thumbnail.
|
|
width:
|
|
type: number
|
|
title: width
|
|
description: The parent's width.
|
|
weight:
|
|
type: number
|
|
title: weight
|
|
description: The parent's weight.
|
|
height:
|
|
type: number
|
|
title: height
|
|
description: The parent's height.
|
|
origin_country:
|
|
type: string
|
|
title: origin_country
|
|
description: The parent's origin country.
|
|
hs_code:
|
|
type: string
|
|
title: hs_code
|
|
description: The parent's hs code.
|
|
mid_code:
|
|
type: string
|
|
title: mid_code
|
|
description: The parent's mid code.
|
|
material:
|
|
type: string
|
|
title: material
|
|
description: The parent's material.
|
|
collection_id:
|
|
type: string
|
|
title: collection_id
|
|
description: The parent's collection id.
|
|
type_id:
|
|
type: string
|
|
title: type_id
|
|
description: The parent's type id.
|
|
images:
|
|
type: array
|
|
description: The parent's images.
|
|
items:
|
|
$ref: '#/components/schemas/BaseProductImage'
|
|
discountable:
|
|
type: boolean
|
|
title: discountable
|
|
description: The parent's discountable.
|
|
external_id:
|
|
type: string
|
|
title: external_id
|
|
description: The parent's external id.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The parent's deleted at.
|
|
AdminProductCategory:
|
|
type: object
|
|
description: The category's categories.
|
|
x-schemaName: AdminProductCategory
|
|
required:
|
|
- category_children
|
|
- parent_category
|
|
- name
|
|
- description
|
|
- id
|
|
- created_at
|
|
- updated_at
|
|
- handle
|
|
- deleted_at
|
|
- is_active
|
|
- is_internal
|
|
- rank
|
|
- parent_category_id
|
|
properties:
|
|
category_children:
|
|
type: array
|
|
description: The category's category children.
|
|
items:
|
|
type: object
|
|
parent_category:
|
|
type: object
|
|
products:
|
|
type: array
|
|
description: The category's products.
|
|
items:
|
|
type: object
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The category's name.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The category's description.
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The category's ID.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The category's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The category's updated at.
|
|
handle:
|
|
type: string
|
|
title: handle
|
|
description: The category's handle.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The category's deleted at.
|
|
is_active:
|
|
type: boolean
|
|
title: is_active
|
|
description: The category's is active.
|
|
is_internal:
|
|
type: boolean
|
|
title: is_internal
|
|
description: The category's is internal.
|
|
rank:
|
|
type: number
|
|
title: rank
|
|
description: The category's rank.
|
|
parent_category_id:
|
|
type: string
|
|
title: parent_category_id
|
|
description: The category's parent category id.
|
|
AdminProductCategoryDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminProductCategoryDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The product category's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The product category's object.
|
|
default: product_category
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The product category's deleted.
|
|
parent:
|
|
type: object
|
|
description: The product category's parent.
|
|
AdminProductCategoryListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminProductCategoryListResponse
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
- product_categories
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The product category's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The product category's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The product category's count.
|
|
product_categories:
|
|
type: array
|
|
description: The product category's product categories.
|
|
items:
|
|
$ref: '#/components/schemas/AdminProductCategory'
|
|
AdminProductCategoryResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminProductCategoryResponse
|
|
required:
|
|
- product_category
|
|
properties:
|
|
product_category:
|
|
$ref: '#/components/schemas/AdminProductCategory'
|
|
AdminProductDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminProductDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The product's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The product's object.
|
|
default: product
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The product's deleted.
|
|
parent:
|
|
type: object
|
|
description: The product's parent.
|
|
AdminProductOption:
|
|
type: object
|
|
description: The product's product option.
|
|
x-schemaName: AdminProductOption
|
|
required:
|
|
- id
|
|
- title
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The product option's ID.
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The product option's title.
|
|
product:
|
|
$ref: '#/components/schemas/BaseProduct'
|
|
product_id:
|
|
type: string
|
|
title: product_id
|
|
description: The product option's product id.
|
|
values:
|
|
type: array
|
|
description: The product option's values.
|
|
items:
|
|
$ref: '#/components/schemas/BaseProductOptionValue'
|
|
metadata:
|
|
type: object
|
|
description: The product option's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The product option's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The product option's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The product option's deleted at.
|
|
AdminProductOptionDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminProductOptionDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The product's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The product's object.
|
|
default: product_option
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The product's deleted.
|
|
parent:
|
|
$ref: '#/components/schemas/AdminProduct'
|
|
AdminProductOptionResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminProductOptionResponse
|
|
required:
|
|
- product_option
|
|
properties:
|
|
product_option:
|
|
$ref: '#/components/schemas/AdminProductOption'
|
|
AdminProductResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminProductResponse
|
|
required:
|
|
- product
|
|
properties:
|
|
product:
|
|
$ref: '#/components/schemas/AdminProduct'
|
|
AdminProductTag:
|
|
type: object
|
|
description: The tag's tags.
|
|
x-schemaName: AdminProductTag
|
|
required:
|
|
- id
|
|
- value
|
|
- created_at
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The tag's ID.
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The tag's value.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The tag's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The tag's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The tag's deleted at.
|
|
metadata:
|
|
type: object
|
|
description: The tag's metadata.
|
|
AdminProductTagDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminProductTagDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The product tag's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The product tag's object.
|
|
default: product_tag
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The product tag's deleted.
|
|
parent:
|
|
type: object
|
|
description: The product tag's parent.
|
|
AdminProductTagListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminProductTagListResponse
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
- product_tags
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The product tag's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The product tag's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The product tag's count.
|
|
product_tags:
|
|
type: array
|
|
description: The product tag's product tags.
|
|
items:
|
|
$ref: '#/components/schemas/AdminProductTag'
|
|
AdminProductTagResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminProductTagResponse
|
|
required:
|
|
- product_tag
|
|
properties:
|
|
product_tag:
|
|
$ref: '#/components/schemas/AdminProductTag'
|
|
AdminProductTypeDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminProductTypeDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The product type's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The product type's object.
|
|
default: product_type
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The product type's deleted.
|
|
parent:
|
|
type: object
|
|
description: The product type's parent.
|
|
AdminProductTypeListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminProductTypeListResponse
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
- product_types
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The product type's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The product type's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The product type's count.
|
|
product_types:
|
|
type: array
|
|
description: The product type's product types.
|
|
items:
|
|
$ref: '#/components/schemas/AdminProduct'
|
|
AdminProductTypeResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminProductTypeResponse
|
|
required:
|
|
- product_type
|
|
properties:
|
|
product_type:
|
|
$ref: '#/components/schemas/AdminProduct'
|
|
AdminProductVariant:
|
|
type: object
|
|
description: The product's parent.
|
|
x-schemaName: AdminProductVariant
|
|
required:
|
|
- prices
|
|
- id
|
|
- title
|
|
- sku
|
|
- barcode
|
|
- ean
|
|
- upc
|
|
- allow_backorder
|
|
- manage_inventory
|
|
- hs_code
|
|
- origin_country
|
|
- mid_code
|
|
- material
|
|
- weight
|
|
- length
|
|
- height
|
|
- width
|
|
- options
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
prices:
|
|
type: array
|
|
description: The parent's prices.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPrice'
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The parent's ID.
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The parent's title.
|
|
sku:
|
|
type: string
|
|
title: sku
|
|
description: The parent's sku.
|
|
barcode:
|
|
type: string
|
|
title: barcode
|
|
description: The parent's barcode.
|
|
ean:
|
|
type: string
|
|
title: ean
|
|
description: The parent's ean.
|
|
upc:
|
|
type: string
|
|
title: upc
|
|
description: The parent's upc.
|
|
allow_backorder:
|
|
type: boolean
|
|
title: allow_backorder
|
|
description: The parent's allow backorder.
|
|
manage_inventory:
|
|
type: boolean
|
|
title: manage_inventory
|
|
description: The parent's manage inventory.
|
|
hs_code:
|
|
type: string
|
|
title: hs_code
|
|
description: The parent's hs code.
|
|
origin_country:
|
|
type: string
|
|
title: origin_country
|
|
description: The parent's origin country.
|
|
mid_code:
|
|
type: string
|
|
title: mid_code
|
|
description: The parent's mid code.
|
|
material:
|
|
type: string
|
|
title: material
|
|
description: The parent's material.
|
|
weight:
|
|
type: number
|
|
title: weight
|
|
description: The parent's weight.
|
|
length:
|
|
type: number
|
|
title: length
|
|
description: The parent's length.
|
|
height:
|
|
type: number
|
|
title: height
|
|
description: The parent's height.
|
|
width:
|
|
type: number
|
|
title: width
|
|
description: The parent's width.
|
|
variant_rank:
|
|
type: number
|
|
title: variant_rank
|
|
description: The parent's variant rank.
|
|
options:
|
|
type: array
|
|
description: The parent's options.
|
|
items:
|
|
$ref: '#/components/schemas/BaseProductOptionValue'
|
|
product:
|
|
$ref: '#/components/schemas/BaseProduct'
|
|
product_id:
|
|
type: string
|
|
title: product_id
|
|
description: The parent's product id.
|
|
calculated_price:
|
|
$ref: '#/components/schemas/BaseCalculatedPriceSet'
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The parent's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The parent's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The parent's deleted at.
|
|
metadata:
|
|
type: object
|
|
description: The parent's metadata.
|
|
AdminProductVariantDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminProductVariantDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The product's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The product's object.
|
|
default: variant
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The product's deleted.
|
|
parent:
|
|
$ref: '#/components/schemas/AdminProduct'
|
|
AdminProductVariantInventoryBatchResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminProductVariantInventoryBatchResponse
|
|
required:
|
|
- created
|
|
- updated
|
|
- deleted
|
|
properties:
|
|
created:
|
|
oneOf:
|
|
- $ref: '#/components/schemas/AdminProductVariantInventoryLink'
|
|
- type: array
|
|
description: The product's created.
|
|
items:
|
|
type: object
|
|
description: The created's details.
|
|
x-schemaName: AdminProductVariantInventoryLink
|
|
required:
|
|
- productService
|
|
- inventoryService
|
|
properties:
|
|
productService:
|
|
type: object
|
|
description: The created's productservice.
|
|
required:
|
|
- variant_id
|
|
properties:
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The productservice's variant id.
|
|
inventoryService:
|
|
type: object
|
|
description: The created's inventoryservice.
|
|
required:
|
|
- inventory_item_id
|
|
properties:
|
|
inventory_item_id:
|
|
type: string
|
|
title: inventory_item_id
|
|
description: The inventoryservice's inventory item id.
|
|
updated:
|
|
oneOf:
|
|
- $ref: '#/components/schemas/AdminProductVariantInventoryLink'
|
|
- type: array
|
|
description: The product's updated.
|
|
items:
|
|
type: object
|
|
description: The updated's details.
|
|
x-schemaName: AdminProductVariantInventoryLink
|
|
required:
|
|
- productService
|
|
- inventoryService
|
|
properties:
|
|
productService:
|
|
type: object
|
|
description: The updated's productservice.
|
|
required:
|
|
- variant_id
|
|
properties:
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The productservice's variant id.
|
|
inventoryService:
|
|
type: object
|
|
description: The updated's inventoryservice.
|
|
required:
|
|
- inventory_item_id
|
|
properties:
|
|
inventory_item_id:
|
|
type: string
|
|
title: inventory_item_id
|
|
description: The inventoryservice's inventory item id.
|
|
deleted:
|
|
oneOf:
|
|
- $ref: '#/components/schemas/AdminProductVariantInventoryLink'
|
|
- type: array
|
|
description: The product's deleted.
|
|
items:
|
|
type: object
|
|
description: The deleted's details.
|
|
x-schemaName: AdminProductVariantInventoryLink
|
|
required:
|
|
- productService
|
|
- inventoryService
|
|
properties:
|
|
productService:
|
|
type: object
|
|
description: The deleted's productservice.
|
|
required:
|
|
- variant_id
|
|
properties:
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The productservice's variant id.
|
|
inventoryService:
|
|
type: object
|
|
description: The deleted's inventoryservice.
|
|
required:
|
|
- inventory_item_id
|
|
properties:
|
|
inventory_item_id:
|
|
type: string
|
|
title: inventory_item_id
|
|
description: The inventoryservice's inventory item id.
|
|
AdminProductVariantInventoryLink:
|
|
type: object
|
|
description: The product's ID.
|
|
x-schemaName: AdminProductVariantInventoryLink
|
|
required:
|
|
- productService
|
|
- inventoryService
|
|
properties:
|
|
productService:
|
|
type: object
|
|
description: The id's productservice.
|
|
required:
|
|
- variant_id
|
|
properties:
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The productservice's variant id.
|
|
inventoryService:
|
|
type: object
|
|
description: The id's inventoryservice.
|
|
required:
|
|
- inventory_item_id
|
|
properties:
|
|
inventory_item_id:
|
|
type: string
|
|
title: inventory_item_id
|
|
description: The inventoryservice's inventory item id.
|
|
AdminProductVariantInventoryLinkDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminProductVariantInventoryLinkDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
- parent
|
|
properties:
|
|
id:
|
|
$ref: '#/components/schemas/AdminProductVariantInventoryLink'
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The product's object.
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The product's deleted.
|
|
parent:
|
|
$ref: '#/components/schemas/AdminProductVariant'
|
|
AdminProductVariantParams:
|
|
type: object
|
|
description: The product's variants.
|
|
x-schemaName: AdminProductVariantParams
|
|
properties:
|
|
q:
|
|
type: string
|
|
title: q
|
|
description: The variant's q.
|
|
id:
|
|
oneOf:
|
|
- type: string
|
|
title: id
|
|
description: The variant's ID.
|
|
- type: array
|
|
description: The variant's ID.
|
|
items:
|
|
type: string
|
|
title: id
|
|
description: The id's ID.
|
|
sku:
|
|
oneOf:
|
|
- type: string
|
|
title: sku
|
|
description: The variant's sku.
|
|
- type: array
|
|
description: The variant's sku.
|
|
items:
|
|
type: string
|
|
title: sku
|
|
description: The sku's details.
|
|
product_id:
|
|
oneOf:
|
|
- type: string
|
|
title: product_id
|
|
description: The variant's product id.
|
|
- type: array
|
|
description: The variant's product id.
|
|
items:
|
|
type: string
|
|
title: product_id
|
|
description: The product id's details.
|
|
options:
|
|
type: object
|
|
description: The variant's options.
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The variant's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The variant's offset.
|
|
order:
|
|
type: string
|
|
title: order
|
|
description: The variant's order.
|
|
fields:
|
|
type: string
|
|
title: fields
|
|
description: The variant's fields.
|
|
$and:
|
|
type: array
|
|
description: The variant's $and.
|
|
items:
|
|
type: array
|
|
description: The $and's details.
|
|
items:
|
|
type: object
|
|
title: $and
|
|
$or:
|
|
type: array
|
|
description: The variant's $or.
|
|
items:
|
|
type: array
|
|
description: The $or's details.
|
|
items:
|
|
type: object
|
|
title: $or
|
|
AdminProductVariantResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminProductVariantResponse
|
|
required:
|
|
- variant
|
|
properties:
|
|
variant:
|
|
$ref: '#/components/schemas/AdminProductVariant'
|
|
AdminPromotion:
|
|
type: object
|
|
description: The promotion's details.
|
|
x-schemaName: AdminPromotion
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The promotion's ID.
|
|
code:
|
|
type: string
|
|
title: code
|
|
description: The promotion's code.
|
|
type:
|
|
type: string
|
|
enum:
|
|
- standard
|
|
- buyget
|
|
is_automatic:
|
|
type: boolean
|
|
title: is_automatic
|
|
description: The promotion's is automatic.
|
|
application_method:
|
|
$ref: '#/components/schemas/BaseApplicationMethod'
|
|
rules:
|
|
type: array
|
|
description: The promotion's rules.
|
|
items:
|
|
$ref: '#/components/schemas/BasePromotionRule'
|
|
campaign_id:
|
|
type: string
|
|
title: campaign_id
|
|
description: The promotion's campaign id.
|
|
campaign:
|
|
$ref: '#/components/schemas/CampaignResponse'
|
|
AdminPromotionResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminPromotionResponse
|
|
required:
|
|
- promotion
|
|
properties:
|
|
promotion:
|
|
$ref: '#/components/schemas/AdminPromotion'
|
|
AdminPromotionRule:
|
|
type: object
|
|
description: The updated's details.
|
|
x-schemaName: AdminPromotionRule
|
|
required:
|
|
- id
|
|
- values
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The updated's ID.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The updated's description.
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The updated's attribute.
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- gt
|
|
- lt
|
|
- eq
|
|
- ne
|
|
- in
|
|
- lte
|
|
- gte
|
|
values:
|
|
type: array
|
|
description: The updated's values.
|
|
items:
|
|
$ref: '#/components/schemas/BasePromotionRuleValue'
|
|
AdminRefundReason:
|
|
type: object
|
|
description: The refund reason's details.
|
|
x-schemaName: AdminRefundReason
|
|
required:
|
|
- id
|
|
- label
|
|
- metadata
|
|
- created_at
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The refund reason's ID.
|
|
label:
|
|
type: string
|
|
title: label
|
|
description: The refund reason's label.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The refund reason's description.
|
|
metadata:
|
|
type: object
|
|
description: The refund reason's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The refund reason's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The refund reason's updated at.
|
|
AdminRegion:
|
|
type: object
|
|
description: The region's details.
|
|
x-schemaName: AdminRegion
|
|
required:
|
|
- id
|
|
- name
|
|
- currency_code
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The region's ID.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The region's name.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The region's currency code.
|
|
automatic_taxes:
|
|
type: boolean
|
|
title: automatic_taxes
|
|
description: The region's automatic taxes.
|
|
countries:
|
|
type: array
|
|
description: The region's countries.
|
|
items:
|
|
$ref: '#/components/schemas/BaseRegionCountry'
|
|
payment_providers:
|
|
type: array
|
|
description: The region's payment providers.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPaymentProvider'
|
|
metadata:
|
|
type: object
|
|
description: The region's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The region's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The region's updated at.
|
|
AdminRegionResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminRegionResponse
|
|
required:
|
|
- region
|
|
properties:
|
|
region:
|
|
$ref: '#/components/schemas/AdminRegion'
|
|
AdminReservationResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminReservationResponse
|
|
required:
|
|
- reservation
|
|
properties:
|
|
reservation:
|
|
$ref: '#/components/schemas/ReservationResponse'
|
|
AdminReturn:
|
|
type: object
|
|
description: The exchange's return.
|
|
x-schemaName: AdminReturn
|
|
required:
|
|
- id
|
|
- order_id
|
|
- order_version
|
|
- display_id
|
|
- items
|
|
- received_at
|
|
- created_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The return's ID.
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The return's order id.
|
|
status:
|
|
type: string
|
|
title: status
|
|
description: The return's status.
|
|
exchange_id:
|
|
type: string
|
|
title: exchange_id
|
|
description: The return's exchange id.
|
|
location_id:
|
|
type: string
|
|
title: location_id
|
|
description: The return's location id.
|
|
claim_id:
|
|
type: string
|
|
title: claim_id
|
|
description: The return's claim id.
|
|
order_version:
|
|
type: number
|
|
title: order_version
|
|
description: The return's order version.
|
|
display_id:
|
|
type: number
|
|
title: display_id
|
|
description: The return's display id.
|
|
no_notification:
|
|
type: boolean
|
|
title: no_notification
|
|
description: The return's no notification.
|
|
refund_amount:
|
|
type: number
|
|
title: refund_amount
|
|
description: The return's refund amount.
|
|
items:
|
|
type: array
|
|
description: The return's items.
|
|
items:
|
|
$ref: '#/components/schemas/BaseReturnItem'
|
|
received_at:
|
|
type: string
|
|
title: received_at
|
|
description: The return's received at.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The return's created at.
|
|
AdminReturnItem:
|
|
type: object
|
|
description: The return item's return items.
|
|
x-schemaName: AdminReturnItem
|
|
required:
|
|
- id
|
|
- quantity
|
|
- received_quantity
|
|
- item_id
|
|
- return_id
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The return item's ID.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The return item's quantity.
|
|
received_quantity:
|
|
type: number
|
|
title: received_quantity
|
|
description: The return item's received quantity.
|
|
reason_id:
|
|
type: string
|
|
title: reason_id
|
|
description: The return item's reason id.
|
|
note:
|
|
type: string
|
|
title: note
|
|
description: The return item's note.
|
|
item_id:
|
|
type: string
|
|
title: item_id
|
|
description: The return item's item id.
|
|
return_id:
|
|
type: string
|
|
title: return_id
|
|
description: The return item's return id.
|
|
metadata:
|
|
type: object
|
|
description: The return item's metadata.
|
|
AdminReturnPreviewResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminReturnPreviewResponse
|
|
required:
|
|
- order_preview
|
|
- return
|
|
properties:
|
|
order_preview:
|
|
$ref: '#/components/schemas/AdminOrderPreview'
|
|
return:
|
|
$ref: '#/components/schemas/AdminReturn'
|
|
AdminReturnReason:
|
|
type: object
|
|
description: The return reason's details.
|
|
x-schemaName: AdminReturnReason
|
|
required:
|
|
- id
|
|
- value
|
|
- label
|
|
- created_at
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The return reason's ID.
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The return reason's value.
|
|
label:
|
|
type: string
|
|
title: label
|
|
description: The return reason's label.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The return reason's description.
|
|
metadata:
|
|
type: object
|
|
description: The return reason's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The return reason's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The return reason's updated at.
|
|
AdminReturnReasonListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminReturnReasonListResponse
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
- return_reasons
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The return reason's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The return reason's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The return reason's count.
|
|
return_reasons:
|
|
type: array
|
|
description: The return reason's return reasons.
|
|
items:
|
|
$ref: '#/components/schemas/AdminReturnReason'
|
|
AdminReturnReasonResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminReturnReasonResponse
|
|
required:
|
|
- return_reason
|
|
properties:
|
|
return_reason:
|
|
$ref: '#/components/schemas/AdminReturnReason'
|
|
AdminReturnResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminReturnResponse
|
|
required:
|
|
- return
|
|
properties:
|
|
return:
|
|
$ref: '#/components/schemas/AdminReturn'
|
|
AdminRevokeApiKey:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminRevokeApiKey
|
|
properties:
|
|
revoke_in:
|
|
type: number
|
|
title: revoke_in
|
|
description: The api key's revoke in.
|
|
AdminRuleAttributeOption:
|
|
type: object
|
|
description: The attribute's attributes.
|
|
x-schemaName: AdminRuleAttributeOption
|
|
required:
|
|
- id
|
|
- value
|
|
- label
|
|
- field_type
|
|
- required
|
|
- disguised
|
|
- operators
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The attribute's ID.
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The attribute's value.
|
|
label:
|
|
type: string
|
|
title: label
|
|
description: The attribute's label.
|
|
field_type:
|
|
type: string
|
|
title: field_type
|
|
description: The attribute's field type.
|
|
required:
|
|
type: boolean
|
|
title: required
|
|
description: The attribute's required.
|
|
disguised:
|
|
type: boolean
|
|
title: disguised
|
|
description: The attribute's disguised.
|
|
operators:
|
|
type: array
|
|
description: The attribute's operators.
|
|
items:
|
|
$ref: '#/components/schemas/BaseRuleOperatorOptions'
|
|
AdminRuleValueOption:
|
|
type: object
|
|
description: The value's values.
|
|
x-schemaName: AdminRuleValueOption
|
|
required:
|
|
- id
|
|
- value
|
|
- label
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The value's ID.
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The value's details.
|
|
label:
|
|
type: string
|
|
title: label
|
|
description: The value's label.
|
|
AdminSalesChannel:
|
|
type: object
|
|
description: The sales channel's sales channels.
|
|
x-schemaName: AdminSalesChannel
|
|
required:
|
|
- id
|
|
- name
|
|
- description
|
|
- is_disabled
|
|
- metadata
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The sales channel's ID.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The sales channel's name.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The sales channel's description.
|
|
is_disabled:
|
|
type: boolean
|
|
title: is_disabled
|
|
description: The sales channel's is disabled.
|
|
metadata:
|
|
type: object
|
|
description: The sales channel's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The sales channel's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The sales channel's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The sales channel's deleted at.
|
|
AdminSalesChannelDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminSalesChannelDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The sales channel's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The sales channel's object.
|
|
default: sales-channel
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The sales channel's deleted.
|
|
parent:
|
|
type: object
|
|
description: The sales channel's parent.
|
|
AdminSalesChannelResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminSalesChannelResponse
|
|
required:
|
|
- sales_channel
|
|
properties:
|
|
sales_channel:
|
|
$ref: '#/components/schemas/AdminSalesChannel'
|
|
AdminServiceZone:
|
|
type: object
|
|
description: The service zone's service zones.
|
|
x-schemaName: AdminServiceZone
|
|
required:
|
|
- id
|
|
- name
|
|
- fulfillment_set_id
|
|
- fulfillment_set
|
|
- geo_zones
|
|
- shipping_options
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The service zone's ID.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The service zone's name.
|
|
fulfillment_set_id:
|
|
type: string
|
|
title: fulfillment_set_id
|
|
description: The service zone's fulfillment set id.
|
|
fulfillment_set:
|
|
type: object
|
|
geo_zones:
|
|
type: array
|
|
description: The service zone's geo zones.
|
|
items:
|
|
$ref: '#/components/schemas/AdminGeoZone'
|
|
shipping_options:
|
|
type: array
|
|
description: The service zone's shipping options.
|
|
items:
|
|
$ref: '#/components/schemas/AdminShippingOption'
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The service zone's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The service zone's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The service zone's deleted at.
|
|
AdminServiceZoneResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminServiceZoneResponse
|
|
required:
|
|
- service_zone
|
|
properties:
|
|
service_zone:
|
|
$ref: '#/components/schemas/AdminServiceZone'
|
|
AdminShippingOption:
|
|
type: object
|
|
description: The shipping option's shipping options.
|
|
x-schemaName: AdminShippingOption
|
|
AdminShippingOptionDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminShippingOptionDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The shipping option's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The shipping option's object.
|
|
default: shipping_option
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The shipping option's deleted.
|
|
parent:
|
|
type: object
|
|
description: The shipping option's parent.
|
|
AdminShippingOptionResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminShippingOptionResponse
|
|
required:
|
|
- shipping_option
|
|
properties:
|
|
shipping_option:
|
|
$ref: '#/components/schemas/AdminShippingOption'
|
|
AdminShippingOptionRule:
|
|
type: object
|
|
description: The updated's details.
|
|
x-schemaName: AdminShippingOptionRule
|
|
required:
|
|
- id
|
|
- attribute
|
|
- operator
|
|
- value
|
|
- shipping_option_id
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The updated's ID.
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The updated's attribute.
|
|
operator:
|
|
type: string
|
|
title: operator
|
|
description: The updated's operator.
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The updated's value.
|
|
- type: array
|
|
description: The updated's value.
|
|
items:
|
|
type: string
|
|
title: value
|
|
description: The value's details.
|
|
shipping_option_id:
|
|
type: string
|
|
title: shipping_option_id
|
|
description: The updated's shipping option id.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The updated's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The updated's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The updated's deleted at.
|
|
AdminShippingProfile:
|
|
type: object
|
|
description: The shipping option's shipping profile.
|
|
x-schemaName: AdminShippingProfile
|
|
AdminShippingProfileDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminShippingProfileDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The shipping profile's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The shipping profile's object.
|
|
default: shipping_profile
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The shipping profile's deleted.
|
|
parent:
|
|
type: object
|
|
description: The shipping profile's parent.
|
|
AdminShippingProfileResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminShippingProfileResponse
|
|
required:
|
|
- shipping_profile
|
|
properties:
|
|
shipping_profile:
|
|
$ref: '#/components/schemas/AdminShippingProfile'
|
|
AdminStockLocation:
|
|
type: object
|
|
description: The fulfillment set's location.
|
|
x-schemaName: AdminStockLocation
|
|
required:
|
|
- id
|
|
- name
|
|
- address_id
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The location's ID.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The location's name.
|
|
address_id:
|
|
type: string
|
|
title: address_id
|
|
description: The location's address id.
|
|
address:
|
|
$ref: '#/components/schemas/AdminStockLocationAddress'
|
|
sales_channels:
|
|
type: array
|
|
description: The location's sales channels.
|
|
items:
|
|
$ref: '#/components/schemas/AdminSalesChannel'
|
|
fulfillment_providers:
|
|
type: array
|
|
description: The location's fulfillment providers.
|
|
items:
|
|
$ref: '#/components/schemas/AdminFulfillmentProvider'
|
|
fulfillment_sets:
|
|
type: array
|
|
description: The location's fulfillment sets.
|
|
items:
|
|
type: object
|
|
AdminStockLocationAddress:
|
|
type: object
|
|
description: The location's address.
|
|
x-schemaName: AdminStockLocationAddress
|
|
AdminStockLocationDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminStockLocationDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The stock location's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The stock location's object.
|
|
default: stock_location
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The stock location's deleted.
|
|
parent:
|
|
type: object
|
|
description: The stock location's parent.
|
|
AdminStockLocationListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminStockLocationListResponse
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
- stock_locations
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The stock location's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The stock location's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The stock location's count.
|
|
stock_locations:
|
|
type: array
|
|
description: The stock location's stock locations.
|
|
items:
|
|
$ref: '#/components/schemas/AdminStockLocation'
|
|
AdminStockLocationResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminStockLocationResponse
|
|
required:
|
|
- stock_location
|
|
properties:
|
|
stock_location:
|
|
$ref: '#/components/schemas/AdminStockLocation'
|
|
AdminStore:
|
|
type: object
|
|
description: The store's details.
|
|
x-schemaName: AdminStore
|
|
required:
|
|
- id
|
|
- name
|
|
- supported_currencies
|
|
- default_sales_channel_id
|
|
- default_region_id
|
|
- default_location_id
|
|
- metadata
|
|
- created_at
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The store's ID.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The store's name.
|
|
supported_currencies:
|
|
type: array
|
|
description: The store's supported currencies.
|
|
items:
|
|
$ref: '#/components/schemas/AdminStoreCurrency'
|
|
default_sales_channel_id:
|
|
type: string
|
|
title: default_sales_channel_id
|
|
description: The store's default sales channel id.
|
|
default_region_id:
|
|
type: string
|
|
title: default_region_id
|
|
description: The store's default region id.
|
|
default_location_id:
|
|
type: string
|
|
title: default_location_id
|
|
description: The store's default location id.
|
|
metadata:
|
|
type: object
|
|
description: The store's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The store's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The store's updated at.
|
|
AdminStoreCurrency:
|
|
type: object
|
|
description: The supported currency's supported currencies.
|
|
x-schemaName: AdminStoreCurrency
|
|
required:
|
|
- id
|
|
- currency_code
|
|
- store_id
|
|
- is_default
|
|
- currency
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The supported currency's ID.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The supported currency's currency code.
|
|
store_id:
|
|
type: string
|
|
title: store_id
|
|
description: The supported currency's store id.
|
|
is_default:
|
|
type: boolean
|
|
title: is_default
|
|
description: The supported currency's is default.
|
|
currency:
|
|
$ref: '#/components/schemas/AdminCurrency'
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The supported currency's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The supported currency's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The supported currency's deleted at.
|
|
AdminStoreListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminStoreListResponse
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
- stores
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The store's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The store's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The store's count.
|
|
stores:
|
|
type: array
|
|
description: The store's stores.
|
|
items:
|
|
$ref: '#/components/schemas/AdminStore'
|
|
AdminStoreResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminStoreResponse
|
|
required:
|
|
- store
|
|
properties:
|
|
store:
|
|
$ref: '#/components/schemas/AdminStore'
|
|
AdminTaxRate:
|
|
type: object
|
|
description: The tax rate's details.
|
|
x-schemaName: AdminTaxRate
|
|
required:
|
|
- id
|
|
- rate
|
|
- code
|
|
- name
|
|
- metadata
|
|
- tax_region_id
|
|
- is_combinable
|
|
- is_default
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
- created_by
|
|
- tax_region
|
|
- rules
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The tax rate's ID.
|
|
rate:
|
|
type: number
|
|
title: rate
|
|
description: The tax rate's rate.
|
|
code:
|
|
type: string
|
|
title: code
|
|
description: The tax rate's code.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The tax rate's name.
|
|
metadata:
|
|
type: object
|
|
description: The tax rate's metadata.
|
|
tax_region_id:
|
|
type: string
|
|
title: tax_region_id
|
|
description: The tax rate's tax region id.
|
|
is_combinable:
|
|
type: boolean
|
|
title: is_combinable
|
|
description: The tax rate's is combinable.
|
|
is_default:
|
|
type: boolean
|
|
title: is_default
|
|
description: The tax rate's is default.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The tax rate's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The tax rate's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The tax rate's deleted at.
|
|
created_by:
|
|
type: string
|
|
title: created_by
|
|
description: The tax rate's created by.
|
|
tax_region:
|
|
$ref: '#/components/schemas/AdminTaxRegion'
|
|
rules:
|
|
type: array
|
|
description: The tax rate's rules.
|
|
items:
|
|
$ref: '#/components/schemas/AdminTaxRateRule'
|
|
AdminTaxRateDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminTaxRateDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The tax rate's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The tax rate's object.
|
|
default: tax_rate
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The tax rate's deleted.
|
|
parent:
|
|
type: object
|
|
description: The tax rate's parent.
|
|
AdminTaxRateResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminTaxRateResponse
|
|
required:
|
|
- tax_rate
|
|
properties:
|
|
tax_rate:
|
|
$ref: '#/components/schemas/AdminTaxRate'
|
|
AdminTaxRateRule:
|
|
type: object
|
|
description: The rule's rules.
|
|
x-schemaName: AdminTaxRateRule
|
|
required:
|
|
- reference
|
|
- reference_id
|
|
properties:
|
|
reference:
|
|
type: string
|
|
title: reference
|
|
description: The rule's reference.
|
|
reference_id:
|
|
type: string
|
|
title: reference_id
|
|
description: The rule's reference id.
|
|
AdminTaxRegion:
|
|
type: object
|
|
description: The tax rate's tax region.
|
|
x-schemaName: AdminTaxRegion
|
|
required:
|
|
- id
|
|
- rate
|
|
- code
|
|
- country_code
|
|
- province_code
|
|
- name
|
|
- metadata
|
|
- tax_region_id
|
|
- is_combinable
|
|
- is_default
|
|
- parent_id
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
- created_by
|
|
- tax_rates
|
|
- parent
|
|
- children
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The tax region's ID.
|
|
rate:
|
|
type: number
|
|
title: rate
|
|
description: The tax region's rate.
|
|
code:
|
|
type: string
|
|
title: code
|
|
description: The tax region's code.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The tax region's country code.
|
|
province_code:
|
|
type: string
|
|
title: province_code
|
|
description: The tax region's province code.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The tax region's name.
|
|
metadata:
|
|
type: object
|
|
description: The tax region's metadata.
|
|
tax_region_id:
|
|
type: string
|
|
title: tax_region_id
|
|
description: The tax region's tax region id.
|
|
is_combinable:
|
|
type: boolean
|
|
title: is_combinable
|
|
description: The tax region's is combinable.
|
|
is_default:
|
|
type: boolean
|
|
title: is_default
|
|
description: The tax region's is default.
|
|
parent_id:
|
|
type: string
|
|
title: parent_id
|
|
description: The tax region's parent id.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The tax region's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The tax region's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The tax region's deleted at.
|
|
created_by:
|
|
type: string
|
|
title: created_by
|
|
description: The tax region's created by.
|
|
tax_rates:
|
|
type: array
|
|
description: The tax region's tax rates.
|
|
items:
|
|
type: object
|
|
parent:
|
|
type: object
|
|
children:
|
|
type: array
|
|
description: The tax region's children.
|
|
items:
|
|
type: object
|
|
AdminTaxRegionDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminTaxRegionDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The tax region's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The tax region's object.
|
|
default: tax_region
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The tax region's deleted.
|
|
parent:
|
|
type: object
|
|
description: The tax region's parent.
|
|
AdminTaxRegionResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminTaxRegionResponse
|
|
required:
|
|
- tax_region
|
|
properties:
|
|
tax_region:
|
|
$ref: '#/components/schemas/AdminTaxRegion'
|
|
AdminUpdateApiKey:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminUpdateApiKey
|
|
required:
|
|
- title
|
|
properties:
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The api key's title.
|
|
AdminUpdateCollection:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminUpdateCollection
|
|
required:
|
|
- metadata
|
|
properties:
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The collection's title.
|
|
handle:
|
|
type: string
|
|
title: handle
|
|
description: The collection's handle.
|
|
metadata:
|
|
type: object
|
|
description: The collection's metadata.
|
|
AdminUpdateCustomerGroup:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminUpdateCustomerGroup
|
|
required:
|
|
- metadata
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The customer group's name.
|
|
metadata:
|
|
type: object
|
|
description: The customer group's metadata.
|
|
AdminUpdatePriceList:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminUpdatePriceList
|
|
required:
|
|
- description
|
|
- starts_at
|
|
- ends_at
|
|
properties:
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The price list's title.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The price list's description.
|
|
starts_at:
|
|
type: string
|
|
title: starts_at
|
|
description: The price list's starts at.
|
|
ends_at:
|
|
type: string
|
|
title: ends_at
|
|
description: The price list's ends at.
|
|
status:
|
|
type: string
|
|
enum:
|
|
- active
|
|
- draft
|
|
type:
|
|
type: string
|
|
enum:
|
|
- sale
|
|
- override
|
|
rules:
|
|
type: object
|
|
description: The price list's rules.
|
|
AdminUpdatePricePreference:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminUpdatePricePreference
|
|
properties:
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The price preference's attribute.
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The price preference's value.
|
|
is_tax_inclusive:
|
|
type: boolean
|
|
title: is_tax_inclusive
|
|
description: The price preference's is tax inclusive.
|
|
AdminUpdateProduct:
|
|
type: object
|
|
description: The update's details.
|
|
x-schemaName: AdminUpdateProduct
|
|
properties:
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The update's title.
|
|
subtitle:
|
|
type: string
|
|
title: subtitle
|
|
description: The update's subtitle.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The update's description.
|
|
is_giftcard:
|
|
type: boolean
|
|
title: is_giftcard
|
|
description: The update's is giftcard.
|
|
discountable:
|
|
type: boolean
|
|
title: discountable
|
|
description: The update's discountable.
|
|
images:
|
|
type: array
|
|
description: The update's images.
|
|
items:
|
|
type: object
|
|
description: The image's images.
|
|
required:
|
|
- url
|
|
properties:
|
|
url:
|
|
type: string
|
|
title: url
|
|
description: The image's url.
|
|
thumbnail:
|
|
type: string
|
|
title: thumbnail
|
|
description: The update's thumbnail.
|
|
handle:
|
|
type: string
|
|
title: handle
|
|
description: The update's handle.
|
|
status:
|
|
type: string
|
|
enum:
|
|
- draft
|
|
- proposed
|
|
- published
|
|
- rejected
|
|
type_id:
|
|
type: string
|
|
title: type_id
|
|
description: The update's type id.
|
|
collection_id:
|
|
type: string
|
|
title: collection_id
|
|
description: The update's collection id.
|
|
categories:
|
|
type: array
|
|
description: The update's categories.
|
|
items:
|
|
type: object
|
|
description: The category's categories.
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The category's ID.
|
|
tags:
|
|
type: array
|
|
description: The update's tags.
|
|
items:
|
|
type: object
|
|
description: The tag's tags.
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The tag's ID.
|
|
options:
|
|
type: array
|
|
description: The update's options.
|
|
items:
|
|
$ref: '#/components/schemas/AdminUpdateProductOption'
|
|
variants:
|
|
type: array
|
|
description: The update's variants.
|
|
items:
|
|
oneOf:
|
|
- type: object
|
|
description: The variant's variants.
|
|
x-schemaName: AdminCreateProductVariant
|
|
required:
|
|
- title
|
|
- prices
|
|
properties:
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The variant's title.
|
|
sku:
|
|
type: string
|
|
title: sku
|
|
description: The variant's sku.
|
|
ean:
|
|
type: string
|
|
title: ean
|
|
description: The variant's ean.
|
|
upc:
|
|
type: string
|
|
title: upc
|
|
description: The variant's upc.
|
|
barcode:
|
|
type: string
|
|
title: barcode
|
|
description: The variant's barcode.
|
|
hs_code:
|
|
type: string
|
|
title: hs_code
|
|
description: The variant's hs code.
|
|
mid_code:
|
|
type: string
|
|
title: mid_code
|
|
description: The variant's mid code.
|
|
allow_backorder:
|
|
type: boolean
|
|
title: allow_backorder
|
|
description: The variant's allow backorder.
|
|
manage_inventory:
|
|
type: boolean
|
|
title: manage_inventory
|
|
description: The variant's manage inventory.
|
|
variant_rank:
|
|
type: number
|
|
title: variant_rank
|
|
description: The variant's variant rank.
|
|
weight:
|
|
type: number
|
|
title: weight
|
|
description: The variant's weight.
|
|
length:
|
|
type: number
|
|
title: length
|
|
description: The variant's length.
|
|
height:
|
|
type: number
|
|
title: height
|
|
description: The variant's height.
|
|
width:
|
|
type: number
|
|
title: width
|
|
description: The variant's width.
|
|
origin_country:
|
|
type: string
|
|
title: origin_country
|
|
description: The variant's origin country.
|
|
material:
|
|
type: string
|
|
title: material
|
|
description: The variant's material.
|
|
metadata:
|
|
type: object
|
|
description: The variant's metadata.
|
|
prices:
|
|
type: array
|
|
description: The variant's prices.
|
|
items:
|
|
$ref: '#/components/schemas/AdminCreateProductVariantPrice'
|
|
options:
|
|
type: object
|
|
description: The variant's options.
|
|
- type: object
|
|
description: The variant's variants.
|
|
x-schemaName: AdminUpdateProductVariant
|
|
properties:
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The variant's title.
|
|
sku:
|
|
type: string
|
|
title: sku
|
|
description: The variant's sku.
|
|
ean:
|
|
type: string
|
|
title: ean
|
|
description: The variant's ean.
|
|
upc:
|
|
type: string
|
|
title: upc
|
|
description: The variant's upc.
|
|
barcode:
|
|
type: string
|
|
title: barcode
|
|
description: The variant's barcode.
|
|
hs_code:
|
|
type: string
|
|
title: hs_code
|
|
description: The variant's hs code.
|
|
mid_code:
|
|
type: string
|
|
title: mid_code
|
|
description: The variant's mid code.
|
|
allow_backorder:
|
|
type: boolean
|
|
title: allow_backorder
|
|
description: The variant's allow backorder.
|
|
manage_inventory:
|
|
type: boolean
|
|
title: manage_inventory
|
|
description: The variant's manage inventory.
|
|
variant_rank:
|
|
type: number
|
|
title: variant_rank
|
|
description: The variant's variant rank.
|
|
weight:
|
|
type: number
|
|
title: weight
|
|
description: The variant's weight.
|
|
length:
|
|
type: number
|
|
title: length
|
|
description: The variant's length.
|
|
height:
|
|
type: number
|
|
title: height
|
|
description: The variant's height.
|
|
width:
|
|
type: number
|
|
title: width
|
|
description: The variant's width.
|
|
origin_country:
|
|
type: string
|
|
title: origin_country
|
|
description: The variant's origin country.
|
|
material:
|
|
type: string
|
|
title: material
|
|
description: The variant's material.
|
|
metadata:
|
|
type: object
|
|
description: The variant's metadata.
|
|
prices:
|
|
type: array
|
|
description: The variant's prices.
|
|
items:
|
|
$ref: '#/components/schemas/AdminCreateProductVariantPrice'
|
|
options:
|
|
type: object
|
|
description: The variant's options.
|
|
sales_channels:
|
|
type: array
|
|
description: The update's sales channels.
|
|
items:
|
|
type: object
|
|
description: The sales channel's sales channels.
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The sales channel's ID.
|
|
weight:
|
|
type: number
|
|
title: weight
|
|
description: The update's weight.
|
|
length:
|
|
type: number
|
|
title: length
|
|
description: The update's length.
|
|
height:
|
|
type: number
|
|
title: height
|
|
description: The update's height.
|
|
width:
|
|
type: number
|
|
title: width
|
|
description: The update's width.
|
|
hs_code:
|
|
type: string
|
|
title: hs_code
|
|
description: The update's hs code.
|
|
mid_code:
|
|
type: string
|
|
title: mid_code
|
|
description: The update's mid code.
|
|
origin_country:
|
|
type: string
|
|
title: origin_country
|
|
description: The update's origin country.
|
|
material:
|
|
type: string
|
|
title: material
|
|
description: The update's material.
|
|
metadata:
|
|
type: object
|
|
description: The update's metadata.
|
|
AdminUpdateProductOption:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminUpdateProductOption
|
|
properties:
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The product's title.
|
|
values:
|
|
type: array
|
|
description: The product's values.
|
|
items:
|
|
type: string
|
|
title: values
|
|
description: The value's values.
|
|
AdminUpdateProductVariant:
|
|
type: object
|
|
description: The update's details.
|
|
x-schemaName: AdminUpdateProductVariant
|
|
properties:
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The update's title.
|
|
sku:
|
|
type: string
|
|
title: sku
|
|
description: The update's sku.
|
|
ean:
|
|
type: string
|
|
title: ean
|
|
description: The update's ean.
|
|
upc:
|
|
type: string
|
|
title: upc
|
|
description: The update's upc.
|
|
barcode:
|
|
type: string
|
|
title: barcode
|
|
description: The update's barcode.
|
|
hs_code:
|
|
type: string
|
|
title: hs_code
|
|
description: The update's hs code.
|
|
mid_code:
|
|
type: string
|
|
title: mid_code
|
|
description: The update's mid code.
|
|
allow_backorder:
|
|
type: boolean
|
|
title: allow_backorder
|
|
description: The update's allow backorder.
|
|
manage_inventory:
|
|
type: boolean
|
|
title: manage_inventory
|
|
description: The update's manage inventory.
|
|
variant_rank:
|
|
type: number
|
|
title: variant_rank
|
|
description: The update's variant rank.
|
|
weight:
|
|
type: number
|
|
title: weight
|
|
description: The update's weight.
|
|
length:
|
|
type: number
|
|
title: length
|
|
description: The update's length.
|
|
height:
|
|
type: number
|
|
title: height
|
|
description: The update's height.
|
|
width:
|
|
type: number
|
|
title: width
|
|
description: The update's width.
|
|
origin_country:
|
|
type: string
|
|
title: origin_country
|
|
description: The update's origin country.
|
|
material:
|
|
type: string
|
|
title: material
|
|
description: The update's material.
|
|
metadata:
|
|
type: object
|
|
description: The update's metadata.
|
|
prices:
|
|
type: array
|
|
description: The update's prices.
|
|
items:
|
|
$ref: '#/components/schemas/AdminCreateProductVariantPrice'
|
|
options:
|
|
type: object
|
|
description: The update's options.
|
|
AdminUpdateSalesChannel:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminUpdateSalesChannel
|
|
required:
|
|
- description
|
|
- metadata
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The sales channel's name.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The sales channel's description.
|
|
is_disabled:
|
|
type: boolean
|
|
title: is_disabled
|
|
description: The sales channel's is disabled.
|
|
metadata:
|
|
type: object
|
|
description: The sales channel's metadata.
|
|
AdminUpdateStockLocation:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminUpdateStockLocation
|
|
required:
|
|
- address_id
|
|
- metadata
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The stock location's name.
|
|
address:
|
|
type: object
|
|
description: The stock location's address.
|
|
required:
|
|
- address_1
|
|
- address_2
|
|
- company
|
|
- city
|
|
- country_code
|
|
- phone
|
|
- postal_code
|
|
- province
|
|
properties:
|
|
address_1:
|
|
type: string
|
|
title: address_1
|
|
description: The address's address 1.
|
|
address_2:
|
|
type: string
|
|
title: address_2
|
|
description: The address's address 2.
|
|
company:
|
|
type: string
|
|
title: company
|
|
description: The address's company.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The address's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The address's country code.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The address's phone.
|
|
postal_code:
|
|
type: string
|
|
title: postal_code
|
|
description: The address's postal code.
|
|
province:
|
|
type: string
|
|
title: province
|
|
description: The address's province.
|
|
address_id:
|
|
type: string
|
|
title: address_id
|
|
description: The stock location's address id.
|
|
metadata:
|
|
type: object
|
|
description: The stock location's metadata.
|
|
AdminUpdateStore:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminUpdateStore
|
|
required:
|
|
- default_sales_channel_id
|
|
- default_region_id
|
|
- default_location_id
|
|
- metadata
|
|
properties:
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The store's name.
|
|
supported_currencies:
|
|
type: array
|
|
description: The store's supported currencies.
|
|
items:
|
|
type: object
|
|
description: The supported currency's supported currencies.
|
|
required:
|
|
- currency_code
|
|
properties:
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The supported currency's currency code.
|
|
is_default:
|
|
type: boolean
|
|
title: is_default
|
|
description: The supported currency's is default.
|
|
is_tax_inclusive:
|
|
type: boolean
|
|
title: is_tax_inclusive
|
|
description: The supported currency's is tax inclusive.
|
|
default_sales_channel_id:
|
|
type: string
|
|
title: default_sales_channel_id
|
|
description: The store's default sales channel id.
|
|
default_region_id:
|
|
type: string
|
|
title: default_region_id
|
|
description: The store's default region id.
|
|
default_location_id:
|
|
type: string
|
|
title: default_location_id
|
|
description: The store's default location id.
|
|
metadata:
|
|
type: object
|
|
description: The store's metadata.
|
|
AdminUpdateTaxRate:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminUpdateTaxRate
|
|
required:
|
|
- code
|
|
- metadata
|
|
properties:
|
|
rate:
|
|
type: number
|
|
title: rate
|
|
description: The tax rate's rate.
|
|
code:
|
|
type: string
|
|
title: code
|
|
description: The tax rate's code.
|
|
rules:
|
|
type: array
|
|
description: The tax rate's rules.
|
|
items:
|
|
type: object
|
|
description: The rule's rules.
|
|
required:
|
|
- reference
|
|
- reference_id
|
|
properties:
|
|
reference:
|
|
type: string
|
|
title: reference
|
|
description: The rule's reference.
|
|
reference_id:
|
|
type: string
|
|
title: reference_id
|
|
description: The rule's reference id.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The tax rate's name.
|
|
is_default:
|
|
type: boolean
|
|
title: is_default
|
|
description: The tax rate's is default.
|
|
is_combinable:
|
|
type: boolean
|
|
title: is_combinable
|
|
description: The tax rate's is combinable.
|
|
metadata:
|
|
type: object
|
|
description: The tax rate's metadata.
|
|
AdminUpdateUser:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminUpdateUser
|
|
required:
|
|
- first_name
|
|
- last_name
|
|
- avatar_url
|
|
properties:
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The user's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The user's last name.
|
|
avatar_url:
|
|
type: string
|
|
title: avatar_url
|
|
description: The user's avatar url.
|
|
AdminUpdateVariantInventoryItem:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminUpdateVariantInventoryItem
|
|
required:
|
|
- required_quantity
|
|
properties:
|
|
required_quantity:
|
|
type: number
|
|
title: required_quantity
|
|
description: The product's required quantity.
|
|
AdminUser:
|
|
type: object
|
|
description: The user's details.
|
|
x-schemaName: AdminUser
|
|
required:
|
|
- id
|
|
- email
|
|
- first_name
|
|
- last_name
|
|
- avatar_url
|
|
- metadata
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The user's ID.
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The user's email.
|
|
format: email
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The user's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The user's last name.
|
|
avatar_url:
|
|
type: string
|
|
title: avatar_url
|
|
description: The user's avatar url.
|
|
metadata:
|
|
type: object
|
|
description: The user's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The user's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The user's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The user's deleted at.
|
|
AdminUserDeleteResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminUserDeleteResponse
|
|
required:
|
|
- id
|
|
- object
|
|
- deleted
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The user's ID.
|
|
object:
|
|
type: string
|
|
title: object
|
|
description: The user's object.
|
|
default: user
|
|
deleted:
|
|
type: boolean
|
|
title: deleted
|
|
description: The user's deleted.
|
|
parent:
|
|
type: object
|
|
description: The user's parent.
|
|
AdminUserListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminUserListResponse
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
- users
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The user's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The user's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The user's count.
|
|
users:
|
|
type: array
|
|
description: The user's users.
|
|
items:
|
|
$ref: '#/components/schemas/AdminUser'
|
|
AdminUserResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminUserResponse
|
|
required:
|
|
- user
|
|
properties:
|
|
user:
|
|
$ref: '#/components/schemas/AdminUser'
|
|
AdminWorkflowExecution:
|
|
type: object
|
|
description: The workflows execution's workflow execution.
|
|
x-schemaName: AdminWorkflowExecution
|
|
required:
|
|
- id
|
|
- workflow_id
|
|
- transaction_id
|
|
- execution
|
|
- context
|
|
- state
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The workflow execution's ID.
|
|
workflow_id:
|
|
type: string
|
|
title: workflow_id
|
|
description: The workflow execution's workflow id.
|
|
transaction_id:
|
|
type: string
|
|
title: transaction_id
|
|
description: The workflow execution's transaction id.
|
|
execution:
|
|
type: string
|
|
title: execution
|
|
description: The workflow execution's execution.
|
|
context:
|
|
type: string
|
|
title: context
|
|
description: The workflow execution's context.
|
|
state: {}
|
|
created_at:
|
|
type: string
|
|
title: created_at
|
|
description: The workflow execution's created at.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
title: updated_at
|
|
description: The workflow execution's updated at.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
title: deleted_at
|
|
description: The workflow execution's deleted at.
|
|
format: date-time
|
|
AdminWorkflowExecutionResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: AdminWorkflowExecutionResponse
|
|
required:
|
|
- workflow_execution
|
|
properties:
|
|
workflow_execution:
|
|
$ref: '#/components/schemas/AdminWorkflowExecution'
|
|
ApiKeyResponse:
|
|
type: object
|
|
description: The api key's details.
|
|
x-schemaName: ApiKeyResponse
|
|
required:
|
|
- id
|
|
- token
|
|
- redacted
|
|
- title
|
|
- type
|
|
- last_used_at
|
|
- created_by
|
|
- created_at
|
|
- revoked_by
|
|
- revoked_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The api key's ID.
|
|
token:
|
|
type: string
|
|
title: token
|
|
description: The api key's token.
|
|
redacted:
|
|
type: string
|
|
title: redacted
|
|
description: The api key's redacted.
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The api key's title.
|
|
type:
|
|
type: string
|
|
enum:
|
|
- secret
|
|
- publishable
|
|
last_used_at:
|
|
type: string
|
|
title: last_used_at
|
|
description: The api key's last used at.
|
|
format: date-time
|
|
created_by:
|
|
type: string
|
|
title: created_by
|
|
description: The api key's created by.
|
|
created_at:
|
|
type: string
|
|
title: created_at
|
|
description: The api key's created at.
|
|
format: date-time
|
|
revoked_by:
|
|
type: string
|
|
title: revoked_by
|
|
description: The api key's revoked by.
|
|
revoked_at:
|
|
type: string
|
|
title: revoked_at
|
|
description: The api key's revoked at.
|
|
format: date-time
|
|
AuthAdminSessionResponse:
|
|
type: object
|
|
description: The authenticated user's details.
|
|
x-schemaName: AuthAdminSessionResponse
|
|
required:
|
|
- user
|
|
properties:
|
|
user:
|
|
title: user
|
|
description: The logged-in user.
|
|
$ref: '#/components/schemas/AdminUser'
|
|
AuthResponse:
|
|
type: object
|
|
description: The authentication's details.
|
|
x-schemaName: AuthResponse
|
|
required:
|
|
- token
|
|
properties:
|
|
token:
|
|
type: string
|
|
title: token
|
|
description: The JWT token used for registration or authentication.
|
|
AuthStoreSessionResponse:
|
|
type: object
|
|
description: The authenticated customer's details.
|
|
x-schemaName: AuthStoreSessionResponse
|
|
required:
|
|
- user
|
|
properties:
|
|
user:
|
|
title: user
|
|
description: The logged-in customer.
|
|
$ref: '#/components/schemas/StoreCustomer'
|
|
BaseApplicationMethod:
|
|
type: object
|
|
description: The promotion's application method.
|
|
x-schemaName: BaseApplicationMethod
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The application method's ID.
|
|
type:
|
|
type: string
|
|
enum:
|
|
- fixed
|
|
- percentage
|
|
target_type:
|
|
type: string
|
|
enum:
|
|
- items
|
|
- shipping_methods
|
|
- order
|
|
allocation:
|
|
type: string
|
|
enum:
|
|
- each
|
|
- across
|
|
value:
|
|
type: number
|
|
title: value
|
|
description: The application method's value.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The application method's currency code.
|
|
max_quantity:
|
|
type: number
|
|
title: max_quantity
|
|
description: The application method's max quantity.
|
|
buy_rules_min_quantity:
|
|
type: number
|
|
title: buy_rules_min_quantity
|
|
description: The application method's buy rules min quantity.
|
|
apply_to_quantity:
|
|
type: number
|
|
title: apply_to_quantity
|
|
description: The application method's apply to quantity.
|
|
promotion:
|
|
$ref: '#/components/schemas/BasePromotion'
|
|
target_rules:
|
|
type: array
|
|
description: The application method's target rules.
|
|
items:
|
|
$ref: '#/components/schemas/BasePromotionRule'
|
|
buy_rules:
|
|
type: array
|
|
description: The application method's buy rules.
|
|
items:
|
|
$ref: '#/components/schemas/BasePromotionRule'
|
|
BaseCalculatedPriceSet:
|
|
type: object
|
|
description: The parent's calculated price.
|
|
x-schemaName: BaseCalculatedPriceSet
|
|
required:
|
|
- id
|
|
- calculated_amount
|
|
- original_amount
|
|
- currency_code
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The calculated price's ID.
|
|
is_calculated_price_price_list:
|
|
type: boolean
|
|
title: is_calculated_price_price_list
|
|
description: The calculated price's is calculated price price list.
|
|
is_calculated_price_tax_inclusive:
|
|
type: boolean
|
|
title: is_calculated_price_tax_inclusive
|
|
description: The calculated price's is calculated price tax inclusive.
|
|
calculated_amount:
|
|
type: number
|
|
title: calculated_amount
|
|
description: The calculated price's calculated amount.
|
|
calculated_amount_with_tax:
|
|
type: number
|
|
title: calculated_amount_with_tax
|
|
description: The calculated price's calculated amount with tax.
|
|
calculated_amount_without_tax:
|
|
type: number
|
|
title: calculated_amount_without_tax
|
|
description: The calculated price's calculated amount without tax.
|
|
is_original_price_price_list:
|
|
type: boolean
|
|
title: is_original_price_price_list
|
|
description: The calculated price's is original price price list.
|
|
is_original_price_tax_inclusive:
|
|
type: boolean
|
|
title: is_original_price_tax_inclusive
|
|
description: The calculated price's is original price tax inclusive.
|
|
original_amount:
|
|
type: number
|
|
title: original_amount
|
|
description: The calculated price's original amount.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The calculated price's currency code.
|
|
calculated_price:
|
|
type: object
|
|
description: The calculated price's details.
|
|
original_price:
|
|
type: object
|
|
description: The calculated price's original price.
|
|
BaseCapture:
|
|
type: object
|
|
description: The capture's captures.
|
|
x-schemaName: BaseCapture
|
|
BaseCart:
|
|
type: object
|
|
description: The item's cart.
|
|
x-schemaName: BaseCart
|
|
BaseCartAddress:
|
|
type: object
|
|
description: The cart's billing address.
|
|
x-schemaName: BaseCartAddress
|
|
required:
|
|
- id
|
|
- created_at
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The billing address's ID.
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The billing address's customer id.
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The billing address's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The billing address's last name.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The billing address's phone.
|
|
company:
|
|
type: string
|
|
title: company
|
|
description: The billing address's company.
|
|
address_1:
|
|
type: string
|
|
title: address_1
|
|
description: The billing address's address 1.
|
|
address_2:
|
|
type: string
|
|
title: address_2
|
|
description: The billing address's address 2.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The billing address's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The billing address's country code.
|
|
province:
|
|
type: string
|
|
title: province
|
|
description: The billing address's province.
|
|
postal_code:
|
|
type: string
|
|
title: postal_code
|
|
description: The billing address's postal code.
|
|
metadata:
|
|
type: object
|
|
description: The billing address's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The billing address's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The billing address's updated at.
|
|
BaseCartLineItem:
|
|
type: object
|
|
description: The item's items.
|
|
x-schemaName: BaseCartLineItem
|
|
required:
|
|
- id
|
|
- title
|
|
- quantity
|
|
- requires_shipping
|
|
- is_discountable
|
|
- is_tax_inclusive
|
|
- unit_price
|
|
- cart
|
|
- cart_id
|
|
- original_total
|
|
- original_subtotal
|
|
- original_tax_total
|
|
- item_total
|
|
- item_subtotal
|
|
- item_tax_total
|
|
- total
|
|
- subtotal
|
|
- tax_total
|
|
- discount_total
|
|
- discount_tax_total
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The item's ID.
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The item's title.
|
|
subtitle:
|
|
type: string
|
|
title: subtitle
|
|
description: The item's subtitle.
|
|
thumbnail:
|
|
type: string
|
|
title: thumbnail
|
|
description: The item's thumbnail.
|
|
quantity:
|
|
oneOf:
|
|
- type: string
|
|
title: quantity
|
|
description: The item's quantity.
|
|
- type: number
|
|
title: quantity
|
|
description: The item's quantity.
|
|
- type: string
|
|
title: quantity
|
|
description: The item's quantity.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
product:
|
|
$ref: '#/components/schemas/BaseProduct'
|
|
product_id:
|
|
type: string
|
|
title: product_id
|
|
description: The item's product id.
|
|
product_title:
|
|
type: string
|
|
title: product_title
|
|
description: The item's product title.
|
|
product_description:
|
|
type: string
|
|
title: product_description
|
|
description: The item's product description.
|
|
product_subtitle:
|
|
type: string
|
|
title: product_subtitle
|
|
description: The item's product subtitle.
|
|
product_type:
|
|
type: string
|
|
title: product_type
|
|
description: The item's product type.
|
|
product_collection:
|
|
type: string
|
|
title: product_collection
|
|
description: The item's product collection.
|
|
product_handle:
|
|
type: string
|
|
title: product_handle
|
|
description: The item's product handle.
|
|
variant:
|
|
$ref: '#/components/schemas/BaseProductVariant'
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The item's variant id.
|
|
variant_sku:
|
|
type: string
|
|
title: variant_sku
|
|
description: The item's variant sku.
|
|
variant_barcode:
|
|
type: string
|
|
title: variant_barcode
|
|
description: The item's variant barcode.
|
|
variant_title:
|
|
type: string
|
|
title: variant_title
|
|
description: The item's variant title.
|
|
variant_option_values:
|
|
type: object
|
|
description: The item's variant option values.
|
|
requires_shipping:
|
|
type: boolean
|
|
title: requires_shipping
|
|
description: The item's requires shipping.
|
|
is_discountable:
|
|
type: boolean
|
|
title: is_discountable
|
|
description: The item's is discountable.
|
|
is_tax_inclusive:
|
|
type: boolean
|
|
title: is_tax_inclusive
|
|
description: The item's is tax inclusive.
|
|
compare_at_unit_price:
|
|
oneOf:
|
|
- type: string
|
|
title: compare_at_unit_price
|
|
description: The item's compare at unit price.
|
|
- type: number
|
|
title: compare_at_unit_price
|
|
description: The item's compare at unit price.
|
|
- type: string
|
|
title: compare_at_unit_price
|
|
description: The item's compare at unit price.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
unit_price:
|
|
oneOf:
|
|
- type: string
|
|
title: unit_price
|
|
description: The item's unit price.
|
|
- type: number
|
|
title: unit_price
|
|
description: The item's unit price.
|
|
- type: string
|
|
title: unit_price
|
|
description: The item's unit price.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
tax_lines:
|
|
type: array
|
|
description: The item's tax lines.
|
|
items:
|
|
$ref: '#/components/schemas/BaseLineItemTaxLine'
|
|
adjustments:
|
|
type: array
|
|
description: The item's adjustments.
|
|
items:
|
|
$ref: '#/components/schemas/BaseLineItemAdjustment'
|
|
cart:
|
|
$ref: '#/components/schemas/BaseCart'
|
|
cart_id:
|
|
type: string
|
|
title: cart_id
|
|
description: The item's cart id.
|
|
metadata:
|
|
type: object
|
|
description: The item's metadata.
|
|
created_at:
|
|
type: string
|
|
title: created_at
|
|
description: The item's created at.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
title: updated_at
|
|
description: The item's updated at.
|
|
format: date-time
|
|
deleted_at:
|
|
type: string
|
|
title: deleted_at
|
|
description: The item's deleted at.
|
|
format: date-time
|
|
original_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_total
|
|
description: The item's original total.
|
|
- type: number
|
|
title: original_total
|
|
description: The item's original total.
|
|
- type: string
|
|
title: original_total
|
|
description: The item's original total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: original_subtotal
|
|
description: The item's original subtotal.
|
|
- type: number
|
|
title: original_subtotal
|
|
description: The item's original subtotal.
|
|
- type: string
|
|
title: original_subtotal
|
|
description: The item's original subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_tax_total
|
|
description: The item's original tax total.
|
|
- type: number
|
|
title: original_tax_total
|
|
description: The item's original tax total.
|
|
- type: string
|
|
title: original_tax_total
|
|
description: The item's original tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
item_total:
|
|
oneOf:
|
|
- type: string
|
|
title: item_total
|
|
description: The item's item total.
|
|
- type: number
|
|
title: item_total
|
|
description: The item's item total.
|
|
- type: string
|
|
title: item_total
|
|
description: The item's item total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
item_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: item_subtotal
|
|
description: The item's item subtotal.
|
|
- type: number
|
|
title: item_subtotal
|
|
description: The item's item subtotal.
|
|
- type: string
|
|
title: item_subtotal
|
|
description: The item's item subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
item_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: item_tax_total
|
|
description: The item's item tax total.
|
|
- type: number
|
|
title: item_tax_total
|
|
description: The item's item tax total.
|
|
- type: string
|
|
title: item_tax_total
|
|
description: The item's item tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
total:
|
|
oneOf:
|
|
- type: string
|
|
title: total
|
|
description: The item's total.
|
|
- type: number
|
|
title: total
|
|
description: The item's total.
|
|
- type: string
|
|
title: total
|
|
description: The item's total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: subtotal
|
|
description: The item's subtotal.
|
|
- type: number
|
|
title: subtotal
|
|
description: The item's subtotal.
|
|
- type: string
|
|
title: subtotal
|
|
description: The item's subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: tax_total
|
|
description: The item's tax total.
|
|
- type: number
|
|
title: tax_total
|
|
description: The item's tax total.
|
|
- type: string
|
|
title: tax_total
|
|
description: The item's tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
discount_total:
|
|
oneOf:
|
|
- type: string
|
|
title: discount_total
|
|
description: The item's discount total.
|
|
- type: number
|
|
title: discount_total
|
|
description: The item's discount total.
|
|
- type: string
|
|
title: discount_total
|
|
description: The item's discount total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
discount_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: discount_tax_total
|
|
description: The item's discount tax total.
|
|
- type: number
|
|
title: discount_tax_total
|
|
description: The item's discount tax total.
|
|
- type: string
|
|
title: discount_tax_total
|
|
description: The item's discount tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
BaseCartShippingMethod:
|
|
type: object
|
|
description: The shipping method's shipping methods.
|
|
x-schemaName: BaseCartShippingMethod
|
|
required:
|
|
- id
|
|
- cart_id
|
|
- name
|
|
- amount
|
|
- is_tax_inclusive
|
|
- created_at
|
|
- updated_at
|
|
- original_total
|
|
- original_subtotal
|
|
- original_tax_total
|
|
- total
|
|
- subtotal
|
|
- tax_total
|
|
- discount_total
|
|
- discount_tax_total
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The shipping method's ID.
|
|
cart_id:
|
|
type: string
|
|
title: cart_id
|
|
description: The shipping method's cart id.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The shipping method's name.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The shipping method's description.
|
|
amount:
|
|
oneOf:
|
|
- type: string
|
|
title: amount
|
|
description: The shipping method's amount.
|
|
- type: number
|
|
title: amount
|
|
description: The shipping method's amount.
|
|
- type: string
|
|
title: amount
|
|
description: The shipping method's amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
is_tax_inclusive:
|
|
type: boolean
|
|
title: is_tax_inclusive
|
|
description: The shipping method's is tax inclusive.
|
|
shipping_option_id:
|
|
type: string
|
|
title: shipping_option_id
|
|
description: The shipping method's shipping option id.
|
|
data:
|
|
type: object
|
|
description: The shipping method's data.
|
|
metadata:
|
|
type: object
|
|
description: The shipping method's metadata.
|
|
tax_lines:
|
|
type: array
|
|
description: The shipping method's tax lines.
|
|
items:
|
|
$ref: '#/components/schemas/BaseShippingMethodTaxLine'
|
|
adjustments:
|
|
type: array
|
|
description: The shipping method's adjustments.
|
|
items:
|
|
$ref: '#/components/schemas/BaseShippingMethodAdjustment'
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The shipping method's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The shipping method's updated at.
|
|
original_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_total
|
|
description: The shipping method's original total.
|
|
- type: number
|
|
title: original_total
|
|
description: The shipping method's original total.
|
|
- type: string
|
|
title: original_total
|
|
description: The shipping method's original total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: original_subtotal
|
|
description: The shipping method's original subtotal.
|
|
- type: number
|
|
title: original_subtotal
|
|
description: The shipping method's original subtotal.
|
|
- type: string
|
|
title: original_subtotal
|
|
description: The shipping method's original subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_tax_total
|
|
description: The shipping method's original tax total.
|
|
- type: number
|
|
title: original_tax_total
|
|
description: The shipping method's original tax total.
|
|
- type: string
|
|
title: original_tax_total
|
|
description: The shipping method's original tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
total:
|
|
oneOf:
|
|
- type: string
|
|
title: total
|
|
description: The shipping method's total.
|
|
- type: number
|
|
title: total
|
|
description: The shipping method's total.
|
|
- type: string
|
|
title: total
|
|
description: The shipping method's total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: subtotal
|
|
description: The shipping method's subtotal.
|
|
- type: number
|
|
title: subtotal
|
|
description: The shipping method's subtotal.
|
|
- type: string
|
|
title: subtotal
|
|
description: The shipping method's subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: tax_total
|
|
description: The shipping method's tax total.
|
|
- type: number
|
|
title: tax_total
|
|
description: The shipping method's tax total.
|
|
- type: string
|
|
title: tax_total
|
|
description: The shipping method's tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
discount_total:
|
|
oneOf:
|
|
- type: string
|
|
title: discount_total
|
|
description: The shipping method's discount total.
|
|
- type: number
|
|
title: discount_total
|
|
description: The shipping method's discount total.
|
|
- type: string
|
|
title: discount_total
|
|
description: The shipping method's discount total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
discount_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: discount_tax_total
|
|
description: The shipping method's discount tax total.
|
|
- type: number
|
|
title: discount_tax_total
|
|
description: The shipping method's discount tax total.
|
|
- type: string
|
|
title: discount_tax_total
|
|
description: The shipping method's discount tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
BaseClaim:
|
|
type: object
|
|
description: The order change's claim.
|
|
x-schemaName: BaseClaim
|
|
BaseClaimItem:
|
|
type: object
|
|
description: The claim item's claim items.
|
|
x-schemaName: BaseClaimItem
|
|
required:
|
|
- id
|
|
- claim_id
|
|
- order_id
|
|
- item_id
|
|
- quantity
|
|
- reason
|
|
- raw_quantity
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The claim item's ID.
|
|
claim_id:
|
|
type: string
|
|
title: claim_id
|
|
description: The claim item's claim id.
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The claim item's order id.
|
|
item_id:
|
|
type: string
|
|
title: item_id
|
|
description: The claim item's item id.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The claim item's quantity.
|
|
reason:
|
|
type: string
|
|
enum:
|
|
- missing_item
|
|
- wrong_item
|
|
- production_failure
|
|
- other
|
|
raw_quantity:
|
|
type: object
|
|
description: The claim item's raw quantity.
|
|
metadata:
|
|
type: object
|
|
description: The claim item's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The claim item's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The claim item's updated at.
|
|
BaseCollection:
|
|
type: object
|
|
description: The product's collection.
|
|
x-schemaName: BaseCollection
|
|
BaseCustomer:
|
|
type: object
|
|
description: The customer's customers.
|
|
x-schemaName: BaseCustomer
|
|
BaseCustomerAddress:
|
|
type: object
|
|
description: The address's addresses.
|
|
x-schemaName: BaseCustomerAddress
|
|
required:
|
|
- id
|
|
- address_name
|
|
- is_default_shipping
|
|
- is_default_billing
|
|
- customer_id
|
|
- company
|
|
- first_name
|
|
- last_name
|
|
- address_1
|
|
- address_2
|
|
- city
|
|
- country_code
|
|
- province
|
|
- postal_code
|
|
- phone
|
|
- metadata
|
|
- created_at
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The address's ID.
|
|
address_name:
|
|
type: string
|
|
title: address_name
|
|
description: The address's address name.
|
|
is_default_shipping:
|
|
type: boolean
|
|
title: is_default_shipping
|
|
description: The address's is default shipping.
|
|
is_default_billing:
|
|
type: boolean
|
|
title: is_default_billing
|
|
description: The address's is default billing.
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The address's customer id.
|
|
company:
|
|
type: string
|
|
title: company
|
|
description: The address's company.
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The address's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The address's last name.
|
|
address_1:
|
|
type: string
|
|
title: address_1
|
|
description: The address's address 1.
|
|
address_2:
|
|
type: string
|
|
title: address_2
|
|
description: The address's address 2.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The address's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The address's country code.
|
|
province:
|
|
type: string
|
|
title: province
|
|
description: The address's province.
|
|
postal_code:
|
|
type: string
|
|
title: postal_code
|
|
description: The address's postal code.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The address's phone.
|
|
metadata:
|
|
type: object
|
|
description: The address's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The address's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The address's updated at.
|
|
BaseExchangeItem:
|
|
type: object
|
|
description: The additional item's additional items.
|
|
x-schemaName: BaseExchangeItem
|
|
required:
|
|
- id
|
|
- exchange_id
|
|
- order_id
|
|
- item_id
|
|
- quantity
|
|
- created_at
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The additional item's ID.
|
|
exchange_id:
|
|
type: string
|
|
title: exchange_id
|
|
description: The additional item's exchange id.
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The additional item's order id.
|
|
item_id:
|
|
type: string
|
|
title: item_id
|
|
description: The additional item's item id.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The additional item's quantity.
|
|
metadata:
|
|
type: object
|
|
description: The additional item's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The additional item's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The additional item's updated at.
|
|
BaseFulfillmentProvider:
|
|
type: object
|
|
description: The shipping option's provider.
|
|
x-schemaName: BaseFulfillmentProvider
|
|
required:
|
|
- id
|
|
- is_enabled
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The provider's ID.
|
|
is_enabled:
|
|
type: boolean
|
|
title: is_enabled
|
|
description: The provider's is enabled.
|
|
BaseLineItemAdjustment:
|
|
type: object
|
|
description: The adjustment's adjustments.
|
|
x-schemaName: BaseLineItemAdjustment
|
|
BaseLineItemTaxLine:
|
|
type: object
|
|
description: The tax line's tax lines.
|
|
x-schemaName: BaseLineItemTaxLine
|
|
BaseOrder:
|
|
type: object
|
|
description: The order change's order.
|
|
x-schemaName: BaseOrder
|
|
BaseOrderAddress:
|
|
type: object
|
|
description: The order's billing address.
|
|
x-schemaName: BaseOrderAddress
|
|
required:
|
|
- id
|
|
- metadata
|
|
- created_at
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The billing address's ID.
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The billing address's customer id.
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The billing address's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The billing address's last name.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The billing address's phone.
|
|
company:
|
|
type: string
|
|
title: company
|
|
description: The billing address's company.
|
|
address_1:
|
|
type: string
|
|
title: address_1
|
|
description: The billing address's address 1.
|
|
address_2:
|
|
type: string
|
|
title: address_2
|
|
description: The billing address's address 2.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The billing address's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The billing address's country code.
|
|
province:
|
|
type: string
|
|
title: province
|
|
description: The billing address's province.
|
|
postal_code:
|
|
type: string
|
|
title: postal_code
|
|
description: The billing address's postal code.
|
|
metadata:
|
|
type: object
|
|
description: The billing address's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The billing address's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The billing address's updated at.
|
|
BaseOrderChange:
|
|
type: object
|
|
description: The order preview's order change.
|
|
x-schemaName: BaseOrderChange
|
|
required:
|
|
- id
|
|
- order_id
|
|
- actions
|
|
- status
|
|
- requested_by
|
|
- requested_at
|
|
- confirmed_by
|
|
- confirmed_at
|
|
- declined_by
|
|
- declined_reason
|
|
- metadata
|
|
- declined_at
|
|
- canceled_by
|
|
- canceled_at
|
|
- created_at
|
|
- updated_at
|
|
- version
|
|
- return_id
|
|
- exchange_id
|
|
- claim_id
|
|
- order
|
|
- return_order
|
|
- exchange
|
|
- claim
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The order change's ID.
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The order change's order id.
|
|
actions:
|
|
type: array
|
|
description: The order change's actions.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderChangeAction'
|
|
status:
|
|
type: string
|
|
title: status
|
|
description: The order change's status.
|
|
requested_by:
|
|
type: string
|
|
title: requested_by
|
|
description: The order change's requested by.
|
|
requested_at:
|
|
oneOf:
|
|
- type: string
|
|
title: requested_at
|
|
description: The order change's requested at.
|
|
- type: string
|
|
title: requested_at
|
|
description: The order change's requested at.
|
|
format: date-time
|
|
confirmed_by:
|
|
type: string
|
|
title: confirmed_by
|
|
description: The order change's confirmed by.
|
|
confirmed_at:
|
|
oneOf:
|
|
- type: string
|
|
title: confirmed_at
|
|
description: The order change's confirmed at.
|
|
- type: string
|
|
title: confirmed_at
|
|
description: The order change's confirmed at.
|
|
format: date-time
|
|
declined_by:
|
|
type: string
|
|
title: declined_by
|
|
description: The order change's declined by.
|
|
declined_reason:
|
|
type: string
|
|
title: declined_reason
|
|
description: The order change's declined reason.
|
|
metadata:
|
|
type: object
|
|
description: The order change's metadata.
|
|
declined_at:
|
|
oneOf:
|
|
- type: string
|
|
title: declined_at
|
|
description: The order change's declined at.
|
|
- type: string
|
|
title: declined_at
|
|
description: The order change's declined at.
|
|
format: date-time
|
|
canceled_by:
|
|
type: string
|
|
title: canceled_by
|
|
description: The order change's canceled by.
|
|
canceled_at:
|
|
oneOf:
|
|
- type: string
|
|
title: canceled_at
|
|
description: The order change's canceled at.
|
|
- type: string
|
|
title: canceled_at
|
|
description: The order change's canceled at.
|
|
format: date-time
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The order change's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The order change's updated at.
|
|
version:
|
|
type: number
|
|
title: version
|
|
description: The order change's version.
|
|
change_type:
|
|
type: string
|
|
enum:
|
|
- return
|
|
- exchange
|
|
- claim
|
|
- edit
|
|
- return_request
|
|
return_id:
|
|
type: string
|
|
title: return_id
|
|
description: The order change's return id.
|
|
exchange_id:
|
|
type: string
|
|
title: exchange_id
|
|
description: The order change's exchange id.
|
|
claim_id:
|
|
type: string
|
|
title: claim_id
|
|
description: The order change's claim id.
|
|
order:
|
|
$ref: '#/components/schemas/BaseOrder'
|
|
return_order: {}
|
|
exchange: {}
|
|
claim:
|
|
$ref: '#/components/schemas/BaseClaim'
|
|
BaseOrderChangeAction:
|
|
type: object
|
|
description: The action's actions.
|
|
x-schemaName: BaseOrderChangeAction
|
|
BaseOrderFulfillment:
|
|
type: object
|
|
description: The fulfillment's fulfillments.
|
|
x-schemaName: BaseOrderFulfillment
|
|
required:
|
|
- id
|
|
- location_id
|
|
- packed_at
|
|
- shipped_at
|
|
- delivered_at
|
|
- canceled_at
|
|
- data
|
|
- provider_id
|
|
- shipping_option_id
|
|
- metadata
|
|
- created_at
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The fulfillment's ID.
|
|
location_id:
|
|
type: string
|
|
title: location_id
|
|
description: The fulfillment's location id.
|
|
packed_at:
|
|
type: string
|
|
title: packed_at
|
|
description: The fulfillment's packed at.
|
|
format: date-time
|
|
shipped_at:
|
|
type: string
|
|
title: shipped_at
|
|
description: The fulfillment's shipped at.
|
|
format: date-time
|
|
delivered_at:
|
|
type: string
|
|
title: delivered_at
|
|
description: The fulfillment's delivered at.
|
|
format: date-time
|
|
canceled_at:
|
|
type: string
|
|
title: canceled_at
|
|
description: The fulfillment's canceled at.
|
|
format: date-time
|
|
data:
|
|
type: object
|
|
description: The fulfillment's data.
|
|
provider_id:
|
|
type: string
|
|
title: provider_id
|
|
description: The fulfillment's provider id.
|
|
shipping_option_id:
|
|
type: string
|
|
title: shipping_option_id
|
|
description: The fulfillment's shipping option id.
|
|
metadata:
|
|
type: object
|
|
description: The fulfillment's metadata.
|
|
created_at:
|
|
type: string
|
|
title: created_at
|
|
description: The fulfillment's created at.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
title: updated_at
|
|
description: The fulfillment's updated at.
|
|
format: date-time
|
|
BaseOrderItemDetail:
|
|
type: object
|
|
description: The item's detail.
|
|
x-schemaName: BaseOrderItemDetail
|
|
BaseOrderLineItem:
|
|
type: object
|
|
description: The item's items.
|
|
x-schemaName: BaseOrderLineItem
|
|
required:
|
|
- id
|
|
- title
|
|
- subtitle
|
|
- thumbnail
|
|
- variant_id
|
|
- product_id
|
|
- product_title
|
|
- product_description
|
|
- product_subtitle
|
|
- product_type
|
|
- product_collection
|
|
- product_handle
|
|
- variant_sku
|
|
- variant_barcode
|
|
- variant_title
|
|
- variant_option_values
|
|
- requires_shipping
|
|
- is_discountable
|
|
- is_tax_inclusive
|
|
- unit_price
|
|
- quantity
|
|
- detail
|
|
- created_at
|
|
- updated_at
|
|
- metadata
|
|
- original_total
|
|
- original_subtotal
|
|
- original_tax_total
|
|
- item_total
|
|
- item_subtotal
|
|
- item_tax_total
|
|
- total
|
|
- subtotal
|
|
- tax_total
|
|
- discount_total
|
|
- discount_tax_total
|
|
- refundable_total
|
|
- refundable_total_per_unit
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The item's ID.
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The item's title.
|
|
subtitle:
|
|
type: string
|
|
title: subtitle
|
|
description: The item's subtitle.
|
|
thumbnail:
|
|
type: string
|
|
title: thumbnail
|
|
description: The item's thumbnail.
|
|
variant:
|
|
$ref: '#/components/schemas/BaseProductVariant'
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The item's variant id.
|
|
product:
|
|
$ref: '#/components/schemas/BaseProduct'
|
|
product_id:
|
|
type: string
|
|
title: product_id
|
|
description: The item's product id.
|
|
product_title:
|
|
type: string
|
|
title: product_title
|
|
description: The item's product title.
|
|
product_description:
|
|
type: string
|
|
title: product_description
|
|
description: The item's product description.
|
|
product_subtitle:
|
|
type: string
|
|
title: product_subtitle
|
|
description: The item's product subtitle.
|
|
product_type:
|
|
type: string
|
|
title: product_type
|
|
description: The item's product type.
|
|
product_collection:
|
|
type: string
|
|
title: product_collection
|
|
description: The item's product collection.
|
|
product_handle:
|
|
type: string
|
|
title: product_handle
|
|
description: The item's product handle.
|
|
variant_sku:
|
|
type: string
|
|
title: variant_sku
|
|
description: The item's variant sku.
|
|
variant_barcode:
|
|
type: string
|
|
title: variant_barcode
|
|
description: The item's variant barcode.
|
|
variant_title:
|
|
type: string
|
|
title: variant_title
|
|
description: The item's variant title.
|
|
variant_option_values:
|
|
type: object
|
|
description: The item's variant option values.
|
|
requires_shipping:
|
|
type: boolean
|
|
title: requires_shipping
|
|
description: The item's requires shipping.
|
|
is_discountable:
|
|
type: boolean
|
|
title: is_discountable
|
|
description: The item's is discountable.
|
|
is_tax_inclusive:
|
|
type: boolean
|
|
title: is_tax_inclusive
|
|
description: The item's is tax inclusive.
|
|
compare_at_unit_price:
|
|
type: number
|
|
title: compare_at_unit_price
|
|
description: The item's compare at unit price.
|
|
unit_price:
|
|
type: number
|
|
title: unit_price
|
|
description: The item's unit price.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The item's quantity.
|
|
tax_lines:
|
|
type: array
|
|
description: The item's tax lines.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderLineItemTaxLine'
|
|
adjustments:
|
|
type: array
|
|
description: The item's adjustments.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderLineItemAdjustment'
|
|
detail:
|
|
$ref: '#/components/schemas/BaseOrderItemDetail'
|
|
created_at:
|
|
type: string
|
|
title: created_at
|
|
description: The item's created at.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
title: updated_at
|
|
description: The item's updated at.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: The item's metadata.
|
|
original_total:
|
|
type: number
|
|
title: original_total
|
|
description: The item's original total.
|
|
original_subtotal:
|
|
type: number
|
|
title: original_subtotal
|
|
description: The item's original subtotal.
|
|
original_tax_total:
|
|
type: number
|
|
title: original_tax_total
|
|
description: The item's original tax total.
|
|
item_total:
|
|
type: number
|
|
title: item_total
|
|
description: The item's item total.
|
|
item_subtotal:
|
|
type: number
|
|
title: item_subtotal
|
|
description: The item's item subtotal.
|
|
item_tax_total:
|
|
type: number
|
|
title: item_tax_total
|
|
description: The item's item tax total.
|
|
total:
|
|
type: number
|
|
title: total
|
|
description: The item's total.
|
|
subtotal:
|
|
type: number
|
|
title: subtotal
|
|
description: The item's subtotal.
|
|
tax_total:
|
|
type: number
|
|
title: tax_total
|
|
description: The item's tax total.
|
|
discount_total:
|
|
type: number
|
|
title: discount_total
|
|
description: The item's discount total.
|
|
discount_tax_total:
|
|
type: number
|
|
title: discount_tax_total
|
|
description: The item's discount tax total.
|
|
refundable_total:
|
|
type: number
|
|
title: refundable_total
|
|
description: The item's refundable total.
|
|
refundable_total_per_unit:
|
|
type: number
|
|
title: refundable_total_per_unit
|
|
description: The item's refundable total per unit.
|
|
BaseOrderLineItemAdjustment:
|
|
type: object
|
|
description: The adjustment's adjustments.
|
|
x-schemaName: BaseOrderLineItemAdjustment
|
|
BaseOrderLineItemTaxLine:
|
|
type: object
|
|
description: The tax line's tax lines.
|
|
x-schemaName: BaseOrderLineItemTaxLine
|
|
BaseOrderShippingMethod:
|
|
type: object
|
|
description: The shipping method's shipping methods.
|
|
x-schemaName: BaseOrderShippingMethod
|
|
required:
|
|
- id
|
|
- order_id
|
|
- name
|
|
- amount
|
|
- is_tax_inclusive
|
|
- shipping_option_id
|
|
- data
|
|
- metadata
|
|
- original_total
|
|
- original_subtotal
|
|
- original_tax_total
|
|
- total
|
|
- subtotal
|
|
- tax_total
|
|
- discount_total
|
|
- discount_tax_total
|
|
- created_at
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The shipping method's ID.
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The shipping method's order id.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The shipping method's name.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The shipping method's description.
|
|
amount:
|
|
type: number
|
|
title: amount
|
|
description: The shipping method's amount.
|
|
is_tax_inclusive:
|
|
type: boolean
|
|
title: is_tax_inclusive
|
|
description: The shipping method's is tax inclusive.
|
|
shipping_option_id:
|
|
type: string
|
|
title: shipping_option_id
|
|
description: The shipping method's shipping option id.
|
|
data:
|
|
type: object
|
|
description: The shipping method's data.
|
|
metadata:
|
|
type: object
|
|
description: The shipping method's metadata.
|
|
tax_lines:
|
|
type: array
|
|
description: The shipping method's tax lines.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderShippingMethodTaxLine'
|
|
adjustments:
|
|
type: array
|
|
description: The shipping method's adjustments.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderShippingMethodAdjustment'
|
|
original_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_total
|
|
description: The shipping method's original total.
|
|
- type: number
|
|
title: original_total
|
|
description: The shipping method's original total.
|
|
- type: string
|
|
title: original_total
|
|
description: The shipping method's original total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: original_subtotal
|
|
description: The shipping method's original subtotal.
|
|
- type: number
|
|
title: original_subtotal
|
|
description: The shipping method's original subtotal.
|
|
- type: string
|
|
title: original_subtotal
|
|
description: The shipping method's original subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_tax_total
|
|
description: The shipping method's original tax total.
|
|
- type: number
|
|
title: original_tax_total
|
|
description: The shipping method's original tax total.
|
|
- type: string
|
|
title: original_tax_total
|
|
description: The shipping method's original tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
total:
|
|
oneOf:
|
|
- type: string
|
|
title: total
|
|
description: The shipping method's total.
|
|
- type: number
|
|
title: total
|
|
description: The shipping method's total.
|
|
- type: string
|
|
title: total
|
|
description: The shipping method's total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: subtotal
|
|
description: The shipping method's subtotal.
|
|
- type: number
|
|
title: subtotal
|
|
description: The shipping method's subtotal.
|
|
- type: string
|
|
title: subtotal
|
|
description: The shipping method's subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: tax_total
|
|
description: The shipping method's tax total.
|
|
- type: number
|
|
title: tax_total
|
|
description: The shipping method's tax total.
|
|
- type: string
|
|
title: tax_total
|
|
description: The shipping method's tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
discount_total:
|
|
oneOf:
|
|
- type: string
|
|
title: discount_total
|
|
description: The shipping method's discount total.
|
|
- type: number
|
|
title: discount_total
|
|
description: The shipping method's discount total.
|
|
- type: string
|
|
title: discount_total
|
|
description: The shipping method's discount total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
discount_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: discount_tax_total
|
|
description: The shipping method's discount tax total.
|
|
- type: number
|
|
title: discount_tax_total
|
|
description: The shipping method's discount tax total.
|
|
- type: string
|
|
title: discount_tax_total
|
|
description: The shipping method's discount tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The shipping method's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The shipping method's updated at.
|
|
BaseOrderShippingMethodAdjustment:
|
|
type: object
|
|
description: The adjustment's adjustments.
|
|
x-schemaName: BaseOrderShippingMethodAdjustment
|
|
BaseOrderShippingMethodTaxLine:
|
|
type: object
|
|
description: The tax line's tax lines.
|
|
x-schemaName: BaseOrderShippingMethodTaxLine
|
|
BaseOrderSummary:
|
|
type: object
|
|
description: The order's summary.
|
|
x-schemaName: BaseOrderSummary
|
|
required:
|
|
- total
|
|
- subtotal
|
|
- total_tax
|
|
- ordered_total
|
|
- fulfilled_total
|
|
- returned_total
|
|
- return_request_total
|
|
- write_off_total
|
|
- projected_total
|
|
- net_total
|
|
- net_subtotal
|
|
- net_total_tax
|
|
- balance
|
|
- paid_total
|
|
- refunded_total
|
|
properties:
|
|
total:
|
|
type: number
|
|
title: total
|
|
description: The summary's total.
|
|
subtotal:
|
|
type: number
|
|
title: subtotal
|
|
description: The summary's subtotal.
|
|
total_tax:
|
|
type: number
|
|
title: total_tax
|
|
description: The summary's total tax.
|
|
ordered_total:
|
|
type: number
|
|
title: ordered_total
|
|
description: The summary's ordered total.
|
|
fulfilled_total:
|
|
type: number
|
|
title: fulfilled_total
|
|
description: The summary's fulfilled total.
|
|
returned_total:
|
|
type: number
|
|
title: returned_total
|
|
description: The summary's returned total.
|
|
return_request_total:
|
|
type: number
|
|
title: return_request_total
|
|
description: The summary's return request total.
|
|
write_off_total:
|
|
type: number
|
|
title: write_off_total
|
|
description: The summary's write off total.
|
|
projected_total:
|
|
type: number
|
|
title: projected_total
|
|
description: The summary's projected total.
|
|
net_total:
|
|
type: number
|
|
title: net_total
|
|
description: The summary's net total.
|
|
net_subtotal:
|
|
type: number
|
|
title: net_subtotal
|
|
description: The summary's net subtotal.
|
|
net_total_tax:
|
|
type: number
|
|
title: net_total_tax
|
|
description: The summary's net total tax.
|
|
balance:
|
|
type: number
|
|
title: balance
|
|
description: The summary's balance.
|
|
paid_total:
|
|
type: number
|
|
title: paid_total
|
|
description: The summary's paid total.
|
|
refunded_total:
|
|
type: number
|
|
title: refunded_total
|
|
description: The summary's refunded total.
|
|
BaseOrderTransaction:
|
|
type: object
|
|
description: The transaction's transactions.
|
|
x-schemaName: BaseOrderTransaction
|
|
required:
|
|
- id
|
|
- order_id
|
|
- amount
|
|
- currency_code
|
|
- reference
|
|
- reference_id
|
|
- metadata
|
|
- created_at
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The transaction's ID.
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The transaction's order id.
|
|
amount:
|
|
type: number
|
|
title: amount
|
|
description: The transaction's amount.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The transaction's currency code.
|
|
reference:
|
|
type: string
|
|
title: reference
|
|
description: The transaction's reference.
|
|
reference_id:
|
|
type: string
|
|
title: reference_id
|
|
description: The transaction's reference id.
|
|
metadata:
|
|
type: object
|
|
description: The transaction's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The transaction's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The transaction's updated at.
|
|
BasePayment:
|
|
type: object
|
|
description: The payment's payments.
|
|
x-schemaName: BasePayment
|
|
BasePaymentCollection:
|
|
type: object
|
|
description: The payment collection's payment collections.
|
|
x-schemaName: BasePaymentCollection
|
|
required:
|
|
- id
|
|
- currency_code
|
|
- region_id
|
|
- amount
|
|
- status
|
|
- payment_providers
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The payment collection's ID.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The payment collection's currency code.
|
|
region_id:
|
|
type: string
|
|
title: region_id
|
|
description: The payment collection's region id.
|
|
amount:
|
|
oneOf:
|
|
- type: string
|
|
title: amount
|
|
description: The payment collection's amount.
|
|
- type: number
|
|
title: amount
|
|
description: The payment collection's amount.
|
|
- type: string
|
|
title: amount
|
|
description: The payment collection's amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
authorized_amount:
|
|
oneOf:
|
|
- type: string
|
|
title: authorized_amount
|
|
description: The payment collection's authorized amount.
|
|
- type: number
|
|
title: authorized_amount
|
|
description: The payment collection's authorized amount.
|
|
- type: string
|
|
title: authorized_amount
|
|
description: The payment collection's authorized amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
captured_amount:
|
|
oneOf:
|
|
- type: string
|
|
title: captured_amount
|
|
description: The payment collection's captured amount.
|
|
- type: number
|
|
title: captured_amount
|
|
description: The payment collection's captured amount.
|
|
- type: string
|
|
title: captured_amount
|
|
description: The payment collection's captured amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
refunded_amount:
|
|
oneOf:
|
|
- type: string
|
|
title: refunded_amount
|
|
description: The payment collection's refunded amount.
|
|
- type: number
|
|
title: refunded_amount
|
|
description: The payment collection's refunded amount.
|
|
- type: string
|
|
title: refunded_amount
|
|
description: The payment collection's refunded amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
completed_at:
|
|
oneOf:
|
|
- type: string
|
|
title: completed_at
|
|
description: The payment collection's completed at.
|
|
- type: string
|
|
title: completed_at
|
|
description: The payment collection's completed at.
|
|
format: date-time
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The payment collection's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The payment collection's updated at.
|
|
metadata:
|
|
type: object
|
|
description: The payment collection's metadata.
|
|
status:
|
|
type: string
|
|
enum:
|
|
- canceled
|
|
- not_paid
|
|
- awaiting
|
|
- authorized
|
|
- partially_authorized
|
|
payment_providers:
|
|
type: array
|
|
description: The payment collection's payment providers.
|
|
items:
|
|
$ref: '#/components/schemas/BasePaymentProvider'
|
|
payment_sessions:
|
|
type: array
|
|
description: The payment collection's payment sessions.
|
|
items:
|
|
$ref: '#/components/schemas/BasePaymentSession'
|
|
payments:
|
|
type: array
|
|
description: The payment collection's payments.
|
|
items:
|
|
$ref: '#/components/schemas/BasePayment'
|
|
BasePaymentProvider:
|
|
type: object
|
|
description: The payment provider's payment providers.
|
|
x-schemaName: BasePaymentProvider
|
|
BasePaymentSession:
|
|
type: object
|
|
description: The payment session's payment sessions.
|
|
x-schemaName: BasePaymentSession
|
|
BaseProduct:
|
|
type: object
|
|
description: The parent's product.
|
|
x-schemaName: BaseProduct
|
|
required:
|
|
- id
|
|
- title
|
|
- handle
|
|
- subtitle
|
|
- description
|
|
- is_giftcard
|
|
- status
|
|
- thumbnail
|
|
- width
|
|
- weight
|
|
- length
|
|
- height
|
|
- origin_country
|
|
- hs_code
|
|
- mid_code
|
|
- material
|
|
- collection_id
|
|
- type_id
|
|
- variants
|
|
- options
|
|
- images
|
|
- discountable
|
|
- external_id
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The product's ID.
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The product's title.
|
|
handle:
|
|
type: string
|
|
title: handle
|
|
description: The product's handle.
|
|
subtitle:
|
|
type: string
|
|
title: subtitle
|
|
description: The product's subtitle.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The product's description.
|
|
is_giftcard:
|
|
type: boolean
|
|
title: is_giftcard
|
|
description: The product's is giftcard.
|
|
status:
|
|
type: string
|
|
enum:
|
|
- draft
|
|
- proposed
|
|
- published
|
|
- rejected
|
|
thumbnail:
|
|
type: string
|
|
title: thumbnail
|
|
description: The product's thumbnail.
|
|
width:
|
|
type: number
|
|
title: width
|
|
description: The product's width.
|
|
weight:
|
|
type: number
|
|
title: weight
|
|
description: The product's weight.
|
|
length:
|
|
type: number
|
|
title: length
|
|
description: The product's length.
|
|
height:
|
|
type: number
|
|
title: height
|
|
description: The product's height.
|
|
origin_country:
|
|
type: string
|
|
title: origin_country
|
|
description: The product's origin country.
|
|
hs_code:
|
|
type: string
|
|
title: hs_code
|
|
description: The product's hs code.
|
|
mid_code:
|
|
type: string
|
|
title: mid_code
|
|
description: The product's mid code.
|
|
material:
|
|
type: string
|
|
title: material
|
|
description: The product's material.
|
|
collection:
|
|
$ref: '#/components/schemas/BaseCollection'
|
|
collection_id:
|
|
type: string
|
|
title: collection_id
|
|
description: The product's collection id.
|
|
categories:
|
|
type: array
|
|
description: The product's categories.
|
|
items:
|
|
$ref: '#/components/schemas/BaseProductCategory'
|
|
type:
|
|
type: object
|
|
type_id:
|
|
type: string
|
|
title: type_id
|
|
description: The product's type id.
|
|
tags:
|
|
type: array
|
|
description: The product's tags.
|
|
items:
|
|
$ref: '#/components/schemas/BaseProductTag'
|
|
variants:
|
|
type: array
|
|
description: The product's variants.
|
|
items:
|
|
$ref: '#/components/schemas/BaseProductVariant'
|
|
options:
|
|
type: array
|
|
description: The product's options.
|
|
items:
|
|
$ref: '#/components/schemas/BaseProductOption'
|
|
images:
|
|
type: array
|
|
description: The product's images.
|
|
items:
|
|
$ref: '#/components/schemas/BaseProductImage'
|
|
discountable:
|
|
type: boolean
|
|
title: discountable
|
|
description: The product's discountable.
|
|
external_id:
|
|
type: string
|
|
title: external_id
|
|
description: The product's external id.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The product's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The product's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The product's deleted at.
|
|
metadata:
|
|
type: object
|
|
description: The product's metadata.
|
|
BaseProductCategory:
|
|
type: object
|
|
description: The category's categories.
|
|
x-schemaName: BaseProductCategory
|
|
BaseProductImage:
|
|
type: object
|
|
description: The image's images.
|
|
x-schemaName: BaseProductImage
|
|
BaseProductOption:
|
|
type: object
|
|
description: The option's options.
|
|
x-schemaName: BaseProductOption
|
|
BaseProductOptionValue:
|
|
type: object
|
|
description: The option's options.
|
|
x-schemaName: BaseProductOptionValue
|
|
required:
|
|
- id
|
|
- value
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The option's ID.
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The option's value.
|
|
option:
|
|
$ref: '#/components/schemas/BaseProductOption'
|
|
option_id:
|
|
type: string
|
|
title: option_id
|
|
description: The option's option id.
|
|
metadata:
|
|
type: object
|
|
description: The option's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The option's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The option's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The option's deleted at.
|
|
BaseProductTag:
|
|
type: object
|
|
description: The tag's tags.
|
|
x-schemaName: BaseProductTag
|
|
BaseProductVariant:
|
|
type: object
|
|
description: The variant's variants.
|
|
x-schemaName: BaseProductVariant
|
|
BasePromotion:
|
|
type: object
|
|
description: The application method's promotion.
|
|
x-schemaName: BasePromotion
|
|
BasePromotionRule:
|
|
type: object
|
|
description: The rule's rules.
|
|
x-schemaName: BasePromotionRule
|
|
required:
|
|
- id
|
|
- values
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The rule's ID.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The rule's description.
|
|
attribute:
|
|
type: string
|
|
title: attribute
|
|
description: The rule's attribute.
|
|
operator:
|
|
type: string
|
|
enum:
|
|
- gt
|
|
- lt
|
|
- eq
|
|
- ne
|
|
- in
|
|
- lte
|
|
- gte
|
|
values:
|
|
type: array
|
|
description: The rule's values.
|
|
items:
|
|
$ref: '#/components/schemas/BasePromotionRuleValue'
|
|
BasePromotionRuleValue:
|
|
type: object
|
|
description: The value's values.
|
|
x-schemaName: BasePromotionRuleValue
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The value's ID.
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The value's details.
|
|
BaseRefund:
|
|
type: object
|
|
description: The refund's refunds.
|
|
x-schemaName: BaseRefund
|
|
BaseRegion:
|
|
type: object
|
|
description: The cart's region.
|
|
x-schemaName: BaseRegion
|
|
required:
|
|
- id
|
|
- name
|
|
- currency_code
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The region's ID.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The region's name.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The region's currency code.
|
|
automatic_taxes:
|
|
type: boolean
|
|
title: automatic_taxes
|
|
description: The region's automatic taxes.
|
|
countries:
|
|
type: array
|
|
description: The region's countries.
|
|
items:
|
|
$ref: '#/components/schemas/BaseRegionCountry'
|
|
payment_providers:
|
|
type: array
|
|
description: The region's payment providers.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPaymentProvider'
|
|
metadata:
|
|
type: object
|
|
description: The region's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The region's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The region's updated at.
|
|
BaseRegionCountry:
|
|
type: object
|
|
description: The country's countries.
|
|
x-schemaName: BaseRegionCountry
|
|
BaseReturnItem:
|
|
type: object
|
|
description: The item's items.
|
|
x-schemaName: BaseReturnItem
|
|
BaseRuleOperatorOptions:
|
|
type: object
|
|
description: The operator's operators.
|
|
x-schemaName: BaseRuleOperatorOptions
|
|
required:
|
|
- id
|
|
- value
|
|
- label
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The operator's ID.
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The operator's value.
|
|
label:
|
|
type: string
|
|
title: label
|
|
description: The operator's label.
|
|
BaseShippingMethodAdjustment:
|
|
type: object
|
|
description: The adjustment's adjustments.
|
|
x-schemaName: BaseShippingMethodAdjustment
|
|
BaseShippingMethodTaxLine:
|
|
type: object
|
|
description: The tax line's tax lines.
|
|
x-schemaName: BaseShippingMethodTaxLine
|
|
CampaignResponse:
|
|
type: object
|
|
description: The campaign's details.
|
|
x-schemaName: CampaignResponse
|
|
required:
|
|
- id
|
|
- name
|
|
- description
|
|
- currency
|
|
- campaign_identifier
|
|
- starts_at
|
|
- ends_at
|
|
- budget
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The campaign's ID.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The campaign's name.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The campaign's description.
|
|
currency:
|
|
type: string
|
|
title: currency
|
|
description: The campaign's currency.
|
|
campaign_identifier:
|
|
type: string
|
|
title: campaign_identifier
|
|
description: The campaign's campaign identifier.
|
|
starts_at:
|
|
type: string
|
|
title: starts_at
|
|
description: The campaign's starts at.
|
|
ends_at:
|
|
type: string
|
|
title: ends_at
|
|
description: The campaign's ends at.
|
|
budget:
|
|
type: object
|
|
description: The campaign's budget.
|
|
required:
|
|
- id
|
|
- type
|
|
- currency_code
|
|
- limit
|
|
- used
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The budget's ID.
|
|
type:
|
|
type: string
|
|
enum:
|
|
- spend
|
|
- usage
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The budget's currency code.
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The budget's limit.
|
|
used:
|
|
type: number
|
|
title: used
|
|
description: The budget's used.
|
|
CreateAddress:
|
|
type: object
|
|
description: The cart's shipping address.
|
|
x-schemaName: CreateAddress
|
|
properties:
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The shipping address's customer id.
|
|
company:
|
|
type: string
|
|
title: company
|
|
description: The shipping address's company.
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The shipping address's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The shipping address's last name.
|
|
address_1:
|
|
type: string
|
|
title: address_1
|
|
description: The shipping address's address 1.
|
|
address_2:
|
|
type: string
|
|
title: address_2
|
|
description: The shipping address's address 2.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The shipping address's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The shipping address's country code.
|
|
province:
|
|
type: string
|
|
title: province
|
|
description: The shipping address's province.
|
|
postal_code:
|
|
type: string
|
|
title: postal_code
|
|
description: The shipping address's postal code.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The shipping address's phone.
|
|
metadata:
|
|
type: object
|
|
description: The shipping address's metadata.
|
|
CreateCartAddress:
|
|
type: object
|
|
description: The cart's billing address.
|
|
x-schemaName: CreateCartAddress
|
|
properties:
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The billing address's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The billing address's last name.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The billing address's phone.
|
|
company:
|
|
type: string
|
|
title: company
|
|
description: The billing address's company.
|
|
address_1:
|
|
type: string
|
|
title: address_1
|
|
description: The billing address's address 1.
|
|
address_2:
|
|
type: string
|
|
title: address_2
|
|
description: The billing address's address 2.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The billing address's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The billing address's country code.
|
|
province:
|
|
type: string
|
|
title: province
|
|
description: The billing address's province.
|
|
postal_code:
|
|
type: string
|
|
title: postal_code
|
|
description: The billing address's postal code.
|
|
metadata:
|
|
type: object
|
|
description: The billing address's metadata.
|
|
CreateCartCreateLineItem:
|
|
type: object
|
|
description: The item's items.
|
|
x-schemaName: CreateCartCreateLineItem
|
|
required:
|
|
- quantity
|
|
- variant_id
|
|
properties:
|
|
quantity:
|
|
type: string
|
|
title: quantity
|
|
description: The item's quantity.
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The item's variant id.
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The item's title.
|
|
subtitle:
|
|
type: string
|
|
title: subtitle
|
|
description: The item's subtitle.
|
|
thumbnail:
|
|
type: string
|
|
title: thumbnail
|
|
description: The item's thumbnail.
|
|
product_id:
|
|
type: string
|
|
title: product_id
|
|
description: The item's product id.
|
|
product_title:
|
|
type: string
|
|
title: product_title
|
|
description: The item's product title.
|
|
product_description:
|
|
type: string
|
|
title: product_description
|
|
description: The item's product description.
|
|
product_subtitle:
|
|
type: string
|
|
title: product_subtitle
|
|
description: The item's product subtitle.
|
|
product_type:
|
|
type: string
|
|
title: product_type
|
|
description: The item's product type.
|
|
product_collection:
|
|
type: string
|
|
title: product_collection
|
|
description: The item's product collection.
|
|
product_handle:
|
|
type: string
|
|
title: product_handle
|
|
description: The item's product handle.
|
|
variant_sku:
|
|
type: string
|
|
title: variant_sku
|
|
description: The item's variant sku.
|
|
variant_barcode:
|
|
type: string
|
|
title: variant_barcode
|
|
description: The item's variant barcode.
|
|
variant_title:
|
|
type: string
|
|
title: variant_title
|
|
description: The item's variant title.
|
|
variant_option_values:
|
|
type: object
|
|
description: The item's variant option values.
|
|
requires_shipping:
|
|
type: boolean
|
|
title: requires_shipping
|
|
description: The item's requires shipping.
|
|
is_discountable:
|
|
type: boolean
|
|
title: is_discountable
|
|
description: The item's is discountable.
|
|
is_tax_inclusive:
|
|
type: boolean
|
|
title: is_tax_inclusive
|
|
description: The item's is tax inclusive.
|
|
is_giftcard:
|
|
type: boolean
|
|
title: is_giftcard
|
|
description: The item's is giftcard.
|
|
compare_at_unit_price:
|
|
type: string
|
|
title: compare_at_unit_price
|
|
description: The item's compare at unit price.
|
|
unit_price:
|
|
type: string
|
|
title: unit_price
|
|
description: The item's unit price.
|
|
metadata:
|
|
type: object
|
|
description: The item's metadata.
|
|
CreateCartWorkflowInput:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: CreateCartWorkflowInput
|
|
properties:
|
|
region_id:
|
|
type: string
|
|
title: region_id
|
|
description: The cart's region id.
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The cart's customer id.
|
|
sales_channel_id:
|
|
type: string
|
|
title: sales_channel_id
|
|
description: The cart's sales channel id.
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The cart's email.
|
|
format: email
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The cart's currency code.
|
|
shipping_address_id:
|
|
type: string
|
|
title: shipping_address_id
|
|
description: The cart's shipping address id.
|
|
billing_address_id:
|
|
type: string
|
|
title: billing_address_id
|
|
description: The cart's billing address id.
|
|
shipping_address:
|
|
oneOf:
|
|
- type: string
|
|
title: shipping_address
|
|
description: The cart's shipping address.
|
|
- $ref: '#/components/schemas/CreateCartAddress'
|
|
billing_address:
|
|
oneOf:
|
|
- type: string
|
|
title: billing_address
|
|
description: The cart's billing address.
|
|
- $ref: '#/components/schemas/CreateCartAddress'
|
|
metadata:
|
|
type: object
|
|
description: The cart's metadata.
|
|
items:
|
|
type: array
|
|
description: The cart's items.
|
|
items:
|
|
$ref: '#/components/schemas/CreateCartCreateLineItem'
|
|
promo_codes:
|
|
type: array
|
|
description: The cart's promo codes.
|
|
items:
|
|
type: string
|
|
title: promo_codes
|
|
description: The promo code's promo codes.
|
|
CreateOrderReturnReason:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: CreateOrderReturnReason
|
|
required:
|
|
- value
|
|
- label
|
|
properties:
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The return reason's value.
|
|
label:
|
|
type: string
|
|
title: label
|
|
description: The return reason's label.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The return reason's description.
|
|
parent_return_reason_id:
|
|
type: string
|
|
title: parent_return_reason_id
|
|
description: The return reason's parent return reason id.
|
|
metadata:
|
|
type: object
|
|
description: The return reason's metadata.
|
|
Error:
|
|
title: Response Error
|
|
type: object
|
|
properties:
|
|
code:
|
|
type: string
|
|
description: A slug code to indicate the type of the error.
|
|
enum:
|
|
- invalid_state_error
|
|
- invalid_request_error
|
|
- api_error
|
|
- unknown_error
|
|
message:
|
|
type: string
|
|
description: Description of the error that occurred.
|
|
example: first_name must be a string
|
|
type:
|
|
type: string
|
|
description: A slug indicating the type of the error.
|
|
enum:
|
|
- QueryRunnerAlreadyReleasedError
|
|
- TransactionAlreadyStartedError
|
|
- TransactionNotStartedError
|
|
- conflict
|
|
- unauthorized
|
|
- payment_authorization_error
|
|
- duplicate_error
|
|
- not_allowed
|
|
- invalid_data
|
|
- not_found
|
|
- database_error
|
|
- unexpected_state
|
|
- invalid_argument
|
|
- unknown_error
|
|
File:
|
|
type: object
|
|
description: The product's file.
|
|
x-schemaName: File
|
|
required:
|
|
- lastModified
|
|
- name
|
|
- webkitRelativePath
|
|
- size
|
|
- type
|
|
- arrayBuffer
|
|
- stream
|
|
- text
|
|
properties:
|
|
lastModified:
|
|
type: number
|
|
title: lastModified
|
|
description: The file's lastmodified.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The file's name.
|
|
webkitRelativePath:
|
|
type: string
|
|
title: webkitRelativePath
|
|
description: The file's webkitrelativepath.
|
|
size:
|
|
type: number
|
|
title: size
|
|
description: The file's size.
|
|
type:
|
|
type: string
|
|
title: type
|
|
description: The file's type.
|
|
arrayBuffer:
|
|
type: object
|
|
description: The file's arraybuffer.
|
|
slice:
|
|
type: object
|
|
description: The file's slice.
|
|
stream:
|
|
type: object
|
|
description: The file's stream.
|
|
text:
|
|
type: object
|
|
description: The file's text.
|
|
IBigNumber:
|
|
type: object
|
|
description: The shipping method's discount tax total.
|
|
x-schemaName: IBigNumber
|
|
InventoryLevel:
|
|
type: object
|
|
description: The inventory level's inventory levels.
|
|
x-schemaName: InventoryLevel
|
|
required:
|
|
- id
|
|
- inventory_item_id
|
|
- location_id
|
|
- stocked_quantity
|
|
- reserved_quantity
|
|
- available_quantity
|
|
- incoming_quantity
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The inventory level's ID.
|
|
inventory_item_id:
|
|
type: string
|
|
title: inventory_item_id
|
|
description: The inventory level's inventory item id.
|
|
location_id:
|
|
type: string
|
|
title: location_id
|
|
description: The inventory level's location id.
|
|
stocked_quantity:
|
|
type: number
|
|
title: stocked_quantity
|
|
description: The inventory level's stocked quantity.
|
|
reserved_quantity:
|
|
type: number
|
|
title: reserved_quantity
|
|
description: The inventory level's reserved quantity.
|
|
available_quantity:
|
|
type: number
|
|
title: available_quantity
|
|
description: The inventory level's available quantity.
|
|
incoming_quantity:
|
|
type: number
|
|
title: incoming_quantity
|
|
description: The inventory level's incoming quantity.
|
|
metadata:
|
|
type: object
|
|
description: The inventory level's metadata.
|
|
Order:
|
|
type: object
|
|
description: The transaction's order.
|
|
x-schemaName: Order
|
|
OrderAddress:
|
|
type: object
|
|
description: The order preview's billing address.
|
|
x-schemaName: OrderAddress
|
|
required:
|
|
- id
|
|
- created_at
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The billing address's ID.
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The billing address's customer id.
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The billing address's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The billing address's last name.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The billing address's phone.
|
|
company:
|
|
type: string
|
|
title: company
|
|
description: The billing address's company.
|
|
address_1:
|
|
type: string
|
|
title: address_1
|
|
description: The billing address's address 1.
|
|
address_2:
|
|
type: string
|
|
title: address_2
|
|
description: The billing address's address 2.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The billing address's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The billing address's country code.
|
|
province:
|
|
type: string
|
|
title: province
|
|
description: The billing address's province.
|
|
postal_code:
|
|
type: string
|
|
title: postal_code
|
|
description: The billing address's postal code.
|
|
metadata:
|
|
type: object
|
|
description: The billing address's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The billing address's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The billing address's updated at.
|
|
OrderChange:
|
|
type: object
|
|
description: The order preview's order change.
|
|
x-schemaName: OrderChange
|
|
required:
|
|
- id
|
|
- version
|
|
- order_id
|
|
- return_id
|
|
- exchange_id
|
|
- claim_id
|
|
- order
|
|
- return_order
|
|
- exchange
|
|
- claim
|
|
- actions
|
|
- status
|
|
- requested_by
|
|
- requested_at
|
|
- confirmed_by
|
|
- confirmed_at
|
|
- declined_by
|
|
- declined_reason
|
|
- metadata
|
|
- declined_at
|
|
- canceled_by
|
|
- canceled_at
|
|
- created_at
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The order change's ID.
|
|
version:
|
|
type: number
|
|
title: version
|
|
description: The order change's version.
|
|
change_type:
|
|
type: string
|
|
enum:
|
|
- return
|
|
- exchange
|
|
- claim
|
|
- edit
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The order change's order id.
|
|
return_id:
|
|
type: string
|
|
title: return_id
|
|
description: The order change's return id.
|
|
exchange_id:
|
|
type: string
|
|
title: exchange_id
|
|
description: The order change's exchange id.
|
|
claim_id:
|
|
type: string
|
|
title: claim_id
|
|
description: The order change's claim id.
|
|
order:
|
|
type: object
|
|
return_order:
|
|
$ref: '#/components/schemas/Return'
|
|
exchange:
|
|
$ref: '#/components/schemas/OrderExchange'
|
|
claim:
|
|
$ref: '#/components/schemas/OrderClaim'
|
|
actions:
|
|
type: array
|
|
description: The order change's actions.
|
|
items:
|
|
$ref: '#/components/schemas/OrderChangeAction'
|
|
status:
|
|
type: string
|
|
title: status
|
|
description: The order change's status.
|
|
requested_by:
|
|
type: string
|
|
title: requested_by
|
|
description: The order change's requested by.
|
|
requested_at:
|
|
oneOf:
|
|
- type: string
|
|
title: requested_at
|
|
description: The order change's requested at.
|
|
- type: string
|
|
title: requested_at
|
|
description: The order change's requested at.
|
|
format: date-time
|
|
confirmed_by:
|
|
type: string
|
|
title: confirmed_by
|
|
description: The order change's confirmed by.
|
|
confirmed_at:
|
|
oneOf:
|
|
- type: string
|
|
title: confirmed_at
|
|
description: The order change's confirmed at.
|
|
- type: string
|
|
title: confirmed_at
|
|
description: The order change's confirmed at.
|
|
format: date-time
|
|
declined_by:
|
|
type: string
|
|
title: declined_by
|
|
description: The order change's declined by.
|
|
declined_reason:
|
|
type: string
|
|
title: declined_reason
|
|
description: The order change's declined reason.
|
|
metadata:
|
|
type: object
|
|
description: The order change's metadata.
|
|
declined_at:
|
|
oneOf:
|
|
- type: string
|
|
title: declined_at
|
|
description: The order change's declined at.
|
|
- type: string
|
|
title: declined_at
|
|
description: The order change's declined at.
|
|
format: date-time
|
|
canceled_by:
|
|
type: string
|
|
title: canceled_by
|
|
description: The order change's canceled by.
|
|
canceled_at:
|
|
oneOf:
|
|
- type: string
|
|
title: canceled_at
|
|
description: The order change's canceled at.
|
|
- type: string
|
|
title: canceled_at
|
|
description: The order change's canceled at.
|
|
format: date-time
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The order change's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The order change's updated at.
|
|
OrderChangeAction:
|
|
type: object
|
|
description: The action's actions.
|
|
x-schemaName: OrderChangeAction
|
|
OrderClaim:
|
|
type: object
|
|
description: The order change's claim.
|
|
x-schemaName: OrderClaim
|
|
OrderExchange:
|
|
type: object
|
|
description: The order change's exchange.
|
|
x-schemaName: OrderExchange
|
|
OrderItem:
|
|
type: object
|
|
description: The item's detail.
|
|
x-schemaName: OrderItem
|
|
OrderLineItemAdjustment:
|
|
type: object
|
|
description: The adjustment's adjustments.
|
|
x-schemaName: OrderLineItemAdjustment
|
|
OrderLineItemTaxLine:
|
|
type: object
|
|
description: The tax line's tax lines.
|
|
x-schemaName: OrderLineItemTaxLine
|
|
OrderPreview:
|
|
type: object
|
|
description: The order edit's order preview.
|
|
x-schemaName: OrderPreview
|
|
required:
|
|
- order_change
|
|
- status
|
|
- currency_code
|
|
- id
|
|
- version
|
|
- original_item_total
|
|
- original_item_subtotal
|
|
- original_item_tax_total
|
|
- item_total
|
|
- item_subtotal
|
|
- item_tax_total
|
|
- original_total
|
|
- original_subtotal
|
|
- original_tax_total
|
|
- total
|
|
- subtotal
|
|
- tax_total
|
|
- discount_total
|
|
- discount_tax_total
|
|
- gift_card_total
|
|
- gift_card_tax_total
|
|
- shipping_total
|
|
- shipping_subtotal
|
|
- shipping_tax_total
|
|
- original_shipping_total
|
|
- original_shipping_subtotal
|
|
- original_shipping_tax_total
|
|
- raw_original_item_total
|
|
- raw_original_item_subtotal
|
|
- raw_original_item_tax_total
|
|
- raw_item_total
|
|
- raw_item_subtotal
|
|
- raw_item_tax_total
|
|
- raw_original_total
|
|
- raw_original_subtotal
|
|
- raw_original_tax_total
|
|
- raw_total
|
|
- raw_subtotal
|
|
- raw_tax_total
|
|
- raw_discount_total
|
|
- raw_discount_tax_total
|
|
- raw_gift_card_total
|
|
- raw_gift_card_tax_total
|
|
- raw_shipping_total
|
|
- raw_shipping_subtotal
|
|
- raw_shipping_tax_total
|
|
- raw_original_shipping_total
|
|
- raw_original_shipping_subtotal
|
|
- raw_original_shipping_tax_total
|
|
properties:
|
|
order_change:
|
|
$ref: '#/components/schemas/OrderChange'
|
|
items:
|
|
type: array
|
|
description: The order preview's items.
|
|
items:
|
|
allOf:
|
|
- type: object
|
|
description: The item's items.
|
|
x-schemaName: OrderLineItem
|
|
required:
|
|
- id
|
|
- title
|
|
- requires_shipping
|
|
- is_discountable
|
|
- is_tax_inclusive
|
|
- unit_price
|
|
- raw_unit_price
|
|
- quantity
|
|
- raw_quantity
|
|
- detail
|
|
- created_at
|
|
- updated_at
|
|
- original_total
|
|
- original_subtotal
|
|
- original_tax_total
|
|
- item_total
|
|
- item_subtotal
|
|
- item_tax_total
|
|
- total
|
|
- subtotal
|
|
- tax_total
|
|
- discount_total
|
|
- discount_tax_total
|
|
- refundable_total
|
|
- refundable_total_per_unit
|
|
- raw_original_total
|
|
- raw_original_subtotal
|
|
- raw_original_tax_total
|
|
- raw_item_total
|
|
- raw_item_subtotal
|
|
- raw_item_tax_total
|
|
- raw_total
|
|
- raw_subtotal
|
|
- raw_tax_total
|
|
- raw_discount_total
|
|
- raw_discount_tax_total
|
|
- raw_refundable_total
|
|
- raw_refundable_total_per_unit
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The item's ID.
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The item's title.
|
|
subtitle:
|
|
type: string
|
|
title: subtitle
|
|
description: The item's subtitle.
|
|
thumbnail:
|
|
type: string
|
|
title: thumbnail
|
|
description: The item's thumbnail.
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The item's variant id.
|
|
product_id:
|
|
type: string
|
|
title: product_id
|
|
description: The item's product id.
|
|
product_title:
|
|
type: string
|
|
title: product_title
|
|
description: The item's product title.
|
|
product_description:
|
|
type: string
|
|
title: product_description
|
|
description: The item's product description.
|
|
product_subtitle:
|
|
type: string
|
|
title: product_subtitle
|
|
description: The item's product subtitle.
|
|
product_type:
|
|
type: string
|
|
title: product_type
|
|
description: The item's product type.
|
|
product_collection:
|
|
type: string
|
|
title: product_collection
|
|
description: The item's product collection.
|
|
product_handle:
|
|
type: string
|
|
title: product_handle
|
|
description: The item's product handle.
|
|
variant_sku:
|
|
type: string
|
|
title: variant_sku
|
|
description: The item's variant sku.
|
|
variant_barcode:
|
|
type: string
|
|
title: variant_barcode
|
|
description: The item's variant barcode.
|
|
variant_title:
|
|
type: string
|
|
title: variant_title
|
|
description: The item's variant title.
|
|
variant_option_values:
|
|
type: object
|
|
description: The item's variant option values.
|
|
requires_shipping:
|
|
type: boolean
|
|
title: requires_shipping
|
|
description: The item's requires shipping.
|
|
is_discountable:
|
|
type: boolean
|
|
title: is_discountable
|
|
description: The item's is discountable.
|
|
is_tax_inclusive:
|
|
type: boolean
|
|
title: is_tax_inclusive
|
|
description: The item's is tax inclusive.
|
|
compare_at_unit_price:
|
|
type: number
|
|
title: compare_at_unit_price
|
|
description: The item's compare at unit price.
|
|
raw_compare_at_unit_price:
|
|
type: object
|
|
description: The item's raw compare at unit price.
|
|
unit_price:
|
|
type: number
|
|
title: unit_price
|
|
description: The item's unit price.
|
|
raw_unit_price:
|
|
type: object
|
|
description: The item's raw unit price.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The item's quantity.
|
|
raw_quantity:
|
|
type: object
|
|
description: The item's raw quantity.
|
|
tax_lines:
|
|
type: array
|
|
description: The item's tax lines.
|
|
items:
|
|
$ref: '#/components/schemas/OrderLineItemTaxLine'
|
|
adjustments:
|
|
type: array
|
|
description: The item's adjustments.
|
|
items:
|
|
$ref: '#/components/schemas/OrderLineItemAdjustment'
|
|
detail:
|
|
$ref: '#/components/schemas/OrderItem'
|
|
created_at:
|
|
type: string
|
|
title: created_at
|
|
description: The item's created at.
|
|
format: date-time
|
|
updated_at:
|
|
type: string
|
|
title: updated_at
|
|
description: The item's updated at.
|
|
format: date-time
|
|
metadata:
|
|
type: object
|
|
description: The item's metadata.
|
|
original_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_total
|
|
description: The item's original total.
|
|
- type: number
|
|
title: original_total
|
|
description: The item's original total.
|
|
- type: string
|
|
title: original_total
|
|
description: The item's original total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: original_subtotal
|
|
description: The item's original subtotal.
|
|
- type: number
|
|
title: original_subtotal
|
|
description: The item's original subtotal.
|
|
- type: string
|
|
title: original_subtotal
|
|
description: The item's original subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_tax_total
|
|
description: The item's original tax total.
|
|
- type: number
|
|
title: original_tax_total
|
|
description: The item's original tax total.
|
|
- type: string
|
|
title: original_tax_total
|
|
description: The item's original tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
item_total:
|
|
oneOf:
|
|
- type: string
|
|
title: item_total
|
|
description: The item's item total.
|
|
- type: number
|
|
title: item_total
|
|
description: The item's item total.
|
|
- type: string
|
|
title: item_total
|
|
description: The item's item total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
item_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: item_subtotal
|
|
description: The item's item subtotal.
|
|
- type: number
|
|
title: item_subtotal
|
|
description: The item's item subtotal.
|
|
- type: string
|
|
title: item_subtotal
|
|
description: The item's item subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
item_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: item_tax_total
|
|
description: The item's item tax total.
|
|
- type: number
|
|
title: item_tax_total
|
|
description: The item's item tax total.
|
|
- type: string
|
|
title: item_tax_total
|
|
description: The item's item tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
total:
|
|
oneOf:
|
|
- type: string
|
|
title: total
|
|
description: The item's total.
|
|
- type: number
|
|
title: total
|
|
description: The item's total.
|
|
- type: string
|
|
title: total
|
|
description: The item's total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: subtotal
|
|
description: The item's subtotal.
|
|
- type: number
|
|
title: subtotal
|
|
description: The item's subtotal.
|
|
- type: string
|
|
title: subtotal
|
|
description: The item's subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: tax_total
|
|
description: The item's tax total.
|
|
- type: number
|
|
title: tax_total
|
|
description: The item's tax total.
|
|
- type: string
|
|
title: tax_total
|
|
description: The item's tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
discount_total:
|
|
oneOf:
|
|
- type: string
|
|
title: discount_total
|
|
description: The item's discount total.
|
|
- type: number
|
|
title: discount_total
|
|
description: The item's discount total.
|
|
- type: string
|
|
title: discount_total
|
|
description: The item's discount total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
discount_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: discount_tax_total
|
|
description: The item's discount tax total.
|
|
- type: number
|
|
title: discount_tax_total
|
|
description: The item's discount tax total.
|
|
- type: string
|
|
title: discount_tax_total
|
|
description: The item's discount tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
refundable_total:
|
|
oneOf:
|
|
- type: string
|
|
title: refundable_total
|
|
description: The item's refundable total.
|
|
- type: number
|
|
title: refundable_total
|
|
description: The item's refundable total.
|
|
- type: string
|
|
title: refundable_total
|
|
description: The item's refundable total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
refundable_total_per_unit:
|
|
oneOf:
|
|
- type: string
|
|
title: refundable_total_per_unit
|
|
description: The item's refundable total per unit.
|
|
- type: number
|
|
title: refundable_total_per_unit
|
|
description: The item's refundable total per unit.
|
|
- type: string
|
|
title: refundable_total_per_unit
|
|
description: The item's refundable total per unit.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
raw_original_total:
|
|
type: object
|
|
description: The item's raw original total.
|
|
raw_original_subtotal:
|
|
type: object
|
|
description: The item's raw original subtotal.
|
|
raw_original_tax_total:
|
|
type: object
|
|
description: The item's raw original tax total.
|
|
raw_item_total:
|
|
type: object
|
|
description: The item's raw item total.
|
|
raw_item_subtotal:
|
|
type: object
|
|
description: The item's raw item subtotal.
|
|
raw_item_tax_total:
|
|
type: object
|
|
description: The item's raw item tax total.
|
|
raw_total:
|
|
type: object
|
|
description: The item's raw total.
|
|
raw_subtotal:
|
|
type: object
|
|
description: The item's raw subtotal.
|
|
raw_tax_total:
|
|
type: object
|
|
description: The item's raw tax total.
|
|
raw_discount_total:
|
|
type: object
|
|
description: The item's raw discount total.
|
|
raw_discount_tax_total:
|
|
type: object
|
|
description: The item's raw discount tax total.
|
|
raw_refundable_total:
|
|
type: object
|
|
description: The item's raw refundable total.
|
|
raw_refundable_total_per_unit:
|
|
type: object
|
|
description: The item's raw refundable total per unit.
|
|
- type: object
|
|
description: The item's items.
|
|
properties:
|
|
actions:
|
|
type: array
|
|
description: The item's actions.
|
|
items:
|
|
type: object
|
|
description: The action's actions.
|
|
x-schemaName: OrderChangeAction
|
|
shipping_methods:
|
|
type: array
|
|
description: The order preview's shipping methods.
|
|
items:
|
|
allOf:
|
|
- type: object
|
|
description: The shipping method's shipping methods.
|
|
x-schemaName: OrderShippingMethod
|
|
required:
|
|
- id
|
|
- order_id
|
|
- name
|
|
- amount
|
|
- raw_amount
|
|
- is_tax_inclusive
|
|
- created_at
|
|
- updated_at
|
|
- original_total
|
|
- original_subtotal
|
|
- original_tax_total
|
|
- total
|
|
- subtotal
|
|
- tax_total
|
|
- discount_total
|
|
- discount_tax_total
|
|
- raw_original_total
|
|
- raw_original_subtotal
|
|
- raw_original_tax_total
|
|
- raw_total
|
|
- raw_subtotal
|
|
- raw_tax_total
|
|
- raw_discount_total
|
|
- raw_discount_tax_total
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The shipping method's ID.
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The shipping method's order id.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The shipping method's name.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The shipping method's description.
|
|
amount:
|
|
oneOf:
|
|
- type: string
|
|
title: amount
|
|
description: The shipping method's amount.
|
|
- type: number
|
|
title: amount
|
|
description: The shipping method's amount.
|
|
- type: string
|
|
title: amount
|
|
description: The shipping method's amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
raw_amount:
|
|
type: object
|
|
description: The shipping method's raw amount.
|
|
is_tax_inclusive:
|
|
type: boolean
|
|
title: is_tax_inclusive
|
|
description: The shipping method's is tax inclusive.
|
|
shipping_option_id:
|
|
type: string
|
|
title: shipping_option_id
|
|
description: The shipping method's shipping option id.
|
|
data:
|
|
type: object
|
|
description: The shipping method's data.
|
|
metadata:
|
|
type: object
|
|
description: The shipping method's metadata.
|
|
tax_lines:
|
|
type: array
|
|
description: The shipping method's tax lines.
|
|
items:
|
|
$ref: '#/components/schemas/OrderShippingMethodTaxLine'
|
|
adjustments:
|
|
type: array
|
|
description: The shipping method's adjustments.
|
|
items:
|
|
$ref: '#/components/schemas/OrderShippingMethodAdjustment'
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The shipping method's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The shipping method's updated at.
|
|
original_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_total
|
|
description: The shipping method's original total.
|
|
- type: number
|
|
title: original_total
|
|
description: The shipping method's original total.
|
|
- type: string
|
|
title: original_total
|
|
description: The shipping method's original total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: original_subtotal
|
|
description: The shipping method's original subtotal.
|
|
- type: number
|
|
title: original_subtotal
|
|
description: The shipping method's original subtotal.
|
|
- type: string
|
|
title: original_subtotal
|
|
description: The shipping method's original subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_tax_total
|
|
description: The shipping method's original tax total.
|
|
- type: number
|
|
title: original_tax_total
|
|
description: The shipping method's original tax total.
|
|
- type: string
|
|
title: original_tax_total
|
|
description: The shipping method's original tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
total:
|
|
oneOf:
|
|
- type: string
|
|
title: total
|
|
description: The shipping method's total.
|
|
- type: number
|
|
title: total
|
|
description: The shipping method's total.
|
|
- type: string
|
|
title: total
|
|
description: The shipping method's total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: subtotal
|
|
description: The shipping method's subtotal.
|
|
- type: number
|
|
title: subtotal
|
|
description: The shipping method's subtotal.
|
|
- type: string
|
|
title: subtotal
|
|
description: The shipping method's subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: tax_total
|
|
description: The shipping method's tax total.
|
|
- type: number
|
|
title: tax_total
|
|
description: The shipping method's tax total.
|
|
- type: string
|
|
title: tax_total
|
|
description: The shipping method's tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
discount_total:
|
|
oneOf:
|
|
- type: string
|
|
title: discount_total
|
|
description: The shipping method's discount total.
|
|
- type: number
|
|
title: discount_total
|
|
description: The shipping method's discount total.
|
|
- type: string
|
|
title: discount_total
|
|
description: The shipping method's discount total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
discount_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: discount_tax_total
|
|
description: The shipping method's discount tax total.
|
|
- type: number
|
|
title: discount_tax_total
|
|
description: The shipping method's discount tax total.
|
|
- type: string
|
|
title: discount_tax_total
|
|
description: The shipping method's discount tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
raw_original_total:
|
|
type: object
|
|
description: The shipping method's raw original total.
|
|
raw_original_subtotal:
|
|
type: object
|
|
description: The shipping method's raw original subtotal.
|
|
raw_original_tax_total:
|
|
type: object
|
|
description: The shipping method's raw original tax total.
|
|
raw_total:
|
|
type: object
|
|
description: The shipping method's raw total.
|
|
raw_subtotal:
|
|
type: object
|
|
description: The shipping method's raw subtotal.
|
|
raw_tax_total:
|
|
type: object
|
|
description: The shipping method's raw tax total.
|
|
raw_discount_total:
|
|
type: object
|
|
description: The shipping method's raw discount total.
|
|
raw_discount_tax_total:
|
|
type: object
|
|
description: The shipping method's raw discount tax total.
|
|
- type: object
|
|
description: The shipping method's shipping methods.
|
|
properties:
|
|
actions:
|
|
type: array
|
|
description: The shipping method's actions.
|
|
items:
|
|
type: object
|
|
description: The action's actions.
|
|
x-schemaName: OrderChangeAction
|
|
status:
|
|
type: string
|
|
enum:
|
|
- canceled
|
|
- requires_action
|
|
- pending
|
|
- completed
|
|
- draft
|
|
- archived
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The order preview's currency code.
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The order preview's ID.
|
|
version:
|
|
type: number
|
|
title: version
|
|
description: The order preview's version.
|
|
region_id:
|
|
type: string
|
|
title: region_id
|
|
description: The order preview's region id.
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The order preview's customer id.
|
|
sales_channel_id:
|
|
type: string
|
|
title: sales_channel_id
|
|
description: The order preview's sales channel id.
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The order preview's email.
|
|
format: email
|
|
shipping_address:
|
|
$ref: '#/components/schemas/OrderAddress'
|
|
billing_address:
|
|
$ref: '#/components/schemas/OrderAddress'
|
|
transactions:
|
|
type: array
|
|
description: The order preview's transactions.
|
|
items:
|
|
$ref: '#/components/schemas/OrderTransaction'
|
|
summary:
|
|
type: object
|
|
description: The order preview's summary.
|
|
required:
|
|
- total
|
|
- subtotal
|
|
- total_tax
|
|
- ordered_total
|
|
- fulfilled_total
|
|
- returned_total
|
|
- return_request_total
|
|
- write_off_total
|
|
- projected_total
|
|
- net_total
|
|
- net_subtotal
|
|
- net_total_tax
|
|
- balance
|
|
- paid_total
|
|
- refunded_total
|
|
properties:
|
|
total:
|
|
oneOf:
|
|
- type: string
|
|
title: total
|
|
description: The summary's total.
|
|
- type: number
|
|
title: total
|
|
description: The summary's total.
|
|
- type: string
|
|
title: total
|
|
description: The summary's total.
|
|
- type: object
|
|
description: The summary's total.
|
|
x-schemaName: IBigNumber
|
|
subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: subtotal
|
|
description: The summary's subtotal.
|
|
- type: number
|
|
title: subtotal
|
|
description: The summary's subtotal.
|
|
- type: string
|
|
title: subtotal
|
|
description: The summary's subtotal.
|
|
- type: object
|
|
description: The summary's subtotal.
|
|
x-schemaName: IBigNumber
|
|
total_tax:
|
|
oneOf:
|
|
- type: string
|
|
title: total_tax
|
|
description: The summary's total tax.
|
|
- type: number
|
|
title: total_tax
|
|
description: The summary's total tax.
|
|
- type: string
|
|
title: total_tax
|
|
description: The summary's total tax.
|
|
- type: object
|
|
description: The summary's total tax.
|
|
x-schemaName: IBigNumber
|
|
ordered_total:
|
|
oneOf:
|
|
- type: string
|
|
title: ordered_total
|
|
description: The summary's ordered total.
|
|
- type: number
|
|
title: ordered_total
|
|
description: The summary's ordered total.
|
|
- type: string
|
|
title: ordered_total
|
|
description: The summary's ordered total.
|
|
- type: object
|
|
description: The summary's ordered total.
|
|
x-schemaName: IBigNumber
|
|
fulfilled_total:
|
|
oneOf:
|
|
- type: string
|
|
title: fulfilled_total
|
|
description: The summary's fulfilled total.
|
|
- type: number
|
|
title: fulfilled_total
|
|
description: The summary's fulfilled total.
|
|
- type: string
|
|
title: fulfilled_total
|
|
description: The summary's fulfilled total.
|
|
- type: object
|
|
description: The summary's fulfilled total.
|
|
x-schemaName: IBigNumber
|
|
returned_total:
|
|
oneOf:
|
|
- type: string
|
|
title: returned_total
|
|
description: The summary's returned total.
|
|
- type: number
|
|
title: returned_total
|
|
description: The summary's returned total.
|
|
- type: string
|
|
title: returned_total
|
|
description: The summary's returned total.
|
|
- type: object
|
|
description: The summary's returned total.
|
|
x-schemaName: IBigNumber
|
|
return_request_total:
|
|
oneOf:
|
|
- type: string
|
|
title: return_request_total
|
|
description: The summary's return request total.
|
|
- type: number
|
|
title: return_request_total
|
|
description: The summary's return request total.
|
|
- type: string
|
|
title: return_request_total
|
|
description: The summary's return request total.
|
|
- type: object
|
|
description: The summary's return request total.
|
|
x-schemaName: IBigNumber
|
|
write_off_total:
|
|
oneOf:
|
|
- type: string
|
|
title: write_off_total
|
|
description: The summary's write off total.
|
|
- type: number
|
|
title: write_off_total
|
|
description: The summary's write off total.
|
|
- type: string
|
|
title: write_off_total
|
|
description: The summary's write off total.
|
|
- type: object
|
|
description: The summary's write off total.
|
|
x-schemaName: IBigNumber
|
|
projected_total:
|
|
oneOf:
|
|
- type: string
|
|
title: projected_total
|
|
description: The summary's projected total.
|
|
- type: number
|
|
title: projected_total
|
|
description: The summary's projected total.
|
|
- type: string
|
|
title: projected_total
|
|
description: The summary's projected total.
|
|
- type: object
|
|
description: The summary's projected total.
|
|
x-schemaName: IBigNumber
|
|
net_total:
|
|
oneOf:
|
|
- type: string
|
|
title: net_total
|
|
description: The summary's net total.
|
|
- type: number
|
|
title: net_total
|
|
description: The summary's net total.
|
|
- type: string
|
|
title: net_total
|
|
description: The summary's net total.
|
|
- type: object
|
|
description: The summary's net total.
|
|
x-schemaName: IBigNumber
|
|
net_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: net_subtotal
|
|
description: The summary's net subtotal.
|
|
- type: number
|
|
title: net_subtotal
|
|
description: The summary's net subtotal.
|
|
- type: string
|
|
title: net_subtotal
|
|
description: The summary's net subtotal.
|
|
- type: object
|
|
description: The summary's net subtotal.
|
|
x-schemaName: IBigNumber
|
|
net_total_tax:
|
|
oneOf:
|
|
- type: string
|
|
title: net_total_tax
|
|
description: The summary's net total tax.
|
|
- type: number
|
|
title: net_total_tax
|
|
description: The summary's net total tax.
|
|
- type: string
|
|
title: net_total_tax
|
|
description: The summary's net total tax.
|
|
- type: object
|
|
description: The summary's net total tax.
|
|
x-schemaName: IBigNumber
|
|
balance:
|
|
oneOf:
|
|
- type: string
|
|
title: balance
|
|
description: The summary's balance.
|
|
- type: number
|
|
title: balance
|
|
description: The summary's balance.
|
|
- type: string
|
|
title: balance
|
|
description: The summary's balance.
|
|
- type: object
|
|
description: The summary's balance.
|
|
x-schemaName: IBigNumber
|
|
paid_total:
|
|
oneOf:
|
|
- type: string
|
|
title: paid_total
|
|
description: The summary's paid total.
|
|
- type: number
|
|
title: paid_total
|
|
description: The summary's paid total.
|
|
- type: string
|
|
title: paid_total
|
|
description: The summary's paid total.
|
|
- type: object
|
|
description: The summary's paid total.
|
|
x-schemaName: IBigNumber
|
|
refunded_total:
|
|
oneOf:
|
|
- type: string
|
|
title: refunded_total
|
|
description: The summary's refunded total.
|
|
- type: number
|
|
title: refunded_total
|
|
description: The summary's refunded total.
|
|
- type: string
|
|
title: refunded_total
|
|
description: The summary's refunded total.
|
|
- type: object
|
|
description: The summary's refunded total.
|
|
x-schemaName: IBigNumber
|
|
metadata:
|
|
type: object
|
|
description: The order preview's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The order preview's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The order preview's updated at.
|
|
original_item_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_item_total
|
|
description: The order preview's original item total.
|
|
- type: number
|
|
title: original_item_total
|
|
description: The order preview's original item total.
|
|
- type: string
|
|
title: original_item_total
|
|
description: The order preview's original item total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_item_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: original_item_subtotal
|
|
description: The order preview's original item subtotal.
|
|
- type: number
|
|
title: original_item_subtotal
|
|
description: The order preview's original item subtotal.
|
|
- type: string
|
|
title: original_item_subtotal
|
|
description: The order preview's original item subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_item_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_item_tax_total
|
|
description: The order preview's original item tax total.
|
|
- type: number
|
|
title: original_item_tax_total
|
|
description: The order preview's original item tax total.
|
|
- type: string
|
|
title: original_item_tax_total
|
|
description: The order preview's original item tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
item_total:
|
|
oneOf:
|
|
- type: string
|
|
title: item_total
|
|
description: The order preview's item total.
|
|
- type: number
|
|
title: item_total
|
|
description: The order preview's item total.
|
|
- type: string
|
|
title: item_total
|
|
description: The order preview's item total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
item_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: item_subtotal
|
|
description: The order preview's item subtotal.
|
|
- type: number
|
|
title: item_subtotal
|
|
description: The order preview's item subtotal.
|
|
- type: string
|
|
title: item_subtotal
|
|
description: The order preview's item subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
item_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: item_tax_total
|
|
description: The order preview's item tax total.
|
|
- type: number
|
|
title: item_tax_total
|
|
description: The order preview's item tax total.
|
|
- type: string
|
|
title: item_tax_total
|
|
description: The order preview's item tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_total
|
|
description: The order preview's original total.
|
|
- type: number
|
|
title: original_total
|
|
description: The order preview's original total.
|
|
- type: string
|
|
title: original_total
|
|
description: The order preview's original total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: original_subtotal
|
|
description: The order preview's original subtotal.
|
|
- type: number
|
|
title: original_subtotal
|
|
description: The order preview's original subtotal.
|
|
- type: string
|
|
title: original_subtotal
|
|
description: The order preview's original subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_tax_total
|
|
description: The order preview's original tax total.
|
|
- type: number
|
|
title: original_tax_total
|
|
description: The order preview's original tax total.
|
|
- type: string
|
|
title: original_tax_total
|
|
description: The order preview's original tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
total:
|
|
oneOf:
|
|
- type: string
|
|
title: total
|
|
description: The order preview's total.
|
|
- type: number
|
|
title: total
|
|
description: The order preview's total.
|
|
- type: string
|
|
title: total
|
|
description: The order preview's total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: subtotal
|
|
description: The order preview's subtotal.
|
|
- type: number
|
|
title: subtotal
|
|
description: The order preview's subtotal.
|
|
- type: string
|
|
title: subtotal
|
|
description: The order preview's subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: tax_total
|
|
description: The order preview's tax total.
|
|
- type: number
|
|
title: tax_total
|
|
description: The order preview's tax total.
|
|
- type: string
|
|
title: tax_total
|
|
description: The order preview's tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
discount_total:
|
|
oneOf:
|
|
- type: string
|
|
title: discount_total
|
|
description: The order preview's discount total.
|
|
- type: number
|
|
title: discount_total
|
|
description: The order preview's discount total.
|
|
- type: string
|
|
title: discount_total
|
|
description: The order preview's discount total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
discount_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: discount_tax_total
|
|
description: The order preview's discount tax total.
|
|
- type: number
|
|
title: discount_tax_total
|
|
description: The order preview's discount tax total.
|
|
- type: string
|
|
title: discount_tax_total
|
|
description: The order preview's discount tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
gift_card_total:
|
|
oneOf:
|
|
- type: string
|
|
title: gift_card_total
|
|
description: The order preview's gift card total.
|
|
- type: number
|
|
title: gift_card_total
|
|
description: The order preview's gift card total.
|
|
- type: string
|
|
title: gift_card_total
|
|
description: The order preview's gift card total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
gift_card_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: gift_card_tax_total
|
|
description: The order preview's gift card tax total.
|
|
- type: number
|
|
title: gift_card_tax_total
|
|
description: The order preview's gift card tax total.
|
|
- type: string
|
|
title: gift_card_tax_total
|
|
description: The order preview's gift card tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
shipping_total:
|
|
oneOf:
|
|
- type: string
|
|
title: shipping_total
|
|
description: The order preview's shipping total.
|
|
- type: number
|
|
title: shipping_total
|
|
description: The order preview's shipping total.
|
|
- type: string
|
|
title: shipping_total
|
|
description: The order preview's shipping total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
shipping_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: shipping_subtotal
|
|
description: The order preview's shipping subtotal.
|
|
- type: number
|
|
title: shipping_subtotal
|
|
description: The order preview's shipping subtotal.
|
|
- type: string
|
|
title: shipping_subtotal
|
|
description: The order preview's shipping subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
shipping_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: shipping_tax_total
|
|
description: The order preview's shipping tax total.
|
|
- type: number
|
|
title: shipping_tax_total
|
|
description: The order preview's shipping tax total.
|
|
- type: string
|
|
title: shipping_tax_total
|
|
description: The order preview's shipping tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_shipping_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_shipping_total
|
|
description: The order preview's original shipping total.
|
|
- type: number
|
|
title: original_shipping_total
|
|
description: The order preview's original shipping total.
|
|
- type: string
|
|
title: original_shipping_total
|
|
description: The order preview's original shipping total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_shipping_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: original_shipping_subtotal
|
|
description: The order preview's original shipping subtotal.
|
|
- type: number
|
|
title: original_shipping_subtotal
|
|
description: The order preview's original shipping subtotal.
|
|
- type: string
|
|
title: original_shipping_subtotal
|
|
description: The order preview's original shipping subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_shipping_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_shipping_tax_total
|
|
description: The order preview's original shipping tax total.
|
|
- type: number
|
|
title: original_shipping_tax_total
|
|
description: The order preview's original shipping tax total.
|
|
- type: string
|
|
title: original_shipping_tax_total
|
|
description: The order preview's original shipping tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
canceled_at:
|
|
oneOf:
|
|
- type: string
|
|
title: canceled_at
|
|
description: The order preview's canceled at.
|
|
- type: string
|
|
title: canceled_at
|
|
description: The order preview's canceled at.
|
|
format: date-time
|
|
raw_original_item_total:
|
|
type: object
|
|
description: The order preview's raw original item total.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw original item total's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw original item total's value.
|
|
raw_original_item_subtotal:
|
|
type: object
|
|
description: The order preview's raw original item subtotal.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw original item subtotal's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw original item subtotal's value.
|
|
raw_original_item_tax_total:
|
|
type: object
|
|
description: The order preview's raw original item tax total.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw original item tax total's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw original item tax total's value.
|
|
raw_item_total:
|
|
type: object
|
|
description: The order preview's raw item total.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw item total's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw item total's value.
|
|
raw_item_subtotal:
|
|
type: object
|
|
description: The order preview's raw item subtotal.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw item subtotal's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw item subtotal's value.
|
|
raw_item_tax_total:
|
|
type: object
|
|
description: The order preview's raw item tax total.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw item tax total's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw item tax total's value.
|
|
raw_original_total:
|
|
type: object
|
|
description: The order preview's raw original total.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw original total's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw original total's value.
|
|
raw_original_subtotal:
|
|
type: object
|
|
description: The order preview's raw original subtotal.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw original subtotal's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw original subtotal's value.
|
|
raw_original_tax_total:
|
|
type: object
|
|
description: The order preview's raw original tax total.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw original tax total's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw original tax total's value.
|
|
raw_total:
|
|
type: object
|
|
description: The order preview's raw total.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw total's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw total's value.
|
|
raw_subtotal:
|
|
type: object
|
|
description: The order preview's raw subtotal.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw subtotal's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw subtotal's value.
|
|
raw_tax_total:
|
|
type: object
|
|
description: The order preview's raw tax total.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw tax total's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw tax total's value.
|
|
raw_discount_total:
|
|
type: object
|
|
description: The order preview's raw discount total.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw discount total's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw discount total's value.
|
|
raw_discount_tax_total:
|
|
type: object
|
|
description: The order preview's raw discount tax total.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw discount tax total's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw discount tax total's value.
|
|
raw_gift_card_total:
|
|
type: object
|
|
description: The order preview's raw gift card total.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw gift card total's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw gift card total's value.
|
|
raw_gift_card_tax_total:
|
|
type: object
|
|
description: The order preview's raw gift card tax total.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw gift card tax total's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw gift card tax total's value.
|
|
raw_shipping_total:
|
|
type: object
|
|
description: The order preview's raw shipping total.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw shipping total's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw shipping total's value.
|
|
raw_shipping_subtotal:
|
|
type: object
|
|
description: The order preview's raw shipping subtotal.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw shipping subtotal's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw shipping subtotal's value.
|
|
raw_shipping_tax_total:
|
|
type: object
|
|
description: The order preview's raw shipping tax total.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw shipping tax total's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw shipping tax total's value.
|
|
raw_original_shipping_total:
|
|
type: object
|
|
description: The order preview's raw original shipping total.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw original shipping total's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw original shipping total's value.
|
|
raw_original_shipping_subtotal:
|
|
type: object
|
|
description: The order preview's raw original shipping subtotal.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw original shipping subtotal's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw original shipping subtotal's value.
|
|
raw_original_shipping_tax_total:
|
|
type: object
|
|
description: The order preview's raw original shipping tax total.
|
|
required:
|
|
- value
|
|
properties:
|
|
value:
|
|
oneOf:
|
|
- type: string
|
|
title: value
|
|
description: The raw original shipping tax total's value.
|
|
- type: number
|
|
title: value
|
|
description: The raw original shipping tax total's value.
|
|
OrderShippingMethodAdjustment:
|
|
type: object
|
|
description: The adjustment's adjustments.
|
|
x-schemaName: OrderShippingMethodAdjustment
|
|
OrderShippingMethodTaxLine:
|
|
type: object
|
|
description: The tax line's tax lines.
|
|
x-schemaName: OrderShippingMethodTaxLine
|
|
OrderTransaction:
|
|
type: object
|
|
description: The transaction's transactions.
|
|
x-schemaName: OrderTransaction
|
|
required:
|
|
- id
|
|
- order_id
|
|
- order
|
|
- amount
|
|
- raw_amount
|
|
- currency_code
|
|
- reference
|
|
- reference_id
|
|
- created_at
|
|
- updated_at
|
|
- metadata
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The transaction's ID.
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The transaction's order id.
|
|
order:
|
|
type: object
|
|
amount:
|
|
oneOf:
|
|
- type: string
|
|
title: amount
|
|
description: The transaction's amount.
|
|
- type: number
|
|
title: amount
|
|
description: The transaction's amount.
|
|
- type: string
|
|
title: amount
|
|
description: The transaction's amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
raw_amount:
|
|
type: object
|
|
description: The transaction's raw amount.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The transaction's currency code.
|
|
reference:
|
|
type: string
|
|
title: reference
|
|
description: The transaction's reference.
|
|
reference_id:
|
|
type: string
|
|
title: reference_id
|
|
description: The transaction's reference id.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The transaction's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The transaction's updated at.
|
|
metadata:
|
|
type: object
|
|
description: The transaction's metadata.
|
|
RefundReasonResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: RefundReasonResponse
|
|
required:
|
|
- refund_reason
|
|
properties:
|
|
refund_reason:
|
|
$ref: '#/components/schemas/AdminRefundReason'
|
|
ReservationResponse:
|
|
type: object
|
|
description: The reservation's details.
|
|
x-schemaName: ReservationResponse
|
|
required:
|
|
- id
|
|
- line_item_id
|
|
- location_id
|
|
- quantity
|
|
- external_id
|
|
- description
|
|
- inventory_item_id
|
|
- inventory_item
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The reservation's ID.
|
|
line_item_id:
|
|
type: string
|
|
title: line_item_id
|
|
description: The reservation's line item id.
|
|
location_id:
|
|
type: string
|
|
title: location_id
|
|
description: The reservation's location id.
|
|
quantity:
|
|
type: string
|
|
title: quantity
|
|
description: The reservation's quantity.
|
|
external_id:
|
|
type: string
|
|
title: external_id
|
|
description: The reservation's external id.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The reservation's description.
|
|
inventory_item_id:
|
|
type: string
|
|
title: inventory_item_id
|
|
description: The reservation's inventory item id.
|
|
inventory_item:
|
|
type: object
|
|
description: The reservation's inventory item.
|
|
metadata:
|
|
type: object
|
|
description: The reservation's metadata.
|
|
created_by:
|
|
type: string
|
|
title: created_by
|
|
description: The reservation's created by.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The reservation's deleted at.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The reservation's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The reservation's updated at.
|
|
Return:
|
|
type: object
|
|
description: The order change's return order.
|
|
x-schemaName: Return
|
|
StoreAddCartLineItem:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreAddCartLineItem
|
|
required:
|
|
- variant_id
|
|
- quantity
|
|
- metadata
|
|
properties:
|
|
variant_id:
|
|
type: string
|
|
title: variant_id
|
|
description: The cart's variant id.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The cart's quantity.
|
|
metadata:
|
|
type: object
|
|
description: The cart's metadata.
|
|
StoreCalculateCartTaxes:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreCalculateCartTaxes
|
|
properties:
|
|
fields:
|
|
type: string
|
|
title: fields
|
|
description: The cart's fields.
|
|
StoreCart:
|
|
type: object
|
|
description: The cart's details.
|
|
x-schemaName: StoreCart
|
|
required:
|
|
- id
|
|
- currency_code
|
|
- original_item_total
|
|
- original_item_subtotal
|
|
- original_item_tax_total
|
|
- item_total
|
|
- item_subtotal
|
|
- item_tax_total
|
|
- original_total
|
|
- original_subtotal
|
|
- original_tax_total
|
|
- total
|
|
- subtotal
|
|
- tax_total
|
|
- discount_total
|
|
- discount_tax_total
|
|
- gift_card_total
|
|
- gift_card_tax_total
|
|
- shipping_total
|
|
- shipping_subtotal
|
|
- shipping_tax_total
|
|
- original_shipping_total
|
|
- original_shipping_subtotal
|
|
- original_shipping_tax_total
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The cart's ID.
|
|
region:
|
|
$ref: '#/components/schemas/BaseRegion'
|
|
region_id:
|
|
type: string
|
|
title: region_id
|
|
description: The cart's region id.
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The cart's customer id.
|
|
sales_channel_id:
|
|
type: string
|
|
title: sales_channel_id
|
|
description: The cart's sales channel id.
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The cart's email.
|
|
format: email
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The cart's currency code.
|
|
shipping_address:
|
|
$ref: '#/components/schemas/BaseCartAddress'
|
|
billing_address:
|
|
$ref: '#/components/schemas/BaseCartAddress'
|
|
items:
|
|
type: array
|
|
description: The cart's items.
|
|
items:
|
|
$ref: '#/components/schemas/BaseCartLineItem'
|
|
shipping_methods:
|
|
type: array
|
|
description: The cart's shipping methods.
|
|
items:
|
|
$ref: '#/components/schemas/BaseCartShippingMethod'
|
|
payment_collection:
|
|
$ref: '#/components/schemas/BasePaymentCollection'
|
|
metadata:
|
|
type: object
|
|
description: The cart's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The cart's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The cart's updated at.
|
|
original_item_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_item_total
|
|
description: The cart's original item total.
|
|
- type: number
|
|
title: original_item_total
|
|
description: The cart's original item total.
|
|
- type: string
|
|
title: original_item_total
|
|
description: The cart's original item total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_item_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: original_item_subtotal
|
|
description: The cart's original item subtotal.
|
|
- type: number
|
|
title: original_item_subtotal
|
|
description: The cart's original item subtotal.
|
|
- type: string
|
|
title: original_item_subtotal
|
|
description: The cart's original item subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_item_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_item_tax_total
|
|
description: The cart's original item tax total.
|
|
- type: number
|
|
title: original_item_tax_total
|
|
description: The cart's original item tax total.
|
|
- type: string
|
|
title: original_item_tax_total
|
|
description: The cart's original item tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
item_total:
|
|
oneOf:
|
|
- type: string
|
|
title: item_total
|
|
description: The cart's item total.
|
|
- type: number
|
|
title: item_total
|
|
description: The cart's item total.
|
|
- type: string
|
|
title: item_total
|
|
description: The cart's item total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
item_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: item_subtotal
|
|
description: The cart's item subtotal.
|
|
- type: number
|
|
title: item_subtotal
|
|
description: The cart's item subtotal.
|
|
- type: string
|
|
title: item_subtotal
|
|
description: The cart's item subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
item_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: item_tax_total
|
|
description: The cart's item tax total.
|
|
- type: number
|
|
title: item_tax_total
|
|
description: The cart's item tax total.
|
|
- type: string
|
|
title: item_tax_total
|
|
description: The cart's item tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_total
|
|
description: The cart's original total.
|
|
- type: number
|
|
title: original_total
|
|
description: The cart's original total.
|
|
- type: string
|
|
title: original_total
|
|
description: The cart's original total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: original_subtotal
|
|
description: The cart's original subtotal.
|
|
- type: number
|
|
title: original_subtotal
|
|
description: The cart's original subtotal.
|
|
- type: string
|
|
title: original_subtotal
|
|
description: The cart's original subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_tax_total
|
|
description: The cart's original tax total.
|
|
- type: number
|
|
title: original_tax_total
|
|
description: The cart's original tax total.
|
|
- type: string
|
|
title: original_tax_total
|
|
description: The cart's original tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
total:
|
|
oneOf:
|
|
- type: string
|
|
title: total
|
|
description: The cart's total.
|
|
- type: number
|
|
title: total
|
|
description: The cart's total.
|
|
- type: string
|
|
title: total
|
|
description: The cart's total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: subtotal
|
|
description: The cart's subtotal.
|
|
- type: number
|
|
title: subtotal
|
|
description: The cart's subtotal.
|
|
- type: string
|
|
title: subtotal
|
|
description: The cart's subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: tax_total
|
|
description: The cart's tax total.
|
|
- type: number
|
|
title: tax_total
|
|
description: The cart's tax total.
|
|
- type: string
|
|
title: tax_total
|
|
description: The cart's tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
discount_total:
|
|
oneOf:
|
|
- type: string
|
|
title: discount_total
|
|
description: The cart's discount total.
|
|
- type: number
|
|
title: discount_total
|
|
description: The cart's discount total.
|
|
- type: string
|
|
title: discount_total
|
|
description: The cart's discount total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
discount_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: discount_tax_total
|
|
description: The cart's discount tax total.
|
|
- type: number
|
|
title: discount_tax_total
|
|
description: The cart's discount tax total.
|
|
- type: string
|
|
title: discount_tax_total
|
|
description: The cart's discount tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
gift_card_total:
|
|
oneOf:
|
|
- type: string
|
|
title: gift_card_total
|
|
description: The cart's gift card total.
|
|
- type: number
|
|
title: gift_card_total
|
|
description: The cart's gift card total.
|
|
- type: string
|
|
title: gift_card_total
|
|
description: The cart's gift card total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
gift_card_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: gift_card_tax_total
|
|
description: The cart's gift card tax total.
|
|
- type: number
|
|
title: gift_card_tax_total
|
|
description: The cart's gift card tax total.
|
|
- type: string
|
|
title: gift_card_tax_total
|
|
description: The cart's gift card tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
shipping_total:
|
|
oneOf:
|
|
- type: string
|
|
title: shipping_total
|
|
description: The cart's shipping total.
|
|
- type: number
|
|
title: shipping_total
|
|
description: The cart's shipping total.
|
|
- type: string
|
|
title: shipping_total
|
|
description: The cart's shipping total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
shipping_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: shipping_subtotal
|
|
description: The cart's shipping subtotal.
|
|
- type: number
|
|
title: shipping_subtotal
|
|
description: The cart's shipping subtotal.
|
|
- type: string
|
|
title: shipping_subtotal
|
|
description: The cart's shipping subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
shipping_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: shipping_tax_total
|
|
description: The cart's shipping tax total.
|
|
- type: number
|
|
title: shipping_tax_total
|
|
description: The cart's shipping tax total.
|
|
- type: string
|
|
title: shipping_tax_total
|
|
description: The cart's shipping tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_shipping_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_shipping_total
|
|
description: The cart's original shipping total.
|
|
- type: number
|
|
title: original_shipping_total
|
|
description: The cart's original shipping total.
|
|
- type: string
|
|
title: original_shipping_total
|
|
description: The cart's original shipping total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_shipping_subtotal:
|
|
oneOf:
|
|
- type: string
|
|
title: original_shipping_subtotal
|
|
description: The cart's original shipping subtotal.
|
|
- type: number
|
|
title: original_shipping_subtotal
|
|
description: The cart's original shipping subtotal.
|
|
- type: string
|
|
title: original_shipping_subtotal
|
|
description: The cart's original shipping subtotal.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
original_shipping_tax_total:
|
|
oneOf:
|
|
- type: string
|
|
title: original_shipping_tax_total
|
|
description: The cart's original shipping tax total.
|
|
- type: number
|
|
title: original_shipping_tax_total
|
|
description: The cart's original shipping tax total.
|
|
- type: string
|
|
title: original_shipping_tax_total
|
|
description: The cart's original shipping tax total.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
StoreCartResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreCartResponse
|
|
required:
|
|
- cart
|
|
properties:
|
|
cart:
|
|
$ref: '#/components/schemas/StoreCart'
|
|
StoreCollection:
|
|
type: object
|
|
description: The collection's details.
|
|
x-schemaName: StoreCollection
|
|
required:
|
|
- id
|
|
- title
|
|
- handle
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
- metadata
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The collection's ID.
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The collection's title.
|
|
handle:
|
|
type: string
|
|
title: handle
|
|
description: The collection's handle.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The collection's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The collection's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The collection's deleted at.
|
|
products:
|
|
type: array
|
|
description: The collection's products.
|
|
items:
|
|
$ref: '#/components/schemas/AdminProduct'
|
|
metadata:
|
|
type: object
|
|
description: The collection's metadata.
|
|
StoreCollectionResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreCollectionResponse
|
|
required:
|
|
- collection
|
|
properties:
|
|
collection:
|
|
$ref: '#/components/schemas/StoreCollection'
|
|
StoreCreateCustomer:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreCreateCustomer
|
|
required:
|
|
- email
|
|
- company_name
|
|
- first_name
|
|
- last_name
|
|
- phone
|
|
properties:
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The customer's email.
|
|
format: email
|
|
company_name:
|
|
type: string
|
|
title: company_name
|
|
description: The customer's company name.
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The customer's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The customer's last name.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The customer's phone.
|
|
StoreCurrency:
|
|
type: object
|
|
description: The currency's details.
|
|
x-schemaName: StoreCurrency
|
|
required:
|
|
- code
|
|
- symbol
|
|
- symbol_native
|
|
- name
|
|
- decimal_digits
|
|
- rounding
|
|
- raw_rounding
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
code:
|
|
type: string
|
|
title: code
|
|
description: The currency's code.
|
|
symbol:
|
|
type: string
|
|
title: symbol
|
|
description: The currency's symbol.
|
|
symbol_native:
|
|
type: string
|
|
title: symbol_native
|
|
description: The currency's symbol native.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The currency's name.
|
|
decimal_digits:
|
|
type: number
|
|
title: decimal_digits
|
|
description: The currency's decimal digits.
|
|
rounding:
|
|
type: number
|
|
title: rounding
|
|
description: The currency's rounding.
|
|
raw_rounding:
|
|
type: object
|
|
description: The currency's raw rounding.
|
|
required:
|
|
- value
|
|
- precision
|
|
properties:
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The raw rounding's value.
|
|
precision:
|
|
type: number
|
|
title: precision
|
|
description: The raw rounding's precision.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The currency's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The currency's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The currency's deleted at.
|
|
StoreCurrencyListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreCurrencyListResponse
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
- currencies
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The currency's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The currency's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The currency's count.
|
|
currencies:
|
|
type: array
|
|
description: The currency's currencies.
|
|
items:
|
|
$ref: '#/components/schemas/StoreCurrency'
|
|
StoreCurrencyResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreCurrencyResponse
|
|
required:
|
|
- currency
|
|
properties:
|
|
currency:
|
|
$ref: '#/components/schemas/StoreCurrency'
|
|
StoreCustomer:
|
|
type: object
|
|
description: The customer's details.
|
|
x-schemaName: StoreCustomer
|
|
required:
|
|
- id
|
|
- email
|
|
- default_billing_address_id
|
|
- default_shipping_address_id
|
|
- company_name
|
|
- first_name
|
|
- last_name
|
|
- addresses
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The customer's ID.
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The customer's email.
|
|
format: email
|
|
default_billing_address_id:
|
|
type: string
|
|
title: default_billing_address_id
|
|
description: The customer's default billing address id.
|
|
default_shipping_address_id:
|
|
type: string
|
|
title: default_shipping_address_id
|
|
description: The customer's default shipping address id.
|
|
company_name:
|
|
type: string
|
|
title: company_name
|
|
description: The customer's company name.
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The customer's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The customer's last name.
|
|
addresses:
|
|
type: array
|
|
description: The customer's addresses.
|
|
items:
|
|
$ref: '#/components/schemas/BaseCustomerAddress'
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The customer's phone.
|
|
metadata:
|
|
type: object
|
|
description: The customer's metadata.
|
|
created_by:
|
|
type: string
|
|
title: created_by
|
|
description: The customer's created by.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The customer's deleted at.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The customer's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The customer's updated at.
|
|
StoreCustomerAddress:
|
|
type: object
|
|
description: The customer's address.
|
|
x-schemaName: StoreCustomerAddress
|
|
required:
|
|
- id
|
|
- address_name
|
|
- is_default_shipping
|
|
- is_default_billing
|
|
- customer_id
|
|
- company
|
|
- first_name
|
|
- last_name
|
|
- address_1
|
|
- address_2
|
|
- city
|
|
- country_code
|
|
- province
|
|
- postal_code
|
|
- phone
|
|
- metadata
|
|
- created_at
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The address's ID.
|
|
address_name:
|
|
type: string
|
|
title: address_name
|
|
description: The address's address name.
|
|
is_default_shipping:
|
|
type: boolean
|
|
title: is_default_shipping
|
|
description: The address's is default shipping.
|
|
is_default_billing:
|
|
type: boolean
|
|
title: is_default_billing
|
|
description: The address's is default billing.
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The address's customer id.
|
|
company:
|
|
type: string
|
|
title: company
|
|
description: The address's company.
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The address's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The address's last name.
|
|
address_1:
|
|
type: string
|
|
title: address_1
|
|
description: The address's address 1.
|
|
address_2:
|
|
type: string
|
|
title: address_2
|
|
description: The address's address 2.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The address's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The address's country code.
|
|
province:
|
|
type: string
|
|
title: province
|
|
description: The address's province.
|
|
postal_code:
|
|
type: string
|
|
title: postal_code
|
|
description: The address's postal code.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The address's phone.
|
|
metadata:
|
|
type: object
|
|
description: The address's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The address's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The address's updated at.
|
|
StoreCustomerAddressListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreCustomerAddressListResponse
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
- addresses
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The customer's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The customer's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The customer's count.
|
|
addresses:
|
|
type: array
|
|
description: The customer's addresses.
|
|
items:
|
|
$ref: '#/components/schemas/StoreCustomerAddress'
|
|
StoreCustomerAddressResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreCustomerAddressResponse
|
|
required:
|
|
- address
|
|
properties:
|
|
address:
|
|
$ref: '#/components/schemas/StoreCustomerAddress'
|
|
StoreCustomerResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreCustomerResponse
|
|
required:
|
|
- customer
|
|
properties:
|
|
customer:
|
|
$ref: '#/components/schemas/StoreCustomer'
|
|
StoreOrder:
|
|
type: object
|
|
description: The cart's order.
|
|
x-schemaName: StoreOrder
|
|
required:
|
|
- id
|
|
- version
|
|
- region_id
|
|
- customer_id
|
|
- sales_channel_id
|
|
- email
|
|
- currency_code
|
|
- items
|
|
- shipping_methods
|
|
- payment_status
|
|
- fulfillment_status
|
|
- summary
|
|
- metadata
|
|
- created_at
|
|
- updated_at
|
|
- original_item_total
|
|
- original_item_subtotal
|
|
- original_item_tax_total
|
|
- item_total
|
|
- item_subtotal
|
|
- item_tax_total
|
|
- original_total
|
|
- original_subtotal
|
|
- original_tax_total
|
|
- total
|
|
- subtotal
|
|
- tax_total
|
|
- discount_total
|
|
- discount_tax_total
|
|
- gift_card_total
|
|
- gift_card_tax_total
|
|
- shipping_total
|
|
- shipping_subtotal
|
|
- shipping_tax_total
|
|
- original_shipping_total
|
|
- original_shipping_subtotal
|
|
- original_shipping_tax_total
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The order's ID.
|
|
version:
|
|
type: number
|
|
title: version
|
|
description: The order's version.
|
|
region_id:
|
|
type: string
|
|
title: region_id
|
|
description: The order's region id.
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The order's customer id.
|
|
sales_channel_id:
|
|
type: string
|
|
title: sales_channel_id
|
|
description: The order's sales channel id.
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The order's email.
|
|
format: email
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The order's currency code.
|
|
display_id:
|
|
type: string
|
|
title: display_id
|
|
description: The order's display id.
|
|
shipping_address:
|
|
$ref: '#/components/schemas/BaseOrderAddress'
|
|
billing_address:
|
|
$ref: '#/components/schemas/BaseOrderAddress'
|
|
items:
|
|
type: array
|
|
description: The order's items.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderLineItem'
|
|
shipping_methods:
|
|
type: array
|
|
description: The order's shipping methods.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderShippingMethod'
|
|
payment_collections:
|
|
type: array
|
|
description: The order's payment collections.
|
|
items:
|
|
$ref: '#/components/schemas/BasePaymentCollection'
|
|
payment_status:
|
|
type: string
|
|
enum:
|
|
- canceled
|
|
- not_paid
|
|
- awaiting
|
|
- authorized
|
|
- partially_authorized
|
|
- captured
|
|
- partially_captured
|
|
- partially_refunded
|
|
- refunded
|
|
- requires_action
|
|
fulfillments:
|
|
type: array
|
|
description: The order's fulfillments.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderFulfillment'
|
|
fulfillment_status:
|
|
type: string
|
|
enum:
|
|
- canceled
|
|
- not_fulfilled
|
|
- partially_fulfilled
|
|
- fulfilled
|
|
- partially_shipped
|
|
- shipped
|
|
- partially_delivered
|
|
- delivered
|
|
transactions:
|
|
type: array
|
|
description: The order's transactions.
|
|
items:
|
|
$ref: '#/components/schemas/BaseOrderTransaction'
|
|
summary:
|
|
$ref: '#/components/schemas/BaseOrderSummary'
|
|
metadata:
|
|
type: object
|
|
description: The order's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The order's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The order's updated at.
|
|
original_item_total:
|
|
type: number
|
|
title: original_item_total
|
|
description: The order's original item total.
|
|
original_item_subtotal:
|
|
type: number
|
|
title: original_item_subtotal
|
|
description: The order's original item subtotal.
|
|
original_item_tax_total:
|
|
type: number
|
|
title: original_item_tax_total
|
|
description: The order's original item tax total.
|
|
item_total:
|
|
type: number
|
|
title: item_total
|
|
description: The order's item total.
|
|
item_subtotal:
|
|
type: number
|
|
title: item_subtotal
|
|
description: The order's item subtotal.
|
|
item_tax_total:
|
|
type: number
|
|
title: item_tax_total
|
|
description: The order's item tax total.
|
|
original_total:
|
|
type: number
|
|
title: original_total
|
|
description: The order's original total.
|
|
original_subtotal:
|
|
type: number
|
|
title: original_subtotal
|
|
description: The order's original subtotal.
|
|
original_tax_total:
|
|
type: number
|
|
title: original_tax_total
|
|
description: The order's original tax total.
|
|
total:
|
|
type: number
|
|
title: total
|
|
description: The order's total.
|
|
subtotal:
|
|
type: number
|
|
title: subtotal
|
|
description: The order's subtotal.
|
|
tax_total:
|
|
type: number
|
|
title: tax_total
|
|
description: The order's tax total.
|
|
discount_total:
|
|
type: number
|
|
title: discount_total
|
|
description: The order's discount total.
|
|
discount_tax_total:
|
|
type: number
|
|
title: discount_tax_total
|
|
description: The order's discount tax total.
|
|
gift_card_total:
|
|
type: number
|
|
title: gift_card_total
|
|
description: The order's gift card total.
|
|
gift_card_tax_total:
|
|
type: number
|
|
title: gift_card_tax_total
|
|
description: The order's gift card tax total.
|
|
shipping_total:
|
|
type: number
|
|
title: shipping_total
|
|
description: The order's shipping total.
|
|
shipping_subtotal:
|
|
type: number
|
|
title: shipping_subtotal
|
|
description: The order's shipping subtotal.
|
|
shipping_tax_total:
|
|
type: number
|
|
title: shipping_tax_total
|
|
description: The order's shipping tax total.
|
|
original_shipping_total:
|
|
type: number
|
|
title: original_shipping_total
|
|
description: The order's original shipping total.
|
|
original_shipping_subtotal:
|
|
type: number
|
|
title: original_shipping_subtotal
|
|
description: The order's original shipping subtotal.
|
|
original_shipping_tax_total:
|
|
type: number
|
|
title: original_shipping_tax_total
|
|
description: The order's original shipping tax total.
|
|
StoreOrderResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreOrderResponse
|
|
required:
|
|
- order
|
|
properties:
|
|
order:
|
|
$ref: '#/components/schemas/StoreOrder'
|
|
StorePaymentCollection:
|
|
type: object
|
|
description: The payment collection's details.
|
|
x-schemaName: StorePaymentCollection
|
|
required:
|
|
- id
|
|
- currency_code
|
|
- region_id
|
|
- amount
|
|
- status
|
|
- payment_providers
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The payment collection's ID.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The payment collection's currency code.
|
|
region_id:
|
|
type: string
|
|
title: region_id
|
|
description: The payment collection's region id.
|
|
amount:
|
|
oneOf:
|
|
- type: string
|
|
title: amount
|
|
description: The payment collection's amount.
|
|
- type: number
|
|
title: amount
|
|
description: The payment collection's amount.
|
|
- type: string
|
|
title: amount
|
|
description: The payment collection's amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
authorized_amount:
|
|
oneOf:
|
|
- type: string
|
|
title: authorized_amount
|
|
description: The payment collection's authorized amount.
|
|
- type: number
|
|
title: authorized_amount
|
|
description: The payment collection's authorized amount.
|
|
- type: string
|
|
title: authorized_amount
|
|
description: The payment collection's authorized amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
captured_amount:
|
|
oneOf:
|
|
- type: string
|
|
title: captured_amount
|
|
description: The payment collection's captured amount.
|
|
- type: number
|
|
title: captured_amount
|
|
description: The payment collection's captured amount.
|
|
- type: string
|
|
title: captured_amount
|
|
description: The payment collection's captured amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
refunded_amount:
|
|
oneOf:
|
|
- type: string
|
|
title: refunded_amount
|
|
description: The payment collection's refunded amount.
|
|
- type: number
|
|
title: refunded_amount
|
|
description: The payment collection's refunded amount.
|
|
- type: string
|
|
title: refunded_amount
|
|
description: The payment collection's refunded amount.
|
|
- $ref: '#/components/schemas/IBigNumber'
|
|
completed_at:
|
|
oneOf:
|
|
- type: string
|
|
title: completed_at
|
|
description: The payment collection's completed at.
|
|
- type: string
|
|
title: completed_at
|
|
description: The payment collection's completed at.
|
|
format: date-time
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The payment collection's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The payment collection's updated at.
|
|
metadata:
|
|
type: object
|
|
description: The payment collection's metadata.
|
|
status:
|
|
type: string
|
|
enum:
|
|
- canceled
|
|
- not_paid
|
|
- awaiting
|
|
- authorized
|
|
- partially_authorized
|
|
payment_providers:
|
|
type: array
|
|
description: The payment collection's payment providers.
|
|
items:
|
|
$ref: '#/components/schemas/BasePaymentProvider'
|
|
payment_sessions:
|
|
type: array
|
|
description: The payment collection's payment sessions.
|
|
items:
|
|
$ref: '#/components/schemas/BasePaymentSession'
|
|
payments:
|
|
type: array
|
|
description: The payment collection's payments.
|
|
items:
|
|
$ref: '#/components/schemas/BasePayment'
|
|
StorePaymentCollectionResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StorePaymentCollectionResponse
|
|
required:
|
|
- payment_collection
|
|
properties:
|
|
payment_collection:
|
|
$ref: '#/components/schemas/StorePaymentCollection'
|
|
StorePaymentProvider:
|
|
type: object
|
|
description: The payment provider's payment providers.
|
|
x-schemaName: StorePaymentProvider
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The payment provider's ID.
|
|
StorePostReturnsReqSchema:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StorePostReturnsReqSchema
|
|
required:
|
|
- order_id
|
|
- items
|
|
- return_shipping
|
|
- note
|
|
- location_id
|
|
properties:
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The return's order id.
|
|
items:
|
|
type: array
|
|
description: The return's items.
|
|
items:
|
|
type: object
|
|
description: The item's items.
|
|
required:
|
|
- id
|
|
- quantity
|
|
- reason_id
|
|
- note
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The item's ID.
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The item's quantity.
|
|
reason_id:
|
|
type: string
|
|
title: reason_id
|
|
description: The item's reason id.
|
|
note:
|
|
type: string
|
|
title: note
|
|
description: The item's note.
|
|
return_shipping:
|
|
type: object
|
|
description: The return's return shipping.
|
|
required:
|
|
- option_id
|
|
properties:
|
|
option_id:
|
|
type: string
|
|
title: option_id
|
|
description: The return shipping's option id.
|
|
price:
|
|
type: number
|
|
title: price
|
|
description: The return shipping's price.
|
|
note:
|
|
type: string
|
|
title: note
|
|
description: The return's note.
|
|
receive_now:
|
|
type: boolean
|
|
title: receive_now
|
|
description: The return's receive now.
|
|
location_id:
|
|
type: string
|
|
title: location_id
|
|
description: The return's location id.
|
|
StoreProduct:
|
|
type: object
|
|
description: The product's details.
|
|
x-schemaName: StoreProduct
|
|
required:
|
|
- title
|
|
- status
|
|
- length
|
|
- options
|
|
- description
|
|
- id
|
|
- created_at
|
|
- updated_at
|
|
- variants
|
|
- handle
|
|
- subtitle
|
|
- is_giftcard
|
|
- thumbnail
|
|
- width
|
|
- weight
|
|
- height
|
|
- origin_country
|
|
- hs_code
|
|
- mid_code
|
|
- material
|
|
- collection_id
|
|
- type_id
|
|
- images
|
|
- discountable
|
|
- external_id
|
|
- deleted_at
|
|
properties:
|
|
categories:
|
|
type: array
|
|
description: The product's categories.
|
|
items:
|
|
type: object
|
|
type:
|
|
type: object
|
|
title:
|
|
type: string
|
|
title: title
|
|
description: The product's title.
|
|
status:
|
|
type: string
|
|
enum:
|
|
- draft
|
|
- proposed
|
|
- published
|
|
- rejected
|
|
length:
|
|
type: number
|
|
title: length
|
|
description: The product's length.
|
|
options:
|
|
type: array
|
|
description: The product's options.
|
|
items:
|
|
$ref: '#/components/schemas/BaseProductOption'
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The product's description.
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The product's ID.
|
|
metadata:
|
|
type: object
|
|
description: The product's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The product's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The product's updated at.
|
|
variants:
|
|
type: array
|
|
description: The product's variants.
|
|
items:
|
|
$ref: '#/components/schemas/BaseProductVariant'
|
|
handle:
|
|
type: string
|
|
title: handle
|
|
description: The product's handle.
|
|
subtitle:
|
|
type: string
|
|
title: subtitle
|
|
description: The product's subtitle.
|
|
is_giftcard:
|
|
type: boolean
|
|
title: is_giftcard
|
|
description: The product's is giftcard.
|
|
thumbnail:
|
|
type: string
|
|
title: thumbnail
|
|
description: The product's thumbnail.
|
|
width:
|
|
type: number
|
|
title: width
|
|
description: The product's width.
|
|
weight:
|
|
type: number
|
|
title: weight
|
|
description: The product's weight.
|
|
height:
|
|
type: number
|
|
title: height
|
|
description: The product's height.
|
|
origin_country:
|
|
type: string
|
|
title: origin_country
|
|
description: The product's origin country.
|
|
hs_code:
|
|
type: string
|
|
title: hs_code
|
|
description: The product's hs code.
|
|
mid_code:
|
|
type: string
|
|
title: mid_code
|
|
description: The product's mid code.
|
|
material:
|
|
type: string
|
|
title: material
|
|
description: The product's material.
|
|
collection:
|
|
$ref: '#/components/schemas/BaseCollection'
|
|
collection_id:
|
|
type: string
|
|
title: collection_id
|
|
description: The product's collection id.
|
|
type_id:
|
|
type: string
|
|
title: type_id
|
|
description: The product's type id.
|
|
tags:
|
|
type: array
|
|
description: The product's tags.
|
|
items:
|
|
$ref: '#/components/schemas/BaseProductTag'
|
|
images:
|
|
type: array
|
|
description: The product's images.
|
|
items:
|
|
$ref: '#/components/schemas/BaseProductImage'
|
|
discountable:
|
|
type: boolean
|
|
title: discountable
|
|
description: The product's discountable.
|
|
external_id:
|
|
type: string
|
|
title: external_id
|
|
description: The product's external id.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The product's deleted at.
|
|
StoreProductCategory:
|
|
type: object
|
|
description: The category's categories.
|
|
x-schemaName: StoreProductCategory
|
|
required:
|
|
- id
|
|
- name
|
|
- description
|
|
- handle
|
|
- is_active
|
|
- is_internal
|
|
- rank
|
|
- parent_category_id
|
|
- parent_category
|
|
- category_children
|
|
- created_at
|
|
- updated_at
|
|
- deleted_at
|
|
properties:
|
|
products:
|
|
type: array
|
|
description: The category's products.
|
|
items:
|
|
$ref: '#/components/schemas/StoreProduct'
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The category's ID.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The category's name.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The category's description.
|
|
handle:
|
|
type: string
|
|
title: handle
|
|
description: The category's handle.
|
|
is_active:
|
|
type: boolean
|
|
title: is_active
|
|
description: The category's is active.
|
|
is_internal:
|
|
type: boolean
|
|
title: is_internal
|
|
description: The category's is internal.
|
|
rank:
|
|
type: number
|
|
title: rank
|
|
description: The category's rank.
|
|
parent_category_id:
|
|
type: string
|
|
title: parent_category_id
|
|
description: The category's parent category id.
|
|
parent_category:
|
|
$ref: '#/components/schemas/BaseProductCategory'
|
|
category_children:
|
|
type: array
|
|
description: The category's category children.
|
|
items:
|
|
$ref: '#/components/schemas/BaseProductCategory'
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The category's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The category's updated at.
|
|
deleted_at:
|
|
type: string
|
|
format: date-time
|
|
title: deleted_at
|
|
description: The category's deleted at.
|
|
StoreProductCategoryListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreProductCategoryListResponse
|
|
required:
|
|
- limit
|
|
- offset
|
|
- count
|
|
- product_categories
|
|
properties:
|
|
limit:
|
|
type: number
|
|
title: limit
|
|
description: The product category's limit.
|
|
offset:
|
|
type: number
|
|
title: offset
|
|
description: The product category's offset.
|
|
count:
|
|
type: number
|
|
title: count
|
|
description: The product category's count.
|
|
product_categories:
|
|
type: array
|
|
description: The product category's product categories.
|
|
items:
|
|
$ref: '#/components/schemas/StoreProductCategory'
|
|
StoreProductCategoryResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreProductCategoryResponse
|
|
required:
|
|
- product_category
|
|
properties:
|
|
product_category:
|
|
$ref: '#/components/schemas/StoreProductCategory'
|
|
StoreProductResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreProductResponse
|
|
required:
|
|
- product
|
|
properties:
|
|
product:
|
|
$ref: '#/components/schemas/StoreProduct'
|
|
StoreRegion:
|
|
type: object
|
|
description: The region's details.
|
|
x-schemaName: StoreRegion
|
|
required:
|
|
- id
|
|
- name
|
|
- currency_code
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The region's ID.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The region's name.
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The region's currency code.
|
|
automatic_taxes:
|
|
type: boolean
|
|
title: automatic_taxes
|
|
description: The region's automatic taxes.
|
|
countries:
|
|
type: array
|
|
description: The region's countries.
|
|
items:
|
|
$ref: '#/components/schemas/BaseRegionCountry'
|
|
payment_providers:
|
|
type: array
|
|
description: The region's payment providers.
|
|
items:
|
|
$ref: '#/components/schemas/AdminPaymentProvider'
|
|
metadata:
|
|
type: object
|
|
description: The region's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The region's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The region's updated at.
|
|
StoreReturn:
|
|
type: object
|
|
description: The return's details.
|
|
x-schemaName: StoreReturn
|
|
required:
|
|
- id
|
|
- order_id
|
|
- order_version
|
|
- display_id
|
|
- items
|
|
- received_at
|
|
- created_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The return's ID.
|
|
order_id:
|
|
type: string
|
|
title: order_id
|
|
description: The return's order id.
|
|
status:
|
|
type: string
|
|
title: status
|
|
description: The return's status.
|
|
exchange_id:
|
|
type: string
|
|
title: exchange_id
|
|
description: The return's exchange id.
|
|
location_id:
|
|
type: string
|
|
title: location_id
|
|
description: The return's location id.
|
|
claim_id:
|
|
type: string
|
|
title: claim_id
|
|
description: The return's claim id.
|
|
order_version:
|
|
type: number
|
|
title: order_version
|
|
description: The return's order version.
|
|
display_id:
|
|
type: number
|
|
title: display_id
|
|
description: The return's display id.
|
|
no_notification:
|
|
type: boolean
|
|
title: no_notification
|
|
description: The return's no notification.
|
|
refund_amount:
|
|
type: number
|
|
title: refund_amount
|
|
description: The return's refund amount.
|
|
items:
|
|
type: array
|
|
description: The return's items.
|
|
items:
|
|
$ref: '#/components/schemas/BaseReturnItem'
|
|
received_at:
|
|
type: string
|
|
title: received_at
|
|
description: The return's received at.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The return's created at.
|
|
StoreReturnReason:
|
|
type: object
|
|
description: The return reason's details.
|
|
x-schemaName: StoreReturnReason
|
|
required:
|
|
- id
|
|
- value
|
|
- label
|
|
- created_at
|
|
- updated_at
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The return reason's ID.
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The return reason's value.
|
|
label:
|
|
type: string
|
|
title: label
|
|
description: The return reason's label.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The return reason's description.
|
|
metadata:
|
|
type: object
|
|
description: The return reason's metadata.
|
|
created_at:
|
|
type: string
|
|
format: date-time
|
|
title: created_at
|
|
description: The return reason's created at.
|
|
updated_at:
|
|
type: string
|
|
format: date-time
|
|
title: updated_at
|
|
description: The return reason's updated at.
|
|
StoreReturnReasonResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreReturnReasonResponse
|
|
required:
|
|
- return_reason
|
|
properties:
|
|
return_reason:
|
|
$ref: '#/components/schemas/StoreReturnReason'
|
|
StoreReturnResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreReturnResponse
|
|
required:
|
|
- return
|
|
properties:
|
|
return:
|
|
$ref: '#/components/schemas/StoreReturn'
|
|
StoreShippingOption:
|
|
type: object
|
|
description: The shipping option's shipping options.
|
|
x-schemaName: StoreShippingOption
|
|
required:
|
|
- id
|
|
- name
|
|
- price_type
|
|
- service_zone_id
|
|
- provider_id
|
|
- provider
|
|
- shipping_option_type_id
|
|
- type
|
|
- shipping_profile_id
|
|
- amount
|
|
- is_tax_inclusive
|
|
- data
|
|
- metadata
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The shipping option's ID.
|
|
name:
|
|
type: string
|
|
title: name
|
|
description: The shipping option's name.
|
|
price_type:
|
|
type: string
|
|
enum:
|
|
- flat
|
|
- calculated
|
|
service_zone_id:
|
|
type: string
|
|
title: service_zone_id
|
|
description: The shipping option's service zone id.
|
|
provider_id:
|
|
type: string
|
|
title: provider_id
|
|
description: The shipping option's provider id.
|
|
provider:
|
|
$ref: '#/components/schemas/BaseFulfillmentProvider'
|
|
shipping_option_type_id:
|
|
type: string
|
|
title: shipping_option_type_id
|
|
description: The shipping option's shipping option type id.
|
|
type:
|
|
type: object
|
|
shipping_profile_id:
|
|
type: string
|
|
title: shipping_profile_id
|
|
description: The shipping option's shipping profile id.
|
|
amount:
|
|
type: number
|
|
title: amount
|
|
description: The shipping option's amount.
|
|
is_tax_inclusive:
|
|
type: boolean
|
|
title: is_tax_inclusive
|
|
description: The shipping option's is tax inclusive.
|
|
data:
|
|
type: object
|
|
description: The shipping option's data.
|
|
metadata:
|
|
type: object
|
|
description: The shipping option's metadata.
|
|
StoreShippingOptionListResponse:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreShippingOptionListResponse
|
|
required:
|
|
- shipping_options
|
|
properties:
|
|
shipping_options:
|
|
type: array
|
|
description: The shipping option's shipping options.
|
|
items:
|
|
$ref: '#/components/schemas/StoreShippingOption'
|
|
StoreUpdateCartLineItem:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreUpdateCartLineItem
|
|
required:
|
|
- quantity
|
|
- metadata
|
|
properties:
|
|
quantity:
|
|
type: number
|
|
title: quantity
|
|
description: The cart's quantity.
|
|
metadata:
|
|
type: object
|
|
description: The cart's metadata.
|
|
StoreUpdateCustomer:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: StoreUpdateCustomer
|
|
required:
|
|
- company_name
|
|
- first_name
|
|
- last_name
|
|
- phone
|
|
properties:
|
|
company_name:
|
|
type: string
|
|
title: company_name
|
|
description: The customer's company name.
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The customer's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The customer's last name.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The customer's phone.
|
|
UpdateAddress:
|
|
type: object
|
|
description: The cart's shipping address.
|
|
x-schemaName: UpdateAddress
|
|
required:
|
|
- id
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The shipping address's ID.
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The shipping address's customer id.
|
|
company:
|
|
type: string
|
|
title: company
|
|
description: The shipping address's company.
|
|
first_name:
|
|
type: string
|
|
title: first_name
|
|
description: The shipping address's first name.
|
|
last_name:
|
|
type: string
|
|
title: last_name
|
|
description: The shipping address's last name.
|
|
address_1:
|
|
type: string
|
|
title: address_1
|
|
description: The shipping address's address 1.
|
|
address_2:
|
|
type: string
|
|
title: address_2
|
|
description: The shipping address's address 2.
|
|
city:
|
|
type: string
|
|
title: city
|
|
description: The shipping address's city.
|
|
country_code:
|
|
type: string
|
|
title: country_code
|
|
description: The shipping address's country code.
|
|
province:
|
|
type: string
|
|
title: province
|
|
description: The shipping address's province.
|
|
postal_code:
|
|
type: string
|
|
title: postal_code
|
|
description: The shipping address's postal code.
|
|
phone:
|
|
type: string
|
|
title: phone
|
|
description: The shipping address's phone.
|
|
metadata:
|
|
type: object
|
|
description: The shipping address's metadata.
|
|
UpdateCartData:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: UpdateCartData
|
|
properties:
|
|
region_id:
|
|
type: string
|
|
title: region_id
|
|
description: The cart's region id.
|
|
customer_id:
|
|
type: string
|
|
title: customer_id
|
|
description: The cart's customer id.
|
|
sales_channel_id:
|
|
type: string
|
|
title: sales_channel_id
|
|
description: The cart's sales channel id.
|
|
email:
|
|
type: string
|
|
title: email
|
|
description: The cart's email.
|
|
format: email
|
|
currency_code:
|
|
type: string
|
|
title: currency_code
|
|
description: The cart's currency code.
|
|
shipping_address_id:
|
|
type: string
|
|
title: shipping_address_id
|
|
description: The cart's shipping address id.
|
|
billing_address_id:
|
|
type: string
|
|
title: billing_address_id
|
|
description: The cart's billing address id.
|
|
billing_address:
|
|
oneOf:
|
|
- $ref: '#/components/schemas/CreateAddress'
|
|
- $ref: '#/components/schemas/UpdateAddress'
|
|
shipping_address:
|
|
oneOf:
|
|
- $ref: '#/components/schemas/CreateAddress'
|
|
- $ref: '#/components/schemas/UpdateAddress'
|
|
metadata:
|
|
type: object
|
|
description: The cart's metadata.
|
|
UpdateOrderReturnReason:
|
|
type: object
|
|
description: SUMMARY
|
|
x-schemaName: UpdateOrderReturnReason
|
|
properties:
|
|
id:
|
|
type: string
|
|
title: id
|
|
description: The return reason's ID.
|
|
label:
|
|
type: string
|
|
title: label
|
|
description: The return reason's label.
|
|
value:
|
|
type: string
|
|
title: value
|
|
description: The return reason's value.
|
|
description:
|
|
type: string
|
|
title: description
|
|
description: The return reason's description.
|
|
metadata:
|
|
type: object
|
|
description: The return reason's metadata.
|
|
responses:
|
|
default_error:
|
|
description: Default Error
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/Error'
|
|
example:
|
|
code: unknown_error
|
|
message: An unknown error occurred.
|
|
type: unknown_error
|
|
invalid_state_error:
|
|
description: Invalid State Error
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/Error'
|
|
example:
|
|
code: unknown_error
|
|
message: The request conflicted with another request. You may retry the request with the provided Idempotency-Key.
|
|
type: QueryRunnerAlreadyReleasedError
|
|
invalid_request_error:
|
|
description: Invalid Request Error
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/Error'
|
|
example:
|
|
code: invalid_request_error
|
|
message: Discount with code TEST already exists.
|
|
type: duplicate_error
|
|
not_found_error:
|
|
description: Not Found Error
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/Error'
|
|
example:
|
|
message: Entity with id 1 was not found
|
|
type: not_found
|
|
400_error:
|
|
description: Client Error
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/Error'
|
|
examples:
|
|
not_allowed:
|
|
$ref: '#/components/examples/not_allowed_error'
|
|
invalid_data:
|
|
$ref: '#/components/examples/invalid_data_error'
|
|
500_error:
|
|
description: Server Error
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/Error'
|
|
examples:
|
|
database:
|
|
$ref: '#/components/examples/database_error'
|
|
unexpected_state:
|
|
$ref: '#/components/examples/unexpected_state_error'
|
|
invalid_argument:
|
|
$ref: '#/components/examples/invalid_argument_error'
|
|
default_error:
|
|
$ref: '#/components/examples/default_error'
|
|
unauthorized:
|
|
description: User is not authorized. Must log in first
|
|
content:
|
|
text/plain:
|
|
schema:
|
|
type: string
|
|
default: Unauthorized
|
|
example: Unauthorized
|
|
incorrect_credentials:
|
|
description: User does not exist or incorrect credentials
|
|
content:
|
|
text/plain:
|
|
schema:
|
|
type: string
|
|
default: Unauthorized
|
|
example: Unauthorized
|
|
examples:
|
|
not_allowed_error:
|
|
summary: Not Allowed Error
|
|
value:
|
|
message: Discount must be set to dynamic
|
|
type: not_allowed
|
|
invalid_data_error:
|
|
summary: Invalid Data Error
|
|
value:
|
|
message: first_name must be a string
|
|
type: invalid_data
|
|
multiple_errors:
|
|
summary: Multiple Errors
|
|
value:
|
|
message: Provided request body contains errors. Please check the data and retry the request
|
|
errors:
|
|
- message: first_name must be a string
|
|
type: invalid_data
|
|
- message: Discount must be set to dynamic
|
|
type: not_allowed
|
|
database_error:
|
|
summary: Database Error
|
|
value:
|
|
code: api_error
|
|
message: An error occured while hashing password
|
|
type: database_error
|
|
unexpected_state_error:
|
|
summary: Unexpected State Error
|
|
value:
|
|
message: cart.total must be defined
|
|
type: unexpected_state
|
|
invalid_argument_error:
|
|
summary: Invalid Argument Error
|
|
value:
|
|
message: cart.total must be defined
|
|
type: unexpected_state
|
|
default_error:
|
|
summary: Default Error
|
|
value:
|
|
code: unknown_error
|
|
message: An unknown error occurred.
|
|
type: unknown_error
|
|
securitySchemes:
|
|
api_token:
|
|
type: apiKey
|
|
x-displayName: API Token
|
|
in: header
|
|
name: x-medusa-access-token
|
|
jwt_token:
|
|
type: http
|
|
x-displayName: JWT Token
|
|
scheme: bearer
|
|
cookie_auth:
|
|
type: apiKey
|
|
in: cookie
|
|
name: connect.sid
|
|
x-displayName: Cookie Session ID
|