All URIs are relative to https://api.brevo.com/v3
Method | HTTP request | Description |
---|---|---|
create_batch_order | POST /orders/status/batch | Create orders in batch |
create_order | POST /orders/status | Managing the status of the order |
create_update_batch_category | POST /categories/batch | Create categories in batch |
create_update_batch_products | POST /products/batch | Create products in batch |
create_update_category | POST /categories | Create/Update a category |
create_update_product | POST /products | Create/Update a product |
ecommerce_activate_post | POST /ecommerce/activate | Activate the eCommerce app |
ecommerce_attribution_metrics_conversion_source_conversion_source_id_get | GET /ecommerce/attribution/metrics/{conversionSource}/{conversionSourceId} | Get detailed attribution metrics for a single Brevo campaign |
ecommerce_attribution_metrics_get | GET /ecommerce/attribution/metrics | Get attribution metrics for one or more Brevo campaigns |
ecommerce_attribution_products_conversion_source_conversion_source_id_get | GET /ecommerce/attribution/products/{conversionSource}/{conversionSourceId} | Get attributed product sales for a single Brevo campaign |
get_categories | GET /categories | Return all your categories |
get_category_info | GET /categories/{id} | Get a category details |
get_orders | GET /orders | Get order details |
get_product_info | GET /products/{id} | Get a product's details |
get_products | GET /products | Return all your products |
create_batch_order(order_batch)
Create orders in batch
Create multiple orders at one time instead of one order at a time
# load the gem
require 'brevo'
# setup authorization
Brevo.configure do |config|
# Configure API key authorization: api-key
config.api_key['api-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['api-key'] = 'Bearer'
# Configure API key authorization: partner-key
config.api_key['partner-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['partner-key'] = 'Bearer'
end
api_instance = Brevo::EcommerceApi.new
order_batch = Brevo::OrderBatch.new # OrderBatch |
begin
#Create orders in batch
api_instance.create_batch_order(order_batch)
rescue Brevo::ApiError => e
puts "Exception when calling EcommerceApi->create_batch_order: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
order_batch | OrderBatch |
nil (empty response body)
- Content-Type: application/json
- Accept: application/json
create_order(order)
Managing the status of the order
Manages the transactional status of the order
# load the gem
require 'brevo'
# setup authorization
Brevo.configure do |config|
# Configure API key authorization: api-key
config.api_key['api-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['api-key'] = 'Bearer'
# Configure API key authorization: partner-key
config.api_key['partner-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['partner-key'] = 'Bearer'
end
api_instance = Brevo::EcommerceApi.new
order = Brevo::Order.new # Order |
begin
#Managing the status of the order
api_instance.create_order(order)
rescue Brevo::ApiError => e
puts "Exception when calling EcommerceApi->create_order: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
order | Order |
nil (empty response body)
- Content-Type: application/json
- Accept: application/json
CreateUpdateBatchCategoryModel create_update_batch_category(create_update_batch_category)
Create categories in batch
# load the gem
require 'brevo'
# setup authorization
Brevo.configure do |config|
# Configure API key authorization: api-key
config.api_key['api-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['api-key'] = 'Bearer'
# Configure API key authorization: partner-key
config.api_key['partner-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['partner-key'] = 'Bearer'
end
api_instance = Brevo::EcommerceApi.new
create_update_batch_category = Brevo::CreateUpdateBatchCategory.new # CreateUpdateBatchCategory | Values to create a batch of categories
begin
#Create categories in batch
result = api_instance.create_update_batch_category(create_update_batch_category)
p result
rescue Brevo::ApiError => e
puts "Exception when calling EcommerceApi->create_update_batch_category: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
create_update_batch_category | CreateUpdateBatchCategory | Values to create a batch of categories |
CreateUpdateBatchCategoryModel
- Content-Type: application/json
- Accept: application/json
CreateUpdateBatchProductsModel create_update_batch_products(create_update_batch_products)
Create products in batch
# load the gem
require 'brevo'
# setup authorization
Brevo.configure do |config|
# Configure API key authorization: api-key
config.api_key['api-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['api-key'] = 'Bearer'
# Configure API key authorization: partner-key
config.api_key['partner-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['partner-key'] = 'Bearer'
end
api_instance = Brevo::EcommerceApi.new
create_update_batch_products = Brevo::CreateUpdateBatchProducts.new # CreateUpdateBatchProducts | Values to create a batch of products
begin
#Create products in batch
result = api_instance.create_update_batch_products(create_update_batch_products)
p result
rescue Brevo::ApiError => e
puts "Exception when calling EcommerceApi->create_update_batch_products: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
create_update_batch_products | CreateUpdateBatchProducts | Values to create a batch of products |
CreateUpdateBatchProductsModel
- Content-Type: application/json
- Accept: application/json
CreateCategoryModel create_update_category(create_update_category)
Create/Update a category
# load the gem
require 'brevo'
# setup authorization
Brevo.configure do |config|
# Configure API key authorization: api-key
config.api_key['api-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['api-key'] = 'Bearer'
# Configure API key authorization: partner-key
config.api_key['partner-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['partner-key'] = 'Bearer'
end
api_instance = Brevo::EcommerceApi.new
create_update_category = Brevo::CreateUpdateCategory.new # CreateUpdateCategory | Values to create/update a category
begin
#Create/Update a category
result = api_instance.create_update_category(create_update_category)
p result
rescue Brevo::ApiError => e
puts "Exception when calling EcommerceApi->create_update_category: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
create_update_category | CreateUpdateCategory | Values to create/update a category |
- Content-Type: application/json
- Accept: application/json
CreateProductModel create_update_product(create_update_product)
Create/Update a product
# load the gem
require 'brevo'
# setup authorization
Brevo.configure do |config|
# Configure API key authorization: api-key
config.api_key['api-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['api-key'] = 'Bearer'
# Configure API key authorization: partner-key
config.api_key['partner-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['partner-key'] = 'Bearer'
end
api_instance = Brevo::EcommerceApi.new
create_update_product = Brevo::CreateUpdateProduct.new # CreateUpdateProduct | Values to create/update a product
begin
#Create/Update a product
result = api_instance.create_update_product(create_update_product)
p result
rescue Brevo::ApiError => e
puts "Exception when calling EcommerceApi->create_update_product: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
create_update_product | CreateUpdateProduct | Values to create/update a product |
- Content-Type: application/json
- Accept: application/json
ecommerce_activate_post
Activate the eCommerce app
Getting access to Brevo eCommerce.
# load the gem
require 'brevo'
# setup authorization
Brevo.configure do |config|
# Configure API key authorization: api-key
config.api_key['api-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['api-key'] = 'Bearer'
# Configure API key authorization: partner-key
config.api_key['partner-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['partner-key'] = 'Bearer'
end
api_instance = Brevo::EcommerceApi.new
begin
#Activate the eCommerce app
api_instance.ecommerce_activate_post
rescue Brevo::ApiError => e
puts "Exception when calling EcommerceApi->ecommerce_activate_post: #{e}"
end
This endpoint does not need any parameter.
nil (empty response body)
- Content-Type: application/json
- Accept: application/json
ecommerce_attribution_metrics_conversion_source_conversion_source_id_get(conversion_source, conversion_source_id)
Get detailed attribution metrics for a single Brevo campaign
# load the gem
require 'brevo'
# setup authorization
Brevo.configure do |config|
# Configure API key authorization: api-key
config.api_key['api-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['api-key'] = 'Bearer'
# Configure API key authorization: partner-key
config.api_key['partner-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['partner-key'] = 'Bearer'
end
api_instance = Brevo::EcommerceApi.new
conversion_source = nil # Object | The Brevo campaign type for which data will be retrieved
conversion_source_id = nil # Object | The Brevo campaign id for which data will be retrieved
begin
#Get detailed attribution metrics for a single Brevo campaign
api_instance.ecommerce_attribution_metrics_conversion_source_conversion_source_id_get(conversion_source, conversion_source_id)
rescue Brevo::ApiError => e
puts "Exception when calling EcommerceApi->ecommerce_attribution_metrics_conversion_source_conversion_source_id_get: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
conversion_source | Object | The Brevo campaign type for which data will be retrieved | |
conversion_source_id | Object | The Brevo campaign id for which data will be retrieved |
nil (empty response body)
- Content-Type: application/json
- Accept: application/json
ecommerce_attribution_metrics_get(opts)
Get attribution metrics for one or more Brevo campaigns
# load the gem
require 'brevo'
# setup authorization
Brevo.configure do |config|
# Configure API key authorization: api-key
config.api_key['api-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['api-key'] = 'Bearer'
# Configure API key authorization: partner-key
config.api_key['partner-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['partner-key'] = 'Bearer'
end
api_instance = Brevo::EcommerceApi.new
opts = {
period_from: nil, # Object | When getting metrics for a specific period, define the starting datetime in RFC3339 format
period_to: nil, # Object | When getting metrics for a specific period, define the end datetime in RFC3339 format
email_campaign_id: nil # Object | The email campaign id(s) to get metrics for
}
begin
#Get attribution metrics for one or more Brevo campaigns
api_instance.ecommerce_attribution_metrics_get(opts)
rescue Brevo::ApiError => e
puts "Exception when calling EcommerceApi->ecommerce_attribution_metrics_get: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
period_from | Object | When getting metrics for a specific period, define the starting datetime in RFC3339 format | [optional] |
period_to | Object | When getting metrics for a specific period, define the end datetime in RFC3339 format | [optional] |
email_campaign_id | Object | The email campaign id(s) to get metrics for | [optional] |
nil (empty response body)
- Content-Type: application/json
- Accept: application/json
ecommerce_attribution_products_conversion_source_conversion_source_id_get(conversion_source, conversion_source_id)
Get attributed product sales for a single Brevo campaign
# load the gem
require 'brevo'
# setup authorization
Brevo.configure do |config|
# Configure API key authorization: api-key
config.api_key['api-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['api-key'] = 'Bearer'
# Configure API key authorization: partner-key
config.api_key['partner-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['partner-key'] = 'Bearer'
end
api_instance = Brevo::EcommerceApi.new
conversion_source = nil # Object | The Brevo campaign type for which data will be retrieved
conversion_source_id = nil # Object | The Brevo campaign id for which data will be retrieved
begin
#Get attributed product sales for a single Brevo campaign
api_instance.ecommerce_attribution_products_conversion_source_conversion_source_id_get(conversion_source, conversion_source_id)
rescue Brevo::ApiError => e
puts "Exception when calling EcommerceApi->ecommerce_attribution_products_conversion_source_conversion_source_id_get: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
conversion_source | Object | The Brevo campaign type for which data will be retrieved | |
conversion_source_id | Object | The Brevo campaign id for which data will be retrieved |
nil (empty response body)
- Content-Type: application/json
- Accept: application/json
GetCategories get_categories(opts)
Return all your categories
# load the gem
require 'brevo'
# setup authorization
Brevo.configure do |config|
# Configure API key authorization: api-key
config.api_key['api-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['api-key'] = 'Bearer'
# Configure API key authorization: partner-key
config.api_key['partner-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['partner-key'] = 'Bearer'
end
api_instance = Brevo::EcommerceApi.new
opts = {
limit: 50, # Integer | Number of documents per page
offset: 0, # Integer | Index of the first document in the page
sort: 'desc', # String | Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed
ids: ['ids_example'], # Array<String> | Filter by category ids
name: 'name_example', # String | Filter by category name
modified_since: 'modified_since_example', # String | Filter (urlencoded) the categories modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.**
created_since: 'created_since_example' # String | Filter (urlencoded) the categories created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.**
}
begin
#Return all your categories
result = api_instance.get_categories(opts)
p result
rescue Brevo::ApiError => e
puts "Exception when calling EcommerceApi->get_categories: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
limit | Integer | Number of documents per page | [optional] [default to 50] |
offset | Integer | Index of the first document in the page | [optional] [default to 0] |
sort | String | Sort the results in the ascending/descending order of record creation. Default order is descending if `sort` is not passed | [optional] [default to desc] |
ids | Array<String> | Filter by category ids | [optional] |
name | String | Filter by category name | [optional] |
modified_since | String | Filter (urlencoded) the categories modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result. | [optional] |
created_since | String | Filter (urlencoded) the categories created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result. | [optional] |
- Content-Type: application/json
- Accept: application/json
GetCategoryDetails get_category_info(id)
Get a category details
# load the gem
require 'brevo'
# setup authorization
Brevo.configure do |config|
# Configure API key authorization: api-key
config.api_key['api-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['api-key'] = 'Bearer'
# Configure API key authorization: partner-key
config.api_key['partner-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['partner-key'] = 'Bearer'
end
api_instance = Brevo::EcommerceApi.new
id = 'id_example' # String | Category ID
begin
#Get a category details
result = api_instance.get_category_info(id)
p result
rescue Brevo::ApiError => e
puts "Exception when calling EcommerceApi->get_category_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
id | String | Category ID |
- Content-Type: application/json
- Accept: application/json
GetOrders get_orders(opts)
Get order details
Get all the orders
# load the gem
require 'brevo'
# setup authorization
Brevo.configure do |config|
# Configure API key authorization: api-key
config.api_key['api-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['api-key'] = 'Bearer'
# Configure API key authorization: partner-key
config.api_key['partner-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['partner-key'] = 'Bearer'
end
api_instance = Brevo::EcommerceApi.new
opts = {
limit: 50, # Integer | Number of documents per page
offset: 0, # Integer | Index of the first document in the page
sort: 'desc', # String | Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed
modified_since: 'modified_since_example', # String | Filter (urlencoded) the orders modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.**
created_since: 'created_since_example' # String | Filter (urlencoded) the orders created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.**
}
begin
#Get order details
result = api_instance.get_orders(opts)
p result
rescue Brevo::ApiError => e
puts "Exception when calling EcommerceApi->get_orders: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
limit | Integer | Number of documents per page | [optional] [default to 50] |
offset | Integer | Index of the first document in the page | [optional] [default to 0] |
sort | String | Sort the results in the ascending/descending order of record creation. Default order is descending if `sort` is not passed | [optional] [default to desc] |
modified_since | String | Filter (urlencoded) the orders modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result. | [optional] |
created_since | String | Filter (urlencoded) the orders created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result. | [optional] |
- Content-Type: application/json
- Accept: application/json
GetProductDetails get_product_info(id)
Get a product's details
# load the gem
require 'brevo'
# setup authorization
Brevo.configure do |config|
# Configure API key authorization: api-key
config.api_key['api-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['api-key'] = 'Bearer'
# Configure API key authorization: partner-key
config.api_key['partner-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['partner-key'] = 'Bearer'
end
api_instance = Brevo::EcommerceApi.new
id = 'id_example' # String | Product ID
begin
#Get a product's details
result = api_instance.get_product_info(id)
p result
rescue Brevo::ApiError => e
puts "Exception when calling EcommerceApi->get_product_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
id | String | Product ID |
- Content-Type: application/json
- Accept: application/json
GetProducts get_products(opts)
Return all your products
# load the gem
require 'brevo'
# setup authorization
Brevo.configure do |config|
# Configure API key authorization: api-key
config.api_key['api-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['api-key'] = 'Bearer'
# Configure API key authorization: partner-key
config.api_key['partner-key'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['partner-key'] = 'Bearer'
end
api_instance = Brevo::EcommerceApi.new
opts = {
limit: 50, # Integer | Number of documents per page
offset: 0, # Integer | Index of the first document in the page
sort: 'desc', # String | Sort the results in the ascending/descending order of record creation. Default order is **descending** if `sort` is not passed
ids: ['ids_example'], # Array<String> | Filter by product ids
name: 'name_example', # String | Filter by product name, minimum 3 characters should be present for search
price_lte: 8.14, # Float | Price filter for products less than and equals to particular amount
price_gte: 8.14, # Float | Price filter for products greater than and equals to particular amount
price_lt: 8.14, # Float | Price filter for products less than particular amount
price_gt: 8.14, # Float | Price filter for products greater than particular amount
price_eq: 8.14, # Float | Price filter for products equals to particular amount
price_ne: 8.14, # Float | Price filter for products not equals to particular amount
categories: ['categories_example'], # Array<String> | Filter by category ids
modified_since: 'modified_since_example', # String | Filter (urlencoded) the orders modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.**
created_since: 'created_since_example' # String | Filter (urlencoded) the orders created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.**
}
begin
#Return all your products
result = api_instance.get_products(opts)
p result
rescue Brevo::ApiError => e
puts "Exception when calling EcommerceApi->get_products: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
limit | Integer | Number of documents per page | [optional] [default to 50] |
offset | Integer | Index of the first document in the page | [optional] [default to 0] |
sort | String | Sort the results in the ascending/descending order of record creation. Default order is descending if `sort` is not passed | [optional] [default to desc] |
ids | Array<String> | Filter by product ids | [optional] |
name | String | Filter by product name, minimum 3 characters should be present for search | [optional] |
price_lte | Float | Price filter for products less than and equals to particular amount | [optional] |
price_gte | Float | Price filter for products greater than and equals to particular amount | [optional] |
price_lt | Float | Price filter for products less than particular amount | [optional] |
price_gt | Float | Price filter for products greater than particular amount | [optional] |
price_eq | Float | Price filter for products equals to particular amount | [optional] |
price_ne | Float | Price filter for products not equals to particular amount | [optional] |
categories | Array<String> | Filter by category ids | [optional] |
modified_since | String | Filter (urlencoded) the orders modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result. | [optional] |
created_since | String | Filter (urlencoded) the orders created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result. | [optional] |
- Content-Type: application/json
- Accept: application/json