---
openapi: 3.0.3
info:
title: Platform API
contact:
name: Spark Solutions
url: https://sparksolutions.co
email: we@sparksolutions.co
description: Spree Platform API
version: v2
paths:
"/api/v2/platform/addresses":
get:
summary: Return a list of Addresses
tags:
- Addresses
security:
- bearer_auth: []
description: Returns a list of Addresses
operationId: addresses-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: user,country,state
schema:
type: string
- name: filter[user_id_eq]
in: query
description: ''
example: '1'
schema:
type: string
- name: filter[firstname_cont]
in: query
description: ''
example: John
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '1'
type: address
attributes:
firstname: John
lastname: Doe
address1: 1 Lovely Street
address2: Northwest
city: Herndon
zipcode: '35005'
phone: 555-555-0199
state_name:
alternative_phone: 555-555-0199
company: Company
created_at: '2021-12-16T15:20:23.671Z'
updated_at: '2021-12-16T15:20:23.671Z'
deleted_at:
label:
public_metadata: {}
private_metadata: {}
relationships:
country:
data:
id: '1'
type: country
state:
data:
id: '1'
type: state
user:
data:
- id: '2'
type: address
attributes:
firstname: John
lastname: Doe
address1: 2 Lovely Street
address2: Northwest
city: Herndon
zipcode: '35005'
phone: 555-555-0199
state_name:
alternative_phone: 555-555-0199
company: Company
created_at: '2021-12-16T15:20:23.680Z'
updated_at: '2021-12-16T15:20:23.680Z'
deleted_at:
label:
public_metadata: {}
private_metadata: {}
relationships:
country:
data:
id: '1'
type: country
state:
data:
id: '2'
type: state
user:
data:
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/addresses?page=1&per_page=&include=&filter[user_id_eq]=&filter[firstname_cont]=
next: http://www.example.com/api/v2/platform/addresses?filter%5Bfirstname_cont%5D=&filter%5Buser_id_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/addresses?filter%5Bfirstname_cont%5D=&filter%5Buser_id_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/addresses?filter%5Bfirstname_cont%5D=&filter%5Buser_id_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/addresses?filter%5Bfirstname_cont%5D=&filter%5Buser_id_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create an Address
tags:
- Addresses
security:
- bearer_auth: []
description: Creates an Address
operationId: create-address
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: user,country,state
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '5'
type: address
attributes:
firstname: John
lastname: Doe
address1: 5 Lovely Street
address2: Northwest
city: Herndon
zipcode: '35005'
phone: 555-555-0199
state_name:
alternative_phone: 555-555-0199
company: Company
created_at: '2021-12-16T15:20:24.446Z'
updated_at: '2021-12-16T15:20:24.446Z'
deleted_at:
label:
public_metadata: {}
private_metadata: {}
relationships:
country:
data:
id: '4'
type: country
state:
data:
id: '5'
type: state
user:
data:
id: '1'
type: user
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: First Name can't be blank, Last Name can't be blank, Address
can't be blank, City can't be blank, Country can't be blank,
Zip Code can't be blank, and Phone can't be blank
errors:
firstname:
- can't be blank
lastname:
- can't be blank
address1:
- can't be blank
city:
- can't be blank
country:
- can't be blank
zipcode:
- can't be blank
phone:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_address_params"
"/api/v2/platform/addresses/{id}":
get:
summary: Return an Address
tags:
- Addresses
security:
- bearer_auth: []
description: Returns an Address
operationId: show-address
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: user,country,state
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '6'
type: address
attributes:
firstname: John
lastname: Doe
address1: 6 Lovely Street
address2: Northwest
city: Herndon
zipcode: '35005'
phone: 555-555-0199
state_name:
alternative_phone: 555-555-0199
company: Company
created_at: '2021-12-16T15:20:24.705Z'
updated_at: '2021-12-16T15:20:24.705Z'
deleted_at:
label:
public_metadata: {}
private_metadata: {}
relationships:
country:
data:
id: '6'
type: country
state:
data:
id: '6'
type: state
user:
data:
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update an Address
tags:
- Addresses
security:
- bearer_auth: []
description: Updates an Address
operationId: update-address
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: user,country,state
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '8'
type: address
attributes:
firstname: Jack
lastname: Doe
address1: 8 Lovely Street
address2: Northwest
city: Herndon
zipcode: '35005'
phone: 555-555-0199
state_name:
alternative_phone: 555-555-0199
company: Company
created_at: '2021-12-16T15:20:25.202Z'
updated_at: '2021-12-16T15:20:25.393Z'
deleted_at:
label:
public_metadata: {}
private_metadata: {}
relationships:
country:
data:
id: '9'
type: country
state:
data:
id: '8'
type: state
user:
data:
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: First Name can't be blank and Last Name can't be blank
errors:
firstname:
- can't be blank
lastname:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_address_params"
delete:
summary: Delete an Address
tags:
- Addresses
security:
- bearer_auth: []
description: Deletes an Address
operationId: delete-address
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/adjustments":
get:
summary: Return a list of Adjustments
tags:
- Adjustments
security:
- bearer_auth: []
description: Returns a list of Adjustments
operationId: adjustments-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: order,adjustable
schema:
type: string
- name: filter[order_id]
in: query
description: ''
example: '1234'
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '1'
type: adjustment
attributes:
source_type: Spree::TaxRate
adjustable_type: Spree::Order
amount: '100.0'
label: Shipping
mandatory:
eligible: true
created_at: '2021-12-16T15:20:26.490Z'
updated_at: '2021-12-16T15:20:26.490Z'
state: open
included: false
display_amount: "$100.00"
relationships:
order:
data:
id: '1'
type: order
adjustable:
data:
id: '2'
type: order
source:
data:
id: '1'
type: tax_rate
- id: '2'
type: adjustment
attributes:
source_type: Spree::TaxRate
adjustable_type: Spree::Order
amount: '100.0'
label: Shipping
mandatory:
eligible: true
created_at: '2021-12-16T15:20:26.530Z'
updated_at: '2021-12-16T15:20:26.530Z'
state: open
included: false
display_amount: "$100.00"
relationships:
order:
data:
id: '1'
type: order
adjustable:
data:
id: '3'
type: order
source:
data:
id: '2'
type: tax_rate
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/adjustments?page=1&per_page=&include=&filter[order_id]=
next: http://www.example.com/api/v2/platform/adjustments?filter%5Border_id%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/adjustments?filter%5Border_id%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/adjustments?filter%5Border_id%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/adjustments?filter%5Border_id%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create an Adjustment
tags:
- Adjustments
security:
- bearer_auth: []
description: Creates an Adjustment
operationId: create-adjustment
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: order,adjustable
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '5'
type: adjustment
attributes:
source_type: Spree::TaxRate
adjustable_type: Spree::LineItem
amount: '100.0'
label: Shipping
mandatory:
eligible: true
created_at: '2021-12-16T15:20:27.383Z'
updated_at: '2021-12-16T15:20:27.383Z'
state: open
included: false
display_amount: "$100.00"
relationships:
order:
data:
id: '7'
type: order
adjustable:
data:
id: '1'
type: line_item
source:
data:
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Adjustable can't be blank, Order can't be blank, Label
can't be blank, and Amount is not a number
errors:
adjustable:
- can't be blank
order:
- can't be blank
label:
- can't be blank
amount:
- is not a number
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_adjustment_params"
"/api/v2/platform/adjustments/{id}":
get:
summary: Return an Adjustment
tags:
- Adjustments
security:
- bearer_auth: []
description: Returns an Adjustment
operationId: show-adjustment
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: order,adjustable
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '6'
type: adjustment
attributes:
source_type: Spree::TaxRate
adjustable_type: Spree::LineItem
amount: '1.0'
label: Shipping
mandatory:
eligible: true
created_at: '2021-12-16T15:20:27.773Z'
updated_at: '2021-12-16T15:20:27.781Z'
state: open
included: false
display_amount: "$1.00"
relationships:
order:
data:
id: '8'
type: order
adjustable:
data:
id: '2'
type: line_item
source:
data:
id: '5'
type: tax_rate
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update an Adjustment
tags:
- Adjustments
security:
- bearer_auth: []
description: Updates an Adjustment
operationId: update-adjustment
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: order,adjustable
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '8'
type: adjustment
attributes:
source_type: Spree::TaxRate
adjustable_type: Spree::LineItem
amount: '15.0'
label: New label
mandatory:
eligible: true
created_at: '2021-12-16T15:20:28.653Z'
updated_at: '2021-12-16T15:20:28.861Z'
state: open
included: false
display_amount: "$15.00"
relationships:
order:
data:
id: '10'
type: order
adjustable:
data:
id: '4'
type: line_item
source:
data:
id: '7'
type: tax_rate
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Label can't be blank
errors:
label:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_adjustment_params"
delete:
summary: Delete an Adjustment
tags:
- Adjustments
security:
- bearer_auth: []
description: Deletes an Adjustment
operationId: delete-adjustment
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/classifications":
get:
summary: Return a list of Classifications
tags:
- Classifications
security:
- bearer_auth: []
description: Returns a list of Classifications
operationId: classifications-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: product,taxon
schema:
type: string
- name: filter[taxon_id_eq]
in: query
description: ''
example: '1'
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '1'
type: classification
attributes:
position: 1
created_at: '2021-12-16T15:20:30.534Z'
updated_at: '2021-12-16T15:20:30.534Z'
relationships:
product:
data:
id: '9'
type: product
taxon:
data:
id: '2'
type: taxon
- id: '2'
type: classification
attributes:
position: 1
created_at: '2021-12-16T15:20:30.661Z'
updated_at: '2021-12-16T15:20:30.661Z'
relationships:
product:
data:
id: '10'
type: product
taxon:
data:
id: '4'
type: taxon
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/classifications?page=1&per_page=&include=&filter[taxon_id_eq]=
next: http://www.example.com/api/v2/platform/classifications?filter%5Btaxon_id_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/classifications?filter%5Btaxon_id_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/classifications?filter%5Btaxon_id_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/classifications?filter%5Btaxon_id_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Classification
tags:
- Classifications
security:
- bearer_auth: []
description: Creates a Classification
operationId: create-classification
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: product,taxon
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '5'
type: classification
attributes:
position: 1
created_at: '2021-12-16T15:20:31.588Z'
updated_at: '2021-12-16T15:20:31.588Z'
relationships:
product:
data:
id: '13'
type: product
taxon:
data:
id: '10'
type: taxon
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Taxon can't be blank and Product can't be blank
errors:
taxon:
- can't be blank
product:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_classification_params"
"/api/v2/platform/classifications/{id}":
get:
summary: Return a Classification
tags:
- Classifications
security:
- bearer_auth: []
description: Returns a Classification
operationId: show-classification
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: product,taxon
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '6'
type: classification
attributes:
position: 1
created_at: '2021-12-16T15:20:32.006Z'
updated_at: '2021-12-16T15:20:32.006Z'
relationships:
product:
data:
id: '14'
type: product
taxon:
data:
id: '12'
type: taxon
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Classification
tags:
- Classifications
security:
- bearer_auth: []
description: Updates a Classification
operationId: update-classification
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: product,taxon
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '8'
type: classification
attributes:
position: 1
created_at: '2021-12-16T15:20:32.787Z'
updated_at: '2021-12-16T15:20:32.787Z'
relationships:
product:
data:
id: '16'
type: product
taxon:
data:
id: '16'
type: taxon
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Product can't be blank
errors:
product:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_classification_params"
delete:
summary: Delete a Classification
tags:
- Classifications
security:
- bearer_auth: []
description: Deletes a Classification
operationId: delete-classification
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/cms_pages":
get:
summary: Return a list of CMS Pages
tags:
- CMS Pages
security:
- bearer_auth: []
description: Returns a list of CMS Pages
operationId: cms-pages-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: cms_sections
schema:
type: string
- name: filter[type_eq]
in: query
description: ''
example: Spree::Cms::Pages::FeaturePage
schema:
type: string
- name: filter[locale_eq]
in: query
description: ''
example: en
schema:
type: string
- name: filter[title_cont]
in: query
description: ''
example: About Us
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '1'
type: cms_page
attributes:
title: Eos cumque illum nulla nisi esse beatae rem doloribus.
meta_title:
content:
meta_description:
visible: true
slug: eos-cumque-illum-nulla-nisi-esse-beatae-rem-doloribus
type: Spree::Cms::Pages::StandardPage
locale: en
deleted_at:
created_at: '2021-12-16T15:20:34.559Z'
updated_at: '2021-12-16T15:20:34.559Z'
relationships:
cms_sections:
data: []
- id: '2'
type: cms_page
attributes:
title: Assumenda eum occaecati sunt quis itaque maiores.
meta_title:
content:
meta_description:
visible: true
slug: assumenda-eum-occaecati-sunt-quis-itaque-maiores
type: Spree::Cms::Pages::StandardPage
locale: en
deleted_at:
created_at: '2021-12-16T15:20:34.564Z'
updated_at: '2021-12-16T15:20:34.564Z'
relationships:
cms_sections:
data: []
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/cms_pages?page=1&per_page=&include=&filter[type_eq]=&filter[locale_eq]=&filter[title_cont]=
next: http://www.example.com/api/v2/platform/cms_pages?filter%5Blocale_eq%5D=&filter%5Btitle_cont%5D=&filter%5Btype_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/cms_pages?filter%5Blocale_eq%5D=&filter%5Btitle_cont%5D=&filter%5Btype_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/cms_pages?filter%5Blocale_eq%5D=&filter%5Btitle_cont%5D=&filter%5Btype_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/cms_pages?filter%5Blocale_eq%5D=&filter%5Btitle_cont%5D=&filter%5Btype_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a CMS Page
tags:
- CMS Pages
security:
- bearer_auth: []
description: Creates a CMS Page
operationId: create-cms-page
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: cms_sections
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '5'
type: cms_page
attributes:
title: Aliquid voluptatum accusamus ea excepturi repellendus
esse officia doloribus.
meta_title:
content:
meta_description:
visible: true
slug: aliquid-voluptatum-accusamus-ea-excepturi-repellendus-esse-officia-doloribus
type: Spree::Cms::Pages::StandardPage
locale: en
deleted_at:
created_at: '2021-12-16T15:20:35.081Z'
updated_at: '2021-12-16T15:20:35.081Z'
relationships:
cms_sections:
data: []
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Title can't be blank, Locale can't be blank, and Type can't
be blank
errors:
title:
- can't be blank
locale:
- can't be blank
type:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
oneOf:
- "$ref": "#/components/schemas/create_standard_cms_page_params"
- "$ref": "#/components/schemas/create_homepage_cms_page_params"
- "$ref": "#/components/schemas/create_feature_cms_page_params"
"/api/v2/platform/cms_pages/{id}":
get:
summary: Return a CMS Page
tags:
- CMS Pages
security:
- bearer_auth: []
description: Returns a CMS Page
operationId: show-cms-page
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: cms_sections
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '6'
type: cms_page
attributes:
title: Quisquam voluptates et optio atque.
meta_title:
content:
meta_description:
visible: true
slug: quisquam-voluptates-et-optio-atque
type: Spree::Cms::Pages::StandardPage
locale: en
deleted_at:
created_at: '2021-12-16T15:20:35.348Z'
updated_at: '2021-12-16T15:20:35.348Z'
relationships:
cms_sections:
data: []
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a CMS Page
tags:
- CMS Pages
security:
- bearer_auth: []
description: Updates a CMS Page
operationId: update-cms-page
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: cms_sections
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '8'
type: cms_page
attributes:
title: My Super Page
meta_title:
content:
meta_description:
visible: true
slug: magni-molestiae-aperiam-sunt-deserunt-explicabo-modi-veritatis-blanditiis
type: Spree::Cms::Pages::StandardPage
locale: en
deleted_at:
created_at: '2021-12-16T15:20:35.855Z'
updated_at: '2021-12-16T15:20:36.069Z'
relationships:
cms_sections:
data: []
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Title can't be blank
errors:
title:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
oneOf:
- "$ref": "#/components/schemas/update_standard_cms_page_params"
- "$ref": "#/components/schemas/update_homepage_cms_page_params"
- "$ref": "#/components/schemas/update_feature_cms_page_params"
delete:
summary: Delete a CMS Page
tags:
- CMS Pages
security:
- bearer_auth: []
description: Deletes a CMS Page
operationId: delete-cms-page
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/cms_sections":
get:
summary: Return a list of CMS Sections
tags:
- CMS Sections
security:
- bearer_auth: []
description: Returns a list of CMS Sections
operationId: cms-sections-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: product
schema:
type: string
- name: filter[name_eq]
in: query
description: ''
example: Hero
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '1'
type: cms_section
attributes:
name: Occaecati odit necessitatibus nemo a.
content: {}
settings:
gutters: No Gutters
fit: Screen
destination:
type: Spree::Cms::Sections::HeroImage
position: 1
linked_resource_type: Spree::Taxon
created_at: '2021-12-16T15:20:37.337Z'
updated_at: '2021-12-16T15:20:37.337Z'
relationships:
cms_page:
data:
id: '13'
type: cms_page
linked_resource:
data:
- id: '2'
type: cms_section
attributes:
name: Ab fuga delectus minima tempora.
content:
link_type_one: Spree::Taxon
link_type_two: Spree::Taxon
link_type_three: Spree::Taxon
settings:
layout_style: Default
fit: Container
destination:
type: Spree::Cms::Sections::ImageGallery
position: 2
linked_resource_type:
created_at: '2021-12-16T15:20:37.345Z'
updated_at: '2021-12-16T15:20:37.345Z'
relationships:
cms_page:
data:
id: '13'
type: cms_page
linked_resource:
data:
- id: '3'
type: cms_section
attributes:
name: Voluptatibus illum ut aliquid vel.
content: {}
settings:
gutters: No Gutters
fit: Screen
destination:
type: Spree::Cms::Sections::FeaturedArticle
position: 3
linked_resource_type: Spree::Taxon
created_at: '2021-12-16T15:20:37.359Z'
updated_at: '2021-12-16T15:20:37.359Z'
relationships:
cms_page:
data:
id: '13'
type: cms_page
linked_resource:
data:
- id: '4'
type: cms_section
attributes:
name: Quisquam culpa facilis maxime exercitationem.
content: {}
settings:
gutters: No Gutters
fit: Screen
destination:
type: Spree::Cms::Sections::HeroImage
position: 4
linked_resource_type: Spree::Product
created_at: '2021-12-16T15:20:37.375Z'
updated_at: '2021-12-16T15:20:37.375Z'
relationships:
cms_page:
data:
id: '13'
type: cms_page
linked_resource:
data:
id: '21'
type: product
- id: '5'
type: cms_section
attributes:
name: Ipsa quas vel doloremque ab accusantium nihil fugiat.
content: {}
settings:
gutters: No Gutters
fit: Screen
destination:
type: Spree::Cms::Sections::HeroImage
position: 5
linked_resource_type: Spree::Product
created_at: '2021-12-16T15:20:37.390Z'
updated_at: '2021-12-16T15:20:37.390Z'
relationships:
cms_page:
data:
id: '13'
type: cms_page
linked_resource:
data:
id: '21'
type: product
meta:
count: 5
total_count: 5
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/cms_sections?page=1&per_page=&include=&filter[name_eq]=
next: http://www.example.com/api/v2/platform/cms_sections?filter%5Bname_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/cms_sections?filter%5Bname_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/cms_sections?filter%5Bname_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/cms_sections?filter%5Bname_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a CMS Section
tags:
- CMS Sections
security:
- bearer_auth: []
description: Creates a CMS Section
operationId: create-cms-section
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: product
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '13'
type: cms_section
attributes:
name: Placeat dolorum molestias ea atque totam.
content: {}
settings:
gutters: No Gutters
fit: Screen
destination:
type: Spree::Cms::Sections::HeroImage
position: 3
linked_resource_type: Spree::Product
created_at: '2021-12-16T15:20:38.314Z'
updated_at: '2021-12-16T15:20:38.314Z'
relationships:
cms_page:
data:
id: '15'
type: cms_page
linked_resource:
data:
id: '23'
type: product
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank, Cms page can't be blank, and Type
can't be blank
errors:
name:
- can't be blank
cms_page:
- can't be blank
type:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
oneOf:
- "$ref": "#/components/schemas/create_hero_image_cms_section_params"
- "$ref": "#/components/schemas/create_product_carousel_cms_section_params"
- "$ref": "#/components/schemas/create_side_by_side_images_cms_section_params"
- "$ref": "#/components/schemas/create_featured_article_cms_section_params"
- "$ref": "#/components/schemas/create_image_gallery_cms_section_params"
- "$ref": "#/components/schemas/create_rich_text_cms_section_params"
"/api/v2/platform/cms_sections/{id}":
get:
summary: Return a CMS Section
tags:
- CMS Sections
security:
- bearer_auth: []
description: Returns a CMS Section
operationId: show-cms-section
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: product
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '19'
type: cms_section
attributes:
name: Eveniet perspiciatis magni facere cupiditate placeat
adipisci reiciendis.
content: {}
settings:
gutters: No Gutters
fit: Screen
destination:
type: Spree::Cms::Sections::HeroImage
position: 4
linked_resource_type: Spree::Product
created_at: '2021-12-16T15:20:38.782Z'
updated_at: '2021-12-16T15:20:38.782Z'
relationships:
cms_page:
data:
id: '17'
type: cms_page
linked_resource:
data:
id: '25'
type: product
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a CMS Section
tags:
- CMS Sections
security:
- bearer_auth: []
description: Updates a CMS Section
operationId: update-cms-section
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: product
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '29'
type: cms_section
attributes:
name: Super Hero
content: {}
settings:
gutters: No Gutters
fit: Screen
destination:
type: Spree::Cms::Sections::HeroImage
position: 1
linked_resource_type: Spree::Product
created_at: '2021-12-16T15:20:39.627Z'
updated_at: '2021-12-16T15:20:39.867Z'
relationships:
cms_page:
data:
id: '20'
type: cms_page
linked_resource:
data:
id: '28'
type: product
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
oneOf:
- "$ref": "#/components/schemas/update_hero_image_cms_section_params"
- "$ref": "#/components/schemas/update_product_carousel_cms_section_params"
- "$ref": "#/components/schemas/update_side_by_side_images_cms_section_params"
- "$ref": "#/components/schemas/update_featured_article_cms_section_params"
- "$ref": "#/components/schemas/update_image_gallery_cms_section_params"
- "$ref": "#/components/schemas/update_rich_text_cms_section_params"
delete:
summary: Delete a CMS Section
tags:
- CMS Sections
security:
- bearer_auth: []
description: Deletes a CMS Section
operationId: delete-cms-section
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/countries":
get:
summary: Returns a list of Countries
tags:
- Countries
security:
- bearer_auth: []
operationId: countries-list
description: Returns a list of Countries
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '72'
type: country
attributes:
iso_name: UNITED STATES
iso: US
iso3: USA
name: United States of America
numcode: 840
states_required: true
updated_at: '2021-12-16T15:20:41.498Z'
zipcode_required: true
created_at: '2021-12-16T15:20:41.498Z'
relationships:
states:
data: []
- id: '73'
type: country
attributes:
iso_name: ISO_NAME_2
iso: I2
iso3: IS2
name: NAME_2
numcode: 840
states_required: false
updated_at: '2021-12-16T15:20:41.508Z'
zipcode_required: true
created_at: '2021-12-16T15:20:41.508Z'
relationships:
states:
data: []
- id: '74'
type: country
attributes:
iso_name: ISO_NAME_3
iso: I3
iso3: IS3
name: NAME_3
numcode: 840
states_required: false
updated_at: '2021-12-16T15:20:41.511Z'
zipcode_required: true
created_at: '2021-12-16T15:20:41.511Z'
relationships:
states:
data: []
meta:
count: 3
total_count: 3
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/countries
next: http://www.example.com/api/v2/platform/countries?page=1
prev: http://www.example.com/api/v2/platform/countries?page=1
last: http://www.example.com/api/v2/platform/countries?page=1
first: http://www.example.com/api/v2/platform/countries?page=1
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/countries/{id}":
get:
summary: Returns a Country
tags:
- Countries
security:
- bearer_auth: []
operationId: show-country
description: Returns a Country
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '79'
type: country
attributes:
iso_name: ISO_NAME_6
iso: I6
iso3: IS6
name: NAME_6
numcode: 840
states_required: false
updated_at: '2021-12-16T15:20:41.800Z'
zipcode_required: true
created_at: '2021-12-16T15:20:41.800Z'
relationships:
states:
data: []
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/digital_links":
get:
summary: Return a list of Digital Links
tags:
- Digital Links
security:
- bearer_auth: []
description: Returns a list of Digital Links
operationId: digital-links-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '1'
type: digital_link
attributes:
token: GW34dA7KUtPVjCa83F4dRD4j
access_counter: 0
relationships:
digital:
data:
id: '1'
type: digital
line_item:
data:
id: '9'
type: line_item
- id: '2'
type: digital_link
attributes:
token: 7TY1QmN3X68NzYLF22Yu2xLH
access_counter: 0
relationships:
digital:
data:
id: '2'
type: digital
line_item:
data:
id: '10'
type: line_item
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/digital_links?page=1&per_page=
next: http://www.example.com/api/v2/platform/digital_links?page=1&per_page=
prev: http://www.example.com/api/v2/platform/digital_links?page=1&per_page=
last: http://www.example.com/api/v2/platform/digital_links?page=1&per_page=
first: http://www.example.com/api/v2/platform/digital_links?page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Digital Link
tags:
- Digital Links
security:
- bearer_auth: []
description: Creates a Digital Link
operationId: create-digital-link
parameters: []
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '5'
type: digital_link
attributes:
token: ZAEC1afQ7ge4vhRHardrDaYx
access_counter: 0
relationships:
digital:
data:
id: '5'
type: digital
line_item:
data:
id: '13'
type: line_item
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Digital can't be blank, Line item can't be blank, and Access
counter is not a number
errors:
digital:
- can't be blank
line_item:
- can't be blank
access_counter:
- is not a number
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_digital_link_params"
"/api/v2/platform/digital_links/{id}":
get:
summary: Return a Digital Link
tags:
- Digital Links
security:
- bearer_auth: []
description: Returns a Digital Link
operationId: show-digital-link
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '6'
type: digital_link
attributes:
token: VeBkPBHc3uXGhW7doCtRp1dq
access_counter: 0
relationships:
digital:
data:
id: '6'
type: digital
line_item:
data:
id: '14'
type: line_item
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Digital Link
tags:
- Digital Links
security:
- bearer_auth: []
description: Updates a Digital Link
operationId: update-digital-link
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '8'
type: digital_link
attributes:
token: 3913U6tGUVDVPei5tYQPkRQh
access_counter: 0
relationships:
digital:
data:
id: '8'
type: digital
line_item:
data:
id: '16'
type: line_item
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Access counter is not a number
errors:
access_counter:
- is not a number
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_digital_link_params"
delete:
summary: Delete a Digital Link
tags:
- Digital Links
security:
- bearer_auth: []
description: Deletes a Digital Link
operationId: delete-digital-link
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/digital_links/{id}/reset":
patch:
summary: Reset a Digital Link
tags:
- Digital Links
security:
- bearer_auth: []
operationId: reset-digital-link
description: Resets a digital link, allowing further downloads.
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '13'
type: digital_link
attributes:
token: t7JZyajYjPMuCFmMooUeUdig
access_counter: 0
relationships:
digital:
data:
id: '13'
type: digital
line_item:
data:
id: '21'
type: line_item
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/digitals":
get:
summary: Return a list of Digital Assets
tags:
- Digital Assets
security:
- bearer_auth: []
description: Returns a list of Digital Assets
operationId: digitals-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: variant
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '15'
type: digital
attributes:
url: "/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBJQT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--c726fbdc9cb23dae590a3f1b6298c107e590bfed/thinking-cat.jpg"
content_type: image/jpeg
filename: thinking-cat.jpg
byte_size: 18090
relationships:
variant:
data:
id: '80'
type: variant
- id: '16'
type: digital
attributes:
url: "/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBJUT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--7d9139edf258b9efe6aee450dd97eb7daf32d508/thinking-cat.jpg"
content_type: image/jpeg
filename: thinking-cat.jpg
byte_size: 18090
relationships:
variant:
data:
id: '82'
type: variant
- id: '17'
type: digital
attributes:
url: "/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBJZz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--9f652e64929d37706af95f4f3b4a9d44c1d2985d/thinking-cat.jpg"
content_type: image/jpeg
filename: thinking-cat.jpg
byte_size: 18090
relationships:
variant:
data:
id: '84'
type: variant
meta:
count: 3
total_count: 3
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/digitals?page=1&per_page=&include=
next: http://www.example.com/api/v2/platform/digitals?include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/digitals?include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/digitals?include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/digitals?include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Digital Asset
tags:
- Digital Assets
security:
- bearer_auth: []
description: Creates a Digital Asset
operationId: create-digital
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: variant
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '24'
type: digital
attributes:
url: "/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBLUT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--c48973e262518a1c81cf689815394d489a0a352b/icon_256x256.jpg"
content_type: image/png
filename: icon_256x256.jpg
byte_size: 818
relationships:
variant:
data:
id: '94'
type: variant
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Attachment can't be blank and Variant can't be blank
errors:
attachment:
- can't be blank
variant:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
multipart/form-data:
schema:
"$ref": "#/components/schemas/create_digital_params"
"/api/v2/platform/digitals/{id}":
get:
summary: Return a Digital Asset
tags:
- Digital Assets
security:
- bearer_auth: []
description: Returns a Digital Asset
operationId: show-digital
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: variant
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '28'
type: digital
attributes:
url: "/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBMUT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--5c0b377c510bf1e4ffeed76fa789ced2ab048dc0/thinking-cat.jpg"
content_type: image/jpeg
filename: thinking-cat.jpg
byte_size: 18090
relationships:
variant:
data:
id: '112'
type: variant
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Digital Asset
tags:
- Digital Assets
security:
- bearer_auth: []
description: Updates a Digital Asset
operationId: update-digital
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: variant
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '36'
type: digital
attributes:
url: "/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBPQT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--15b5c7964f86d712c68ce2502f33a183e9e421c3/icon_256x256.jpg"
content_type: image/png
filename: icon_256x256.jpg
byte_size: 818
relationships:
variant:
data:
id: '134'
type: variant
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Variant can't be blank
errors:
variant:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
multipart/form-data:
schema:
"$ref": "#/components/schemas/update_digital_params"
delete:
summary: Delete a Digital Asset
tags:
- Digital Assets
security:
- bearer_auth: []
description: Deletes a Digital Asset
operationId: delete-digital
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/line_items":
get:
summary: Return a list of Line Items
tags:
- Line Items
security:
- bearer_auth: []
description: Returns a list of Line Items
operationId: line-items-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: order,tax_category,variant.product,digital_links
schema:
type: string
- name: filter[order_id_eq]
in: query
description: ''
example: '123'
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '23'
type: line_item
attributes:
quantity: 1
price: '10.0'
created_at: '2021-12-16T15:20:58.109Z'
updated_at: '2021-12-16T15:20:58.120Z'
currency: USD
cost_price: '17.0'
adjustment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
included_tax_total: '0.0'
pre_tax_amount: '10.0'
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
public_metadata: {}
private_metadata: {}
display_adjustment_total: "$0.00"
display_additional_tax_total: "$0.00"
display_total: "$10.00"
display_discounted_amount: "$10.00"
display_promo_total: "$0.00"
display_included_tax_total: "$0.00"
display_subtotal: "$10.00"
display_final_amount: "$10.00"
display_pre_tax_amount: "$10.00"
display_amount: "$10.00"
display_price: "$10.00"
relationships:
order:
data:
id: '29'
type: order
tax_category:
data:
id: '70'
type: tax_category
variant:
data:
id: '183'
type: variant
adjustments:
data: []
inventory_units:
data: []
digital_links:
data: []
- id: '24'
type: line_item
attributes:
quantity: 1
price: '10.0'
created_at: '2021-12-16T15:20:58.178Z'
updated_at: '2021-12-16T15:20:58.187Z'
currency: USD
cost_price: '17.0'
adjustment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
included_tax_total: '0.0'
pre_tax_amount: '10.0'
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
public_metadata: {}
private_metadata: {}
display_adjustment_total: "$0.00"
display_additional_tax_total: "$0.00"
display_total: "$10.00"
display_discounted_amount: "$10.00"
display_promo_total: "$0.00"
display_included_tax_total: "$0.00"
display_subtotal: "$10.00"
display_final_amount: "$10.00"
display_pre_tax_amount: "$10.00"
display_amount: "$10.00"
display_price: "$10.00"
relationships:
order:
data:
id: '29'
type: order
tax_category:
data:
id: '70'
type: tax_category
variant:
data:
id: '184'
type: variant
adjustments:
data: []
inventory_units:
data: []
digital_links:
data: []
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/line_items?page=1&per_page=&include=&filter[order_id_eq]=
next: http://www.example.com/api/v2/platform/line_items?filter%5Border_id_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/line_items?filter%5Border_id_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/line_items?filter%5Border_id_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/line_items?filter%5Border_id_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Line Item
tags:
- Line Items
security:
- bearer_auth: []
description: Creates a Line Item
operationId: create-line-item
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: order,tax_category,variant.product,digital_links
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '27'
type: line_item
attributes:
quantity: 1
price: '10.0'
created_at: '2021-12-16T15:20:59.000Z'
updated_at: '2021-12-16T15:20:59.052Z'
currency: USD
cost_price: '17.0'
adjustment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
included_tax_total: '0.0'
pre_tax_amount: '10.0'
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
public_metadata: {}
private_metadata: {}
display_adjustment_total: "$0.00"
display_additional_tax_total: "$0.00"
display_total: "$10.00"
display_discounted_amount: "$10.00"
display_promo_total: "$0.00"
display_included_tax_total: "$0.00"
display_subtotal: "$10.00"
display_final_amount: "$10.00"
display_pre_tax_amount: "$10.00"
display_amount: "$10.00"
display_price: "$10.00"
relationships:
order:
data:
id: '31'
type: order
tax_category:
data:
id: '72'
type: tax_category
variant:
data:
id: '187'
type: variant
adjustments:
data: []
inventory_units:
data: []
digital_links:
data: []
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Variant can't be blank, Price is not a number, Currency
Must match order currency
errors:
variant:
- can't be blank
price:
- is not a number
currency:
- Must match order currency
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_line_item_params"
"/api/v2/platform/line_items/{id}":
get:
summary: Return a Line Item
tags:
- Line Items
security:
- bearer_auth: []
description: Returns a Line Item
operationId: show-line-item
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: order,tax_category,variant.product,digital_links
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '28'
type: line_item
attributes:
quantity: 1
price: '10.0'
created_at: '2021-12-16T15:20:59.534Z'
updated_at: '2021-12-16T15:20:59.547Z'
currency: USD
cost_price: '17.0'
adjustment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
included_tax_total: '0.0'
pre_tax_amount: '10.0'
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
public_metadata: {}
private_metadata: {}
display_adjustment_total: "$0.00"
display_additional_tax_total: "$0.00"
display_total: "$10.00"
display_discounted_amount: "$10.00"
display_promo_total: "$0.00"
display_included_tax_total: "$0.00"
display_subtotal: "$10.00"
display_final_amount: "$10.00"
display_pre_tax_amount: "$10.00"
display_amount: "$10.00"
display_price: "$10.00"
relationships:
order:
data:
id: '33'
type: order
tax_category:
data:
id: '73'
type: tax_category
variant:
data:
id: '188'
type: variant
adjustments:
data: []
inventory_units:
data: []
digital_links:
data: []
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Line Item
tags:
- Line Items
security:
- bearer_auth: []
description: Updates a Line Item
operationId: update-line-item
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: order,tax_category,variant.product,digital_links
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '30'
type: line_item
attributes:
quantity: 4
price: '10.0'
created_at: '2021-12-16T15:21:00.423Z'
updated_at: '2021-12-16T15:21:00.680Z'
currency: USD
cost_price: '17.0'
adjustment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
included_tax_total: '0.0'
pre_tax_amount: '40.0'
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
public_metadata: {}
private_metadata: {}
display_adjustment_total: "$0.00"
display_additional_tax_total: "$0.00"
display_total: "$40.00"
display_discounted_amount: "$40.00"
display_promo_total: "$0.00"
display_included_tax_total: "$0.00"
display_subtotal: "$40.00"
display_final_amount: "$40.00"
display_pre_tax_amount: "$40.00"
display_amount: "$40.00"
display_price: "$10.00"
relationships:
order:
data:
id: '35'
type: order
tax_category:
data:
id: '75'
type: tax_category
variant:
data:
id: '192'
type: variant
adjustments:
data: []
inventory_units:
data: []
digital_links:
data: []
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: 'Quantity selected of "Product #127 - 8149" is not available.'
errors:
quantity:
- 'selected of "Product #127 - 8149" is not available.'
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_line_item_params"
delete:
summary: Delete a Line Item
tags:
- Line Items
security:
- bearer_auth: []
description: Deletes a Line Item
operationId: delete-line-item
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/menu_items":
get:
summary: Return a list of Menu Items
tags:
- Menu Items
security:
- bearer_auth: []
description: Returns a list of Menu Items
operationId: menu-items-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: menu,icon,parent,children,linked_resource
schema:
type: string
- name: filter[name_eq]
in: query
description: ''
example: T-Shirts
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '2'
type: menu_item
attributes:
name: Link no. 1 To Somewhere
subtitle:
destination:
new_window: false
item_type: Link
linked_resource_type: URL
code:
lft: 2
rgt: 3
depth: 1
created_at: '2021-12-16T15:21:02.749Z'
updated_at: '2021-12-16T15:21:02.755Z'
link:
is_container: false
is_root: false
is_child: true
is_leaf: true
relationships:
icon:
data:
id: '13'
type: icon
menu:
data:
id: '1'
type: menu
parent:
data:
id: '1'
type: menu_item
linked_resource:
data:
children:
data: []
- id: '3'
type: menu_item
attributes:
name: Link no. 2 To Somewhere
subtitle:
destination:
new_window: false
item_type: Link
linked_resource_type: URL
code:
lft: 4
rgt: 5
depth: 1
created_at: '2021-12-16T15:21:02.795Z'
updated_at: '2021-12-16T15:21:02.800Z'
link:
is_container: false
is_root: false
is_child: true
is_leaf: true
relationships:
icon:
data:
id: '14'
type: icon
menu:
data:
id: '1'
type: menu
parent:
data:
id: '1'
type: menu_item
linked_resource:
data:
children:
data: []
- id: '4'
type: menu_item
attributes:
name: Link no. 3 To Somewhere
subtitle:
destination:
new_window: false
item_type: Link
linked_resource_type: URL
code:
lft: 6
rgt: 7
depth: 1
created_at: '2021-12-16T15:21:02.837Z'
updated_at: '2021-12-16T15:21:02.842Z'
link:
is_container: false
is_root: false
is_child: true
is_leaf: true
relationships:
icon:
data:
id: '15'
type: icon
menu:
data:
id: '1'
type: menu
parent:
data:
id: '1'
type: menu_item
linked_resource:
data:
children:
data: []
- id: '5'
type: menu_item
attributes:
name: Link no. 4 To Somewhere
subtitle:
destination:
new_window: false
item_type: Link
linked_resource_type: URL
code:
lft: 8
rgt: 9
depth: 1
created_at: '2021-12-16T15:21:02.879Z'
updated_at: '2021-12-16T15:21:02.884Z'
link:
is_container: false
is_root: false
is_child: true
is_leaf: true
relationships:
icon:
data:
id: '16'
type: icon
menu:
data:
id: '1'
type: menu
parent:
data:
id: '1'
type: menu_item
linked_resource:
data:
children:
data: []
- id: '6'
type: menu_item
attributes:
name: Link no. 5 To Somewhere
subtitle:
destination:
new_window: false
item_type: Link
linked_resource_type: URL
code:
lft: 10
rgt: 11
depth: 1
created_at: '2021-12-16T15:21:02.917Z'
updated_at: '2021-12-16T15:21:02.922Z'
link:
is_container: false
is_root: false
is_child: true
is_leaf: true
relationships:
icon:
data:
id: '17'
type: icon
menu:
data:
id: '1'
type: menu
parent:
data:
id: '1'
type: menu_item
linked_resource:
data:
children:
data: []
- id: '7'
type: menu_item
attributes:
name: Link no. 6 To Somewhere
subtitle:
destination:
new_window: false
item_type: Link
linked_resource_type: URL
code:
lft: 12
rgt: 13
depth: 1
created_at: '2021-12-16T15:21:02.954Z'
updated_at: '2021-12-16T15:21:02.959Z'
link:
is_container: false
is_root: false
is_child: true
is_leaf: true
relationships:
icon:
data:
id: '18'
type: icon
menu:
data:
id: '1'
type: menu
parent:
data:
id: '1'
type: menu_item
linked_resource:
data:
children:
data: []
- id: '8'
type: menu_item
attributes:
name: Link no. 7 To Somewhere
subtitle:
destination:
new_window: false
item_type: Link
linked_resource_type: URL
code:
lft: 14
rgt: 15
depth: 1
created_at: '2021-12-16T15:21:02.991Z'
updated_at: '2021-12-16T15:21:02.996Z'
link:
is_container: false
is_root: false
is_child: true
is_leaf: true
relationships:
icon:
data:
id: '19'
type: icon
menu:
data:
id: '1'
type: menu
parent:
data:
id: '1'
type: menu_item
linked_resource:
data:
children:
data: []
- id: '1'
type: menu_item
attributes:
name: Cum nemo quaerat provident tempore.
subtitle:
destination:
new_window: false
item_type: Container
linked_resource_type: URL
code:
lft: 1
rgt: 16
depth: 0
created_at: '2021-12-16T15:21:02.710Z'
updated_at: '2021-12-16T15:21:03.007Z'
link:
is_container: true
is_root: true
is_child: false
is_leaf: false
relationships:
icon:
data:
menu:
data:
id: '1'
type: menu
parent:
data:
linked_resource:
data:
children:
data:
- id: '2'
type: menu_item
- id: '3'
type: menu_item
- id: '4'
type: menu_item
- id: '5'
type: menu_item
- id: '6'
type: menu_item
- id: '7'
type: menu_item
- id: '8'
type: menu_item
meta:
count: 8
total_count: 8
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/menu_items?page=1&per_page=&include=&filter[name_eq]=
next: http://www.example.com/api/v2/platform/menu_items?filter%5Bname_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/menu_items?filter%5Bname_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/menu_items?filter%5Bname_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/menu_items?filter%5Bname_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Menu Item
tags:
- Menu Items
security:
- bearer_auth: []
description: Creates a Menu Item
operationId: create-menu-item
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: menu,icon,parent,children,linked_resource
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '21'
type: menu_item
attributes:
name: Link no. 18 To Somewhere
subtitle:
destination:
new_window: false
item_type: Link
linked_resource_type: URL
code:
lft: 8
rgt: 9
depth: 1
created_at: '2021-12-16T15:21:04.009Z'
updated_at: '2021-12-16T15:21:04.034Z'
link:
is_container: false
is_root: false
is_child: true
is_leaf: true
relationships:
icon:
data:
menu:
data:
id: '3'
type: menu
parent:
data:
id: '17'
type: menu_item
linked_resource:
data:
children:
data: []
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank, Menu can't be blank, and Item type
is not included in the list
errors:
name:
- can't be blank
menu:
- can't be blank
item_type:
- is not included in the list
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_menu_item_params"
"/api/v2/platform/menu_items/{id}":
get:
summary: Return a Menu Item
tags:
- Menu Items
security:
- bearer_auth: []
description: Returns a Menu Item
operationId: show-menu-item
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: menu,icon,parent,children,linked_resource
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '30'
type: menu_item
attributes:
name: Link no. 25 To Somewhere
subtitle:
destination:
new_window: false
item_type: Link
linked_resource_type: URL
code:
lft: 8
rgt: 9
depth: 1
created_at: '2021-12-16T15:21:04.705Z'
updated_at: '2021-12-16T15:21:04.710Z'
link:
is_container: false
is_root: false
is_child: true
is_leaf: true
relationships:
icon:
data:
id: '36'
type: icon
menu:
data:
id: '5'
type: menu
parent:
data:
id: '26'
type: menu_item
linked_resource:
data:
children:
data: []
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Menu Item
tags:
- Menu Items
security:
- bearer_auth: []
description: Updates a Menu Item
operationId: update-menu-item
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: menu,icon,parent,children,linked_resource
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '44'
type: menu_item
attributes:
name: Menu Item One
subtitle:
destination:
new_window: false
item_type: Link
linked_resource_type: URL
code:
lft: 8
rgt: 9
depth: 1
created_at: '2021-12-16T15:21:05.696Z'
updated_at: '2021-12-16T15:21:05.936Z'
link:
is_container: false
is_root: false
is_child: true
is_leaf: true
relationships:
icon:
data:
id: '47'
type: icon
menu:
data:
id: '8'
type: menu
parent:
data:
id: '40'
type: menu_item
linked_resource:
data:
children:
data: []
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_menu_item_params"
delete:
summary: Delete a Menu Item
tags:
- Menu Items
security:
- bearer_auth: []
description: Deletes a Menu Item
operationId: delete-menu-item
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/menu_items/{id}/reposition":
patch:
summary: Reposition a Menu Item
tags:
- Menu Items
security:
- bearer_auth: []
operationId: reposition-menu-item
description: Reposition a Menu Item
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '77'
type: menu_item
attributes:
name: Link no. 62 To Somewhere
subtitle:
destination:
new_window: false
item_type: Link
linked_resource_type: URL
code:
lft: 5
rgt: 6
depth: 2
created_at: '2021-12-16T15:21:08.095Z'
updated_at: '2021-12-16T15:21:08.306Z'
link:
is_container: false
is_root: false
is_child: true
is_leaf: true
relationships:
icon:
data:
id: '73'
type: icon
menu:
data:
id: '15'
type: menu
parent:
data:
id: '75'
type: menu_item
linked_resource:
data:
children:
data: []
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/menu_item_reposition"
"/api/v2/platform/menus":
get:
summary: Return a list of Menus
tags:
- Menus
security:
- bearer_auth: []
description: Returns a list of Menus
operationId: menus-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: menu_items
schema:
type: string
- name: filter[name_eq]
in: query
description: ''
example: Main Menu
schema:
type: string
- name: filter[location_eq]
in: query
description: ''
example: header
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '18'
type: menu
attributes:
name: Main Menu
location: header
locale: en
created_at: '2021-12-16T15:21:08.939Z'
updated_at: '2021-12-16T15:21:09.030Z'
relationships:
menu_items:
data:
- id: '89'
type: menu_item
- id: '90'
type: menu_item
- id: '87'
type: menu_item
- id: '19'
type: menu
attributes:
name: Footer Menu
location: footer
locale: en
created_at: '2021-12-16T15:21:08.951Z'
updated_at: '2021-12-16T15:21:09.107Z'
relationships:
menu_items:
data:
- id: '91'
type: menu_item
- id: '92'
type: menu_item
- id: '88'
type: menu_item
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/menus?page=1&per_page=&include=&filter[name_eq]=&filter[location_eq]=
next: http://www.example.com/api/v2/platform/menus?filter%5Blocation_eq%5D=&filter%5Bname_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/menus?filter%5Blocation_eq%5D=&filter%5Bname_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/menus?filter%5Blocation_eq%5D=&filter%5Bname_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/menus?filter%5Blocation_eq%5D=&filter%5Bname_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Menu
tags:
- Menus
security:
- bearer_auth: []
description: Creates a Menu
operationId: create-menu
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: menu_items
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '22'
type: menu
attributes:
name: Main Menu
location: header
locale: en
created_at: '2021-12-16T15:21:09.794Z'
updated_at: '2021-12-16T15:21:09.803Z'
relationships:
menu_items:
data:
- id: '99'
type: menu_item
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank, Locale can't be blank, and Location
is not included in the list
errors:
name:
- can't be blank
locale:
- can't be blank
location:
- is not included in the list
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_menu_params"
"/api/v2/platform/menus/{id}":
get:
summary: Return a Menu
tags:
- Menus
security:
- bearer_auth: []
description: Returns a Menu
operationId: show-menu
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: menu_items
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '23'
type: menu
attributes:
name: Main Menu
location: header
locale: en
created_at: '2021-12-16T15:21:10.058Z'
updated_at: '2021-12-16T15:21:10.066Z'
relationships:
menu_items:
data:
- id: '100'
type: menu_item
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Menu
tags:
- Menus
security:
- bearer_auth: []
description: Updates a Menu
operationId: update-menu
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: menu_items
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '25'
type: menu
attributes:
name: Main Menu
location: header
locale: en
created_at: '2021-12-16T15:21:10.571Z'
updated_at: '2021-12-16T15:21:10.583Z'
relationships:
menu_items:
data:
- id: '102'
type: menu_item
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank, Locale can't be blank, and Location
is not included in the list
errors:
name:
- can't be blank
locale:
- can't be blank
location:
- is not included in the list
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_menu_params"
delete:
summary: Delete a Menu
tags:
- Menus
security:
- bearer_auth: []
description: Deletes a Menu
operationId: delete-menu
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/option_types":
get:
summary: Return a list of Option Types
tags:
- Option Types
security:
- bearer_auth: []
description: Returns a list of Option Types
operationId: option-types-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: filter[option_type_id_eq]
in: query
description: ''
example: '1'
schema:
type: string
- name: filter[name_cont]
in: query
description: ''
example: Size
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '68'
type: option_type
attributes:
name: foo-size-68
presentation: Size
position: 1
created_at: '2021-12-16T15:21:11.829Z'
updated_at: '2021-12-16T15:21:11.829Z'
filterable: true
public_metadata: {}
private_metadata: {}
relationships:
option_values:
data: []
- id: '69'
type: option_type
attributes:
name: foo-size-69
presentation: Size
position: 2
created_at: '2021-12-16T15:21:11.832Z'
updated_at: '2021-12-16T15:21:11.832Z'
filterable: true
public_metadata: {}
private_metadata: {}
relationships:
option_values:
data: []
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/option_types?page=1&per_page=&filter[option_type_id_eq]=&filter[name_cont]=
next: http://www.example.com/api/v2/platform/option_types?filter%5Bname_cont%5D=&filter%5Boption_type_id_eq%5D=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/option_types?filter%5Bname_cont%5D=&filter%5Boption_type_id_eq%5D=&page=1&per_page=
last: http://www.example.com/api/v2/platform/option_types?filter%5Bname_cont%5D=&filter%5Boption_type_id_eq%5D=&page=1&per_page=
first: http://www.example.com/api/v2/platform/option_types?filter%5Bname_cont%5D=&filter%5Boption_type_id_eq%5D=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create an Option Type
tags:
- Option Types
security:
- bearer_auth: []
description: Creates an Option Type
operationId: create-option-type
parameters: []
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '72'
type: option_type
attributes:
name: foo-size-72
presentation: Size
position: 1
created_at: '2021-12-16T15:21:12.306Z'
updated_at: '2021-12-16T15:21:12.306Z'
filterable: true
public_metadata: {}
private_metadata: {}
relationships:
option_values:
data: []
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank and Presentation can't be blank
errors:
name:
- can't be blank
presentation:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_option_type_params"
"/api/v2/platform/option_types/{id}":
get:
summary: Return an Option Type
tags:
- Option Types
security:
- bearer_auth: []
description: Returns an Option Type
operationId: show-option-type
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '73'
type: option_type
attributes:
name: foo-size-73
presentation: Size
position: 1
created_at: '2021-12-16T15:21:12.568Z'
updated_at: '2021-12-16T15:21:12.568Z'
filterable: true
public_metadata: {}
private_metadata: {}
relationships:
option_values:
data: []
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update an Option Type
tags:
- Option Types
security:
- bearer_auth: []
description: Updates an Option Type
operationId: update-option-type
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '75'
type: option_type
attributes:
name: Size-X
presentation: Size
position: 1
created_at: '2021-12-16T15:21:13.028Z'
updated_at: '2021-12-16T15:21:13.213Z'
filterable: true
public_metadata: {}
private_metadata: {}
relationships:
option_values:
data: []
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_option_type_params"
delete:
summary: Delete an Option Type
tags:
- Option Types
security:
- bearer_auth: []
description: Deletes an Option Type
operationId: delete-option-type
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/option_values":
get:
summary: Return a list of Option Values
tags:
- Option Values
security:
- bearer_auth: []
description: Returns a list of Option Values
operationId: option-values-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: option_type
schema:
type: string
- name: filter[option_type_id_eq]
in: query
description: ''
example: '1'
schema:
type: string
- name: filter[name_cont]
in: query
description: ''
example: Red
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '68'
type: option_value
attributes:
position: 1
name: Size-68
presentation: S
created_at: '2021-12-16T15:21:14.183Z'
updated_at: '2021-12-16T15:21:14.183Z'
public_metadata: {}
private_metadata: {}
relationships:
option_type:
data:
id: '80'
type: option_type
- id: '69'
type: option_value
attributes:
position: 1
name: Size-69
presentation: S
created_at: '2021-12-16T15:21:14.193Z'
updated_at: '2021-12-16T15:21:14.193Z'
public_metadata: {}
private_metadata: {}
relationships:
option_type:
data:
id: '81'
type: option_type
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/option_values?page=1&per_page=&include=&filter[option_type_id_eq]=&filter[name_cont]=
next: http://www.example.com/api/v2/platform/option_values?filter%5Bname_cont%5D=&filter%5Boption_type_id_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/option_values?filter%5Bname_cont%5D=&filter%5Boption_type_id_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/option_values?filter%5Bname_cont%5D=&filter%5Boption_type_id_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/option_values?filter%5Bname_cont%5D=&filter%5Boption_type_id_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create an Option Value
tags:
- Option Values
security:
- bearer_auth: []
description: Creates an Option Value
operationId: create-option-value
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: option_type
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '72'
type: option_value
attributes:
position: 1
name: Size-72
presentation: S
created_at: '2021-12-16T15:21:14.676Z'
updated_at: '2021-12-16T15:21:14.676Z'
public_metadata: {}
private_metadata: {}
relationships:
option_type:
data:
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank and Presentation can't be blank
errors:
name:
- can't be blank
presentation:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_option_value_params"
"/api/v2/platform/option_values/{id}":
get:
summary: Return an Option Value
tags:
- Option Values
security:
- bearer_auth: []
description: Returns an Option Value
operationId: show-option-value
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: option_type
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '73'
type: option_value
attributes:
position: 1
name: Size-73
presentation: S
created_at: '2021-12-16T15:21:14.937Z'
updated_at: '2021-12-16T15:21:14.937Z'
public_metadata: {}
private_metadata: {}
relationships:
option_type:
data:
id: '84'
type: option_type
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update an Option Value
tags:
- Option Values
security:
- bearer_auth: []
description: Updates an Option Value
operationId: update-option-value
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: option_type
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '75'
type: option_value
attributes:
position: 1
name: M
presentation: S
created_at: '2021-12-16T15:21:15.454Z'
updated_at: '2021-12-16T15:21:15.676Z'
public_metadata: {}
private_metadata: {}
relationships:
option_type:
data:
id: '86'
type: option_type
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_option_value_params"
delete:
summary: Delete an Option Value
tags:
- Option Values
security:
- bearer_auth: []
description: Deletes an Option Value
operationId: delete-option-value
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/orders":
get:
summary: Return a list of Orders
tags:
- Orders
security:
- bearer_auth: []
description: Returns a list of Orders
operationId: orders-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
- name: filter[state_eq]
in: query
description: ''
example: complete
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '40'
type: order
attributes:
number: R744077143
item_total: '0.0'
total: '0.0'
state: cart
adjustment_total: '0.0'
completed_at:
payment_total: '0.0'
shipment_state:
payment_state:
email: fidel@denesik.co.uk
special_instructions:
created_at: '2021-12-16T15:21:16.794Z'
updated_at: '2021-12-16T15:21:16.794Z'
currency: USD
last_ip_address:
shipment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
channel: spree
included_tax_total: '0.0'
item_count: 0
approved_at:
confirmation_delivered: false
canceled_at:
state_lock_version: 0
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
store_owner_notification_delivered:
public_metadata: {}
private_metadata: {}
display_outstanding_balance: "$0.00"
display_item_total: "$0.00"
display_adjustment_total: "$0.00"
display_included_tax_total: "$0.00"
display_additional_tax_total: "$0.00"
display_tax_total: "$0.00"
display_promo_total: "$0.00"
display_total: "$0.00"
display_cart_promo_total: "$0.00"
display_pre_tax_item_amount: "$0.00"
display_pre_tax_total: "$0.00"
display_ship_total: "$0.00"
display_shipment_total: "$0.00"
display_total_applicable_store_credit: "$0.00"
display_total_applied_store_credit: "$0.00"
display_order_total_after_store_credit: "$0.00"
display_total_available_store_credit: "$0.00"
display_store_credit_remaining_after_capture: "$0.00"
relationships:
user:
data:
id: '41'
type: user
created_by:
data:
approver:
data:
canceler:
data:
bill_address:
data:
id: '52'
type: address
ship_address:
data:
line_items:
data: []
payments:
data: []
shipments:
data: []
state_changes:
data: []
return_authorizations:
data: []
reimbursements:
data: []
adjustments:
data: []
all_adjustments:
data: []
order_promotions:
data: []
- id: '41'
type: order
attributes:
number: R808102538
item_total: '0.0'
total: '0.0'
state: cart
adjustment_total: '0.0'
completed_at:
payment_total: '0.0'
shipment_state:
payment_state:
email: karoline_satterfield@romaguera.name
special_instructions:
created_at: '2021-12-16T15:21:16.811Z'
updated_at: '2021-12-16T15:21:16.811Z'
currency: USD
last_ip_address:
shipment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
channel: spree
included_tax_total: '0.0'
item_count: 0
approved_at:
confirmation_delivered: false
canceled_at:
state_lock_version: 0
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
store_owner_notification_delivered:
public_metadata: {}
private_metadata: {}
display_outstanding_balance: "$0.00"
display_item_total: "$0.00"
display_adjustment_total: "$0.00"
display_included_tax_total: "$0.00"
display_additional_tax_total: "$0.00"
display_tax_total: "$0.00"
display_promo_total: "$0.00"
display_total: "$0.00"
display_cart_promo_total: "$0.00"
display_pre_tax_item_amount: "$0.00"
display_pre_tax_total: "$0.00"
display_ship_total: "$0.00"
display_shipment_total: "$0.00"
display_total_applicable_store_credit: "$0.00"
display_total_applied_store_credit: "$0.00"
display_order_total_after_store_credit: "$0.00"
display_total_available_store_credit: "$0.00"
display_store_credit_remaining_after_capture: "$0.00"
relationships:
user:
data:
id: '42'
type: user
created_by:
data:
approver:
data:
canceler:
data:
bill_address:
data:
id: '53'
type: address
ship_address:
data:
line_items:
data: []
payments:
data: []
shipments:
data: []
state_changes:
data: []
return_authorizations:
data: []
reimbursements:
data: []
adjustments:
data: []
all_adjustments:
data: []
order_promotions:
data: []
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/orders?page=1&per_page=&include=&filter[state_eq]=
next: http://www.example.com/api/v2/platform/orders?filter%5Bstate_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/orders?filter%5Bstate_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/orders?filter%5Bstate_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/orders?filter%5Bstate_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Creates an Order
tags:
- Orders
security:
- bearer_auth: []
description: Creates an Order
operationId: create-order
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '44'
type: order
attributes:
number: R149481100
item_total: '0.0'
total: '0.0'
state: cart
adjustment_total: '0.0'
completed_at:
payment_total: '0.0'
shipment_state:
payment_state:
email:
special_instructions:
created_at: '2021-12-16T15:21:17.715Z'
updated_at: '2021-12-16T15:21:17.741Z'
currency: USD
last_ip_address:
shipment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
channel: spree
included_tax_total: '0.0'
item_count: 0
approved_at:
confirmation_delivered: false
canceled_at:
state_lock_version: 0
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
store_owner_notification_delivered:
public_metadata: {}
private_metadata: {}
display_outstanding_balance: "$0.00"
display_item_total: "$0.00"
display_adjustment_total: "$0.00"
display_included_tax_total: "$0.00"
display_additional_tax_total: "$0.00"
display_tax_total: "$0.00"
display_promo_total: "$0.00"
display_total: "$0.00"
display_cart_promo_total: "$0.00"
display_pre_tax_item_amount: "$20.00"
display_pre_tax_total: "$20.00"
display_ship_total: "$0.00"
display_shipment_total: "$0.00"
display_total_applicable_store_credit: "$0.00"
display_total_applied_store_credit: "$0.00"
display_order_total_after_store_credit: "$0.00"
display_total_available_store_credit: "$0.00"
display_store_credit_remaining_after_capture: "$0.00"
relationships:
user:
data:
created_by:
data:
approver:
data:
canceler:
data:
bill_address:
data:
id: '56'
type: address
ship_address:
data:
id: '56'
type: address
line_items:
data:
- id: '35'
type: line_item
payments:
data:
- id: '1'
type: payment
shipments:
data: []
state_changes:
data: []
return_authorizations:
data: []
reimbursements:
data: []
adjustments:
data: []
all_adjustments:
data: []
order_promotions:
data: []
schema:
"$ref": "#/components/schemas/resource"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_order_params"
"/api/v2/platform/orders/{id}":
get:
summary: Return an Order
tags:
- Orders
security:
- bearer_auth: []
description: Returns an Order
operationId: show-order
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '45'
type: order
attributes:
number: R780118269
item_total: '10.0'
total: '110.0'
state: delivery
adjustment_total: '0.0'
completed_at:
payment_total: '0.0'
shipment_state:
payment_state:
email: quincy.bruen@harris.ca
special_instructions:
created_at: '2021-12-16T15:21:17.852Z'
updated_at: '2021-12-16T15:21:18.071Z'
currency: USD
last_ip_address:
shipment_total: '100.0'
additional_tax_total: '0.0'
promo_total: '0.0'
channel: spree
included_tax_total: '0.0'
item_count: 1
approved_at:
confirmation_delivered: false
canceled_at:
state_lock_version: 0
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
store_owner_notification_delivered:
public_metadata: {}
private_metadata: {}
display_outstanding_balance: "$110.00"
display_item_total: "$10.00"
display_adjustment_total: "$0.00"
display_included_tax_total: "$0.00"
display_additional_tax_total: "$0.00"
display_tax_total: "$0.00"
display_promo_total: "$0.00"
display_total: "$110.00"
display_cart_promo_total: "$0.00"
display_pre_tax_item_amount: "$10.00"
display_pre_tax_total: "$10.00"
display_ship_total: "$100.00"
display_shipment_total: "$100.00"
display_total_applicable_store_credit: "$0.00"
display_total_applied_store_credit: "$0.00"
display_order_total_after_store_credit: "$110.00"
display_total_available_store_credit: "$0.00"
display_store_credit_remaining_after_capture: "$0.00"
relationships:
user:
data:
id: '45'
type: user
created_by:
data:
approver:
data:
canceler:
data:
bill_address:
data:
id: '57'
type: address
ship_address:
data:
id: '58'
type: address
line_items:
data:
- id: '36'
type: line_item
payments:
data: []
shipments:
data:
- id: '1'
type: shipment
state_changes:
data: []
return_authorizations:
data: []
reimbursements:
data: []
adjustments:
data: []
all_adjustments:
data: []
order_promotions:
data: []
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update an Order
tags:
- Orders
security:
- bearer_auth: []
description: Updates an Order
operationId: update-order
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '47'
type: order
attributes:
number: R729431639
item_total: '10.0'
total: '110.0'
state: delivery
adjustment_total: '0.0'
completed_at:
payment_total: '0.0'
shipment_state:
payment_state:
email: new@example.com
special_instructions:
created_at: '2021-12-16T15:21:18.813Z'
updated_at: '2021-12-16T15:21:19.172Z'
currency: USD
last_ip_address:
shipment_total: '100.0'
additional_tax_total: '0.0'
promo_total: '0.0'
channel: spree
included_tax_total: '0.0'
item_count: 1
approved_at:
confirmation_delivered: false
canceled_at:
state_lock_version: 0
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
store_owner_notification_delivered:
public_metadata: {}
private_metadata: {}
display_outstanding_balance: "$110.00"
display_item_total: "$10.00"
display_adjustment_total: "$0.00"
display_included_tax_total: "$0.00"
display_additional_tax_total: "$0.00"
display_tax_total: "$0.00"
display_promo_total: "$0.00"
display_total: "$110.00"
display_cart_promo_total: "$0.00"
display_pre_tax_item_amount: "$10.00"
display_pre_tax_total: "$10.00"
display_ship_total: "$100.00"
display_shipment_total: "$100.00"
display_total_applicable_store_credit: "$0.00"
display_total_applied_store_credit: "$0.00"
display_order_total_after_store_credit: "$110.00"
display_total_available_store_credit: "$0.00"
display_store_credit_remaining_after_capture: "$0.00"
relationships:
user:
data:
id: '47'
type: user
created_by:
data:
approver:
data:
canceler:
data:
bill_address:
data:
id: '61'
type: address
ship_address:
data:
id: '62'
type: address
line_items:
data:
- id: '38'
type: line_item
payments:
data: []
shipments:
data:
- id: '3'
type: shipment
state_changes:
data: []
return_authorizations:
data: []
reimbursements:
data: []
adjustments:
data: []
all_adjustments:
data: []
order_promotions:
data: []
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Email is invalid
errors:
email:
- is invalid
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_order_params"
delete:
summary: Delete an Order
tags:
- Orders
security:
- bearer_auth: []
description: Deletes an Order
operationId: delete-order
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/orders/{id}/advance":
patch:
summary: Advances an Order
tags:
- Orders
security:
- bearer_auth: []
description: Advances an Order
operationId: advance-order
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '52'
type: order
attributes:
number: R437482996
item_total: '10.0'
total: '110.0'
state: payment
adjustment_total: '0.0'
completed_at:
payment_total: '0.0'
shipment_state:
payment_state:
email: theresia.okon@cummerata.co.uk
special_instructions:
created_at: '2021-12-16T15:21:21.046Z'
updated_at: '2021-12-16T15:21:21.427Z'
currency: USD
last_ip_address:
shipment_total: '100.0'
additional_tax_total: '0.0'
promo_total: '0.0'
channel: spree
included_tax_total: '0.0'
item_count: 1
approved_at:
confirmation_delivered: false
canceled_at:
state_lock_version: 0
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
store_owner_notification_delivered:
public_metadata: {}
private_metadata: {}
display_outstanding_balance: "$110.00"
display_item_total: "$10.00"
display_adjustment_total: "$0.00"
display_included_tax_total: "$0.00"
display_additional_tax_total: "$0.00"
display_tax_total: "$0.00"
display_promo_total: "$0.00"
display_total: "$110.00"
display_cart_promo_total: "$0.00"
display_pre_tax_item_amount: "$10.00"
display_pre_tax_total: "$110.00"
display_ship_total: "$100.00"
display_shipment_total: "$100.00"
display_total_applicable_store_credit: "$0.00"
display_total_applied_store_credit: "$0.00"
display_order_total_after_store_credit: "$110.00"
display_total_available_store_credit: "$0.00"
display_store_credit_remaining_after_capture: "$0.00"
relationships:
user:
data:
id: '52'
type: user
created_by:
data:
approver:
data:
canceler:
data:
bill_address:
data:
id: '71'
type: address
ship_address:
data:
id: '72'
type: address
line_items:
data:
- id: '43'
type: line_item
payments:
data: []
shipments:
data:
- id: '8'
type: shipment
state_changes:
data:
- id: '2'
type: state_change
return_authorizations:
data: []
reimbursements:
data: []
adjustments:
data: []
all_adjustments:
data: []
order_promotions:
data: []
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/orders/{id}/next":
patch:
summary: Next an Order
tags:
- Orders
security:
- bearer_auth: []
description: Moves an Order to the next state
operationId: next-order
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '54'
type: order
attributes:
number: R614190089
item_total: '10.0'
total: '110.0'
state: payment
adjustment_total: '0.0'
completed_at:
payment_total: '0.0'
shipment_state:
payment_state:
email: floy_schiller@schmelerbechtelar.co.uk
special_instructions:
created_at: '2021-12-16T15:21:22.155Z'
updated_at: '2021-12-16T15:21:22.577Z'
currency: USD
last_ip_address:
shipment_total: '100.0'
additional_tax_total: '0.0'
promo_total: '0.0'
channel: spree
included_tax_total: '0.0'
item_count: 1
approved_at:
confirmation_delivered: false
canceled_at:
state_lock_version: 0
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
store_owner_notification_delivered:
public_metadata: {}
private_metadata: {}
display_outstanding_balance: "$110.00"
display_item_total: "$10.00"
display_adjustment_total: "$0.00"
display_included_tax_total: "$0.00"
display_additional_tax_total: "$0.00"
display_tax_total: "$0.00"
display_promo_total: "$0.00"
display_total: "$110.00"
display_cart_promo_total: "$0.00"
display_pre_tax_item_amount: "$10.00"
display_pre_tax_total: "$110.00"
display_ship_total: "$100.00"
display_shipment_total: "$100.00"
display_total_applicable_store_credit: "$0.00"
display_total_applied_store_credit: "$0.00"
display_order_total_after_store_credit: "$110.00"
display_total_available_store_credit: "$0.00"
display_store_credit_remaining_after_capture: "$0.00"
relationships:
user:
data:
id: '54'
type: user
created_by:
data:
approver:
data:
canceler:
data:
bill_address:
data:
id: '75'
type: address
ship_address:
data:
id: '76'
type: address
line_items:
data:
- id: '45'
type: line_item
payments:
data: []
shipments:
data:
- id: '10'
type: shipment
state_changes:
data:
- id: '3'
type: state_change
return_authorizations:
data: []
reimbursements:
data: []
adjustments:
data: []
all_adjustments:
data: []
order_promotions:
data: []
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/orders/{id}/complete":
patch:
summary: Completes an Order
tags:
- Orders
security:
- bearer_auth: []
description: Marks an Order as completed
operationId: complete-order
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '56'
type: order
attributes:
number: R630646840
item_total: '10.0'
total: '110.0'
state: complete
adjustment_total: '0.0'
completed_at: '2021-12-16T15:21:23.724Z'
payment_total: '0.0'
shipment_state: pending
payment_state: balance_due
email: olen_osinski@purdy.info
special_instructions:
created_at: '2021-12-16T15:21:23.179Z'
updated_at: '2021-12-16T15:21:23.724Z'
currency: USD
last_ip_address:
shipment_total: '100.0'
additional_tax_total: '0.0'
promo_total: '0.0'
channel: spree
included_tax_total: '0.0'
item_count: 1
approved_at:
confirmation_delivered: false
canceled_at:
state_lock_version: 0
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
store_owner_notification_delivered:
public_metadata: {}
private_metadata: {}
display_outstanding_balance: "$110.00"
display_item_total: "$10.00"
display_adjustment_total: "$0.00"
display_included_tax_total: "$0.00"
display_additional_tax_total: "$0.00"
display_tax_total: "$0.00"
display_promo_total: "$0.00"
display_total: "$110.00"
display_cart_promo_total: "$0.00"
display_pre_tax_item_amount: "$10.00"
display_pre_tax_total: "$110.00"
display_ship_total: "$100.00"
display_shipment_total: "$100.00"
display_total_applicable_store_credit: "$0.00"
display_total_applied_store_credit: "$0.00"
display_order_total_after_store_credit: "$110.00"
display_total_available_store_credit: "$0.00"
display_store_credit_remaining_after_capture: "$0.00"
relationships:
user:
data:
id: '56'
type: user
created_by:
data:
approver:
data:
canceler:
data:
bill_address:
data:
id: '79'
type: address
ship_address:
data:
id: '80'
type: address
line_items:
data:
- id: '47'
type: line_item
payments:
data:
- id: '2'
type: payment
shipments:
data:
- id: '12'
type: shipment
state_changes:
data:
- id: '4'
type: state_change
- id: '5'
type: state_change
- id: '8'
type: state_change
- id: '9'
type: state_change
- id: '10'
type: state_change
return_authorizations:
data: []
reimbursements:
data: []
adjustments:
data: []
all_adjustments:
data: []
order_promotions:
data: []
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/orders/{id}/empty":
patch:
summary: Empties an Order
tags:
- Orders
security:
- bearer_auth: []
description: Removes all line items, promotions, shipment and payments from
an Order
operationId: empty-order
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '59'
type: order
attributes:
number: R020172557
item_total: '0.0'
total: '0.0'
state: cart
adjustment_total: '0.0'
completed_at:
payment_total: '0.0'
shipment_state:
payment_state:
email: dannie.tromp@lind.us
special_instructions:
created_at: '2021-12-16T15:21:24.527Z'
updated_at: '2021-12-16T15:21:24.890Z'
currency: USD
last_ip_address:
shipment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
channel: spree
included_tax_total: '0.0'
item_count: 0
approved_at:
confirmation_delivered: false
canceled_at:
state_lock_version: 0
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
store_owner_notification_delivered:
public_metadata: {}
private_metadata: {}
display_outstanding_balance: "$0.00"
display_item_total: "$0.00"
display_adjustment_total: "$0.00"
display_included_tax_total: "$0.00"
display_additional_tax_total: "$0.00"
display_tax_total: "$0.00"
display_promo_total: "$0.00"
display_total: "$0.00"
display_cart_promo_total: "$0.00"
display_pre_tax_item_amount: "$0.00"
display_pre_tax_total: "$0.00"
display_ship_total: "$0.00"
display_shipment_total: "$0.00"
display_total_applicable_store_credit: "$0.00"
display_total_applied_store_credit: "$0.00"
display_order_total_after_store_credit: "$0.00"
display_total_available_store_credit: "$0.00"
display_store_credit_remaining_after_capture: "$0.00"
relationships:
user:
data:
id: '59'
type: user
created_by:
data:
approver:
data:
canceler:
data:
bill_address:
data:
id: '85'
type: address
ship_address:
data:
id: '86'
type: address
line_items:
data: []
payments:
data: []
shipments:
data: []
state_changes:
data: []
return_authorizations:
data: []
reimbursements:
data: []
adjustments:
data: []
all_adjustments:
data: []
order_promotions:
data: []
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/orders/{id}/approve":
patch:
summary: Approves an Order
tags:
- Orders
security:
- bearer_auth: []
description: Approves an Order, when using a token created for a user, it will
save this user as the approver
operationId: approve-order
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'200':
description: Record approved
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '61'
type: order
attributes:
number: R042137028
item_total: '10.0'
total: '110.0'
state: delivery
adjustment_total: '0.0'
completed_at:
payment_total: '0.0'
shipment_state:
payment_state:
email: lincoln@mcglynnhickle.info
special_instructions:
created_at: '2021-12-16T15:21:25.411Z'
updated_at: '2021-12-16T15:21:25.576Z'
currency: USD
last_ip_address:
shipment_total: '100.0'
additional_tax_total: '0.0'
promo_total: '0.0'
channel: spree
included_tax_total: '0.0'
item_count: 1
approved_at:
confirmation_delivered: false
canceled_at:
state_lock_version: 0
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
store_owner_notification_delivered:
public_metadata: {}
private_metadata: {}
display_outstanding_balance: "$110.00"
display_item_total: "$10.00"
display_adjustment_total: "$0.00"
display_included_tax_total: "$0.00"
display_additional_tax_total: "$0.00"
display_tax_total: "$0.00"
display_promo_total: "$0.00"
display_total: "$110.00"
display_cart_promo_total: "$0.00"
display_pre_tax_item_amount: "$10.00"
display_pre_tax_total: "$10.00"
display_ship_total: "$100.00"
display_shipment_total: "$100.00"
display_total_applicable_store_credit: "$0.00"
display_total_applied_store_credit: "$0.00"
display_order_total_after_store_credit: "$110.00"
display_total_available_store_credit: "$0.00"
display_store_credit_remaining_after_capture: "$0.00"
relationships:
user:
data:
id: '61'
type: user
created_by:
data:
approver:
data:
canceler:
data:
bill_address:
data:
id: '89'
type: address
ship_address:
data:
id: '90'
type: address
line_items:
data:
- id: '52'
type: line_item
payments:
data: []
shipments:
data:
- id: '17'
type: shipment
state_changes:
data: []
return_authorizations:
data: []
reimbursements:
data: []
adjustments:
data: []
all_adjustments:
data: []
order_promotions:
data: []
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/orders/{id}/cancel":
patch:
summary: Cancels an Order
tags:
- Orders
security:
- bearer_auth: []
description: Cancels an Order, when using a token created for a user, it will
save this user as the canceler
operationId: cancel-order
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'200':
description: record canceled
'422':
description: cannot be canceled
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/orders/{id}/use_store_credit":
patch:
summary: Use Store Credit for an Order
tags:
- Orders
security:
- bearer_auth: []
description: Creates Store Credit payment for an Order
operationId: use-store-credit-order
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'200':
description: store credit payment created
'422':
description: user does not have store credit available
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/amount_param"
"/api/v2/platform/orders/{id}/apply_coupon_code":
patch:
summary: Apply Coupon Code for an Order
tags:
- Orders
security:
- bearer_auth: []
description: Creates Store Credit payment for an Order
operationId: apply-coupon-code-order
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'200':
description: coupon code applied
'422':
description: coupon code couldn't be applied
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/coupon_code_param"
"/api/v2/platform/payment_methods":
get:
summary: Return a list of Payment Methods
tags:
- Payment Methods
security:
- bearer_auth: []
description: Returns a list of Payment Methods
operationId: payment-methods-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: stores
schema:
type: string
- name: filter[name]
in: query
description: ''
example: Stripe
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '12'
type: payment_method
attributes:
name: Test
type: Spree::PaymentMethod
description:
active: true
display_on: both
auto_capture:
position: 1
created_at: '2021-12-16T15:21:30.602Z'
updated_at: '2021-12-16T15:21:30.605Z'
deleted_at:
public_metadata: {}
private_metadata: {}
preferences: {}
relationships:
stores:
data:
- id: '287'
type: store
- id: '13'
type: payment_method
attributes:
name: Test
type: Spree::PaymentMethod
description:
active: true
display_on: both
auto_capture:
position: 2
created_at: '2021-12-16T15:21:30.615Z'
updated_at: '2021-12-16T15:21:30.618Z'
deleted_at:
public_metadata: {}
private_metadata: {}
preferences: {}
relationships:
stores:
data:
- id: '287'
type: store
- id: '14'
type: payment_method
attributes:
name: Test
type: Spree::PaymentMethod
description:
active: true
display_on: both
auto_capture:
position: 3
created_at: '2021-12-16T15:21:30.627Z'
updated_at: '2021-12-16T15:21:30.631Z'
deleted_at:
public_metadata: {}
private_metadata: {}
preferences: {}
relationships:
stores:
data:
- id: '287'
type: store
- id: '15'
type: payment_method
attributes:
name: Credit Card
type: Spree::Gateway::Bogus
description:
active: true
display_on: both
auto_capture:
position: 4
created_at: '2021-12-16T15:21:30.640Z'
updated_at: '2021-12-16T15:21:30.644Z'
deleted_at:
public_metadata: {}
private_metadata: {}
preferences:
dummy_key: PUBLICKEY123
server: test
test_mode: true
relationships:
stores:
data:
- id: '287'
type: store
- id: '16'
type: payment_method
attributes:
name: Credit Card
type: Spree::Gateway::Bogus
description:
active: true
display_on: both
auto_capture:
position: 5
created_at: '2021-12-16T15:21:30.651Z'
updated_at: '2021-12-16T15:21:30.654Z'
deleted_at:
public_metadata: {}
private_metadata: {}
preferences:
dummy_key: PUBLICKEY123
server: test
test_mode: true
relationships:
stores:
data:
- id: '287'
type: store
meta:
count: 5
total_count: 5
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/payment_methods?page=1&per_page=&include=&filter[name]=
next: http://www.example.com/api/v2/platform/payment_methods?filter%5Bname%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/payment_methods?filter%5Bname%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/payment_methods?filter%5Bname%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/payment_methods?filter%5Bname%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Payment Method
tags:
- Payment Methods
security:
- bearer_auth: []
description: Creates a Payment Method
operationId: create-payment-method
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: stores
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '24'
type: payment_method
attributes:
name: API Bogus
type: Spree::Gateway::Bogus
description:
active: true
display_on: both
auto_capture:
position: 3
created_at: '2021-12-16T15:21:31.255Z'
updated_at: '2021-12-16T15:21:31.259Z'
deleted_at:
public_metadata: {}
private_metadata: {}
preferences:
dummy_key: PUBLICKEY123
server: test
test_mode: true
relationships:
stores:
data:
- id: '291'
type: store
- id: '292'
type: store
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_payment_method_params"
"/api/v2/platform/payment_methods/{id}":
get:
summary: Return a Payment Method
tags:
- Payment Methods
security:
- bearer_auth: []
description: Returns a Payment Method
operationId: show-payment-method
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: stores
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '30'
type: payment_method
attributes:
name: Credit Card
type: Spree::Gateway::Bogus
description:
active: true
display_on: both
auto_capture:
position: 4
created_at: '2021-12-16T15:21:31.614Z'
updated_at: '2021-12-16T15:21:31.618Z'
deleted_at:
public_metadata: {}
private_metadata: {}
preferences:
dummy_key: PUBLICKEY123
server: test
test_mode: true
relationships:
stores:
data:
- id: '295'
type: store
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Payment Method
tags:
- Payment Methods
security:
- bearer_auth: []
description: Updates a Payment Method
operationId: update-payment-method
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: stores
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '40'
type: payment_method
attributes:
name: Credit Card
type: Spree::Gateway::Bogus
description:
active: true
display_on: both
auto_capture:
position: 3
created_at: '2021-12-16T15:21:32.242Z'
updated_at: '2021-12-16T15:21:32.444Z'
deleted_at:
public_metadata: {}
private_metadata: {}
preferences:
dummy_key: UPDATED-DUMMY-KEY-123
server: production
test_mode: false
relationships:
stores:
data:
- id: '301'
type: store
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
oneOf:
- "$ref": "#/components/schemas/update_payment_method_params"
- "$ref": "#/components/schemas/update_payment_method_params_bogus_gateway"
delete:
summary: Delete a Payment Method
tags:
- Payment Methods
security:
- bearer_auth: []
description: Deletes a Payment Method
operationId: delete-payment-method
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/payments":
get:
summary: Return a list of Payments
tags:
- Payments
security:
- bearer_auth: []
description: Returns a list of Payments
operationId: payments-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: payment_method,order,source
schema:
type: string
- name: filter[payment_method_id_eq]
in: query
description: ''
example: '1'
schema:
type: string
- name: filter[amount_gteq]
in: query
description: ''
example: '99.90'
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '6'
type: payment
attributes:
amount: '45.75'
source_type: Spree::CreditCard
state: invalid
response_code: '12345'
avs_response:
created_at: '2021-12-16T15:21:33.731Z'
updated_at: '2021-12-16T15:21:33.764Z'
number: PG78R9TD
cvv_response_code:
cvv_response_message:
public_metadata: {}
private_metadata: {}
display_amount: "$45.75"
relationships:
order:
data:
id: '72'
type: order
payment_method:
data:
id: '60'
type: payment_method
source:
data:
id: '5'
type: credit_card
log_entries:
data: []
state_changes:
data:
- id: '15'
type: state_change
payment_capture_events:
data: []
refunds:
data: []
- id: '7'
type: payment
attributes:
amount: '45.75'
source_type: Spree::CreditCard
state: checkout
response_code: '12345'
avs_response:
created_at: '2021-12-16T15:21:33.759Z'
updated_at: '2021-12-16T15:21:33.759Z'
number: P36896JL
cvv_response_code:
cvv_response_message:
public_metadata: {}
private_metadata: {}
display_amount: "$45.75"
relationships:
order:
data:
id: '72'
type: order
payment_method:
data:
id: '60'
type: payment_method
source:
data:
id: '6'
type: credit_card
log_entries:
data: []
state_changes:
data: []
payment_capture_events:
data: []
refunds:
data: []
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/payments?page=1&per_page=&include=&filter[payment_method_id_eq]=&filter[amount_gteq]=
next: http://www.example.com/api/v2/platform/payments?filter%5Bamount_gteq%5D=&filter%5Bpayment_method_id_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/payments?filter%5Bamount_gteq%5D=&filter%5Bpayment_method_id_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/payments?filter%5Bamount_gteq%5D=&filter%5Bpayment_method_id_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/payments?filter%5Bamount_gteq%5D=&filter%5Bpayment_method_id_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/payments/{id}":
get:
summary: Return a Payment
tags:
- Payments
security:
- bearer_auth: []
description: Returns a Payment
operationId: show-payment
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: payment_method,order,source
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '10'
type: payment
attributes:
amount: '45.75'
source_type: Spree::CreditCard
state: checkout
response_code: '12345'
avs_response:
created_at: '2021-12-16T15:21:34.224Z'
updated_at: '2021-12-16T15:21:34.224Z'
number: PKO2OZ84
cvv_response_code:
cvv_response_message:
public_metadata: {}
private_metadata: {}
display_amount: "$45.75"
relationships:
order:
data:
id: '74'
type: order
payment_method:
data:
id: '66'
type: payment_method
source:
data:
id: '9'
type: credit_card
log_entries:
data: []
state_changes:
data: []
payment_capture_events:
data: []
refunds:
data: []
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
delete:
summary: Delete a Payment
tags:
- Payments
security:
- bearer_auth: []
description: Deletes a Payment
operationId: delete-payment
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/promotion_actions":
get:
summary: Return a list of Promotion Actions
tags:
- Promotion Actions
security:
- bearer_auth: []
description: Returns a list of Promotion Actions
operationId: promotion-actions-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: calculator
schema:
type: string
- name: filter[type_eq]
in: query
description: ''
example: Spree::Promotion::Actions::CreateAdjustment
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '5'
type: promotion_action
attributes:
position:
type:
deleted_at:
created_at: '2021-12-16T15:21:35.384Z'
updated_at: '2021-12-16T15:21:35.384Z'
relationships:
promotion:
data:
id: '5'
type: promotion
- id: '6'
type: promotion_action
attributes:
position:
type:
deleted_at:
created_at: '2021-12-16T15:21:35.385Z'
updated_at: '2021-12-16T15:21:35.385Z'
relationships:
promotion:
data:
id: '5'
type: promotion
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/promotion_actions?page=1&per_page=&include=&filter[type_eq]=
next: http://www.example.com/api/v2/platform/promotion_actions?filter%5Btype_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/promotion_actions?filter%5Btype_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/promotion_actions?filter%5Btype_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/promotion_actions?filter%5Btype_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Promotion Action
tags:
- Promotion Actions
security:
- bearer_auth: []
description: Creates a Promotion Action
operationId: create-promotion-action
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: calculator
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '9'
type: promotion_action
attributes:
position:
type:
deleted_at:
created_at: '2021-12-16T15:21:35.882Z'
updated_at: '2021-12-16T15:21:35.882Z'
relationships:
promotion:
data:
id: '7'
type: promotion
schema:
"$ref": "#/components/schemas/resource"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_promotion_action_params"
"/api/v2/platform/promotion_actions/{id}":
get:
summary: Return a Promotion Action
tags:
- Promotion Actions
security:
- bearer_auth: []
description: Returns a Promotion Action
operationId: show-promotion-action
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: calculator
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '10'
type: promotion_action
attributes:
position:
type:
deleted_at:
created_at: '2021-12-16T15:21:35.968Z'
updated_at: '2021-12-16T15:21:35.968Z'
relationships:
promotion:
data:
id: '8'
type: promotion
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Promotion Action
tags:
- Promotion Actions
security:
- bearer_auth: []
description: Updates a Promotion Action
operationId: update-promotion-action
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: calculator
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '12'
type: promotion_action
attributes:
position:
type: Spree::Promotion::Actions::CreateAdjustment
deleted_at:
created_at: '2021-12-16T15:21:36.478Z'
updated_at: '2021-12-16T15:21:36.666Z'
relationships:
promotion:
data:
id: '10'
type: promotion
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_promotion_action_params"
delete:
summary: Delete a Promotion Action
tags:
- Promotion Actions
security:
- bearer_auth: []
description: Deletes a Promotion Action
operationId: delete-promotion-action
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/promotion_categories":
get:
summary: Return a list of Promotion Categories
tags:
- Promotion Categories
security:
- bearer_auth: []
description: Returns a list of Promotion Categories
operationId: promotion-categories-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: promotions
schema:
type: string
- name: filter[code_eq]
in: query
description: ''
example: BLK-FRI
schema:
type: string
- name: filter[name_eq]
in: query
description: ''
example: 2020 Promotions
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '1'
type: promotion_category
attributes:
name: Promotion Category
created_at: '2021-12-16T15:21:37.472Z'
updated_at: '2021-12-16T15:21:37.472Z'
code: POP123
relationships:
promotions:
data: []
- id: '2'
type: promotion_category
attributes:
name: Promotion Category
created_at: '2021-12-16T15:21:37.474Z'
updated_at: '2021-12-16T15:21:37.474Z'
code: POP123
relationships:
promotions:
data: []
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/promotion_categories?page=1&per_page=&include=&filter[code_eq]=&filter[name_eq]=
next: http://www.example.com/api/v2/platform/promotion_categories?filter%5Bcode_eq%5D=&filter%5Bname_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/promotion_categories?filter%5Bcode_eq%5D=&filter%5Bname_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/promotion_categories?filter%5Bcode_eq%5D=&filter%5Bname_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/promotion_categories?filter%5Bcode_eq%5D=&filter%5Bname_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Promotion Category
tags:
- Promotion Categories
security:
- bearer_auth: []
description: Creates a Promotion Category
operationId: create-promotion-category
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: promotions
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '5'
type: promotion_category
attributes:
name: Promotion Category
created_at: '2021-12-16T15:21:37.946Z'
updated_at: '2021-12-16T15:21:37.946Z'
code: 2021-BFM
relationships:
promotions:
data: []
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_promotion_category_params"
"/api/v2/platform/promotion_categories/{id}":
get:
summary: Return a Promotion Category
tags:
- Promotion Categories
security:
- bearer_auth: []
description: Returns a Promotion Category
operationId: show-promotion-category
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: promotions
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '6'
type: promotion_category
attributes:
name: Promotion Category
created_at: '2021-12-16T15:21:38.212Z'
updated_at: '2021-12-16T15:21:38.212Z'
code: MJO
relationships:
promotions:
data: []
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Promotion Category
tags:
- Promotion Categories
security:
- bearer_auth: []
description: Updates a Promotion Category
operationId: update-promotion-category
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: promotions
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '8'
type: promotion_category
attributes:
name: 2021 Promotions
created_at: '2021-12-16T15:21:38.690Z'
updated_at: '2021-12-16T15:21:38.878Z'
code: 2021-Promos
relationships:
promotions:
data: []
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_promotion_category_params"
delete:
summary: Delete a Promotion Category
tags:
- Promotion Categories
security:
- bearer_auth: []
description: Deletes a Promotion Category
operationId: delete-promotion-category
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/promotion_rules":
get:
summary: Return a list of Promotion Rules
tags:
- Promotion Rules
security:
- bearer_auth: []
description: Returns a list of Promotion Rules
operationId: promotion-rules-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: user
schema:
type: string
- name: filter[type_eq]
in: query
description: ''
example: Spree::Promotion::Rules::Product
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '1'
type: promotion_rule
attributes:
type:
created_at: '2021-12-16T15:21:39.876Z'
updated_at: '2021-12-16T15:21:39.876Z'
code:
preferences: {}
relationships:
promotion:
data:
id: '14'
type: promotion
- id: '2'
type: promotion_rule
attributes:
type:
created_at: '2021-12-16T15:21:39.879Z'
updated_at: '2021-12-16T15:21:39.879Z'
code:
preferences: {}
relationships:
promotion:
data:
id: '14'
type: promotion
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/promotion_rules?page=1&per_page=&include=&filter[type_eq]=
next: http://www.example.com/api/v2/platform/promotion_rules?filter%5Btype_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/promotion_rules?filter%5Btype_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/promotion_rules?filter%5Btype_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/promotion_rules?filter%5Btype_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Promotion Rule
tags:
- Promotion Rules
security:
- bearer_auth: []
description: Creates a Promotion Rule
operationId: create-promotion-rule
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: user
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '5'
type: promotion_rule
attributes:
type:
created_at: '2021-12-16T15:21:40.405Z'
updated_at: '2021-12-16T15:21:40.405Z'
code:
preferences: {}
relationships:
promotion:
data:
id: '16'
type: promotion
schema:
"$ref": "#/components/schemas/resource"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_promotion_rule_params"
"/api/v2/platform/promotion_rules/{id}":
get:
summary: Return a Promotion Rule
tags:
- Promotion Rules
security:
- bearer_auth: []
description: Returns a Promotion Rule
operationId: show-promotion-rule
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: user
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '6'
type: promotion_rule
attributes:
type:
created_at: '2021-12-16T15:21:40.455Z'
updated_at: '2021-12-16T15:21:40.455Z'
code:
preferences: {}
relationships:
promotion:
data:
id: '17'
type: promotion
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Promotion Rule
tags:
- Promotion Rules
security:
- bearer_auth: []
description: Updates a Promotion Rule
operationId: update-promotion-rule
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: user
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '8'
type: promotion_rule
attributes:
type: Spree::Promotion::Rules::Country
created_at: '2021-12-16T15:21:40.954Z'
updated_at: '2021-12-16T15:21:41.141Z'
code:
preferences: {}
relationships:
promotion:
data:
id: '19'
type: promotion
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_promotion_rule_params"
delete:
summary: Delete a Promotion Rule
tags:
- Promotion Rules
security:
- bearer_auth: []
description: Deletes a Promotion Rule
operationId: delete-promotion-rule
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/promotions":
get:
summary: Return a list of Promotions
tags:
- Promotions
security:
- bearer_auth: []
description: Returns a list of Promotions
operationId: promotions-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: promotion_category,promotion_rules,promotion_actions,stores
schema:
type: string
- name: filter[code_eq]
in: query
description: ''
example: BLK-FRI
schema:
type: string
- name: filter[name_cont]
in: query
description: ''
example: New Customer
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '23'
type: promotion
attributes:
description:
expires_at:
starts_at:
name: Promo
type:
usage_limit:
match_policy: all
code:
advertise: false
path:
created_at: '2021-12-16T15:21:42.117Z'
updated_at: '2021-12-16T15:21:42.119Z'
public_metadata: {}
private_metadata: {}
relationships:
promotion_category:
data:
promotion_rules:
data: []
promotion_actions:
data: []
stores:
data:
- id: '361'
type: store
- id: '24'
type: promotion
attributes:
description:
expires_at:
starts_at:
name: Promo
type:
usage_limit:
match_policy: all
code:
advertise: false
path:
created_at: '2021-12-16T15:21:42.141Z'
updated_at: '2021-12-16T15:21:42.144Z'
public_metadata: {}
private_metadata: {}
relationships:
promotion_category:
data:
id: '13'
type: promotion_category
promotion_rules:
data: []
promotion_actions:
data:
- id: '16'
type: promotion_action
stores:
data:
- id: '361'
type: store
- id: '25'
type: promotion
attributes:
description:
expires_at:
starts_at:
name: Promo
type:
usage_limit:
match_policy: all
code:
advertise: false
path:
created_at: '2021-12-16T15:21:42.168Z'
updated_at: '2021-12-16T15:21:42.171Z'
public_metadata: {}
private_metadata: {}
relationships:
promotion_category:
data:
id: '13'
type: promotion_category
promotion_rules:
data: []
promotion_actions:
data:
- id: '17'
type: promotion_action
stores:
data:
- id: '361'
type: store
- id: '26'
type: promotion
attributes:
description:
expires_at:
starts_at:
name: Promo
type:
usage_limit:
match_policy: all
code:
advertise: false
path:
created_at: '2021-12-16T15:21:42.190Z'
updated_at: '2021-12-16T15:21:42.193Z'
public_metadata: {}
private_metadata: {}
relationships:
promotion_category:
data:
id: '13'
type: promotion_category
promotion_rules:
data:
- id: '12'
type: promotion_rule
promotion_actions:
data:
- id: '18'
type: promotion_action
stores:
data:
- id: '361'
type: store
meta:
count: 4
total_count: 4
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/promotions?page=1&per_page=&include=&filter[code_eq]=&filter[name_cont]=
next: http://www.example.com/api/v2/platform/promotions?filter%5Bcode_eq%5D=&filter%5Bname_cont%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/promotions?filter%5Bcode_eq%5D=&filter%5Bname_cont%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/promotions?filter%5Bcode_eq%5D=&filter%5Bname_cont%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/promotions?filter%5Bcode_eq%5D=&filter%5Bname_cont%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Promotion
tags:
- Promotions
security:
- bearer_auth: []
description: Creates a Promotion
operationId: create-promotion
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: promotion_category,promotion_rules,promotion_actions,stores
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '35'
type: promotion
attributes:
description: First 1000 Customers Save 20%
expires_at: '2021-12-20T15:21:42.690Z'
starts_at: '2021-12-16T15:21:42.690Z'
name: Black Friday 20% Off
type: Spree::Promotion
usage_limit: 1000
match_policy: any
code: BLK-20
advertise: true
path: "/black-fri/today"
created_at: '2021-12-16T15:21:42.894Z'
updated_at: '2021-12-16T15:21:42.900Z'
public_metadata: {}
private_metadata: {}
relationships:
promotion_category:
data:
id: '15'
type: promotion_category
promotion_rules:
data: []
promotion_actions:
data: []
stores:
data:
- id: '368'
type: store
- id: '369'
type: store
- id: '367'
type: store
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_promotion_params"
"/api/v2/platform/promotions/{id}":
get:
summary: Return a Promotion
tags:
- Promotions
security:
- bearer_auth: []
description: Returns a Promotion
operationId: show-promotion
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: promotion_category,promotion_rules,promotion_actions,stores
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '44'
type: promotion
attributes:
description:
expires_at:
starts_at:
name: Promo
type:
usage_limit:
match_policy: all
code:
advertise: false
path:
created_at: '2021-12-16T15:21:43.386Z'
updated_at: '2021-12-16T15:21:43.389Z'
public_metadata: {}
private_metadata: {}
relationships:
promotion_category:
data:
id: '17'
type: promotion_category
promotion_rules:
data:
- id: '16'
type: promotion_rule
promotion_actions:
data:
- id: '31'
type: promotion_action
stores:
data:
- id: '373'
type: store
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Promotion
tags:
- Promotions
security:
- bearer_auth: []
description: Updates a Promotion
operationId: update-promotion
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: promotion_category,promotion_rules,promotion_actions,stores
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '58'
type: promotion
attributes:
description: This is the new updated promo
expires_at:
starts_at:
name: 10% OFF
type:
usage_limit:
match_policy: all
code: RAND-10
advertise: false
path:
created_at: '2021-12-16T15:21:44.223Z'
updated_at: '2021-12-16T15:21:44.427Z'
public_metadata: {}
private_metadata: {}
relationships:
promotion_category:
data:
id: '20'
type: promotion_category
promotion_rules:
data:
- id: '19'
type: promotion_rule
promotion_actions:
data:
- id: '42'
type: promotion_action
stores:
data:
- id: '382'
type: store
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
oneOf:
- "$ref": "#/components/schemas/update_promotion_params"
- "$ref": "#/components/schemas/update_promotion_add_rule_params"
- "$ref": "#/components/schemas/update_promotion_update_rule_params"
- "$ref": "#/components/schemas/update_promotion_add_action_params"
- "$ref": "#/components/schemas/update_promotion_change_action_params"
- "$ref": "#/components/schemas/update_promotion_action_calculator_params"
- "$ref": "#/components/schemas/update_promotion_change_calculator_params"
delete:
summary: Delete a Promotion
tags:
- Promotions
security:
- bearer_auth: []
description: Deletes a Promotion
operationId: delete-promotion
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/roles":
get:
summary: Return a list of Roles
tags:
- Roles
security:
- bearer_auth: []
description: Returns a list of Roles
operationId: roles-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: filter[name_eq]
in: query
description: ''
example: admin
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '1'
type: role
attributes:
name: 'Role #1'
created_at: '2021-12-16T15:21:46.199Z'
updated_at: '2021-12-16T15:21:46.199Z'
- id: '2'
type: role
attributes:
name: 'Role #2'
created_at: '2021-12-16T15:21:46.201Z'
updated_at: '2021-12-16T15:21:46.201Z'
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/roles?page=1&per_page=&filter[name_eq]=
next: http://www.example.com/api/v2/platform/roles?filter%5Bname_eq%5D=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/roles?filter%5Bname_eq%5D=&page=1&per_page=
last: http://www.example.com/api/v2/platform/roles?filter%5Bname_eq%5D=&page=1&per_page=
first: http://www.example.com/api/v2/platform/roles?filter%5Bname_eq%5D=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Role
tags:
- Roles
security:
- bearer_auth: []
description: Creates a Role
operationId: create-role
parameters: []
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '5'
type: role
attributes:
name: 'Role #5'
created_at: '2021-12-16T15:21:46.660Z'
updated_at: '2021-12-16T15:21:46.660Z'
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_role_params"
"/api/v2/platform/roles/{id}":
get:
summary: Return a Role
tags:
- Roles
security:
- bearer_auth: []
description: Returns a Role
operationId: show-role
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '6'
type: role
attributes:
name: 'Role #6'
created_at: '2021-12-16T15:21:46.904Z'
updated_at: '2021-12-16T15:21:46.904Z'
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Role
tags:
- Roles
security:
- bearer_auth: []
description: Updates a Role
operationId: update-role
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '8'
type: role
attributes:
name: administrator
created_at: '2021-12-16T15:21:47.368Z'
updated_at: '2021-12-16T15:21:47.556Z'
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_role_params"
delete:
summary: Delete a Role
tags:
- Roles
security:
- bearer_auth: []
description: Deletes a Role
operationId: delete-role
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/shipments":
get:
summary: Return a list of Shipments
tags:
- Shipments
security:
- bearer_auth: []
description: Returns a list of Shipments
operationId: shipments-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
- name: filter[state_eq]
in: query
description: ''
example: complete
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '28'
type: shipment
attributes:
tracking: U10000
number: H34388615237
cost: '100.0'
shipped_at:
state: pending
created_at: '2021-12-16T15:21:48.665Z'
updated_at: '2021-12-16T15:21:48.670Z'
adjustment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
included_tax_total: '0.0'
pre_tax_amount: '0.0'
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
public_metadata: {}
private_metadata: {}
display_discounted_cost: "$100.00"
display_item_cost: "$0.00"
display_amount: "$100.00"
display_final_price: "$100.00"
display_cost: "$100.00"
tracking_url:
relationships:
order:
data:
id: '78'
type: order
address:
data:
stock_location:
data:
id: '124'
type: stock_location
adjustments:
data: []
inventory_units:
data: []
shipping_rates:
data:
- id: '30'
type: shipping_rate
state_changes:
data: []
selected_shipping_rate:
data:
id: '30'
type: shipping_rate
- id: '29'
type: shipment
attributes:
tracking: U10000
number: H33721918326
cost: '100.0'
shipped_at:
state: pending
created_at: '2021-12-16T15:21:48.716Z'
updated_at: '2021-12-16T15:21:48.720Z'
adjustment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
included_tax_total: '0.0'
pre_tax_amount: '0.0'
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
public_metadata: {}
private_metadata: {}
display_discounted_cost: "$100.00"
display_item_cost: "$0.00"
display_amount: "$100.00"
display_final_price: "$100.00"
display_cost: "$100.00"
tracking_url:
relationships:
order:
data:
id: '79'
type: order
address:
data:
stock_location:
data:
id: '125'
type: stock_location
adjustments:
data: []
inventory_units:
data: []
shipping_rates:
data:
- id: '31'
type: shipping_rate
state_changes:
data: []
selected_shipping_rate:
data:
id: '31'
type: shipping_rate
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/shipments?page=1&per_page=&include=&filter[state_eq]=
next: http://www.example.com/api/v2/platform/shipments?filter%5Bstate_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/shipments?filter%5Bstate_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/shipments?filter%5Bstate_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/shipments?filter%5Bstate_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Shipment
tags:
- Shipments
security:
- bearer_auth: []
description: Creates a Shipment
operationId: create-shipment
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '32'
type: shipment
attributes:
tracking:
number: H45409435945
cost: '0.0'
shipped_at:
state: pending
created_at: '2021-12-16T15:21:49.514Z'
updated_at: '2021-12-16T15:21:49.535Z'
adjustment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
included_tax_total: '0.0'
pre_tax_amount: '0.0'
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
public_metadata: {}
private_metadata: {}
display_discounted_cost: "$0.00"
display_item_cost: "$19.99"
display_amount: "$0.00"
display_final_price: "$0.00"
display_cost: "$0.00"
tracking_url:
relationships:
order:
data:
id: '82'
type: order
address:
data:
stock_location:
data:
id: '128'
type: stock_location
adjustments:
data: []
inventory_units:
data:
- id: '28'
type: inventory_unit
shipping_rates:
data: []
state_changes:
data: []
selected_shipping_rate:
data:
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: order_not_found
errors: {}
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_shipment_params"
"/api/v2/platform/shipments/{id}":
get:
summary: Return a Shipment
tags:
- Shipments
security:
- bearer_auth: []
description: Returns a Shipment
operationId: show-shipment
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '34'
type: shipment
attributes:
tracking: U10000
number: H13919587516
cost: '100.0'
shipped_at:
state: pending
created_at: '2021-12-16T15:21:50.128Z'
updated_at: '2021-12-16T15:21:50.156Z'
adjustment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
included_tax_total: '0.0'
pre_tax_amount: '0.0'
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
public_metadata: {}
private_metadata: {}
display_discounted_cost: "$100.00"
display_item_cost: "$10.00"
display_amount: "$100.00"
display_final_price: "$100.00"
display_cost: "$100.00"
tracking_url:
relationships:
order:
data:
id: '83'
type: order
address:
data:
stock_location:
data:
id: '131'
type: stock_location
adjustments:
data: []
inventory_units:
data:
- id: '30'
type: inventory_unit
shipping_rates:
data:
- id: '37'
type: shipping_rate
state_changes:
data: []
selected_shipping_rate:
data:
id: '37'
type: shipping_rate
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Shipment
tags:
- Shipments
security:
- bearer_auth: []
description: Updates a Shipment
operationId: update-shipment
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '38'
type: shipment
attributes:
tracking: MY-TRACKING-NUMBER-1234
number: H10633621568
cost: '100.0'
shipped_at:
state: pending
created_at: '2021-12-16T15:21:51.214Z'
updated_at: '2021-12-16T15:21:51.431Z'
adjustment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
included_tax_total: '0.0'
pre_tax_amount: '0.0'
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
public_metadata: {}
private_metadata: {}
display_discounted_cost: "$100.00"
display_item_cost: "$10.00"
display_amount: "$100.00"
display_final_price: "$100.00"
display_cost: "$100.00"
tracking_url:
relationships:
order:
data:
id: '85'
type: order
address:
data:
stock_location:
data:
id: '137'
type: stock_location
adjustments:
data: []
inventory_units:
data:
- id: '34'
type: inventory_unit
shipping_rates:
data:
- id: '45'
type: shipping_rate
state_changes:
data: []
selected_shipping_rate:
data:
id: '45'
type: shipping_rate
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Stock location can't be blank
errors:
stock_location:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_shipment_params"
delete:
summary: Delete a Shipment
tags:
- Shipments
security:
- bearer_auth: []
description: Deletes a Shipment
operationId: delete-shipment
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/shipments/{id}/add_item":
patch:
summary: Adds item (Variant) to an existing Shipment
tags:
- Shipments
security:
- bearer_auth: []
description: If selected Variant was already added to Order it will increase
the quantity of existing Line Item, if not it will create a new Line Item
operationId: add-item-shipment
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '48'
type: shipment
attributes:
tracking: U10000
number: H77433939045
cost: '0.0'
shipped_at:
state: pending
created_at: '2021-12-16T15:21:54.127Z'
updated_at: '2021-12-16T15:21:54.491Z'
adjustment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
included_tax_total: '0.0'
pre_tax_amount: '0.0'
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
public_metadata: {}
private_metadata: {}
display_discounted_cost: "$0.00"
display_item_cost: "$29.99"
display_amount: "$0.00"
display_final_price: "$0.00"
display_cost: "$0.00"
tracking_url:
relationships:
order:
data:
id: '90'
type: order
address:
data:
stock_location:
data:
id: '152'
type: stock_location
adjustments:
data: []
inventory_units:
data:
- id: '44'
type: inventory_unit
- id: '45'
type: inventory_unit
shipping_rates:
data:
- id: '76'
type: shipping_rate
- id: '77'
type: shipping_rate
state_changes:
data: []
selected_shipping_rate:
data:
id: '77'
type: shipping_rate
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/add_item_shipment_params"
"/api/v2/platform/shipments/{id}/remove_item":
patch:
summary: Removes item (Variant) from Shipment
tags:
- Shipments
security:
- bearer_auth: []
description: If selected Variant is removed completely and Shipment doesn't
include any other Line Items, Shipment itself will be deleted
operationId: remove-item-shipment
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'204':
description: Record deleted
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '54'
type: shipment
attributes:
tracking: U10000
number: H67769958864
cost: '0.0'
shipped_at:
state: pending
created_at: '2021-12-16T15:21:57.005Z'
updated_at: '2021-12-16T15:21:57.437Z'
adjustment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
included_tax_total: '0.0'
pre_tax_amount: '0.0'
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
public_metadata: {}
private_metadata: {}
display_discounted_cost: "$0.00"
display_item_cost: "$10.00"
display_amount: "$0.00"
display_final_price: "$0.00"
display_cost: "$0.00"
tracking_url:
relationships:
order:
data:
id: '93'
type: order
address:
data:
stock_location:
data:
id: '162'
type: stock_location
adjustments:
data: []
inventory_units:
data:
- id: '51'
type: inventory_unit
shipping_rates:
data:
- id: '100'
type: shipping_rate
- id: '101'
type: shipping_rate
state_changes:
data: []
selected_shipping_rate:
data:
id: '97'
type: shipping_rate
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/remove_item_shipment_params"
"/api/v2/platform/shipments/{id}/ready":
patch:
summary: Mark Shipment as ready to be shipped
tags:
- Shipments
security:
- bearer_auth: []
description: Marks Shipment as ready to be shipped
operationId: ready-shipment
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '58'
type: shipment
attributes:
tracking: U10000
number: H63814061900
cost: '100.0'
shipped_at:
state: ready
created_at: '2021-12-16T15:21:58.706Z'
updated_at: '2021-12-16T15:21:58.930Z'
adjustment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
included_tax_total: '0.0'
pre_tax_amount: '0.0'
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
public_metadata: {}
private_metadata: {}
display_discounted_cost: "$100.00"
display_item_cost: "$10.00"
display_amount: "$100.00"
display_final_price: "$100.00"
display_cost: "$100.00"
tracking_url:
relationships:
order:
data:
id: '95'
type: order
address:
data:
stock_location:
data:
id: '168'
type: stock_location
adjustments:
data: []
inventory_units:
data:
- id: '55'
type: inventory_unit
shipping_rates:
data:
- id: '109'
type: shipping_rate
state_changes:
data:
- id: '25'
type: state_change
selected_shipping_rate:
data:
id: '109'
type: shipping_rate
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/shipments/{id}/ship":
patch:
summary: Mark Shipment as shipped
tags:
- Shipments
security:
- bearer_auth: []
description: Marks Shipment as shipped
operationId: ship-shipment
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '62'
type: shipment
attributes:
tracking: U10000
number: H14639821135
cost: '100.0'
shipped_at: '2021-12-16T15:22:00.159Z'
state: shipped
created_at: '2021-12-16T15:21:59.908Z'
updated_at: '2021-12-16T15:22:00.159Z'
adjustment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
included_tax_total: '0.0'
pre_tax_amount: '0.0'
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
public_metadata: {}
private_metadata: {}
display_discounted_cost: "$100.00"
display_item_cost: "$10.00"
display_amount: "$100.00"
display_final_price: "$100.00"
display_cost: "$100.00"
tracking_url:
relationships:
order:
data:
id: '97'
type: order
address:
data:
stock_location:
data:
id: '174'
type: stock_location
adjustments:
data: []
inventory_units:
data:
- id: '59'
type: inventory_unit
shipping_rates:
data:
- id: '117'
type: shipping_rate
state_changes:
data:
- id: '27'
type: state_change
selected_shipping_rate:
data:
id: '117'
type: shipping_rate
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/shipments/{id}/cancel":
patch:
summary: Cancels the Shipment
tags:
- Shipments
security:
- bearer_auth: []
description: Cancels the Shipment
operationId: cancel-shipment
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '66'
type: shipment
attributes:
tracking: U10000
number: H63292298819
cost: '100.0'
shipped_at:
state: canceled
created_at: '2021-12-16T15:22:01.086Z'
updated_at: '2021-12-16T15:22:01.300Z'
adjustment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
included_tax_total: '0.0'
pre_tax_amount: '0.0'
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
public_metadata: {}
private_metadata: {}
display_discounted_cost: "$100.00"
display_item_cost: "$10.00"
display_amount: "$100.00"
display_final_price: "$100.00"
display_cost: "$100.00"
tracking_url:
relationships:
order:
data:
id: '99'
type: order
address:
data:
stock_location:
data:
id: '180'
type: stock_location
adjustments:
data: []
inventory_units:
data:
- id: '63'
type: inventory_unit
shipping_rates:
data:
- id: '125'
type: shipping_rate
state_changes:
data:
- id: '28'
type: state_change
selected_shipping_rate:
data:
id: '125'
type: shipping_rate
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/shipments/{id}/resume":
patch:
summary: Resumes the Shipment
tags:
- Shipments
security:
- bearer_auth: []
description: Resumes previously canceled Shipment
operationId: resume-shipment
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '70'
type: shipment
attributes:
tracking: U10000
number: H27877240588
cost: '100.0'
shipped_at:
state: ready
created_at: '2021-12-16T15:22:02.221Z'
updated_at: '2021-12-16T15:22:02.440Z'
adjustment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
included_tax_total: '0.0'
pre_tax_amount: '0.0'
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
public_metadata: {}
private_metadata: {}
display_discounted_cost: "$100.00"
display_item_cost: "$10.00"
display_amount: "$100.00"
display_final_price: "$100.00"
display_cost: "$100.00"
tracking_url:
relationships:
order:
data:
id: '101'
type: order
address:
data:
stock_location:
data:
id: '186'
type: stock_location
adjustments:
data: []
inventory_units:
data:
- id: '67'
type: inventory_unit
shipping_rates:
data:
- id: '133'
type: shipping_rate
state_changes:
data:
- id: '29'
type: state_change
selected_shipping_rate:
data:
id: '133'
type: shipping_rate
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/shipments/{id}/pend":
patch:
summary: Moves Shipment back to pending state
tags:
- Shipments
security:
- bearer_auth: []
description: Moves Shipment back to pending state
operationId: pend-shipment
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: line_items,variants,product
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '75'
type: shipment
attributes:
tracking: U10000
number: H64414019642
cost: '100.0'
shipped_at:
state: pending
created_at: '2021-12-16T15:22:03.593Z'
updated_at: '2021-12-16T15:22:03.810Z'
adjustment_total: '0.0'
additional_tax_total: '0.0'
promo_total: '0.0'
included_tax_total: '0.0'
pre_tax_amount: '0.0'
taxable_adjustment_total: '0.0'
non_taxable_adjustment_total: '0.0'
public_metadata: {}
private_metadata: {}
display_discounted_cost: "$100.00"
display_item_cost: "$10.00"
display_amount: "$100.00"
display_final_price: "$100.00"
display_cost: "$100.00"
tracking_url:
relationships:
order:
data:
id: '104'
type: order
address:
data:
stock_location:
data:
id: '194'
type: stock_location
adjustments:
data: []
inventory_units:
data:
- id: '72'
type: inventory_unit
shipping_rates:
data:
- id: '144'
type: shipping_rate
state_changes:
data:
- id: '30'
type: state_change
selected_shipping_rate:
data:
id: '144'
type: shipping_rate
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/shipping_categories":
get:
summary: Return a list of Shipping Categories
tags:
- Shipping Categories
security:
- bearer_auth: []
description: Returns a list of Shipping Categories
operationId: shipping-categories-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: filter[name_i_cont]
in: query
description: ''
example: default
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '124'
type: shipping_category
attributes:
name: 'ShippingCategory #124'
created_at: '2021-12-16T15:22:04.541Z'
updated_at: '2021-12-16T15:22:04.541Z'
- id: '125'
type: shipping_category
attributes:
name: 'ShippingCategory #125'
created_at: '2021-12-16T15:22:04.543Z'
updated_at: '2021-12-16T15:22:04.543Z'
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/shipping_categories?page=1&per_page=&filter[name_i_cont]=
next: http://www.example.com/api/v2/platform/shipping_categories?filter%5Bname_i_cont%5D=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/shipping_categories?filter%5Bname_i_cont%5D=&page=1&per_page=
last: http://www.example.com/api/v2/platform/shipping_categories?filter%5Bname_i_cont%5D=&page=1&per_page=
first: http://www.example.com/api/v2/platform/shipping_categories?filter%5Bname_i_cont%5D=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Shipping Category
tags:
- Shipping Categories
security:
- bearer_auth: []
description: Creates a Shipping Category
operationId: create-shipping-category
parameters: []
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '128'
type: shipping_category
attributes:
name: 'ShippingCategory #128'
created_at: '2021-12-16T15:22:05.006Z'
updated_at: '2021-12-16T15:22:05.006Z'
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_shipping_category_params"
"/api/v2/platform/shipping_categories/{id}":
get:
summary: Return a Shipping Category
tags:
- Shipping Categories
security:
- bearer_auth: []
description: Returns a Shipping Category
operationId: show-shipping-category
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '129'
type: shipping_category
attributes:
name: 'ShippingCategory #129'
created_at: '2021-12-16T15:22:05.270Z'
updated_at: '2021-12-16T15:22:05.270Z'
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Shipping Category
tags:
- Shipping Categories
security:
- bearer_auth: []
description: Updates a Shipping Category
operationId: update-shipping-category
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '131'
type: shipping_category
attributes:
name: Default
created_at: '2021-12-16T15:22:05.789Z'
updated_at: '2021-12-16T15:22:05.976Z'
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_shipping_category_params"
delete:
summary: Delete a Shipping Category
tags:
- Shipping Categories
security:
- bearer_auth: []
description: Deletes a Shipping Category
operationId: delete-shipping-category
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/shipping_methods":
get:
summary: Return a list of Shipping Methods
tags:
- Shipping Methods
security:
- bearer_auth: []
description: Returns a list of Shipping Methods
operationId: shipping-methods-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: calculator,shipping_categories,shipping_rates,tax_category
schema:
type: string
- name: filter[name]
in: query
description: ''
example: DHL Express
schema:
type: string
- name: filter[title_cont]
in: query
description: ''
example: About Us
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '77'
type: shipping_method
attributes:
name: UPS Ground
code: UPS_GROUND
admin_name:
display_on: both
tracking_url:
created_at: '2021-12-16T15:22:06.930Z'
updated_at: '2021-12-16T15:22:06.930Z'
deleted_at:
public_metadata: {}
private_metadata: {}
relationships:
shipping_categories:
data:
- id: '136'
type: shipping_category
shipping_rates:
data: []
tax_category:
data:
calculator:
data:
id: '137'
type: calculator
- id: '78'
type: shipping_method
attributes:
name: UPS Ground
code: UPS_GROUND
admin_name:
display_on: both
tracking_url:
created_at: '2021-12-16T15:22:06.948Z'
updated_at: '2021-12-16T15:22:06.948Z'
deleted_at:
public_metadata: {}
private_metadata: {}
relationships:
shipping_categories:
data:
- id: '136'
type: shipping_category
shipping_rates:
data: []
tax_category:
data:
calculator:
data:
id: '138'
type: calculator
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/shipping_methods?page=1&per_page=&include=&filter[name]=&filter[title_cont]=
next: http://www.example.com/api/v2/platform/shipping_methods?filter%5Bname%5D=&filter%5Btitle_cont%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/shipping_methods?filter%5Bname%5D=&filter%5Btitle_cont%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/shipping_methods?filter%5Bname%5D=&filter%5Btitle_cont%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/shipping_methods?filter%5Bname%5D=&filter%5Btitle_cont%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Shipping Method
tags:
- Shipping Methods
security:
- bearer_auth: []
description: Creates a Shipping Method
operationId: create-shipping-method
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: calculator,shipping_categories,shipping_rates,tax_category
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '81'
type: shipping_method
attributes:
name: DHL Express Domestic
code: DDD
admin_name: DHL Express- Zone A
display_on: both
tracking_url:
created_at: '2021-12-16T15:22:07.498Z'
updated_at: '2021-12-16T15:22:07.498Z'
deleted_at:
public_metadata: {}
private_metadata: {}
relationships:
shipping_categories:
data:
- id: '138'
type: shipping_category
shipping_rates:
data: []
tax_category:
data:
id: '133'
type: tax_category
calculator:
data:
id: '141'
type: calculator
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Calculator can't be blank, Name can't be blank, Display
on can't be blank, and You must select at least one shipping
category
errors:
calculator:
- can't be blank
name:
- can't be blank
display_on:
- can't be blank
base:
- You must select at least one shipping category
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_shipping_method_params"
"/api/v2/platform/shipping_methods/{id}":
get:
summary: Return a Shipping Method
tags:
- Shipping Methods
security:
- bearer_auth: []
description: Returns a Shipping Method
operationId: show-shipping-method
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: calculator,shipping_categories,shipping_rates,tax_category
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '82'
type: shipping_method
attributes:
name: UPS Ground
code: UPS_GROUND
admin_name:
display_on: both
tracking_url:
created_at: '2021-12-16T15:22:07.767Z'
updated_at: '2021-12-16T15:22:07.767Z'
deleted_at:
public_metadata: {}
private_metadata: {}
relationships:
shipping_categories:
data:
- id: '139'
type: shipping_category
shipping_rates:
data: []
tax_category:
data:
calculator:
data:
id: '142'
type: calculator
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Shipping Method
tags:
- Shipping Methods
security:
- bearer_auth: []
description: Updates a Shipping Method
operationId: update-shipping-method
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: calculator,shipping_categories,shipping_rates,tax_category
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '84'
type: shipping_method
attributes:
name: FedEx Expedited
code: UPS_GROUND
admin_name:
display_on: both
tracking_url:
created_at: '2021-12-16T15:22:08.276Z'
updated_at: '2021-12-16T15:22:08.491Z'
deleted_at:
public_metadata: {}
private_metadata: {}
relationships:
shipping_categories:
data:
- id: '141'
type: shipping_category
shipping_rates:
data: []
tax_category:
data:
calculator:
data:
id: '145'
type: calculator
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_shipping_method_params"
delete:
summary: Delete a Shipping Method
tags:
- Shipping Methods
security:
- bearer_auth: []
description: Deletes a Shipping Method
operationId: delete-shipping-method
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/states":
get:
summary: Returns a list of States
tags:
- States
security:
- bearer_auth: []
operationId: states-list
description: Returns a list of States
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: country
schema:
type: string
- name: filter[country_id_eq]
in: query
description: ''
example: '4'
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '221'
type: state
attributes:
name: STATE_NAME_221
abbr: STATE_ABBR_221
updated_at: '2021-12-16T15:22:09.574Z'
created_at: '2021-12-16T15:22:09.574Z'
relationships:
country:
data:
id: '380'
type: country
- id: '222'
type: state
attributes:
name: STATE_NAME_222
abbr: STATE_ABBR_222
updated_at: '2021-12-16T15:22:09.576Z'
created_at: '2021-12-16T15:22:09.576Z'
relationships:
country:
data:
id: '380'
type: country
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/states?page=1&per_page=&include=&filter[country_id_eq]=
next: http://www.example.com/api/v2/platform/states?filter%5Bcountry_id_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/states?filter%5Bcountry_id_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/states?filter%5Bcountry_id_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/states?filter%5Bcountry_id_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/states/{id}":
get:
summary: Returns a State
tags:
- States
security:
- bearer_auth: []
operationId: show-state
description: Returns a State
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '225'
type: state
attributes:
name: STATE_NAME_225
abbr: STATE_ABBR_225
updated_at: '2021-12-16T15:22:09.847Z'
created_at: '2021-12-16T15:22:09.847Z'
relationships:
country:
data:
id: '382'
type: country
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/stock_items":
get:
summary: Return a list of Stock Items
tags:
- Stock Items
security:
- bearer_auth: []
description: Returns a list of Stock Items
operationId: stock-items-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: stock_location,variant
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '335'
type: stock_item
attributes:
count_on_hand: 0
created_at: '2021-12-16T15:22:10.364Z'
updated_at: '2021-12-16T15:22:10.425Z'
backorderable: false
deleted_at:
is_available: false
relationships:
stock_location:
data:
id: '198'
type: stock_location
variant:
data:
id: '259'
type: variant
- id: '336'
type: stock_item
attributes:
count_on_hand: 10
created_at: '2021-12-16T15:22:10.437Z'
updated_at: '2021-12-16T15:22:10.453Z'
backorderable: true
deleted_at:
is_available: true
relationships:
stock_location:
data:
id: '198'
type: stock_location
variant:
data:
id: '260'
type: variant
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/stock_items?page=1&per_page=&include=
next: http://www.example.com/api/v2/platform/stock_items?include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/stock_items?include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/stock_items?include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/stock_items?include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Stock Item
tags:
- Stock Items
security:
- bearer_auth: []
description: Creates a Stock Item
operationId: create-stock-item
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: stock_location,variant
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '341'
type: stock_item
attributes:
count_on_hand: 0
created_at: '2021-12-16T15:22:11.210Z'
updated_at: '2021-12-16T15:22:11.210Z'
backorderable: false
deleted_at:
is_available: false
relationships:
stock_location:
data:
id: '201'
type: stock_location
variant:
data:
id: '264'
type: variant
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Stock location can't be blank and Variant can't be blank
errors:
stock_location:
- can't be blank
variant:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_stock_item_params"
"/api/v2/platform/stock_items/{id}":
get:
summary: Return a Stock Item
tags:
- Stock Items
security:
- bearer_auth: []
description: Returns a Stock Item
operationId: show-stock-item
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: stock_location,variant
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '343'
type: stock_item
attributes:
count_on_hand: 10
created_at: '2021-12-16T15:22:11.560Z'
updated_at: '2021-12-16T15:22:11.584Z'
backorderable: true
deleted_at:
is_available: true
relationships:
stock_location:
data:
id: '203'
type: stock_location
variant:
data:
id: '265'
type: variant
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Stock Item
tags:
- Stock Items
security:
- bearer_auth: []
description: Updates a Stock Item
operationId: update-stock-item
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: stock_location,variant
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '347'
type: stock_item
attributes:
count_on_hand: 200
created_at: '2021-12-16T15:22:12.247Z'
updated_at: '2021-12-16T15:22:12.467Z'
backorderable: true
deleted_at:
is_available: true
relationships:
stock_location:
data:
id: '207'
type: stock_location
variant:
data:
id: '267'
type: variant
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Variant can't be blank
errors:
variant:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_stock_item_params"
delete:
summary: Delete a Stock Item
tags:
- Stock Items
security:
- bearer_auth: []
description: Deletes a Stock Item
operationId: delete-stock-item
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/stock_locations":
get:
summary: Return a list of Stock Locations
tags:
- Stock Locations
security:
- bearer_auth: []
description: Returns a list of Stock Locations
operationId: stock-locations-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: country
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '216'
type: stock_location
attributes:
name: Audrie Franecki
created_at: '2021-12-16T15:22:13.982Z'
updated_at: '2021-12-16T15:22:13.982Z'
default: false
address1: 1600 Pennsylvania Ave NW
address2:
city: Washington
state_name:
zipcode: '20500'
phone: "(202) 456-1111"
active: true
backorderable_default: true
propagate_all_variants: true
admin_name:
relationships:
country:
data:
id: '399'
type: country
- id: '217'
type: stock_location
attributes:
name: Jessia Ruecker
created_at: '2021-12-16T15:22:13.986Z'
updated_at: '2021-12-16T15:22:13.986Z'
default: false
address1: 1600 Pennsylvania Ave NW
address2:
city: Washington
state_name:
zipcode: '20500'
phone: "(202) 456-1111"
active: true
backorderable_default: true
propagate_all_variants: true
admin_name:
relationships:
country:
data:
id: '399'
type: country
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/stock_locations?page=1&per_page=&include=
next: http://www.example.com/api/v2/platform/stock_locations?include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/stock_locations?include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/stock_locations?include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/stock_locations?include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Stock Location
tags:
- Stock Locations
security:
- bearer_auth: []
description: Creates a Stock Location
operationId: create-stock-location
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: country
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '220'
type: stock_location
attributes:
name: Nella Jerde
created_at: '2021-12-16T15:22:14.478Z'
updated_at: '2021-12-16T15:22:14.478Z'
default: false
address1: 1600 Pennsylvania Ave NW
address2:
city: Washington
state_name:
zipcode: '20500'
phone: "(202) 456-1111"
active: true
backorderable_default: true
propagate_all_variants: true
admin_name:
relationships:
country:
data:
id: '401'
type: country
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_stock_location_params"
"/api/v2/platform/stock_locations/{id}":
get:
summary: Return a Stock Location
tags:
- Stock Locations
security:
- bearer_auth: []
description: Returns a Stock Location
operationId: show-stock-location
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: country
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '221'
type: stock_location
attributes:
name: Bess Grant
created_at: '2021-12-16T15:22:14.740Z'
updated_at: '2021-12-16T15:22:14.740Z'
default: false
address1: 1600 Pennsylvania Ave NW
address2:
city: Washington
state_name:
zipcode: '20500'
phone: "(202) 456-1111"
active: true
backorderable_default: true
propagate_all_variants: true
admin_name:
relationships:
country:
data:
id: '403'
type: country
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Stock Location
tags:
- Stock Locations
security:
- bearer_auth: []
description: Updates a Stock Location
operationId: update-stock-location
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: country
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '223'
type: stock_location
attributes:
name: Warehouse 3
created_at: '2021-12-16T15:22:15.263Z'
updated_at: '2021-12-16T15:22:15.464Z'
default: true
address1: South Street 8/2
address2:
city: Los Angeles
state_name:
zipcode: '11223'
phone: "(202) 456-1111"
active: true
backorderable_default: true
propagate_all_variants: true
admin_name:
relationships:
country:
data:
id: '406'
type: country
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_stock_location_params"
delete:
summary: Delete a Stock Location
tags:
- Stock Locations
security:
- bearer_auth: []
description: Deletes a Stock Location
operationId: delete-stock-location
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/store_credit_categories":
get:
summary: Return a list of Store Credit Categories
tags:
- Store Credit Categories
security:
- bearer_auth: []
description: Returns a list of Store Credit Categories
operationId: store-credit-categories-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: filter[name_eq]
in: query
description: ''
example: refunded
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '2'
type: store_credit_category
attributes:
name: Exchange
created_at: '2021-12-16T15:22:16.494Z'
updated_at: '2021-12-16T15:22:16.494Z'
- id: '3'
type: store_credit_category
attributes:
name: Exchange
created_at: '2021-12-16T15:22:16.495Z'
updated_at: '2021-12-16T15:22:16.495Z'
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/store_credit_categories?page=1&per_page=&filter[name_eq]=
next: http://www.example.com/api/v2/platform/store_credit_categories?filter%5Bname_eq%5D=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/store_credit_categories?filter%5Bname_eq%5D=&page=1&per_page=
last: http://www.example.com/api/v2/platform/store_credit_categories?filter%5Bname_eq%5D=&page=1&per_page=
first: http://www.example.com/api/v2/platform/store_credit_categories?filter%5Bname_eq%5D=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Store Credit Category
tags:
- Store Credit Categories
security:
- bearer_auth: []
description: Creates a Store Credit Category
operationId: create-store-credit-category
parameters: []
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '6'
type: store_credit_category
attributes:
name: Exchange
created_at: '2021-12-16T15:22:16.987Z'
updated_at: '2021-12-16T15:22:16.987Z'
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_store_credit_category_params"
"/api/v2/platform/store_credit_categories/{id}":
get:
summary: Return a Store Credit Category
tags:
- Store Credit Categories
security:
- bearer_auth: []
description: Returns a Store Credit Category
operationId: show-store-credit-category
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '7'
type: store_credit_category
attributes:
name: Exchange
created_at: '2021-12-16T15:22:17.256Z'
updated_at: '2021-12-16T15:22:17.256Z'
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Store Credit Category
tags:
- Store Credit Categories
security:
- bearer_auth: []
description: Updates a Store Credit Category
operationId: update-store-credit-category
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '9'
type: store_credit_category
attributes:
name: refunded
created_at: '2021-12-16T15:22:17.819Z'
updated_at: '2021-12-16T15:22:18.166Z'
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_store_credit_category_params"
delete:
summary: Delete a Store Credit Category
tags:
- Store Credit Categories
security:
- bearer_auth: []
description: Deletes a Store Credit Category
operationId: delete-store-credit-category
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/store_credit_types":
get:
summary: Return a list of Store Credit Types
tags:
- Store Credit Types
security:
- bearer_auth: []
description: Returns a list of Store Credit Types
operationId: store-credit-types-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '2'
type: store_credit_type
attributes:
name: Expiring
priority: 1
created_at: '2021-12-16T15:22:19.428Z'
updated_at: '2021-12-16T15:22:19.428Z'
- id: '3'
type: store_credit_type
attributes:
name: Expiring
priority: 1
created_at: '2021-12-16T15:22:19.429Z'
updated_at: '2021-12-16T15:22:19.429Z'
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/store_credit_types?page=1&per_page=
next: http://www.example.com/api/v2/platform/store_credit_types?page=1&per_page=
prev: http://www.example.com/api/v2/platform/store_credit_types?page=1&per_page=
last: http://www.example.com/api/v2/platform/store_credit_types?page=1&per_page=
first: http://www.example.com/api/v2/platform/store_credit_types?page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Store Credit Type
tags:
- Store Credit Types
security:
- bearer_auth: []
description: Creates a Store Credit Type
operationId: create-store-credit-type
parameters: []
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '6'
type: store_credit_type
attributes:
name: Expiring
priority: 1
created_at: '2021-12-16T15:22:19.885Z'
updated_at: '2021-12-16T15:22:19.885Z'
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_store_credit_type_params"
"/api/v2/platform/store_credit_types/{id}":
get:
summary: Return a Store Credit Type
tags:
- Store Credit Types
security:
- bearer_auth: []
description: Returns a Store Credit Type
operationId: show-store-credit-type
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '7'
type: store_credit_type
attributes:
name: Expiring
priority: 1
created_at: '2021-12-16T15:22:20.138Z'
updated_at: '2021-12-16T15:22:20.138Z'
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Store Credit Type
tags:
- Store Credit Types
security:
- bearer_auth: []
description: Updates a Store Credit Type
operationId: update-store-credit-type
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '9'
type: store_credit_type
attributes:
name: default
priority: 1
created_at: '2021-12-16T15:22:20.603Z'
updated_at: '2021-12-16T15:22:20.785Z'
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_store_credit_type_params"
delete:
summary: Delete a Store Credit Type
tags:
- Store Credit Types
security:
- bearer_auth: []
description: Deletes a Store Credit Type
operationId: delete-store-credit-type
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/store_credits":
get:
summary: Return a list of Store Credits
tags:
- Store Credits
security:
- bearer_auth: []
description: Returns a list of Store Credits
operationId: store-credits-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: user,created_by,category,credit_type
schema:
type: string
- name: filter[user_id_eq]
in: query
description: ''
example: '5'
schema:
type: string
- name: filter[created_by_id_eq]
in: query
description: ''
example: '2'
schema:
type: string
- name: filter[amount_gteq]
in: query
description: ''
example: '50.0'
schema:
type: string
- name: filter[currency_eq]
in: query
description: ''
example: USD
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '2'
type: store_credit
attributes:
amount: '150.0'
amount_used: '0.0'
memo:
deleted_at:
currency: USD
amount_authorized: '0.0'
originator_type:
created_at: '2021-12-16T15:22:21.737Z'
updated_at: '2021-12-16T15:22:21.737Z'
public_metadata: {}
private_metadata: {}
display_amount_used: "$0.00"
display_amount: "$150.00"
relationships:
user:
data:
id: '107'
type: user
created_by:
data:
id: '108'
type: user
store_credit_category:
data:
id: '14'
type: store_credit_category
store_credit_type:
data:
id: '14'
type: store_credit_type
store_credit_events:
data:
- id: '3'
type: store_credit_event
- id: '3'
type: store_credit
attributes:
amount: '150.0'
amount_used: '0.0'
memo:
deleted_at:
currency: USD
amount_authorized: '0.0'
originator_type:
created_at: '2021-12-16T15:22:21.751Z'
updated_at: '2021-12-16T15:22:21.751Z'
public_metadata: {}
private_metadata: {}
display_amount_used: "$0.00"
display_amount: "$150.00"
relationships:
user:
data:
id: '107'
type: user
created_by:
data:
id: '109'
type: user
store_credit_category:
data:
id: '15'
type: store_credit_category
store_credit_type:
data:
id: '15'
type: store_credit_type
store_credit_events:
data:
- id: '4'
type: store_credit_event
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/store_credits?page=1&per_page=&include=&filter[user_id_eq]=&filter[created_by_id_eq]=&filter[amount_gteq]=&filter[currency_eq]=
next: http://www.example.com/api/v2/platform/store_credits?filter%5Bamount_gteq%5D=&filter%5Bcreated_by_id_eq%5D=&filter%5Bcurrency_eq%5D=&filter%5Buser_id_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/store_credits?filter%5Bamount_gteq%5D=&filter%5Bcreated_by_id_eq%5D=&filter%5Bcurrency_eq%5D=&filter%5Buser_id_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/store_credits?filter%5Bamount_gteq%5D=&filter%5Bcreated_by_id_eq%5D=&filter%5Bcurrency_eq%5D=&filter%5Buser_id_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/store_credits?filter%5Bamount_gteq%5D=&filter%5Bcreated_by_id_eq%5D=&filter%5Bcurrency_eq%5D=&filter%5Buser_id_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Store Credit
tags:
- Store Credits
security:
- bearer_auth: []
description: Creates a Store Credit
operationId: create-store-credit
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: user,created_by,category,credit_type
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '6'
type: store_credit
attributes:
amount: '150.0'
amount_used: '0.0'
memo:
deleted_at:
currency: USD
amount_authorized: '0.0'
originator_type:
created_at: '2021-12-16T15:22:22.280Z'
updated_at: '2021-12-16T15:22:22.280Z'
public_metadata: {}
private_metadata: {}
display_amount_used: "$0.00"
display_amount: "$150.00"
relationships:
user:
data:
id: '113'
type: user
created_by:
data:
id: '114'
type: user
store_credit_category:
data:
id: '18'
type: store_credit_category
store_credit_type:
data:
id: '18'
type: store_credit_type
store_credit_events:
data:
- id: '7'
type: store_credit_event
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: User can't be blank, Category can't be blank, Credit type
can't be blank, Created by can't be blank, Currency can't be
blank, Amount must be greater than 0, Amount used Cannot be
greater than amount., and Amount authorized Exceeds total credits.
errors:
user:
- can't be blank
category:
- can't be blank
credit_type:
- can't be blank
created_by:
- can't be blank
currency:
- can't be blank
amount:
- must be greater than 0
amount_used:
- Cannot be greater than amount.
amount_authorized:
- Exceeds total credits.
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_store_credit_params"
"/api/v2/platform/store_credits/{id}":
get:
summary: Return a Store Credit
tags:
- Store Credits
security:
- bearer_auth: []
description: Returns a Store Credit
operationId: show-store-credit
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: user,created_by,category,credit_type
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '7'
type: store_credit
attributes:
amount: '150.0'
amount_used: '0.0'
memo:
deleted_at:
currency: USD
amount_authorized: '0.0'
originator_type:
created_at: '2021-12-16T15:22:22.570Z'
updated_at: '2021-12-16T15:22:22.570Z'
public_metadata: {}
private_metadata: {}
display_amount_used: "$0.00"
display_amount: "$150.00"
relationships:
user:
data:
id: '115'
type: user
created_by:
data:
id: '116'
type: user
store_credit_category:
data:
id: '19'
type: store_credit_category
store_credit_type:
data:
id: '19'
type: store_credit_type
store_credit_events:
data:
- id: '8'
type: store_credit_event
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Store Credit
tags:
- Store Credits
security:
- bearer_auth: []
description: Updates a Store Credit
operationId: update-store-credit
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: user,created_by,category,credit_type
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '9'
type: store_credit
attributes:
amount: '500.0'
amount_used: '0.0'
memo: The user is awarded
deleted_at:
currency: CAD
amount_authorized: '0.0'
originator_type:
created_at: '2021-12-16T15:22:23.119Z'
updated_at: '2021-12-16T15:22:23.319Z'
public_metadata:
loyalty_reward: true
private_metadata: {}
display_amount_used: "$0.00"
display_amount: "$500.00"
relationships:
user:
data:
id: '119'
type: user
created_by:
data:
id: '120'
type: user
store_credit_category:
data:
id: '21'
type: store_credit_category
store_credit_type:
data:
id: '21'
type: store_credit_type
store_credit_events:
data:
- id: '10'
type: store_credit_event
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Amount must be greater than 0, Amount used Cannot be greater
than amount., and Amount authorized Exceeds total credits.
errors:
amount:
- must be greater than 0
amount_used:
- Cannot be greater than amount.
amount_authorized:
- Exceeds total credits.
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_store_credit_params"
delete:
summary: Delete a Store Credit
tags:
- Store Credits
security:
- bearer_auth: []
description: Deletes a Store Credit
operationId: delete-store-credit
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/tax_categories":
get:
summary: Return a list of Tax Categories
tags:
- Tax Categories
security:
- bearer_auth: []
description: Returns a list of Tax Categories
operationId: tax-categories-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: tax_rates
schema:
type: string
- name: filter[name_eq]
in: query
description: ''
example: Clothing
schema:
type: string
- name: filter[is_default_true]
in: query
description: ''
example: '1'
schema:
type: string
- name: filter[tax_code_eq]
in: query
description: ''
example: 1257L
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '144'
type: tax_category
attributes:
name: TaxCategory - 558433
description: Suscipit temporibus laborum quam eum quos voluptatibus
consequuntur assumenda.
is_default: false
deleted_at:
created_at: '2021-12-16T15:22:24.837Z'
updated_at: '2021-12-16T15:22:24.837Z'
tax_code:
relationships:
tax_rates:
data: []
- id: '145'
type: tax_category
attributes:
name: TaxCategory - 481695
description: Earum laboriosam fuga dolorem officiis.
is_default: false
deleted_at:
created_at: '2021-12-16T15:22:24.842Z'
updated_at: '2021-12-16T15:22:24.842Z'
tax_code:
relationships:
tax_rates:
data: []
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/tax_categories?page=1&per_page=&include=&filter[name_eq]=&filter[is_default_true]=&filter[tax_code_eq]=
next: http://www.example.com/api/v2/platform/tax_categories?filter%5Bis_default_true%5D=&filter%5Bname_eq%5D=&filter%5Btax_code_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/tax_categories?filter%5Bis_default_true%5D=&filter%5Bname_eq%5D=&filter%5Btax_code_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/tax_categories?filter%5Bis_default_true%5D=&filter%5Bname_eq%5D=&filter%5Btax_code_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/tax_categories?filter%5Bis_default_true%5D=&filter%5Bname_eq%5D=&filter%5Btax_code_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Tax Category
tags:
- Tax Categories
security:
- bearer_auth: []
description: Creates a Tax Category
operationId: create-tax-category
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: tax_rates
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '148'
type: tax_category
attributes:
name: TaxCategory - 415819
description: Voluptates autem porro iste natus illum officiis.
is_default: false
deleted_at:
created_at: '2021-12-16T15:22:25.390Z'
updated_at: '2021-12-16T15:22:25.390Z'
tax_code:
relationships:
tax_rates:
data: []
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_tax_category_params"
"/api/v2/platform/tax_categories/{id}":
get:
summary: Return a Tax Category
tags:
- Tax Categories
security:
- bearer_auth: []
description: Returns a Tax Category
operationId: show-tax-category
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: tax_rates
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '149'
type: tax_category
attributes:
name: TaxCategory - 101073
description: Blanditiis consequuntur earum mollitia laudantium.
is_default: false
deleted_at:
created_at: '2021-12-16T15:22:25.690Z'
updated_at: '2021-12-16T15:22:25.690Z'
tax_code:
relationships:
tax_rates:
data: []
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Tax Category
tags:
- Tax Categories
security:
- bearer_auth: []
description: Updates a Tax Category
operationId: update-tax-category
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: tax_rates
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '151'
type: tax_category
attributes:
name: Clothing
description: Men's, women's and children's clothing
is_default: true
deleted_at:
created_at: '2021-12-16T15:22:26.201Z'
updated_at: '2021-12-16T15:22:26.406Z'
tax_code: 1233K
relationships:
tax_rates:
data: []
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_tax_category_params"
delete:
summary: Delete a Tax Category
tags:
- Tax Categories
security:
- bearer_auth: []
description: Deletes a Tax Category
operationId: delete-tax-category
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/tax_rates":
get:
summary: Return a list of Tax Rates
tags:
- Tax Rates
security:
- bearer_auth: []
description: Returns a list of Tax Rates
operationId: tax-rates-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: zone,tax_category
schema:
type: string
- name: filter[zone_id_eq]
in: query
description: ''
example: '3'
schema:
type: string
- name: filter[amount_gt]
in: query
description: ''
example: '0.05'
schema:
type: string
- name: filter[tax_category_id_eq]
in: query
description: ''
example: '1'
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '12'
type: tax_rate
attributes:
amount: '0.1'
included_in_price: false
created_at: '2021-12-16T15:22:27.427Z'
updated_at: '2021-12-16T15:22:27.427Z'
name: TaxRate - 280805
show_rate_in_label: true
deleted_at:
relationships:
zone:
data:
id: '99'
type: zone
tax_category:
data:
id: '156'
type: tax_category
- id: '13'
type: tax_rate
attributes:
amount: '0.1'
included_in_price: false
created_at: '2021-12-16T15:22:27.433Z'
updated_at: '2021-12-16T15:22:27.433Z'
name: TaxRate - 846289
show_rate_in_label: true
deleted_at:
relationships:
zone:
data:
id: '100'
type: zone
tax_category:
data:
id: '156'
type: tax_category
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/tax_rates?page=1&per_page=&include=&filter[zone_id_eq]=&filter[amount_gt]=&filter[tax_category_id_eq]=
next: http://www.example.com/api/v2/platform/tax_rates?filter%5Bamount_gt%5D=&filter%5Btax_category_id_eq%5D=&filter%5Bzone_id_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/tax_rates?filter%5Bamount_gt%5D=&filter%5Btax_category_id_eq%5D=&filter%5Bzone_id_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/tax_rates?filter%5Bamount_gt%5D=&filter%5Btax_category_id_eq%5D=&filter%5Bzone_id_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/tax_rates?filter%5Bamount_gt%5D=&filter%5Btax_category_id_eq%5D=&filter%5Bzone_id_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Tax Rate
tags:
- Tax Rates
security:
- bearer_auth: []
description: Creates a Tax Rate
operationId: create-tax-rate
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: zone,tax_category
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '16'
type: tax_rate
attributes:
amount: '0.1'
included_in_price: false
created_at: '2021-12-16T15:22:27.936Z'
updated_at: '2021-12-16T15:22:27.936Z'
name: TaxRate - 582932
show_rate_in_label: true
deleted_at:
relationships:
zone:
data:
tax_category:
data:
id: '158'
type: tax_category
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Calculator can't be blank, Rate can't be blank, Tax category
can't be blank, and Name can't be blank
errors:
calculator:
- can't be blank
amount:
- can't be blank
tax_category:
- can't be blank
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_tax_rate_params"
"/api/v2/platform/tax_rates/{id}":
get:
summary: Return a Tax Rate
tags:
- Tax Rates
security:
- bearer_auth: []
description: Returns a Tax Rate
operationId: show-tax-rate
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: zone,tax_category
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '17'
type: tax_rate
attributes:
amount: '0.1'
included_in_price: false
created_at: '2021-12-16T15:22:28.211Z'
updated_at: '2021-12-16T15:22:28.211Z'
name: TaxRate - 779703
show_rate_in_label: true
deleted_at:
relationships:
zone:
data:
id: '103'
type: zone
tax_category:
data:
id: '159'
type: tax_category
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Tax Rate
tags:
- Tax Rates
security:
- bearer_auth: []
description: Updates a Tax Rate
operationId: update-tax-rate
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: zone,tax_category
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '19'
type: tax_rate
attributes:
amount: '25.9'
included_in_price: true
created_at: '2021-12-16T15:22:28.813Z'
updated_at: '2021-12-16T15:22:29.021Z'
name: TaxRate - 987069
show_rate_in_label: true
deleted_at:
relationships:
zone:
data:
id: '106'
type: zone
tax_category:
data:
id: '161'
type: tax_category
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Rate can't be blank
errors:
amount:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_tax_rate_params"
delete:
summary: Delete a Tax Rate
tags:
- Tax Rates
security:
- bearer_auth: []
description: Deletes a Tax Rate
operationId: delete-tax-rate
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/taxonomies":
get:
summary: Return a list of Taxonomies
tags:
- Taxonomies
security:
- bearer_auth: []
description: Returns a list of Taxonomies
operationId: taxonomies-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: taxons,root
schema:
type: string
- name: filter[name_eq]
in: query
description: ''
example: Categories
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '13'
type: taxonomy
attributes:
name: taxonomy_13
created_at: '2021-12-16T15:22:30.103Z'
updated_at: '2021-12-16T15:22:30.122Z'
position: 1
public_metadata: {}
private_metadata: {}
relationships:
taxons:
data:
- id: '25'
type: taxon
root:
data:
id: '25'
type: taxon
- id: '14'
type: taxonomy
attributes:
name: taxonomy_14
created_at: '2021-12-16T15:22:30.125Z'
updated_at: '2021-12-16T15:22:30.144Z'
position: 2
public_metadata: {}
private_metadata: {}
relationships:
taxons:
data:
- id: '26'
type: taxon
root:
data:
id: '26'
type: taxon
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/taxonomies?page=1&per_page=&include=&filter[name_eq]=
next: http://www.example.com/api/v2/platform/taxonomies?filter%5Bname_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/taxonomies?filter%5Bname_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/taxonomies?filter%5Bname_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/taxonomies?filter%5Bname_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Taxonomy
tags:
- Taxonomies
security:
- bearer_auth: []
description: Creates a Taxonomy
operationId: create-taxonomy
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: taxons,root
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '17'
type: taxonomy
attributes:
name: taxonomy_17
created_at: '2021-12-16T15:22:30.685Z'
updated_at: '2021-12-16T15:22:30.705Z'
position: 1
public_metadata: {}
private_metadata: {}
relationships:
taxons:
data:
- id: '29'
type: taxon
root:
data:
id: '29'
type: taxon
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_taxonomy_params"
"/api/v2/platform/taxonomies/{id}":
get:
summary: Return a Taxonomy
tags:
- Taxonomies
security:
- bearer_auth: []
description: Returns a Taxonomy
operationId: show-taxonomy
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: taxons,root
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '18'
type: taxonomy
attributes:
name: taxonomy_18
created_at: '2021-12-16T15:22:30.978Z'
updated_at: '2021-12-16T15:22:31.001Z'
position: 1
public_metadata: {}
private_metadata: {}
relationships:
taxons:
data:
- id: '30'
type: taxon
root:
data:
id: '30'
type: taxon
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Taxonomy
tags:
- Taxonomies
security:
- bearer_auth: []
description: Updates a Taxonomy
operationId: update-taxonomy
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: taxons,root
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '20'
type: taxonomy
attributes:
name: Categories
created_at: '2021-12-16T15:22:31.736Z'
updated_at: '2021-12-16T15:22:31.968Z'
position: 1
public_metadata:
balanced: true
private_metadata: {}
relationships:
taxons:
data:
- id: '32'
type: taxon
root:
data:
id: '32'
type: taxon
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_taxonomy_params"
delete:
summary: Delete a Taxonomy
tags:
- Taxonomies
security:
- bearer_auth: []
description: Deletes a Taxonomy
operationId: delete-taxonomy
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/taxons":
get:
summary: Return a list of Taxons
tags:
- Taxons
security:
- bearer_auth: []
description: Returns a list of Taxons
operationId: taxons-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: taxonomy,parent,children
schema:
type: string
- name: filter[taxonomy_id_eq]
in: query
description: ''
example: '1'
schema:
type: string
- name: filter[name_cont]
in: query
description: ''
example: Shirts
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '38'
type: taxon
attributes:
position: 0
name: Shorts
permalink: taxonomy-25/shorts
lft: 2
rgt: 3
description:
created_at: '2021-12-16T15:22:33.289Z'
updated_at: '2021-12-16T15:22:33.296Z'
meta_title:
meta_description:
meta_keywords:
depth: 1
public_metadata: {}
private_metadata: {}
pretty_name: taxonomy_25 -> Shorts
seo_title: Shorts
is_root: false
is_child: true
is_leaf: true
relationships:
parent:
data:
id: '37'
type: taxon
taxonomy:
data:
id: '25'
type: taxonomy
children:
data: []
image:
data:
id: '89'
type: taxon_image
- id: '39'
type: taxon
attributes:
position: 0
name: taxon_13
permalink: taxonomy-25/taxon-13
lft: 4
rgt: 5
description:
created_at: '2021-12-16T15:22:33.337Z'
updated_at: '2021-12-16T15:22:33.343Z'
meta_title:
meta_description:
meta_keywords:
depth: 1
public_metadata: {}
private_metadata: {}
pretty_name: taxonomy_25 -> taxon_13
seo_title: taxon_13
is_root: false
is_child: true
is_leaf: true
relationships:
parent:
data:
id: '37'
type: taxon
taxonomy:
data:
id: '25'
type: taxonomy
children:
data: []
image:
data:
id: '90'
type: taxon_image
- id: '40'
type: taxon
attributes:
position: 0
name: taxon_14
permalink: taxonomy-25/taxon-14
lft: 6
rgt: 7
description:
created_at: '2021-12-16T15:22:33.396Z'
updated_at: '2021-12-16T15:22:33.402Z'
meta_title:
meta_description:
meta_keywords:
depth: 1
public_metadata: {}
private_metadata: {}
pretty_name: taxonomy_25 -> taxon_14
seo_title: taxon_14
is_root: false
is_child: true
is_leaf: true
relationships:
parent:
data:
id: '37'
type: taxon
taxonomy:
data:
id: '25'
type: taxonomy
children:
data: []
image:
data:
id: '91'
type: taxon_image
- id: '37'
type: taxon
attributes:
position: 0
name: taxonomy_25
permalink: taxonomy-25
lft: 1
rgt: 8
description:
created_at: '2021-12-16T15:22:33.247Z'
updated_at: '2021-12-16T15:22:33.418Z'
meta_title:
meta_description:
meta_keywords:
depth: 0
public_metadata: {}
private_metadata: {}
pretty_name: taxonomy_25
seo_title: taxonomy_25
is_root: true
is_child: false
is_leaf: false
relationships:
parent:
data:
taxonomy:
data:
id: '25'
type: taxonomy
children:
data:
- id: '38'
type: taxon
- id: '39'
type: taxon
- id: '40'
type: taxon
image:
data:
meta:
count: 4
total_count: 4
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/taxons?page=1&per_page=&include=&filter[taxonomy_id_eq]=&filter[name_cont]=
next: http://www.example.com/api/v2/platform/taxons?filter%5Bname_cont%5D=&filter%5Btaxonomy_id_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/taxons?filter%5Bname_cont%5D=&filter%5Btaxonomy_id_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/taxons?filter%5Bname_cont%5D=&filter%5Btaxonomy_id_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/taxons?filter%5Bname_cont%5D=&filter%5Btaxonomy_id_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Taxon
tags:
- Taxons
security:
- bearer_auth: []
description: Creates a Taxon
operationId: create-taxon
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: taxonomy,parent,children
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '47'
type: taxon
attributes:
position: 0
name: taxon_17
permalink: taxonomy-27/taxon-17
lft: 4
rgt: 5
description:
created_at: '2021-12-16T15:22:34.346Z'
updated_at: '2021-12-16T15:22:34.362Z'
meta_title:
meta_description:
meta_keywords:
depth: 1
public_metadata: {}
private_metadata: {}
pretty_name: taxonomy_27 -> taxon_17
seo_title: taxon_17
is_root: false
is_child: true
is_leaf: true
relationships:
parent:
data:
id: '45'
type: taxon
taxonomy:
data:
id: '27'
type: taxonomy
children:
data: []
image:
data:
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank and Taxonomy can't be blank
errors:
name:
- can't be blank
taxonomy:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_taxon_params"
"/api/v2/platform/taxons/{id}":
get:
summary: Return a Taxon
tags:
- Taxons
security:
- bearer_auth: []
description: Returns a Taxon
operationId: show-taxon
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: taxonomy,parent,children
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '52'
type: taxon
attributes:
position: 0
name: taxon_18
permalink: taxonomy-29/taxon-18
lft: 4
rgt: 5
description:
created_at: '2021-12-16T15:22:34.845Z'
updated_at: '2021-12-16T15:22:34.851Z'
meta_title:
meta_description:
meta_keywords:
depth: 1
public_metadata: {}
private_metadata: {}
pretty_name: taxonomy_29 -> taxon_18
seo_title: taxon_18
is_root: false
is_child: true
is_leaf: true
relationships:
parent:
data:
id: '50'
type: taxon
taxonomy:
data:
id: '29'
type: taxonomy
children:
data: []
products:
data: []
image:
data:
id: '98'
type: taxon_image
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Taxon
tags:
- Taxons
security:
- bearer_auth: []
description: Updates a Taxon
operationId: update-taxon
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: taxonomy,parent,children
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '60'
type: taxon
attributes:
position: 0
name: T-Shirts
permalink: taxonomy-32/taxon-20
lft: 4
rgt: 5
description:
created_at: '2021-12-16T15:22:35.890Z'
updated_at: '2021-12-16T15:22:36.211Z'
meta_title:
meta_description:
meta_keywords:
depth: 1
public_metadata:
profitability: 3
private_metadata: {}
pretty_name: taxonomy_32 -> T-Shirts
seo_title: T-Shirts
is_root: false
is_child: true
is_leaf: true
relationships:
parent:
data:
id: '58'
type: taxon
taxonomy:
data:
id: '32'
type: taxonomy
children:
data: []
image:
data:
id: '103'
type: taxon_image
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_taxon_params"
delete:
summary: Delete a Taxon
tags:
- Taxons
security:
- bearer_auth: []
description: Deletes a Taxon
operationId: delete-taxon
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/taxons/{id}/reposition":
patch:
summary: Reposition a Taxon
tags:
- Taxons
security:
- bearer_auth: []
operationId: reposition-taxon
description: Reposition a Taxon
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '79'
type: taxon
attributes:
position: 0
name: taxon_25
permalink: taxonomy-39/shorts/taxon-25
lft: 3
rgt: 4
description:
created_at: '2021-12-16T15:22:37.949Z'
updated_at: '2021-12-16T15:22:38.189Z'
meta_title:
meta_description:
meta_keywords:
depth: 2
public_metadata: {}
private_metadata: {}
pretty_name: taxonomy_39 -> Shorts -> taxon_25
seo_title: taxon_25
is_root: false
is_child: true
is_leaf: true
relationships:
parent:
data:
id: '78'
type: taxon
taxonomy:
data:
id: '39'
type: taxonomy
children:
data: []
image:
data:
id: '115'
type: taxon_image
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/taxon_reposition"
"/api/v2/platform/users":
get:
summary: Return a list of Users
tags:
- Users
security:
- bearer_auth: []
description: Returns a list of Users
operationId: users-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: ship_address,bill_address
schema:
type: string
- name: filter[user_id_eq]
in: query
description: ''
example: '1'
schema:
type: string
- name: filter[email_cont]
in: query
description: ''
example: spree@example.com
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '129'
type: user
attributes:
email: douglass.klein@blickhand.info
created_at: '2021-12-16T15:22:38.665Z'
updated_at: '2021-12-16T15:22:38.665Z'
public_metadata: {}
private_metadata: {}
average_order_value: []
lifetime_value: []
store_credits: []
relationships:
bill_address:
data:
ship_address:
data:
- id: '130'
type: user
attributes:
email: leonie.lowe@mitchell.com
created_at: '2021-12-16T15:22:38.674Z'
updated_at: '2021-12-16T15:22:38.674Z'
public_metadata: {}
private_metadata: {}
average_order_value: []
lifetime_value: []
store_credits: []
relationships:
bill_address:
data:
ship_address:
data:
- id: '131'
type: user
attributes:
email: santina.willms@lind.ca
created_at: '2021-12-16T15:22:38.677Z'
updated_at: '2021-12-16T15:22:38.677Z'
public_metadata: {}
private_metadata: {}
average_order_value: []
lifetime_value: []
store_credits: []
relationships:
bill_address:
data:
ship_address:
data:
meta:
count: 3
total_count: 3
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/users?page=1&per_page=&include=&filter[user_id_eq]=&filter[email_cont]=
next: http://www.example.com/api/v2/platform/users?filter%5Bemail_cont%5D=&filter%5Buser_id_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/users?filter%5Bemail_cont%5D=&filter%5Buser_id_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/users?filter%5Bemail_cont%5D=&filter%5Buser_id_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/users?filter%5Bemail_cont%5D=&filter%5Buser_id_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a User
tags:
- Users
security:
- bearer_auth: []
description: Creates a User
operationId: create-user
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: ship_address,bill_address
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '136'
type: user
attributes:
email: dung@becker.com
created_at: '2021-12-16T15:22:39.195Z'
updated_at: '2021-12-16T15:22:39.195Z'
public_metadata: {}
private_metadata: {}
average_order_value: []
lifetime_value: []
store_credits: []
relationships:
bill_address:
data:
ship_address:
data:
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Bill address belongs to other user
errors:
bill_address_id:
- belongs to other user
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_user_params"
"/api/v2/platform/users/{id}":
get:
summary: Return a User
tags:
- Users
security:
- bearer_auth: []
description: Returns a User
operationId: show-user
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: ship_address,bill_address
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '139'
type: user
attributes:
email: dorothy@oreilly.biz
created_at: '2021-12-16T15:22:39.660Z'
updated_at: '2021-12-16T15:22:39.660Z'
public_metadata: {}
private_metadata: {}
average_order_value: []
lifetime_value: []
store_credits: []
relationships:
bill_address:
data:
ship_address:
data:
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a User
tags:
- Users
security:
- bearer_auth: []
description: Updates a User
operationId: update-user
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: ship_address,bill_address
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '144'
type: user
attributes:
email: john@example.com
created_at: '2021-12-16T15:22:40.209Z'
updated_at: '2021-12-16T15:22:40.427Z'
public_metadata: {}
private_metadata: {}
average_order_value: []
lifetime_value: []
store_credits: []
relationships:
bill_address:
data:
ship_address:
data:
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Bill address belongs to other user
errors:
bill_address_id:
- belongs to other user
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_user_params"
delete:
summary: Delete a User
tags:
- Users
security:
- bearer_auth: []
description: Deletes a User
operationId: delete-user
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/variants":
get:
summary: Return a list of Variants
tags:
- Variants
security:
- bearer_auth: []
description: Returns a list of Variants
operationId: variants-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: product,tax_category,images,digitals
schema:
type: string
- name: filter[product_id_eq]
in: query
description: ''
example: '1'
schema:
type: string
- name: filter[sku_i_cont]
in: query
description: ''
example: SKU123
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '272'
type: variant
attributes:
sku: SKU-272
weight: '0.0'
height:
depth:
deleted_at:
is_master: true
cost_price: '17.0'
position: 1
cost_currency: USD
track_inventory: true
updated_at: '2021-12-16T15:22:41.561Z'
discontinue_on:
created_at: '2021-12-16T15:22:41.561Z'
public_metadata: {}
private_metadata: {}
display_price: "$19.99"
display_compare_at_price:
name: 'Product #202 - 3657'
options_text: ''
total_on_hand: 0
purchasable: true
in_stock: false
backorderable: true
available: true
currency: USD
price: '19.99'
compare_at_price:
relationships:
product:
data:
id: '202'
type: product
tax_category:
data:
digitals:
data: []
images:
data: []
option_values:
data: []
stock_items:
data:
- id: '356'
type: stock_item
stock_locations:
data:
- id: '228'
type: stock_location
- id: '273'
type: variant
attributes:
sku: SKU-273
weight: '127.35'
height: '18.65'
depth: '157.5'
deleted_at:
is_master: false
cost_price: '17.0'
position: 2
cost_currency: USD
track_inventory: true
updated_at: '2021-12-16T15:22:41.616Z'
discontinue_on:
created_at: '2021-12-16T15:22:41.609Z'
public_metadata: {}
private_metadata: {}
display_price: "$19.99"
display_compare_at_price:
name: 'Product #202 - 3657'
options_text: 'Size: S'
total_on_hand: 0
purchasable: true
in_stock: false
backorderable: true
available: true
currency: USD
price: '19.99'
compare_at_price:
relationships:
product:
data:
id: '202'
type: product
tax_category:
data:
digitals:
data: []
images:
data: []
option_values:
data:
- id: '83'
type: option_value
stock_items:
data:
- id: '357'
type: stock_item
stock_locations:
data:
- id: '228'
type: stock_location
- id: '274'
type: variant
attributes:
sku: SKU-274
weight: '99.82'
height: '160.64'
depth: '127.97'
deleted_at:
is_master: false
cost_price: '17.0'
position: 3
cost_currency: USD
track_inventory: true
updated_at: '2021-12-16T15:22:41.655Z'
discontinue_on:
created_at: '2021-12-16T15:22:41.649Z'
public_metadata: {}
private_metadata: {}
display_price: "$19.99"
display_compare_at_price:
name: 'Product #202 - 3657'
options_text: 'Size: S'
total_on_hand: 0
purchasable: true
in_stock: false
backorderable: true
available: true
currency: USD
price: '19.99'
compare_at_price:
relationships:
product:
data:
id: '202'
type: product
tax_category:
data:
digitals:
data: []
images:
data: []
option_values:
data:
- id: '84'
type: option_value
stock_items:
data:
- id: '358'
type: stock_item
stock_locations:
data:
- id: '228'
type: stock_location
meta:
count: 3
total_count: 3
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/variants?page=1&per_page=&include=&filter[product_id_eq]=&filter[sku_i_cont]=
next: http://www.example.com/api/v2/platform/variants?filter%5Bproduct_id_eq%5D=&filter%5Bsku_i_cont%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/variants?filter%5Bproduct_id_eq%5D=&filter%5Bsku_i_cont%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/variants?filter%5Bproduct_id_eq%5D=&filter%5Bsku_i_cont%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/variants?filter%5Bproduct_id_eq%5D=&filter%5Bsku_i_cont%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/variants/{id}":
get:
summary: Return a Variant
tags:
- Variants
security:
- bearer_auth: []
description: Returns a Variant
operationId: show-variant
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: product,tax_category,images,digitals
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '279'
type: variant
attributes:
sku: SKU-279
weight: '131.7'
height: '31.4'
depth: '101.85'
deleted_at:
is_master: false
cost_price: '17.0'
position: 2
cost_currency: USD
track_inventory: true
updated_at: '2021-12-16T15:22:42.255Z'
discontinue_on:
created_at: '2021-12-16T15:22:42.249Z'
public_metadata: {}
private_metadata: {}
display_price: "$19.99"
display_compare_at_price:
name: 'Product #204 - 2477'
options_text: 'Size: S'
total_on_hand: 0
purchasable: true
in_stock: false
backorderable: true
available: true
currency: USD
price: '19.99'
compare_at_price:
relationships:
product:
data:
id: '204'
type: product
tax_category:
data:
digitals:
data: []
images:
data: []
option_values:
data:
- id: '87'
type: option_value
stock_items:
data:
- id: '363'
type: stock_item
stock_locations:
data:
- id: '230'
type: stock_location
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
delete:
summary: Delete a Variant
tags:
- Variants
security:
- bearer_auth: []
description: Deletes a Variant
operationId: delete-variant
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/webhooks/events":
get:
summary: Return a list of Webhook Events
tags:
- Webhook Events
security:
- bearer_auth: []
description: Returns a list of Webhook Events
operationId: webhook-events-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: subscriber
schema:
type: string
- name: filter[name_eq]
in: query
description: ''
example: order.canceled
schema:
type: string
- name: filter[request_errors_cont]
in: query
description: ''
example: google
schema:
type: string
- name: filter[response_code_eq]
in: query
description: ''
example: '200'
schema:
type: string
- name: filter[success_eq]
in: query
description: ''
example: 'true'
schema:
type: string
- name: filter[url_cont]
in: query
description: ''
example: mysite
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '1'
type: event
attributes:
execution_time: 40486
name: order.canceled
request_errors: ''
response_code: '200'
success: true
url: https://www.url1.com/
created_at: '2021-12-16T15:22:43.898Z'
updated_at: '2021-12-16T15:22:43.898Z'
relationships:
subscriber:
data:
id: '1'
type: subscriber
- id: '2'
type: event
attributes:
execution_time: 10782
name: order.canceled
request_errors: ''
response_code: '200'
success: true
url: https://www.url2.com/
created_at: '2021-12-16T15:22:43.903Z'
updated_at: '2021-12-16T15:22:43.903Z'
relationships:
subscriber:
data:
id: '2'
type: subscriber
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/webhooks/events?page=1&per_page=&include=&filter[name_eq]=&filter[request_errors_cont]=&filter[response_code_eq]=&filter[success_eq]=&filter[url_cont]=
next: http://www.example.com/api/v2/platform/webhooks/events?filter%5Bname_eq%5D=&filter%5Brequest_errors_cont%5D=&filter%5Bresponse_code_eq%5D=&filter%5Bsuccess_eq%5D=&filter%5Burl_cont%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/webhooks/events?filter%5Bname_eq%5D=&filter%5Brequest_errors_cont%5D=&filter%5Bresponse_code_eq%5D=&filter%5Bsuccess_eq%5D=&filter%5Burl_cont%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/webhooks/events?filter%5Bname_eq%5D=&filter%5Brequest_errors_cont%5D=&filter%5Bresponse_code_eq%5D=&filter%5Bsuccess_eq%5D=&filter%5Burl_cont%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/webhooks/events?filter%5Bname_eq%5D=&filter%5Brequest_errors_cont%5D=&filter%5Bresponse_code_eq%5D=&filter%5Bsuccess_eq%5D=&filter%5Burl_cont%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/webhooks/subscribers":
get:
summary: Return a list of Webhook Subscribers
tags:
- Webhook Subscribers
security:
- bearer_auth: []
description: Returns a list of Webhook Subscribers
operationId: webhook-subscribers-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: filter[active_eq]
in: query
description: ''
example: 'true'
schema:
type: string
- name: filter[url_cont]
in: query
description: ''
example: mysite
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '5'
type: subscriber
attributes:
url: https://www.url5.com/
active: true
subscriptions:
- "*"
created_at: '2021-12-16T15:22:44.194Z'
updated_at: '2021-12-16T15:22:44.194Z'
- id: '6'
type: subscriber
attributes:
url: https://www.url6.com/
active: true
subscriptions:
- "*"
created_at: '2021-12-16T15:22:44.196Z'
updated_at: '2021-12-16T15:22:44.196Z'
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/webhooks/subscribers?page=1&per_page=&filter[active_eq]=&filter[url_cont]=
next: http://www.example.com/api/v2/platform/webhooks/subscribers?filter%5Bactive_eq%5D=&filter%5Burl_cont%5D=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/webhooks/subscribers?filter%5Bactive_eq%5D=&filter%5Burl_cont%5D=&page=1&per_page=
last: http://www.example.com/api/v2/platform/webhooks/subscribers?filter%5Bactive_eq%5D=&filter%5Burl_cont%5D=&page=1&per_page=
first: http://www.example.com/api/v2/platform/webhooks/subscribers?filter%5Bactive_eq%5D=&filter%5Burl_cont%5D=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Webhook Subscriber
tags:
- Webhook Subscribers
security:
- bearer_auth: []
description: Creates a Webhook Subscriber
operationId: create-webhook-subscriber
parameters: []
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '9'
type: subscriber
attributes:
url: https://www.url9.com/
active: true
subscriptions:
- "*"
created_at: '2021-12-16T15:22:44.669Z'
updated_at: '2021-12-16T15:22:44.669Z'
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Url must be a valid URL, Url can't be blank, and Url the
URL must have a path
errors:
url:
- must be a valid URL
- can't be blank
- the URL must have a path
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_webhook_subscriber_params"
"/api/v2/platform/webhooks/subscribers/{id}":
get:
summary: Return a Webhook Subscriber
tags:
- Webhook Subscribers
security:
- bearer_auth: []
description: Returns a Webhook Subscriber
operationId: show-webhook-subscriber
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '10'
type: subscriber
attributes:
url: https://www.url10.com/
active: true
subscriptions:
- "*"
created_at: '2021-12-16T15:22:44.922Z'
updated_at: '2021-12-16T15:22:44.922Z'
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Webhook Subscriber
tags:
- Webhook Subscribers
security:
- bearer_auth: []
description: Updates a Webhook Subscriber
operationId: update-webhook-subscriber
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '12'
type: subscriber
attributes:
url: https://www.url12.com/
active: true
subscriptions:
- "*"
created_at: '2021-12-16T15:22:45.394Z'
updated_at: '2021-12-16T15:22:45.394Z'
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Url must be a valid URL, Url can't be blank, and Url the
URL must have a path
errors:
url:
- must be a valid URL
- can't be blank
- the URL must have a path
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_webhook_subscriber_params"
delete:
summary: Delete a Webhook Subscriber
tags:
- Webhook Subscribers
security:
- bearer_auth: []
description: Deletes a Webhook Subscriber
operationId: delete-webhook-subscriber
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/wished_items":
get:
summary: Return a list of Wished Items
tags:
- Wished Items
security:
- bearer_auth: []
description: Returns a list of Wished Items
operationId: wished-items-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: variant
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '1'
type: wished_item
attributes:
quantity: 1
created_at: '2021-12-16T15:22:46.976Z'
updated_at: '2021-12-16T15:22:46.976Z'
display_total: "$19.99"
display_price: "$19.99"
price: '19.99'
total: '19.99'
relationships:
variant:
data:
id: '289'
type: variant
- id: '2'
type: wished_item
attributes:
quantity: 1
created_at: '2021-12-16T15:22:47.087Z'
updated_at: '2021-12-16T15:22:47.087Z'
display_total: "$19.99"
display_price: "$19.99"
price: '19.99'
total: '19.99'
relationships:
variant:
data:
id: '291'
type: variant
- id: '3'
type: wished_item
attributes:
quantity: 1
created_at: '2021-12-16T15:22:47.178Z'
updated_at: '2021-12-16T15:22:47.178Z'
display_total: "$19.99"
display_price: "$19.99"
price: '19.99'
total: '19.99'
relationships:
variant:
data:
id: '293'
type: variant
- id: '4'
type: wished_item
attributes:
quantity: 1
created_at: '2021-12-16T15:22:47.274Z'
updated_at: '2021-12-16T15:22:47.274Z'
display_total: "$19.99"
display_price: "$19.99"
price: '19.99'
total: '19.99'
relationships:
variant:
data:
id: '295'
type: variant
meta:
count: 4
total_count: 4
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/wished_items?page=1&per_page=&include=
next: http://www.example.com/api/v2/platform/wished_items?include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/wished_items?include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/wished_items?include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/wished_items?include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Wished Item
tags:
- Wished Items
security:
- bearer_auth: []
description: Creates a Wished Item
operationId: create-wished-item
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: variant
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '9'
type: wished_item
attributes:
quantity: 1
created_at: '2021-12-16T15:22:48.380Z'
updated_at: '2021-12-16T15:22:48.380Z'
display_total: "$19.99"
display_price: "$19.99"
price: '19.99'
total: '19.99'
relationships:
variant:
data:
id: '307'
type: variant
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Variant can't be blank, Wishlist can't be blank, and Quantity
is not a number
errors:
variant:
- can't be blank
wishlist:
- can't be blank
quantity:
- is not a number
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_wished_item_params"
"/api/v2/platform/wished_items/{id}":
get:
summary: Return a Wished Item
tags:
- Wished Items
security:
- bearer_auth: []
description: Returns a Wished Item
operationId: show-wished-item
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: variant
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '10'
type: wished_item
attributes:
quantity: 1
created_at: '2021-12-16T15:22:48.982Z'
updated_at: '2021-12-16T15:22:48.982Z'
display_total: "$19.99"
display_price: "$19.99"
price: '19.99'
total: '19.99'
relationships:
variant:
data:
id: '313'
type: variant
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Wished Item
tags:
- Wished Items
security:
- bearer_auth: []
description: Updates a Wished Item
operationId: update-wished-item
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: variant
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '12'
type: wished_item
attributes:
quantity: 3
created_at: '2021-12-16T15:22:50.222Z'
updated_at: '2021-12-16T15:22:50.428Z'
display_total: "$59.97"
display_price: "$19.99"
price: '19.99'
total: '59.97'
relationships:
variant:
data:
id: '323'
type: variant
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Quantity is not a number
errors:
quantity:
- is not a number
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_wished_item_params"
delete:
summary: Delete a Wished Item
tags:
- Wished Items
security:
- bearer_auth: []
description: Deletes a Wished Item
operationId: delete-wished-item
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/wishlists":
get:
summary: Return a list of Wishlists
tags:
- Wishlists
security:
- bearer_auth: []
description: Returns a list of Wishlists
operationId: wishlists-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: wished_items
schema:
type: string
- name: filter[name_cont]
in: query
description: ''
example: Birthday
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '22'
type: wishlist
attributes:
name: Black Friday
is_private: true
is_default: false
created_at: '2021-12-16T15:22:52.586Z'
updated_at: '2021-12-16T15:22:52.586Z'
token: k7fKm96qT3UGmSdwiMDVc7zu
variant_included: false
relationships:
wished_items:
data:
- id: '17'
type: wished_item
- id: '18'
type: wished_item
- id: '23'
type: wishlist
attributes:
name: Birthday
is_private: true
is_default: false
created_at: '2021-12-16T15:22:52.589Z'
updated_at: '2021-12-16T15:22:52.589Z'
token: nBVfbFjqvyYQhEHdmCX2kC46
variant_included: false
relationships:
wished_items:
data:
- id: '19'
type: wished_item
- id: '20'
type: wished_item
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/wishlists?page=1&per_page=&include=&filter[name_cont]=
next: http://www.example.com/api/v2/platform/wishlists?filter%5Bname_cont%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/wishlists?filter%5Bname_cont%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/wishlists?filter%5Bname_cont%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/wishlists?filter%5Bname_cont%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Wishlist
tags:
- Wishlists
security:
- bearer_auth: []
description: Creates a Wishlist
operationId: create-wishlist
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: wished_items
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '26'
type: wishlist
attributes:
name: Wishlist_26
is_private: true
is_default: false
created_at: '2021-12-16T15:22:53.861Z'
updated_at: '2021-12-16T15:22:53.861Z'
token: fEnLh3BRCtib8sTkPxrQLEUq
variant_included: false
relationships:
wished_items:
data: []
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank and User can't be blank
errors:
name:
- can't be blank
user:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_wishlist_params"
"/api/v2/platform/wishlists/{id}":
get:
summary: Return a Wishlist
tags:
- Wishlists
security:
- bearer_auth: []
description: Returns a Wishlist
operationId: show-wishlist
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: wished_items
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '27'
type: wishlist
attributes:
name: My Wishlist
is_private: true
is_default: false
created_at: '2021-12-16T15:22:54.121Z'
updated_at: '2021-12-16T15:22:54.121Z'
token: Kx768J7Zfggjqb3sNDifML7U
variant_included: false
relationships:
wished_items:
data: []
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Wishlist
tags:
- Wishlists
security:
- bearer_auth: []
description: Updates a Wishlist
operationId: update-wishlist
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: wished_items
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '29'
type: wishlist
attributes:
name: My Super Wishlist
is_private: true
is_default: false
created_at: '2021-12-16T15:22:54.650Z'
updated_at: '2021-12-16T15:22:54.857Z'
token: 34LfiXj81nYam1nD6TLRXxPK
variant_included: false
relationships:
wished_items:
data: []
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_wishlist_params"
delete:
summary: Delete a Wishlist
tags:
- Wishlists
security:
- bearer_auth: []
description: Deletes a Wishlist
operationId: delete-wishlist
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
"/api/v2/platform/zones":
get:
summary: Return a list of Zones
tags:
- Zones
security:
- bearer_auth: []
description: Returns a list of Zones
operationId: zones-list
parameters:
- name: page
in: query
example: 1
schema:
type: integer
- name: per_page
in: query
example: 50
schema:
type: integer
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: zone_members
schema:
type: string
- name: filter[description_eq]
in: query
description: ''
example: The zone containing all EU countries
schema:
type: string
responses:
'200':
description: Records returned
content:
application/vnd.api+json:
examples:
Example:
value:
data:
- id: '113'
type: zone
attributes:
name: Incidunt harum exercitationem dolor beatae.
description: Temporibus quas facere neque magni expedita laboriosam
quam.
default_tax: false
zone_members_count: 0
created_at: '2021-12-16T15:22:55.922Z'
updated_at: '2021-12-16T15:22:55.922Z'
kind: state
relationships:
zone_members:
data: []
- id: '114'
type: zone
attributes:
name: Alias fuga excepturi dolorem sed est dolor ab recusandae.
description: Similique quam atque sint id porro.
default_tax: false
zone_members_count: 0
created_at: '2021-12-16T15:22:55.924Z'
updated_at: '2021-12-16T15:22:55.924Z'
kind: state
relationships:
zone_members:
data: []
meta:
count: 2
total_count: 2
total_pages: 1
links:
self: http://www.example.com/api/v2/platform/zones?page=1&per_page=&include=&filter[description_eq]=
next: http://www.example.com/api/v2/platform/zones?filter%5Bdescription_eq%5D=&include=&page=1&per_page=
prev: http://www.example.com/api/v2/platform/zones?filter%5Bdescription_eq%5D=&include=&page=1&per_page=
last: http://www.example.com/api/v2/platform/zones?filter%5Bdescription_eq%5D=&include=&page=1&per_page=
first: http://www.example.com/api/v2/platform/zones?filter%5Bdescription_eq%5D=&include=&page=1&per_page=
schema:
"$ref": "#/components/schemas/resources_list"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
post:
summary: Create a Zone
tags:
- Zones
security:
- bearer_auth: []
description: Creates a Zone
operationId: create-zone
parameters:
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: zone_members
schema:
type: string
responses:
'201':
description: Record created
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '117'
type: zone
attributes:
name: Perspiciatis non quia temporibus hic.
description: Earum perferendis vel quis nostrum.
default_tax: false
zone_members_count: 0
created_at: '2021-12-16T15:22:56.389Z'
updated_at: '2021-12-16T15:22:56.389Z'
kind: state
relationships:
zone_members:
data: []
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/create_zone_params"
"/api/v2/platform/zones/{id}":
get:
summary: Return a Zone
tags:
- Zones
security:
- bearer_auth: []
description: Returns a Zone
operationId: show-zone
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: zone_members
schema:
type: string
responses:
'200':
description: Record found
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '118'
type: zone
attributes:
name: Minus atque sequi voluptas magni adipisci ducimus aperiam
odit.
description: Delectus tempore error architecto laborum corporis
quod.
default_tax: false
zone_members_count: 0
created_at: '2021-12-16T15:22:56.649Z'
updated_at: '2021-12-16T15:22:56.649Z'
kind: state
relationships:
zone_members:
data: []
schema:
"$ref": "#/components/schemas/resource"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
patch:
summary: Update a Zone
tags:
- Zones
security:
- bearer_auth: []
description: Updates a Zone
operationId: update-zone
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: include
in: query
description: 'Select which associated resources you would like to fetch, see:
https://jsonapi.org/format/#fetching-includes'
example: zone_members
schema:
type: string
responses:
'200':
description: Record updated
content:
application/vnd.api+json:
examples:
Example:
value:
data:
id: '120'
type: zone
attributes:
name: EU
description: The zone containing all EU countries
default_tax: false
zone_members_count: 0
created_at: '2021-12-16T15:22:57.141Z'
updated_at: '2021-12-16T15:22:57.342Z'
kind: state
relationships:
zone_members:
data: []
schema:
"$ref": "#/components/schemas/resource"
'422':
description: Invalid request
content:
application/vnd.api+json:
examples:
Example:
value:
error: Name can't be blank
errors:
name:
- can't be blank
schema:
"$ref": "#/components/schemas/validation_errors"
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
requestBody:
content:
application/json:
schema:
"$ref": "#/components/schemas/update_zone_params"
delete:
summary: Delete a Zone
tags:
- Zones
security:
- bearer_auth: []
description: Deletes a Zone
operationId: delete-zone
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'204':
description: Record deleted
'404':
description: Record not found
content:
application/vnd.api+json:
examples:
Example:
value:
error: The resource you were looking for could not be found.
schema:
"$ref": "#/components/schemas/error"
'401':
description: Authentication Failed
content:
application/vnd.api+json:
examples:
Example:
value:
error: The access token is invalid
schema:
"$ref": "#/components/schemas/error"
servers:
- url: https://{defaultHost}
variables:
defaultHost:
default: localhost:3000
tags:
- name: Addresses
- name: Adjustments
- name: Classifications
- name: Countries
- name: CMS Pages
- name: CMS Sections
- name: Digital Assets
- name: Digital Links
- name: Line Items
- name: Menus
- name: Menu Items
- name: Option Types
- name: Option Values
- name: Orders
- name: Payments
- name: Payment Methods
- name: Promotions
- name: Promotion Actions
- name: Promotion Categories
- name: Promotion Rules
- name: Roles
- name: Shipments
- name: Shipping Categories
- name: Shipping Methods
- name: Stock Items
- name: Stock Locations
- name: Store Credit Categories
- name: Store Credit Types
- name: Store Credits
- name: Tax Categories
- name: Tax Rates
- name: Taxons
- name: Taxonomies
- name: Users
- name: Webhook Events
- name: Webhook Subscribers
- name: Wishlists
- name: Wished Items
- name: Variants
- name: Zones
components:
securitySchemes:
bearer_auth:
type: http
scheme: bearer
schemas:
create_address_params:
type: object
properties:
address:
type: object
required:
- country_id
- address1
- city
- zipcode
- phone
- firstname
- lastname
properties:
country_id:
type: string
example: '224'
state_id:
type: string
example: '516'
state_name:
type: string
example: New York
address1:
type: string
example: 5th ave
address2:
type: string
example: 1st suite
city:
type: string
example: NY
zipcode:
type: string
example: '10001'
phone:
type: string
example: "+1 123 456 789"
alternative_phone:
type: string
firstname:
type: string
example: John
lastname:
type: string
example: Snow
label:
type: string
example: My home address
company:
type: string
example: Vendo Cloud Inc
user_id:
type: string
public_metadata:
type: object
example:
distance_from_nearest_city_in_km: 10
location_type: building
private_metadata:
type: object
example:
close_to_shop: true
required:
- address
x-internal: true
update_address_params:
type: object
properties:
address:
type: object
properties:
country_id:
type: string
example: '224'
state_id:
type: string
example: '516'
state_name:
type: string
example: New York
address1:
type: string
example: 5th ave
address2:
type: string
example: 1st suite
city:
type: string
example: NY
zipcode:
type: string
example: '10001'
phone:
type: string
example: "+1 123 456 789"
alternative_phone:
type: string
firstname:
type: string
example: John
lastname:
type: string
example: Snow
label:
type: string
example: My home address
company:
type: string
example: Vendo Cloud Inc
user_id:
type: string
public_metadata:
type: object
example:
distance_from_city_in_km: 10
location_type: building
private_metadata:
type: object
example:
close_to_shop: true
required:
- address
x-internal: true
create_adjustment_params:
type: object
properties:
adjustment:
type: object
required:
- order_id
- label
- adjustable_id
- adjustable_type
properties:
order_id:
type: string
label:
type: string
example: Shipping costs
adjustable_id:
type: string
adjustable_type:
type: string
example: Spree::LineItem
source_id:
type: string
source_type:
type: string
example: Spree::TaxRate
amount:
type: number
example: 10.9
mandatory:
type: boolean
eligible:
type: boolean
state:
type: string
example: closed
default: open
enum:
- closed
- open
included:
type: boolean
example: true
default: false
required:
- adjustment
x-internal: true
update_adjustment_params:
type: object
properties:
adjustment:
type: object
properties:
order_id:
type: string
label:
type: string
example: Shipping costs
adjustable_id:
type: string
adjustable_type:
type: string
example: Spree::LineItem
source_id:
type: string
source_type:
type: string
example: Spree::TaxRate
amount:
type: number
example: 10.9
mandatory:
type: boolean
eligible:
type: boolean
state:
type: string
example: closed
default: open
enum:
- closed
- open
included:
type: boolean
example: true
default: false
required:
- adjustment
x-internal: true
create_classification_params:
type: object
properties:
classification:
type: object
required:
- product_id
- taxon_id
- position
properties:
product_id:
type: string
example: '1'
taxon_id:
type: string
example: '1'
position:
type: integer
example: 1
required:
- classification
x-internal: true
update_classification_params:
type: object
properties:
classification:
type: object
properties:
product_id:
type: string
example: '1'
taxon_id:
type: string
example: '1'
position:
type: integer
example: 1
required:
- classification
x-internal: true
create_standard_cms_page_params:
type: object
properties:
cms_page:
type: object
required:
- title
- locale
- type
properties:
title:
type: string
example: About Us
description: Give your page a title.
type:
type: string
enum:
- Spree::Cms::Pages::StandardPage
description: Set the type of page.
meta_title:
type: string
nullable: true
example: Learn More About Super-Shop
description: Set the meta title for this page, this appears in the title
bar of the browser.
content:
type: string
nullable: true
example: Lot's of text..
description: The text content of a standard page, this can be HTML from
a rich text editor.
meta_description:
type: string
nullable: true
example: Learn more about us on this page here...
description: Set a meta description, used for SEO and displayed in search
results.
visible:
type: boolean
enum:
- true
- false
description: This page is publicly visible when set to `true`.
slug:
type: string
nullable: true
example: about-us
description: Set a slug for this page.
locale:
type: string
example: en-US
description: The language this page is written in.
required:
- cms_page
title: Create a Standard Page
x-internal: true
create_homepage_cms_page_params:
type: object
properties:
cms_page:
type: object
required:
- title
- locale
- type
properties:
title:
type: string
example: Our Flash Homepage
description: Give your page a title.
type:
type: string
enum:
- Spree::Cms::Pages::Homepage
description: Set the type of page.
meta_title:
type: string
nullable: true
example: Visit Our Store - Great Deals
description: Set the meta title for this page, this appears in the title
bar of the browser.
meta_description:
type: string
nullable: true
example: Discover great new products that we sell in this store...
description: Set a meta description, used for SEO and displayed in search
results.
visible:
type: boolean
enum:
- true
- false
description: This page is publicly visible when set to `true`.
locale:
type: string
example: en-US
description: The language this page is written in.
required:
- cms_page
title: Create a Homepage
x-internal: true
create_feature_cms_page_params:
type: object
properties:
cms_page:
type: object
required:
- title
- locale
- type
properties:
title:
type: string
example: Featured Product
description: Give your page a title.
type:
type: string
enum:
- Spree::Cms::Pages::FeaturePage
description: Set the type of page.
meta_title:
type: string
nullable: true
example: Learn More About This Featured Product
description: Set the meta title for this page, this appears in the title
bar of the browser.
meta_description:
type: string
nullable: true
example: Learn more about us this amazing product that we sell right
here...
description: Set a meta description, used for SEO and displayed in search
results.
visible:
type: boolean
enum:
- true
- false
description: This page is publicly visible when set to `true`.
slug:
type: string
nullable: true
example: about-us
description: Set a slug for this page.
locale:
type: string
example: en-US
description: The language this page is written in.
required:
- cms_page
title: Create a Feature Page
x-internal: true
update_standard_cms_page_params:
type: object
properties:
cms_page:
type: object
properties:
title:
type: string
example: About Us
description: Update the page title.
type:
type: string
enum:
- Spree::Cms::Pages::StandardPage
- Spree::Cms::Pages::Homepage
- Spree::Cms::Pages::FeaturePage
description: Change the type of page.
meta_title:
type: string
nullable: true
example: Learn More About Super-Shop
description: Update the meta title for this page, this appears in the
title bar of the browser.
content:
type: string
nullable: true
example: Lot's of text..
description: Update the text content of a standard page, this can be
HTML from a rich text editor.
meta_description:
type: string
nullable: true
example: Learn more about us on this page here...
description: Update the meta description, used for SEO and displayed
in search results.
visible:
type: boolean
enum:
- true
- false
description: This page is publicly visible when set to `true`.
slug:
type: string
nullable: true
example: about-us
description: Update the slug for this page.
locale:
type: string
example: en-US
description: Update the language of this page.
required:
- cms_page
title: Update a Standard Page
x-internal: true
update_homepage_cms_page_params:
type: object
properties:
cms_page:
type: object
properties:
title:
type: string
example: Our Flash Homepage
description: Update the page title.
type:
type: string
enum:
- Spree::Cms::Pages::StandardPage
- Spree::Cms::Pages::Homepage
- Spree::Cms::Pages::FeaturePage
description: Change the type of page.
meta_title:
type: string
nullable: true
example: Visit Our Store - Great Deals
description: Update the meta title for this page, this appears in the
title bar of the browser.
meta_description:
type: string
nullable: true
example: Discover great new products that we sell in this store...
description: Update the meta description, used for SEO and displayed
in search results.
visible:
type: boolean
enum:
- true
- false
description: This page is publicly visible when set to `true`.
locale:
type: string
example: en-US
description: Update the language of this page.
required:
- cms_page
title: Update a Homepage
x-internal: true
update_feature_cms_page_params:
type: object
properties:
cms_page:
type: object
properties:
title:
type: string
example: Featured Product
description: Update the page title.
type:
type: string
enum:
- Spree::Cms::Pages::StandardPage
- Spree::Cms::Pages::Homepage
- Spree::Cms::Pages::FeaturePage
description: Change the type of page.
meta_title:
type: string
nullable: true
example: Learn More About This Featured Product
description: Update the meta title for this page, this appears in the
title bar of the browser.
meta_description:
type: string
nullable: true
example: Learn more about us this amazing product that we sell right
here...
description: Update the meta description, used for SEO and displayed
in search results.
visible:
type: boolean
enum:
- true
- false
description: This page is publicly visible when set to `true`.
slug:
type: string
nullable: true
example: about-us
description: Update the slug for this page.
locale:
type: string
example: en-US
description: Update the language of this page.
required:
- cms_page
title: Update a Feature Page
x-internal: true
create_hero_image_cms_section_params:
type: object
properties:
cms_section:
type: object
required:
- name
- cms_page_id
- type
properties:
name:
type: string
description: Give this section a name.
cms_page_id:
type: string
description: Set the `cms_page` ID that this section belongs to.
type:
type: string
enum:
- Spree::Cms::Sections::HeroImage
example: Spree::Cms::Sections::HeroImage
description: Set the section type.
linked_resource_type:
type: string
example: Spree::Taxon
nullable: true
enum:
- Spree::Taxon
- Spree::Product
- Spree::CmsPage
description: Set the resource type that this section links to.
linked_resource_id:
type: string
example: '1'
nullable: true
description: Set the ID of the resource that you would like this section
to link to.
fit:
type: string
example: Screen
enum:
- Screen
- Container
description: This value is used by front end developers to set CSS classes
for content that fits the screen edge-to-edge, or stays within the
boundaries of the central container.
position:
type: integer
example: 2
description: 'Pass the position that you want this section to appear
in. (The list is not zero indexed, so the first item is position:
`1`)'
gutters:
type: string
example: No Gutters
enum:
- Gutters
- No Gutters
description: This value is used by front end developers for styling
the section padding.
button_text:
type: string
example: Click Here
description: Set the text value of the button used in this section.
title:
type: string
example: Shop Today
description: Create a title for the Hero Section.
cms_section[image_one]:
type: string
format: binary
description: Use a `multipart/form-data` request to upload assets.
required:
- cms_section
title: Create a Hero Image Section
x-internal: true
create_product_carousel_cms_section_params:
type: object
properties:
cms_section:
type: object
required:
- name
- cms_page_id
- type
properties:
name:
type: string
description: Give this section a name.
cms_page_id:
type: string
description: Set the `cms_page` ID that this section belongs to.
type:
type: string
enum:
- Spree::Cms::Sections::ProductCarousel
example: Spree::Cms::Sections::ProductCarousel
description: Set the section type.
position:
type: integer
example: 2
description: 'Pass the position that you want this section to appear
in. (The list is not zero indexed, so the first item is position:
`1`)'
linked_resource_id:
type: string
example: '1'
nullable: true
description: Set the ID of the Taxon that you would like displayed as
a Product Carousel.
required:
- cms_section
title: Create a Product Carousel Section
x-internal: true
create_side_by_side_images_cms_section_params:
type: object
properties:
cms_section:
type: object
required:
- name
- cms_page_id
- type
properties:
name:
type: string
description: Give this section a name.
cms_page_id:
type: string
description: Set the `cms_page` ID that this section belongs to.
type:
type: string
enum:
- Spree::Cms::Sections::SideBySideImages
example: Spree::Cms::Sections::SideBySideImages
description: Set the section type.
position:
type: integer
example: 2
description: 'Pass the position that you want this section to appear
in. (The list is not zero indexed, so the first item is position:
`1`)'
link_type_one:
type: string
example: Spree::Taxon
enum:
- Spree::Taxon
- Spree::Product
description: Set the resource type that image one links to.
link_type_two:
type: string
example: Spree::Taxon
enum:
- Spree::Taxon
- Spree::Product
description: Set the resource type that image two links to.
link_one:
type: string
example: men/shirts
nullable: true
description: Set the slug or path that image two links to.
link_two:
type: string
example: white-shirt
nullable: true
description: Set the slug or path that image two links to.
title_one:
type: string
example: Shop Men's Shirts
nullable: true
description: Set the title used in image one.
title_two:
type: string
example: Buy This Men's Shirt
nullable: true
description: Set the title used in image two.
fit:
type: string
example: Screen
enum:
- Screen
- Container
description: This value is used by front end developers to set CSS classes
for content that fits the screen edge-to-edge, or stays within the
boundaries of the central container.
subtitle_one:
type: string
example: Save 50% today
nullable: true
description: Set the subtitle used in image one.
subtitle_two:
type: string
example: Save 50% today
nullable: true
description: Set the subtitle used in image two.
gutters:
type: string
example: No Gutters
enum:
- Gutters
- No Gutters
description: This value is used by front end developers for styling
the section padding.
cms_section[image_one]:
type: string
format: binary
description: Use a `multipart/form-data` request to upload assets.
cms_section[image_two]:
type: string
format: binary
description: Use a `multipart/form-data` request to upload assets.
required:
- cms_section
title: Create a Side-by-Side Image Section
x-internal: true
create_image_gallery_cms_section_params:
type: object
properties:
cms_section:
type: object
required:
- name
- cms_page_id
- type
properties:
name:
type: string
description: Give this section a name.
cms_page_id:
type: string
description: Set the `cms_page` ID that this section belongs to.
type:
type: string
enum:
- Spree::Cms::Sections::ImageGallery
example: Spree::Cms::Sections::ImageGallery
description: Set the section type.
position:
type: integer
example: 2
description: 'Pass the position that you want this section to appear
in. (The list is not zero indexed, so the first item is position:
`1`)'
link_type_one:
type: string
example: Spree::Taxon
enum:
- Spree::Taxon
- Spree::Product
description: Set the resource type that image one links to.
link_type_two:
type: string
example: Spree::Taxon
enum:
- Spree::Taxon
- Spree::Product
description: Set the resource type that image two links to.
link_type_three:
type: string
example: Spree::Taxon
enum:
- Spree::Taxon
- Spree::Product
description: Set the resource type that image three links to.
link_one:
type: string
example: men/shirts
nullable: true
description: Set the slug or path that image two links to.
link_two:
type: string
example: white-shirt
nullable: true
description: Set the slug or path that image two links to.
link_three:
type: string
example: red-shirt
nullable: true
description: Set the slug or path that image three links to.
title_one:
type: string
example: Shop Men's Shirts
nullable: true
description: Set the title used in image one.
title_two:
type: string
example: Buy This Men's Shirt
nullable: true
description: Set the title used in image two.
title_three:
type: string
example: Buy This Women's Skirt
nullable: true
description: Set the title used in image three.
fit:
type: string
example: Screen
enum:
- Screen
- Container
description: This value is used by front end developers to set CSS classes
for content that fits the screen edge-to-edge, or stays within the
boundaries of the central container.
layout_style:
type: string
example: Default
enum:
- Default
- Reversed
description: This value is used by front end developers for styling
the order the images appear.
display_labels:
type: string
example: Show
enum:
- Show
- Hide
description: This value is used by front end developers for showing
and hiding the label on the images.
cms_section[image_one]:
type: string
format: binary
description: Use a `multipart/form-data` request to upload assets.
cms_section[image_two]:
type: string
format: binary
description: Use a `multipart/form-data` request to upload assets.
cms_section[image_three]:
type: string
format: binary
description: Use a `multipart/form-data` request to upload assets.
required:
- cms_section
title: Create an Image Gallery Section
x-internal: true
create_featured_article_cms_section_params:
type: object
properties:
cms_section:
type: object
required:
- name
- cms_page_id
- type
properties:
name:
type: string
description: Give this section a name.
cms_page_id:
type: string
description: Set the `cms_page` ID that this section belongs to.
type:
type: string
enum:
- Spree::Cms::Sections::FeaturedArticle
example: Spree::Cms::Sections::FeaturedArticle
description: Set the section type.
position:
type: integer
example: 2
description: 'Pass the position that you want this section to appear
in. (The list is not zero indexed, so the first item is position:
`1`)'
linked_resource_type:
type: string
example: Spree::Taxon
nullable: true
enum:
- Spree::Taxon
- Spree::Product
- Spree::CmsPage
description: Set the resource type that this section links to.
linked_resource_id:
type: string
example: '1'
nullable: true
description: Set the ID of the resource that you would like this section
to link to.
fit:
type: string
example: Screen
enum:
- Screen
- Container
description: This value is used by front end developers to set CSS classes
for content that fits the screen edge-to-edge, or stays within the
boundaries of the central container.
gutters:
type: string
example: No Gutters
enum:
- Gutters
- No Gutters
description: This value is used by front end developers for styling
the section padding.
button_text:
type: string
example: Click Here
description: Set the text value of the button used in this section.
title:
type: string
example: Shop Today
description: Create a title for the Section.
subtitle:
type: string
example: Save Big!
description: Create a subtitle for the Section.
rte_content:
type: string
example: Lots of text and content goes here.
description: Set the content, here, this can be rich text editor content.
required:
- cms_section
title: Create a Featured Article Section
x-internal: true
create_rich_text_cms_section_params:
type: object
properties:
cms_section:
type: object
required:
- name
- cms_page_id
- type
properties:
name:
type: string
description: Give this section a name.
cms_page_id:
type: string
description: Set the `cms_page` ID that this section belongs to.
type:
type: string
enum:
- Spree::Cms::Sections::RichTextContent
example: Spree::Cms::Sections::RichTextContent
description: Set the section type.
position:
type: integer
example: 2
description: 'Pass the position that you want this section to appear
in. (The list is not zero indexed, so the first item is position:
`1`)'
fit:
type: string
example: Screen
enum:
- Screen
- Container
description: This value is used by front end developers to set CSS classes
for content that fits the screen edge-to-edge, or stays within the
boundaries of the central container.
rte_content:
type: string
example: Lots of text and content goes here.
description: Set the content, here, this can be rich text editor content.
required:
- cms_section
title: Create a Rich Text Section
x-internal: true
update_hero_image_cms_section_params:
type: object
properties:
cms_section:
type: object
properties:
name:
type: string
description: Update this section name.
type:
type: string
enum:
- Spree::Cms::Sections::HeroImage
- Spree::Cms::Sections::FeaturedArticle
- Spree::Cms::Sections::ProductCarousel
- Spree::Cms::Sections::ImageGallery
- Spree::Cms::Sections::SideBySideImages
- Spree::Cms::Sections::RichTextContent
example: Spree::Cms::Sections::ProductCarousel
description: Change the section type.
linked_resource_type:
type: string
example: Spree::Taxon
nullable: true
enum:
- Spree::Taxon
- Spree::Product
- Spree::CmsPage
description: Update the resource type that this section links to.
linked_resource_id:
type: string
example: '1'
nullable: true
description: Set the ID of the resource that you would like this section
to link to.
fit:
type: string
example: Screen
enum:
- Screen
- Container
description: This value is used by front end developers to set CSS classes
for content that fits the screen edge-to-edge, or stays within the
boundaries of the central container.
position:
type: integer
example: 2
description: 'Pass the position that you want this section to appear
in. (The list is not zero indexed, so the first item is position:
`1`)'
gutters:
type: string
example: No Gutters
enum:
- Gutters
- No Gutters
description: This value is used by front end developers for styling
the section padding.
button_text:
type: string
example: Click Here
description: Update the text value of the button used in this section.
title:
type: string
example: Shop Today
description: Update the title for this section.
cms_section[image_one]:
type: string
format: binary
description: Use a `multipart/form-data` request to upload assets.
required:
- cms_section
title: Update a Hero Image Section
x-internal: true
update_product_carousel_cms_section_params:
type: object
properties:
cms_section:
type: object
properties:
name:
type: string
description: Change this section name.
type:
type: string
enum:
- Spree::Cms::Sections::HeroImage
- Spree::Cms::Sections::FeaturedArticle
- Spree::Cms::Sections::ProductCarousel
- Spree::Cms::Sections::ImageGallery
- Spree::Cms::Sections::SideBySideImages
- Spree::Cms::Sections::RichTextContent
example: Spree::Cms::Sections::ProductCarousel
description: Change the section type.
position:
type: integer
example: 2
description: 'Pass the position that you want this section to appear
in. (The list is not zero indexed, so the first item is position:
`1`)'
linked_resource_id:
type: string
example: '1'
nullable: true
description: Update the ID of the Taxon that you would like displayed
as a Product Carousel.
required:
- cms_section
title: Update a Product Carousel Section
x-internal: true
update_side_by_side_images_cms_section_params:
type: object
properties:
cms_section:
type: object
properties:
name:
type: string
description: Update this section name.
type:
type: string
enum:
- Spree::Cms::Sections::HeroImage
- Spree::Cms::Sections::FeaturedArticle
- Spree::Cms::Sections::ProductCarousel
- Spree::Cms::Sections::ImageGallery
- Spree::Cms::Sections::SideBySideImages
- Spree::Cms::Sections::RichTextContent
example: Spree::Cms::Sections::ProductCarousel
description: Change the section type.
position:
type: integer
example: 2
description: 'Pass the position that you want this section to appear
in. (The list is not zero indexed, so the first item is position:
`1`)'
link_type_one:
type: string
example: Spree::Taxon
enum:
- Spree::Taxon
- Spree::Product
description: Update the resource type that image one links to.
link_type_two:
type: string
example: Spree::Taxon
enum:
- Spree::Taxon
- Spree::Product
description: Update the resource type that image two links to.
link_one:
type: string
example: men/shirts
nullable: true
description: Update the slug or path that image two links to.
link_two:
type: string
example: white-shirt
nullable: true
description: Update the slug or path that image two links to.
title_one:
type: string
example: Shop Men's Shirts
nullable: true
description: Update the title used in image one.
title_two:
type: string
example: Buy This Men's Shirt
nullable: true
description: Update the title used in image two.
fit:
type: string
example: Screen
enum:
- Screen
- Container
description: This value is used by front end developers to set CSS classes
for content that fits the screen edge-to-edge, or stays within the
boundaries of the central container.
subtitle_one:
type: string
example: Save 50% today
nullable: true
description: Update the subtitle used in image one.
subtitle_two:
type: string
example: Save 50% today
nullable: true
description: Update the subtitle used in image two.
gutters:
type: string
example: No Gutters
enum:
- Gutters
- No Gutters
description: This value is used by front end developers for styling
the section padding.
cms_section[image_one]:
type: string
format: binary
description: Use a `multipart/form-data` request to upload assets.
cms_section[image_two]:
type: string
format: binary
description: Use a `multipart/form-data` request to upload assets.
required:
- cms_section
title: Update a Side-by-Side Image Section
x-internal: true
update_image_gallery_cms_section_params:
type: object
properties:
cms_section:
type: object
properties:
name:
type: string
description: Update this section name.
type:
type: string
enum:
- Spree::Cms::Sections::HeroImage
- Spree::Cms::Sections::FeaturedArticle
- Spree::Cms::Sections::ProductCarousel
- Spree::Cms::Sections::ImageGallery
- Spree::Cms::Sections::SideBySideImages
- Spree::Cms::Sections::RichTextContent
example: Spree::Cms::Sections::ProductCarousel
description: Change the section type.
position:
type: integer
example: 2
description: 'Pass the position that you want this section to appear
in. (The list is not zero indexed, so the first item is position:
`1`)'
link_type_one:
type: string
example: Spree::Taxon
enum:
- Spree::Taxon
- Spree::Product
description: Update the resource type that image one links to.
link_type_two:
type: string
example: Spree::Taxon
enum:
- Spree::Taxon
- Spree::Product
description: Update the resource type that image two links to.
link_type_three:
type: string
example: Spree::Taxon
enum:
- Spree::Taxon
- Spree::Product
description: Update the resource type that image three links to.
link_one:
type: string
example: men/shirts
nullable: true
description: Update the slug or path that image two links to.
link_two:
type: string
example: white-shirt
nullable: true
description: Update the slug or path that image two links to.
link_three:
type: string
example: red-shirt
nullable: true
description: Update the slug or path that image three links to.
title_one:
type: string
example: Shop Men's Shirts
nullable: true
description: Update the title used in image one.
title_two:
type: string
example: Buy This Men's Shirt
nullable: true
description: Update the title used in image two.
title_three:
type: string
example: Buy This Women's Skirt
nullable: true
description: Update the title used in image three.
fit:
type: string
example: Screen
enum:
- Screen
- Container
description: This value is used by front end developers to set CSS classes
for content that fits the screen edge-to-edge, or stays within the
boundaries of the central container.
layout_style:
type: string
example: Default
enum:
- Default
- Reversed
description: This value is used by front end developers for styling
the order the images appear.
display_labels:
type: string
example: Show
enum:
- Show
- Hide
description: This value is used by front end developers for showing
and hiding the label on the images.
cms_section[image_one]:
type: string
format: binary
description: Use a `multipart/form-data` request to upload assets.
cms_section[image_two]:
type: string
format: binary
description: Use a `multipart/form-data` request to upload assets.
cms_section[image_three]:
type: string
format: binary
description: Use a `multipart/form-data` request to upload assets.
required:
- cms_section
title: Update an Image Gallery Section
x-internal: true
update_featured_article_cms_section_params:
type: object
properties:
cms_section:
type: object
properties:
name:
type: string
description: Update this section name.
type:
type: string
enum:
- Spree::Cms::Sections::HeroImage
- Spree::Cms::Sections::FeaturedArticle
- Spree::Cms::Sections::ProductCarousel
- Spree::Cms::Sections::ImageGallery
- Spree::Cms::Sections::SideBySideImages
- Spree::Cms::Sections::RichTextContent
example: Spree::Cms::Sections::ProductCarousel
description: Change the section type.
position:
type: integer
example: 2
description: 'Pass the position that you want this section to appear
in. (The list is not zero indexed, so the first item is position:
`1`)'
linked_resource_type:
type: string
example: Spree::Taxon
nullable: true
enum:
- Spree::Taxon
- Spree::Product
- Spree::CmsPage
description: Set the resource type that this section links to.
linked_resource_id:
type: string
example: '1'
nullable: true
description: Change the ID of the resource that you would like this
section to link to.
fit:
type: string
example: Screen
enum:
- Screen
- Container
description: This value is used by front end developers to set CSS classes
for content that fits the screen edge-to-edge, or stays within the
boundaries of the central container.
gutters:
type: string
example: No Gutters
enum:
- Gutters
- No Gutters
description: This value is used by front end developers for styling
the section padding.
button_text:
type: string
example: Click Here
description: Update the text value of the button used in this section.
title:
type: string
example: Shop Today
description: Update the title for the Section.
subtitle:
type: string
example: Save Big!
description: Update the subtitle for the Section.
rte_content:
type: string
example: Lots of text and content goes here.
description: Update the content here, this can be rich text editor content.
required:
- cms_section
title: Update a Featured Article Section
x-internal: true
update_rich_text_cms_section_params:
type: object
properties:
cms_section:
type: object
properties:
name:
type: string
description: Update this section name.
type:
type: string
enum:
- Spree::Cms::Sections::HeroImage
- Spree::Cms::Sections::FeaturedArticle
- Spree::Cms::Sections::ProductCarousel
- Spree::Cms::Sections::ImageGallery
- Spree::Cms::Sections::SideBySideImages
- Spree::Cms::Sections::RichTextContent
example: Spree::Cms::Sections::ProductCarousel
description: Change the section type.
position:
type: integer
example: 2
description: 'Pass the position that you want this section to appear
in. (The list is not zero indexed, so the first item is position:
`1`)'
fit:
type: string
example: Screen
enum:
- Screen
- Container
description: This value is used by front end developers to set CSS classes
for content that fits the screen edge-to-edge, or stays within the
boundaries of the central container.
rte_content:
type: string
example: Lots of text and content goes here.
description: Update the content, here, this can be rich text editor
content.
required:
- cms_section
title: Update a Rich Text Section
x-internal: true
create_digital_params:
type: object
properties:
digital[attachment]:
type: string
format: binary
digital[variant_id]:
type: string
example: '123'
required:
- digital[attachment]
- digital[variant_id]
x-internal: true
update_digital_params:
type: object
properties:
digital[attachment]:
type: string
format: binary
digital[variant_id]:
type: string
example: '123'
required:
- digital[attachment]
- digital[variant_id]
x-internal: true
create_digital_link_params:
type: object
properties:
digital_link:
type: object
required:
- line_item_id
- digital_id
properties:
access_counter:
type: integer
example: 0
line_item_id:
type: string
example: '1'
digital_id:
type: string
example: '1'
required:
- digital_link
x-internal: true
update_digital_link_params:
type: object
properties:
digital_link:
type: object
properties:
access_counter:
type: integer
example: 0
line_item_id:
type: string
example: '1'
digital_id:
type: string
example: '1'
required:
- digital_link
x-internal: true
create_line_item_params:
type: object
properties:
line_item:
type: object
required:
- order_id
- variant_id
- quantity
properties:
order_id:
type: string
example: '1'
variant_id:
type: string
example: '1'
quantity:
type: integer
example: 2
public_metadata:
type: object
private_metadata:
type: object
required:
- line_item
x-internal: true
update_line_item_params:
type: object
properties:
line_item:
type: object
properties:
variant_id:
type: string
example: '1'
quantity:
type: integer
example: 2
required:
- line_item
x-internal: true
create_menu_params:
type: object
properties:
menu:
type: object
required:
- name
- location
- locale
properties:
name:
type: string
example: Main Menu
description: Give this Menu a name.
location:
type: string
enum:
- header
- footer
description: Set the location this menu appears in the website.
locale:
type: string
example: en-US
description: Set the language of this menu.
required:
- menu
x-internal: true
update_menu_params:
type: object
properties:
menu:
type: object
properties:
name:
type: string
example: Main Menu
description: Update this Menu name.
location:
type: string
enum:
- header
- footer
description: Update the location this menu appears in the website.
locale:
type: string
example: en-US
description: Change the language of this menu.
required:
- menu
x-internal: true
create_menu_item_params:
type: object
properties:
menu_item:
type: object
required:
- name
- menu_id
properties:
name:
type: string
example: T-Shirts
description: The name of this Menu Item
code:
type: string
nullable: true
example: MEN-TS
description: Give this Menu Item a code to identify this Menu Item from
others. This is especially useful when using Container type Menu Items
to group items.
subtitle:
type: string
nullable: true
example: Shop men's T-Shirts
description: Set an optional subtitle for the Menu Item, this is useful
if your menu has promotional links that require more than just a link
name.
destination:
type: string
nullable: true
example: https://getvendo.com
description: 'Used when the linked_resource_type is set to: URL'
menu_id:
type: integer
example: 1
description: Specify the ID of the Menu this item belongs to.
new_window:
type: boolean
description: When set to `true` the link will be opened in a new tab
or window.
item_type:
type: string
enum:
- Link
- Container
description: Links are standard links, where as Containers are used
to group links.
linked_resource_type:
type: string
enum:
- URL
- Spree::Taxon
- Spree::Product
- Spree::CmsPage
description: 'Set the type of resource you want to link to, or set to:
URL to use the destination field for an external link.'
linked_resource_id:
type: integer
example: 1
nullable: true
description: The ID of the resource you are linking to.
required:
- menu_item
title: Create a Menu Item
x-internal: true
update_menu_item_params:
type: object
properties:
menu_item:
type: object
properties:
name:
type: string
example: T-Shirts
description: Update the name of this Menu Item
code:
type: string
nullable: true
example: MEN-TS
description: The Menu Item a code to identifies this Menu Item from
others. This is especially useful when using Container type Menu Items
to group items.
subtitle:
type: string
nullable: true
example: Shop men's T-Shirts
description: Set an optional subtitle for the Menu Item, this is useful
if your menu has promotional links that require more than just a link
name.
destination:
type: string
nullable: true
example: https://getvendo.com
description: 'Used when the linked_resource_type is set to: URL'
menu_id:
type: integer
example: 1
description: Specify the ID of the Menu this item belongs to.
new_window:
type: boolean
description: When set to `true` the link will be opened in a new tab
or window.
item_type:
type: string
enum:
- Link
- Container
description: Links are standard links, where as Containers are used
to group links.
linked_resource_type:
type: string
enum:
- URL
- Spree::Taxon
- Spree::Product
- Spree::CmsPage
description: 'Change the type of resource you want to link to, or set
to: URL to use the destination field for an external link.'
linked_resource_id:
type: integer
example: 1
nullable: true
description: The ID of the resource you are linking to.
required:
- menu_item
title: Update a Menu Item
x-internal: true
menu_item_reposition:
type: object
properties:
menu_item:
type: object
required:
- new_parent_id
- new_position_idx
properties:
new_parent_id:
type: integer
example: 1
description: The ID of the new target parent Menu Item.
new_position_idx:
type: integer
example: 1
description: The new index position of the Menu Item within its parent
required:
- menu_item
title: Reposition a Menu Item
x-internal: true
create_option_type_params:
type: object
properties:
option_type:
type: object
required:
- name
- presentation
properties:
name:
type: string
example: color
presentation:
type: string
example: Color
public_metadata:
type: object
private_metadata:
type: object
required:
- option_type
x-internal: true
update_option_type_params:
type: object
properties:
option_type:
type: object
properties:
name:
type: string
example: color
presentation:
type: string
example: Color
public_metadata:
type: object
private_metadata:
type: object
required:
- option_type
x-internal: true
create_option_value_params:
type: object
properties:
option_value:
type: object
required:
- name
- presentation
properties:
name:
type: string
example: red
presentation:
type: string
example: Red
public_metadata:
type: object
private_metadata:
type: object
required:
- option_value
x-internal: true
update_option_value_params:
type: object
properties:
option_value:
type: object
properties:
name:
type: string
example: red
presentation:
type: string
example: Red
public_metadata:
type: object
private_metadata:
type: object
required:
- option_value
x-internal: true
create_order_params:
type: object
properties:
order:
type: object
properties:
item_total:
type: number
example: 170.9
total:
type: number
example: 190.9
state:
type: string
example: complete
enum:
- cart
- address
- delivery
- payment
- confirm
- complete
- canceled
adjustment_total:
type: number
example: 20.0
user_id:
type: string
example: '1'
completed_at:
type: string
format: date_time
example: 2021-12-16 15:20:22 UTC
bill_address_id:
type: string
example: '1'
ship_address_id:
type: string
example: '1'
payment_total:
type: number
example: 190.9
shipment_state:
type: string
example: shipped
enum:
- backorder
- canceled
- partial
- pending
- ready
- shipped
payment_state:
type: string
example: paid
enum:
- balance_due
- credit_owed
- failed
- paid
- void
email:
type: string
format: email
example: hi@getvendo.com
special_instructions:
type: string
example: I need it ASAP!
currency:
type: string
example: USD
last_ip_address:
type: string
example: 127.0.0.1
created_by_id:
type: string
example: '1'
shipment_total:
type: number
example: 10.0
additional_tax_total:
type: number
example: 10.0
promo_total:
type: number
example: 0.0
channel:
type: string
example: online
included_tax_total:
type: number
example: 0.0
item_count:
type: integer
example: 2
approver_id:
type: string
approved_at:
type: string
format: date_time
example: 2021-12-16 15:20:22 UTC
confirmation_delivered:
type: boolean
example: true
default: false
considered_risky:
type: boolean
example: true
default: false
canceled_at:
type: string
format: date_time
canceler_id:
type: string
taxable_adjustment_total:
type: number
example: 170.9
non_taxable_adjustment_total:
type: number
example: 10.0
store_owner_notification_delivered:
type: boolean
example: true
default: false
bill_address_attributes:
"$ref": "#/components/schemas/update_address_params"
ship_address_attributes:
"$ref": "#/components/schemas/update_address_params"
line_items_attributes:
type: array
items:
"$ref": "#/components/schemas/update_line_item_params"
public_metadata:
type: object
private_metadata:
type: object
required:
- order
x-internal: true
update_order_params:
type: object
properties:
order:
type: object
properties:
item_total:
type: number
example: 170.9
total:
type: number
example: 190.9
state:
type: string
example: complete
enum:
- cart
- address
- delivery
- payment
- confirm
- complete
- canceled
adjustment_total:
type: number
example: 20.0
user_id:
type: string
example: '1'
completed_at:
type: string
format: date_time
example: 2021-12-16 15:20:22 UTC
bill_address_id:
type: string
example: '1'
ship_address_id:
type: string
example: '1'
payment_total:
type: number
example: 190.9
shipment_state:
type: string
example: shipped
enum:
- backorder
- canceled
- partial
- pending
- ready
- shipped
payment_state:
type: string
example: paid
enum:
- balance_due
- credit_owed
- failed
- paid
- void
email:
type: string
format: email
example: hi@getvendo.com
special_instructions:
type: string
example: I need it ASAP!
currency:
type: string
example: USD
last_ip_address:
type: string
example: 127.0.0.1
created_by_id:
type: string
example: '1'
shipment_total:
type: number
example: 10.0
additional_tax_total:
type: number
example: 10.0
promo_total:
type: number
example: 0.0
channel:
type: string
example: online
included_tax_total:
type: number
example: 0.0
item_count:
type: integer
example: 2
approver_id:
type: string
approved_at:
type: string
format: date_time
example: 2021-12-16 15:20:22 UTC
confirmation_delivered:
type: boolean
example: true
default: false
considered_risky:
type: boolean
example: true
default: false
canceled_at:
type: string
format: date_time
canceler_id:
type: string
taxable_adjustment_total:
type: number
example: 170.9
non_taxable_adjustment_total:
type: number
example: 10.0
store_owner_notification_delivered:
type: boolean
example: true
default: false
bill_address_attributes:
"$ref": "#/components/schemas/update_address_params"
ship_address_attributes:
"$ref": "#/components/schemas/update_address_params"
line_items_attributes:
type: array
items:
"$ref": "#/components/schemas/update_line_item_params"
public_metadata:
type: object
private_metadata:
type: object
required:
- order
x-internal: true
create_payment_method_params:
type: object
properties:
payment_method:
type: object
required:
- name
properties:
name:
type: string
example: Test Payment Method
active:
type: boolean
auto_capture:
type: boolean
description:
type: string
example: This is a test payment method
type:
type: string
example: Spree::Gateway::Bogus
enum:
- Spree::Gateway::Bogus
- Spree::PaymentMethod::Check
display_on:
type: string
example: both
enum:
- both
- back_end
- front_end
store_ids:
type: array
items:
allOf:
- type: string
example: '2'
public_metadata:
type: object
private_metadata:
type: object
required:
- payment_method
x-internal: true
update_payment_method_params:
type: object
properties:
payment_method:
type: object
properties:
name:
type: string
example: Test Payment Method
active:
type: boolean
auto_capture:
type: boolean
description:
type: string
example: This is a test payment method
type:
type: string
example: Spree::Gateway::Bogus
enum:
- Spree::Gateway::Bogus
- Spree::PaymentMethod::Check
display_on:
type: string
example: both
enum:
- both
- back_end
- front_end
store_ids:
type: array
items:
allOf:
- type: string
example: '2'
public_metadata:
type: object
private_metadata:
type: object
required:
- payment_method
x-internal: true
title: Update Payment Method
update_payment_method_params_bogus_gateway:
type: object
properties:
payment_method:
type: object
properties:
preferred_dummy_key:
type: string
example: UPDATED-DUMMY-KEY-123
preferred_server:
type: string
example: production
preferred_test_mode:
type: boolean
required:
- payment_method
x-internal: true
title: Update Bogus Gateway
create_product_params:
type: object
properties:
product:
type: object
required:
- name
- price
- shipping_category_id
properties:
name:
type: string
description:
type: string
available_on:
type: string
discontinue_on:
type: string
permalink:
type: string
meta_description:
type: string
meta_keywords:
type: string
price:
type: string
sku:
type: string
deleted_at:
type: string
prototype_id:
type: string
option_values_hash:
type: string
weight:
type: string
height:
type: string
width:
type: string
depth:
type: string
shipping_category_id:
type: string
tax_category_id:
type: string
cost_currency:
type: string
cost_price:
type: string
compare_at_price:
type: string
option_type_ids:
type: string
taxon_ids:
type: string
public_metadata:
type: object
private_metadata:
type: object
required:
- product
x-internal: true
update_product_params:
type: object
properties:
product:
type: object
properties:
name:
type: string
description:
type: string
available_on:
type: string
discontinue_on:
type: string
permalink:
type: string
meta_description:
type: string
meta_keywords:
type: string
price:
type: string
sku:
type: string
deleted_at:
type: string
prototype_id:
type: string
option_values_hash:
type: string
weight:
type: string
height:
type: string
width:
type: string
depth:
type: string
shipping_category_id:
type: string
tax_category_id:
type: string
cost_currency:
type: string
cost_price:
type: string
compare_at_price:
type: string
option_type_ids:
type: string
taxon_ids:
type: string
public_metadata:
type: object
private_metadata:
type: object
required:
- product
x-internal: true
create_promotion_params:
type: object
properties:
promotion:
type: object
required:
- name
properties:
name:
type: string
example: Promotions Used in 2021
description: Give the promotion a name.
code:
type: string
example: BLK-FRI
nullable: true
description: Set the promotion code. Promotions without a code are automatically
applied if the order meets the Promotion Rule requirements.
description:
type: string
example: Save today with discount code XYZ at checkout.
nullable: true
description: Give the promotion a description.
usage_limit:
type: integer
example: 100
nullable: true
description: If you wish you can set a usage limit for this promotion.
advertise:
type: boolean
starts_at:
type: string
format: date_time
nullable: true
description: Set a date and time that this promotion begins.
ends_at:
type: string
format: date_time
nullable: true
description: Set a date and time that this promotion ends.
store_ids:
type: array
items:
allOf:
- type: string
example: '2'
required:
- promotion
title: Create a Promotion
x-internal: true
update_promotion_params:
type: object
properties:
promotion:
type: object
properties:
name:
type: string
example: Promotions Used in 2021
description: Change the promotion a name.
code:
type: string
example: CYB-MON
nullable: true
description: Change or remove the promotion code. Promotions without
a code are automatically applied if the order meets the Promotion
Rule requirements.
description:
type: string
example: Save today with discount code XYZ at checkout.
nullable: true
description: Update the promotion a description.
usage_limit:
type: integer
example: 100
nullable: true
description: If you wish you can set a usage limit for this promotion.
advertise:
type: boolean
starts_at:
type: string
format: date_time
nullable: true
description: Set a date and time that this promotion begins.
ends_at:
type: string
format: date_time
nullable: true
description: Set a date and time that this promotion ends.
store_ids:
type: array
items:
allOf:
- type: string
example: '2'
required:
- promotion
title: Update a Promotion
x-internal: true
update_promotion_add_rule_params:
type: object
properties:
promotion:
type: object
properties:
promotion_rules_attributes:
type: array
items:
allOf:
- properties:
type:
type: string
example: Spree::Promotion::Rules::Country
enum:
- Spree::Promotion::Rules::Country
- Spree::Promotion::Rules::ItemTotal
- Spree::Promotion::Rules::Product
- Spree::Promotion::Rules::User
- Spree::Promotion::Rules::FirstOrder
- Spree::Promotion::Rules::UserLoggedIn
- Spree::Promotion::Rules::OneUsePerUser
- Spree::Promotion::Rules::Taxon
- Spree::Promotion::Rules::OptionValue
description: Set the Promotion Rule type.
preferred_country_id:
type: integer
example: 122
description: 'Each rule type has its own preferred attributes.
In this example we are setting the ID of the Country this
rule applies to. To learn more about Spree preferences visit
TODO: [LINK].'
required:
- promotion
title: Add a Rule to a Promotion
x-internal: true
update_promotion_update_rule_params:
type: object
properties:
promotion:
type: object
properties:
promotion_rules_attributes:
type: array
items:
allOf:
- properties:
id:
type: string
example: '22'
description: To update an existing Promotion Rule, you are required
to pass the ID of the rule you are updating.
type:
type: string
example: Spree::Promotion::Rules::Country
enum:
- Spree::Promotion::Rules::Country
- Spree::Promotion::Rules::ItemTotal
- Spree::Promotion::Rules::Product
- Spree::Promotion::Rules::User
- Spree::Promotion::Rules::FirstOrder
- Spree::Promotion::Rules::UserLoggedIn
- Spree::Promotion::Rules::OneUsePerUser
- Spree::Promotion::Rules::Taxon
- Spree::Promotion::Rules::OptionValue
description: Set the Promotion Rule type.
preferred_country_id:
type: integer
example: 143
description: 'Each rule type has its own preferred attributes.
In this example we are changing the ID of the Country this
rule applies to. To learn more about Spree preferences visit
TODO: [LINK].'
required:
- promotion
title: Update an existing Rule
x-internal: true
update_promotion_add_action_params:
type: object
properties:
promotion:
type: object
properties:
promotion_actions_attributes:
type: array
items:
allOf:
- properties:
type:
type: string
example: Spree::Promotion::Actions::CreateAdjustment
enum:
- Spree::Promotion::Actions::CreateAdjustment
- Spree::Promotion::Actions::CreateItemAdjustments
- Spree::Promotion::Actions::FreeShipping
- Spree::Promotion::Actions::CreateLineItems
description: Set the Promotion Action Type.
required:
- promotion
title: Add an Action to a Promotion
x-internal: true
update_promotion_action_calculator_params:
type: object
properties:
promotion:
type: object
properties:
promotion_actions_attributes:
type: array
items:
allOf:
- properties:
id:
type: string
example: '22'
description: To update an existing Promotion Action, you are
required to pass the ID of the action you wish to update.
calculator_attributes:
properties:
id:
type: string
example: '19'
description: To update an existing Action Calculator, you
are required to pass the ID of the calculator.
type:
type: string
example: Spree::Promotion::Actions::CreateAdjustment
enum:
- Spree::Promotion::Actions::CreateAdjustment
- Spree::Promotion::Actions::CreateItemAdjustments
- Spree::Promotion::Actions::CreateLineItems
- Spree::Promotion::Actions::FreeShipping
description: Set the Type of Promotion Action you wish to
use.
preferred_flat_percent:
type: integer
example: 10
description: In this example we are setting the preferred
flat percentage to `10`.
required:
- promotion
title: Update an Action Calculator
x-internal: true
update_promotion_change_calculator_params:
type: object
properties:
promotion:
type: object
properties:
promotion_actions_attributes:
type: array
items:
allOf:
- properties:
id:
type: string
example: '22'
description: To update an existing Promotion Action, you are
required to pass the ID of the Promotion Action.
calculator_attributes:
properties:
type:
type: string
example: Spree::Calculator::FlatPercentItemTotal
enum:
- Spree::Calculator::FlatPercentItemTotal
- Spree::Calculator::FlatRate
- Spree::Calculator::FlexiRate
- Spree::Calculator::TieredPercent
- Spree::Calculator::TieredFlatRate
- Spree::Calculator::PercentOnLineItem
description: 'To set the Promotion Action Calculator pass
the calculator type. Each Promotion action has certain
Calculators available, to learn more visit TODO: [LINK]'
required:
- promotion
title: Change an Action Calculator
x-internal: true
update_promotion_change_action_params:
type: object
properties:
promotion:
type: object
properties:
promotion_actions_attributes:
type: array
items:
allOf:
- properties:
id:
type: string
example: '22'
description: To update an existing Promotion Action, you are
required to pass the ID of the Promotion Action.
type:
type: string
example: Spree::Promotion::Actions::CreateAdjustment
enum:
- Spree::Promotion::Actions::CreateAdjustment
- Spree::Promotion::Actions::CreateItemAdjustments
- Spree::Promotion::Actions::CreateLineItems
- Spree::Promotion::Actions::FreeShipping
description: Set the Type of Promotion Action you wish to use.
required:
- promotion
title: Change an Action Type
x-internal: true
create_promotion_action_params:
type: object
properties:
promotion_action:
type: object
required:
- type
- promotion_id
properties:
type:
type: string
example: Spree::Promotion::Actions::CreateAdjustment
enum:
- Spree::Promotion::Actions::CreateAdjustment
- Spree::Promotion::Actions::CreateItemAdjustments
- Spree::Promotion::Actions::CreateLineItems
- Spree::Promotion::Actions::FreeShipping
description: Set the Type of Promotion Action you wish to use.
promotion_id:
type: string
example: '22'
description: Set the ID of the promotion this action belongs to.
required:
- promotion_action
title: Create a Promotion Action
x-internal: true
update_promotion_action_params:
type: object
properties:
promotion_action:
type: object
properties:
type:
type: string
example: Spree::Promotion::Actions::CreateAdjustment
enum:
- Spree::Promotion::Actions::CreateAdjustment
- Spree::Promotion::Actions::CreateItemAdjustments
- Spree::Promotion::Actions::CreateLineItems
- Spree::Promotion::Actions::FreeShipping
description: Set the Type of Promotion Action you wish to use.
required:
- promotion_action
title: Create a Promotion Action
x-internal: true
create_promotion_category_params:
type: object
properties:
promotion_category:
type: object
required:
- name
properties:
name:
type: string
example: Promotions Used in 2021
description: Give this Promotion Category a name.
code:
type: string
example: 2021-PROMOS
nullable: true
description: Give this promotion category a code.
required:
- promotion_category
x-internal: true
update_promotion_category_params:
type: object
properties:
promotion_category:
type: object
required:
- name
properties:
name:
type: string
example: Promotions Used in 2021
description: Update the name of this Promotion Category.
code:
type: string
example: 2021-PROMOS
nullable: true
description: Change or remove the code for this Promotion Category.
required:
- promotion_category
x-internal: true
create_promotion_rule_params:
type: object
properties:
promotion_rule:
type: object
required:
- type
- promotion_id
properties:
promotion_id:
type: string
example: '22'
description: Set the ID of the promotion this Promotion Rule belongs
to.
type:
type: string
example: Spree::Promotion::Rules::Country
enum:
- Spree::Promotion::Rules::Country
- Spree::Promotion::Rules::ItemTotal
- Spree::Promotion::Rules::Product
- Spree::Promotion::Rules::User
- Spree::Promotion::Rules::FirstOrder
- Spree::Promotion::Rules::UserLoggedIn
- Spree::Promotion::Rules::OneUsePerUser
- Spree::Promotion::Rules::Taxon
- Spree::Promotion::Rules::OptionValue
description: Set the Promotion Rule type.
required:
- promotion_rule
title: Create a Promotion Rule
x-internal: true
update_promotion_rule_params:
type: object
properties:
promotion_rule:
type: object
properties:
type:
type: string
example: Spree::Promotion::Rules::Country
enum:
- Spree::Promotion::Rules::Country
- Spree::Promotion::Rules::ItemTotal
- Spree::Promotion::Rules::Product
- Spree::Promotion::Rules::User
- Spree::Promotion::Rules::FirstOrder
- Spree::Promotion::Rules::UserLoggedIn
- Spree::Promotion::Rules::OneUsePerUser
- Spree::Promotion::Rules::Taxon
- Spree::Promotion::Rules::OptionValue
description: Set the Promotion Rule type.
required:
- promotion_rule
title: Create a Promotion Rule
x-internal: true
create_role_params:
type: object
properties:
role:
type: object
required:
- name
properties:
name:
type: string
example: vendor
required:
- zone
x-internal: true
update_role_params:
type: object
properties:
role:
type: object
properties:
name:
type: string
example: vendor
required:
- zone
x-internal: true
create_shipment_params:
type: object
properties:
shipment:
type: object
required:
- stock_location_id
- order_id
- variant_id
properties:
stock_location_id:
type: string
example: '101'
order_id:
type: string
example: '101'
variant_id:
type: string
example: '101'
quantity:
type: integer
example: 2
required:
- shipping_category
x-internal: true
update_shipment_params:
type: object
properties:
shipment:
type: object
properties:
tracking:
type: string
example: MY-TRACKING-REF-12324
required:
- shipping_category
x-internal: true
add_item_shipment_params:
type: object
properties:
shipment:
type: object
required:
- variant_id
properties:
variant_id:
type: string
example: '101'
quantity:
type: integer
example: 2
required:
- shipping_category
x-internal: true
remove_item_shipment_params:
type: object
properties:
shipment:
type: object
required:
- variant_id
properties:
variant_id:
type: string
example: '101'
quantity:
type: integer
example: 2
required:
- shipping_category
x-internal: true
create_shipping_category_params:
type: object
properties:
shipping_category:
type: object
required:
- name
properties:
name:
type: string
example: Another Category
required:
- shipping_category
x-internal: true
update_shipping_category_params:
type: object
properties:
shipping_category:
type: object
required:
- name
properties:
name:
type: string
example: Another Category
required:
- shipping_category
x-internal: true
create_shipping_method_params:
type: object
properties:
shipping_method:
type: object
required:
- name
- display_on
- shipping_category_ids
properties:
name:
type: string
example: DHL Express
admin_name:
type: string
example: DHL Area Code D
code:
type: string
example: DHL-A-D
tracking_url:
type: string
example: dhlexpress.com?tracking=
display_on:
type: string
example: both
enum:
- both
- back_end
- front_end
tax_category_id:
type: string
example: '1'
shipping_category_ids:
type: array
items:
allOf:
- type: string
example: '2'
calculator_attributes:
"$ref": "#/components/schemas/shipping_calculator_params"
public_metadata:
type: object
private_metadata:
type: object
required:
- shipping_method
x-internal: true
update_shipping_method_params:
type: object
properties:
shipping_method:
type: object
properties:
name:
type: string
example: DHL Express
admin_name:
type: string
example: DHL Area Code D
code:
type: string
example: DHL-A-D
tracking_url:
type: string
example: dhlexpress.com?tracking=
display_on:
type: string
example: both
enum:
- both
- back_end
- front_end
tax_category_id:
type: string
example: '1'
shipping_category_ids:
type: array
items:
allOf:
- type: string
example: '2'
calculator_attributes:
"$ref": "#/components/schemas/shipping_calculator_params"
public_metadata:
type: object
private_metadata:
type: object
required:
- shipping_method
x-internal: true
shipping_calculator_params:
type: object
properties:
type:
type: string
example: Spree::Calculator::Shipping::FlatPercentItemTotal
enum:
- Spree::Calculator::Shipping::DigitalDelivery
- Spree::Calculator::Shipping::FlatPercentItemTotal
- Spree::Calculator::Shipping::FlatRate
- Spree::Calculator::Shipping::FlexiRate
- Spree::Calculator::Shipping::PerItem
- Spree::Calculator::Shipping::PriceSack
required:
- type
x-internal: true
create_stock_item_params:
type: object
properties:
stock_item:
type: object
required:
- variant_id
- stock_location_id
- count_on_hand
properties:
variant_id:
type: string
example: '2'
stock_location_id:
type: string
example: '2'
count_on_hand:
type: number
example: 200
backorderable:
type: boolean
example: true
default: false
required:
- stock_item
x-internal: true
update_stock_item_params:
type: object
properties:
stock_item:
type: object
required:
- variant_id
- stock_location_id
- count_on_hand
properties:
variant_id:
type: string
example: '2'
stock_location_id:
type: string
example: '2'
count_on_hand:
type: number
example: 200
backorderable:
type: boolean
example: true
default: false
required:
- stock_item
x-internal: true
create_stock_location_params:
type: object
properties:
stock_location:
type: object
required:
- name
properties:
name:
type: string
example: Warehouse 3
default:
type: boolean
address1:
type: string
example: South St. 8
address2:
type: string
example: South St. 109
country_id:
type: string
example: '2'
state_id:
type: string
example: '4'
city:
type: string
example: Los Angeles
state_name:
type: string
example: California
zipcode:
type: string
example: '90005'
phone:
type: string
example: '23333456'
active:
type: boolean
backorderable_default:
type: boolean
propagate_all_variants:
type: boolean
admin_name:
type: string
required:
- stock_location
x-internal: true
update_stock_location_params:
type: object
properties:
stock_location:
type: object
required:
- name
properties:
name:
type: string
example: Warehouse 3
default:
type: boolean
address1:
type: string
example: South St. 8
address2:
type: string
example: South St. 109
country_id:
type: string
example: '2'
state_id:
type: string
example: '4'
city:
type: string
example: Los Angeles
state_name:
type: string
example: California
zipcode:
type: string
example: '90005'
phone:
type: string
example: '23333456'
active:
type: boolean
backorderable_default:
type: boolean
propagate_all_variants:
type: boolean
admin_name:
type: string
required:
- stock_location
x-internal: true
create_store_credit_category_params:
type: object
properties:
store_credit_category:
type: object
required:
- name
properties:
name:
type: string
example: refunded
required:
- store_credit_category
x-internal: true
update_store_credit_category_params:
type: object
properties:
store_credit_category:
type: object
required:
- name
properties:
name:
type: string
example: refunded
required:
- store_credit_category
x-internal: true
create_store_credit_type_params:
type: object
properties:
store_credit_type:
type: object
required:
- name
properties:
name:
type: string
example: refunded
priority:
type: integer
example: 1
required:
- store_credit_type
x-internal: true
update_store_credit_type_params:
type: object
properties:
store_credit_type:
type: object
properties:
name:
type: string
example: refunded
priority:
type: integer
example: 1
required:
- store_credit_type
x-internal: true
create_store_credit_params:
type: object
properties:
store_credit:
type: object
required:
- user_id
- category_id
- type_id
- created_by_id
- currency
- store_id
- amount
properties:
user_id:
type: string
example: '2'
category_id:
type: string
example: '4'
created_by_id:
type: string
example: '5'
amount:
type: number
example: 25.0
amount_used:
type: number
example: 10.0
memo:
type: string
example: This credit was given as a refund
currency:
type: string
example: USD
amount_authorized:
type: number
example: 15.5
originator_id:
type: string
example: '3'
originator_type:
type: string
example: Refund
type_id:
type: string
example: '1'
store_id:
type: string
example: '2'
public_metadata:
type: object
private_metadata:
type: object
required:
- store_credit
x-internal: true
update_store_credit_params:
type: object
properties:
store_credit:
type: object
required:
- user_id
- category_id
- type_id
- created_by_id
- currency
- store_id
- amount
properties:
user_id:
type: string
example: '2'
category_id:
type: string
example: '4'
created_by_id:
type: string
example: '5'
amount:
type: number
example: 25.0
amount_used:
type: number
example: 10.0
memo:
type: string
example: This credit was given as a refund
currency:
type: string
example: USD
amount_authorized:
type: number
example: 15.5
originator_id:
type: string
example: '3'
originator_type:
type: string
example: Refund
type_id:
type: string
example: '1'
store_id:
type: string
example: '2'
public_metadata:
type: object
private_metadata:
type: object
required:
- store_credit
x-internal: true
create_tax_category_params:
type: object
properties:
tax_category:
type: object
required:
- name
properties:
name:
type: string
example: Clothing
is_default:
type: boolean
example: true
tax_code:
type: string
example: 1257L
description:
type: string
example: Men's, women's and children's branded clothing
required:
- tax_category
x-internal: true
update_tax_category_params:
type: object
properties:
tax_category:
type: object
required:
- name
properties:
name:
type: string
example: Clothing
is_default:
type: boolean
example: true
tax_code:
type: string
example: 1257L
description:
type: string
example: Men's, women's and children's branded clothing
required:
- tax_category
x-internal: true
create_tax_rate_params:
type: object
properties:
tax_rate:
type: object
required:
- amount
- calculator_attributes
- tax_category_id
properties:
amount:
type: number
example: 0.05
zone_id:
type: string
example: '2'
tax_category_id:
type: string
example: '1'
included_in_price:
type: boolean
example: true
name:
type: string
example: California
show_rate_in_label:
type: boolean
example: false
calculator_attributes:
type: object
properties:
type:
type: string
example: Spree::Calculator::FlatRate
preferences:
type: object
example:
amount: 0
currency: USD
required:
- tax_rate
x-internal: true
update_tax_rate_params:
type: object
properties:
tax_rate:
type: object
required:
- amount
- calculator_attributes
- tax_category_id
properties:
amount:
type: number
example: 0.05
zone_id:
type: string
example: '2'
tax_category_id:
type: string
example: '1'
included_in_price:
type: boolean
example: true
name:
type: string
example: California
show_rate_in_label:
type: boolean
example: false
calculator_attributes:
type: object
properties:
type:
type: string
example: Spree::Calculator::FlatRate
preferences:
type: object
example:
amount: 0
currency: USD
required:
- tax_rate
x-internal: true
create_taxon_params:
type: object
properties:
taxon:
type: object
required:
- name
- taxonomy_id
properties:
taxonomy_id:
type: string
parent_id:
type: string
name:
type: string
public_metadata:
type: object
example:
ability_to_recycle: 90%
private_metadata:
type: object
example:
profitability: 2
required:
- taxon
x-internal: true
update_taxon_params:
type: object
properties:
taxon:
type: object
properties:
taxonomy_id:
type: string
parent_id:
type: string
name:
type: string
public_metadata:
type: object
private_metadata:
type: object
required:
- taxon
x-internal: true
taxon_reposition:
type: object
properties:
taxon:
type: object
required:
- new_parent_id
- new_position_idx
properties:
new_parent_id:
type: integer
example: 1
description: The ID of the new target parent Taxon.
new_position_idx:
type: integer
example: 1
description: The new index position of the Taxon within the parent Taxon.
required:
- taxon
title: Reposition a Taxon
x-internal: true
create_taxonomy_params:
type: object
properties:
taxonomy:
type: object
required:
- name
properties:
name:
type: string
position:
type: integer
example: 2
description: 'Pass the position that you want this Taxonomy to appear
in. (The list is not zero indexed, so the first item is position:
`1`)'
public_metadata:
type: object
example:
ability_to_recycle: 90%
private_metadata:
type: object
example:
profitability: 2
required:
- taxonomy
x-internal: true
update_taxonomy_params:
type: object
properties:
taxonomy:
type: object
properties:
name:
type: string
position:
type: integer
example: 2
description: 'Pass the position that you want this Taxonomy to appear
in. (The list is not zero indexed, so the first item is position:
`1`)'
public_metadata:
type: object
example:
ability_to_recycle: 90%
private_metadata:
type: object
example:
profitability: 2
required:
- taxonomy
x-internal: true
create_user_params:
type: object
properties:
user:
type: object
required:
- email
- password
- password_confirmation
properties:
email:
type: string
password:
type: string
password_confirmation:
type: string
ship_address_id:
type: string
bill_address_id:
type: string
public_metadata:
type: object
private_metadata:
type: object
required:
- user
x-internal: true
update_user_params:
type: object
properties:
user:
type: object
properties:
email:
type: string
password:
type: string
password_confirmation:
type: string
ship_address_id:
type: string
bill_address_id:
type: string
public_metadata:
type: object
private_metadata:
type: object
required:
- user
x-internal: true
create_webhook_subscriber_params:
type: object
properties:
subscriber:
type: object
required:
- url
properties:
active:
type: boolean
example: true
default: false
subscriptions:
type: array
items:
allOf:
- type: string
example: order.completed
example:
- order.created
- order.completed
- product.updated
default: []
url:
type: string
example: https://www.url.com/
required:
- subscriber
x-internal: true
update_webhook_subscriber_params:
type: object
properties:
subscriber:
type: object
required:
- url
properties:
active:
type: boolean
example: true
default: false
subscriptions:
type: array
items:
allOf:
- type: string
example: order.completed
example:
- order.created
- order.completed
- product.updated
default: []
url:
type: string
example: https://www.url.com/
required:
- subscriber
x-internal: true
create_wishlist_params:
type: object
properties:
wishlist:
type: object
required:
- name
- user_id
properties:
name:
type: string
user_id:
type: string
is_default:
type: boolean
is_private:
type: boolean
required:
- wishlist
x-internal: true
update_wishlist_params:
type: object
properties:
wishlist:
type: object
properties:
name:
type: string
user_id:
type: string
is_default:
type: boolean
is_private:
type: boolean
required:
- wishlist
x-internal: true
create_wished_item_params:
type: object
properties:
wished_item:
type: object
required:
- wishlist_id
- variant_id
- quantity
properties:
wishlist_id:
type: string
variant_id:
type: string
quantity:
type: integer
description: Must be an integer greater than 0
required:
- wished_item
x-internal: true
update_wished_item_params:
type: object
properties:
wished_item:
type: object
required:
- wishlist_id
- variant_id
- quantity
properties:
wishlist_id:
type: string
variant_id:
type: string
quantity:
type: integer
description: Must be an integer greater than 0
required:
- wished_item
x-internal: true
create_zone_params:
type: object
properties:
zone:
type: object
required:
- name
properties:
name:
type: string
example: EU
description:
type: string
example: All countries in the EU
default_tax:
type: boolean
kind:
type: string
example: state
enum:
- state
- country
required:
- zone
x-internal: true
update_zone_params:
type: object
properties:
address:
type: object
properties:
name:
type: string
example: EU
description:
type: string
example: All countries in the EU
default_tax:
type: boolean
kind:
type: string
example: state
enum:
- state
- country
required:
- zone
x-internal: true
amount_param:
type: object
properties:
amount:
type: number
x-internal: true
coupon_code_param:
type: object
properties:
coupon_code:
type: string
x-internal: true
resources_list:
type: object
properties:
data:
type: array
items:
allOf:
- "$ref": "#/components/schemas/resource_properties"
meta:
type: object
properties:
count:
type: integer
total_count:
type: integer
total_pages:
type: integer
required:
- count
- total_count
- total_pages
links:
type: object
properties:
self:
type: string
next:
type: string
prev:
type: string
last:
type: string
first:
type: string
required:
- self
- next
- prev
- last
- first
required:
- data
- meta
- links
x-internal: true
resource_properties:
type: object
properties:
id:
type: string
type:
type: string
attributes:
type: object
relationships:
type: object
required:
- id
- type
- attributes
x-internal: true
resource:
type: object
properties:
data:
"$ref": "#/components/schemas/resource_properties"
required:
- data
x-internal: true
error:
type: object
properties:
error:
type: string
required:
- error
x-internal: true
validation_errors:
type: object
properties:
error:
type: string
errors:
type: object
required:
- error
- errors
x-internal: true