blog

Retrieve a blog post

get/blog/posts/{id}

Retrieves the details of an existing blog post. You need only supply the unique model identifier that was returned upon model creation.

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the blog post to be retrieved.507f191e810c19729de860ea

Responses

Status CodeResultType
200SuccessBlogPostModel

Update a blog post

put/blog/posts/{id}

Update an existing blog post.

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the blog post to be updated.507f191e810c19729de860ea

Body Parameters

namerequireddescription
blogpostoptionalThe fields to update

Responses

Status CodeResultType
200SuccessBlogPostModel

Delete a blog post

delete/blog/posts/{id}

Permanently deletes a blog post. It cannot be undone

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the blog post to be deleted.507f191e810c19729de860ea

Responses

Status CodeResultType
200Success

List all blog posts

get/blog/posts

Returns a list of your blog posts. The blog posts are returned sorted by creation date, with the most recent blog posts appearing first.

Query Parameters

nametyperequireddescriptionexample
limitintegeroptionalA limit on the number of objects to be returned. Limit can range between 1 and 100 items. (default is 10)
starting_afterstringoptionalA cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.53fabc07b7987212a01acffc
ending_beforestringoptionalA cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.54c85cceb79872183cee5f3b

Responses

Status CodeResultType
200SuccessBlogPostListModel

Create a blog post

post/blog/posts

Creates a new blog post object.

Body Parameters

namerequireddescription
blogpostoptional

Responses

Status CodeResultType
200SuccessBlogPostModel

Add blog post hero image

post/blog/posts/{id}/image

Add an image to a blog post hero

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the blog post.507f191e810c19729de860ea

Body Parameters

namerequireddescription
imageoptional

Responses

Status CodeResultType
200Success

Remove blog post hero image

delete/blog/posts/{id}/image

Remove the hero image from a blog post

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the blog post.507f191e810c19729de860ea

Responses

Status CodeResultType
200Success

categories

Retrieve a category

get/categories/{id}

Retrieves the details of an existing category. You need only supply the unique model identifier that was returned upon model creation.

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the category to be retrieved.507f191e810c19729de860ea

Responses

Status CodeResultType
200SuccessCategoryModel

Update a category

put/categories/{id}

Update an existing category.

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the category to be updated.507f191e810c19729de860ea

Body Parameters

namerequireddescription
categoryoptionalThe fields to update

Responses

Status CodeResultType
200SuccessCategoryModel

Delete a category

delete/categories/{id}

Permanently deletes a category. It cannot be undone

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the category to be deleted.507f191e810c19729de860ea

Responses

Status CodeResultType
200Success

List all categories

get/categories

Returns a list of your categories. The categories are returned sorted by creation date, with the most recent categories appearing first.

Query Parameters

nametyperequireddescriptionexample
limitintegeroptionalA limit on the number of objects to be returned. Limit can range between 1 and 100 items. (default is 10)
starting_afterstringoptionalA cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.53fabc07b7987212a01acffc
ending_beforestringoptionalA cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.54c85cceb79872183cee5f3b

Responses

Status CodeResultType
200SuccessCategoryListModel

Create a category

post/categories

Creates a new category object.

Body Parameters

namerequireddescription
categoryoptional

Responses

Status CodeResultType
200SuccessCategoryModel

Add category image

post/categories/{id}/image

Add an image to a category

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the category.507f191e810c19729de860ea

Body Parameters

namerequireddescription
imageoptional

Responses

Status CodeResultType
200Success

Remove category image

delete/categories/{id}/image

Remove the image from a category

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the category.507f191e810c19729de860ea

Responses

Status CodeResultType
200Success

customers

Retrieve a customer

get/customers/{id}

Retrieves the details of an existing customer. You need only supply the unique model identifier that was returned upon model creation.

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the customer to be retrieved.507f191e810c19729de860ea

Responses

Status CodeResultType
200SuccessCustomerModel

Update a customer

put/customers/{id}

Update an existing customer.

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the customer to be updated.507f191e810c19729de860ea

Body Parameters

namerequireddescription
customeroptionalThe fields to update

Responses

Status CodeResultType
200SuccessCustomerModel

Delete a customer

delete/customers/{id}

Permanently deletes a customer. It cannot be undone

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the customer to be deleted.507f191e810c19729de860ea

Responses

Status CodeResultType
200Success

List all customers

get/customers

Returns a list of your customers. The customers are returned sorted by creation date, with the most recent customers appearing first.

Query Parameters

nametyperequireddescriptionexample
emailstringoptional
limitintegeroptionalA limit on the number of objects to be returned. Limit can range between 1 and 100 items. (default is 10)
starting_afterstringoptionalA cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.53fabc07b7987212a01acffc
ending_beforestringoptionalA cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.54c85cceb79872183cee5f3b

Responses

Status CodeResultType
200SuccessCustomerListModel

Create a customer

post/customers

Creates a new customer object.

Body Parameters

namerequireddescription
customeroptional

Responses

Status CodeResultType
200SuccessCustomerModel

discounts

Retrieve a discount

get/discounts/{id}

Retrieves the details of an existing discount. You need only supply the unique model identifier that was returned upon model creation.

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the discount to be retrieved.507f191e810c19729de860ea

Responses

Status CodeResultType
200SuccessDiscountModel

Update a discount

put/discounts/{id}

Update an existing discount.

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the discount to be updated.507f191e810c19729de860ea

Body Parameters

namerequireddescription
discountoptionalThe fields to update

Responses

Status CodeResultType
200SuccessDiscountModel

Delete a discount

delete/discounts/{id}

Permanently deletes a discount. It cannot be undone

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the discount to be deleted.507f191e810c19729de860ea

Responses

Status CodeResultType
204Success

List all discounts

get/discounts

Returns a list of your discounts. The discounts are returned sorted by creation date, with the most recent discounts appearing first.

Query Parameters

nametyperequireddescriptionexample
discount_codestringoptional
limitintegeroptionalA limit on the number of objects to be returned. Limit can range between 1 and 100 items. (default is 10)
starting_afterstringoptionalA cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.53fabc07b7987212a01acffc
ending_beforestringoptionalA cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.54c85cceb79872183cee5f3b

Responses

Status CodeResultType
200SuccessDiscountListModel

Create a discount

post/discounts

Creates a new discount object.

Body Parameters

namerequireddescription
discountoptional

Responses

Status CodeResultType
200SuccessDiscountModel

orders

Retrieve an Order

get/orders/{id}

Retrieves the details of an existing Order. You need only supply the unique model identifier that was returned upon model creation.

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the Order to be retrieved.507f191e810c19729de860ea

Responses

Status CodeResultType
200SuccessOrderModel

List all Orders

get/orders

Returns a list of your Orders. The Orders are returned sorted by creation date, with the most recent Orders appearing first.

Query Parameters

nametyperequireddescriptionexample
customer_emailstringoptional
limitintegeroptionalA limit on the number of objects to be returned. Limit can range between 1 and 100 items. (default is 10)
starting_afterstringoptionalA cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.53fabc07b7987212a01acffc
ending_beforestringoptionalA cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.54c85cceb79872183cee5f3b

Responses

Status CodeResultType
200SuccessOrderListModel

Update an order to complete status

put/orders/{id}/complete

Update an existing order status to complete.

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the order to be updated.507f191e810c19729de860ea

Responses

Status CodeResultType
200SuccessOrderModel

products

Retrieve a product

get/products/{id}

Retrieves the details of an product. You need only supply the unique model identifier that was returned upon model creation.

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the product to be retrieved.507f191e810c19729de860ea

Responses

Status CodeResultType
200SuccessProductModel

Update a product

put/products/{id}

Update an existing product.

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the product to be updated.507f191e810c19729de860ea

Body Parameters

namerequireddescription
productoptionalThe fields to update

Responses

Status CodeResultType
200SuccessProductModel

Delete a product

delete/products/{id}

Permanently deletes a product. It cannot be undone

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the product to be deleted.507f191e810c19729de860ea

Responses

Status CodeResultType
200Success

List all products

get/products

Returns a list of your products. The products are returned sorted by creation date, with the most recent products appearing first.

Query Parameters

nametyperequireddescriptionexample
product_typestringoptional
limitintegeroptionalA limit on the number of objects to be returned. Limit can range between 1 and 100 items. (default is 10)
starting_afterstringoptionalA cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.53fabc07b7987212a01acffc
ending_beforestringoptionalA cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.54c85cceb79872183cee5f3b

Responses

Status CodeResultType
200SuccessProductListModel

Create a product

post/products

Creates a new product object.

Body Parameters

namerequireddescription
productoptional

Responses

Status CodeResultType
200SuccessProductModel

Add product image

post/products/{id}/image

Add an image to a product

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the product.507f191e810c19729de860ea

Body Parameters

namerequireddescription
imageoptional

Responses

Status CodeResultType
200Success

Remove product images

delete/products/{id}/images

Remove images from a product

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the product.507f191e810c19729de860ea

Responses

Status CodeResultType
200Success

Verify a license key

post/products/{id}/licenses/verify

Retrieves the details of a license key and the order associated with it.

Path Parameters

nametyperequireddescriptionexample
idstringrequiredthe product id507f191e810c19729de860ea

Body Parameters

namerequireddescription
licenseverifyoptional

Responses

Status CodeResultType
200SuccessLicenseVerifyModel

Assign to category

post/products/{id}/category

Allows you to assign a category to a specified product.

Path Parameters

nametyperequireddescriptionexample
idstringrequiredthe product id507f191e810c19729de860ea

Body Parameters

namerequireddescription
categoryproductoptional

Responses

Status CodeResultType
200SuccessCategoryProductPostModel

Remove from category

delete/products/{id}/category/{category_id}

Allows you to remove a category from a specified product.

Path Parameters

nametyperequireddescriptionexample
idstringrequiredthe product id507f191e810c19729de860ea
category_idstringrequiredthe category id
category_idstringrequired

Responses

Status CodeResultType
200Success

List categories

get/products/{id}/categories

Allows you to retrieve information about categories assigned to the specified product.

Path Parameters

nametyperequireddescriptionexample
idstringrequired507f191e810c19729de860ea

Query Parameters

nametyperequireddescriptionexample
product_idstringoptional
limitintegeroptionalA limit on the number of objects to be returned. Limit can range between 1 and 100 items. (default is 10)
starting_afterstringoptionalA cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.53fabc07b7987212a01acffc
ending_beforestringoptionalA cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.54c85cceb79872183cee5f3b

Responses

Status CodeResultType
200SuccessCategoryListModel

store

Retrieve store details

get/store

Get details of the store

Responses

Status CodeResultType
200SuccessStoreModel

webhooks

Retrieve a webhook

get/webhooks/{id}

Retrieves the details of an existing webhook. You need only supply the unique model identifier that was returned upon model creation.

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the webhook to be retrieved.507f191e810c19729de860ea

Responses

Status CodeResultType
200SuccessWebhookModel

Update a webhook

put/webhooks/{id}

Update an existing webhook.

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the webhook to be updated.507f191e810c19729de860ea

Body Parameters

namerequireddescription
webhookoptionalThe fields to update

Responses

Status CodeResultType
200SuccessWebhookModel

Delete a webhook

delete/webhooks/{id}

Permanently deletes a webhook. It cannot be undone

Path Parameters

nametyperequireddescriptionexample
idstringrequiredThe identifier of the webhook to be deleted.507f191e810c19729de860ea

Responses

Status CodeResultType
204Success

List all webhooks

get/webhooks

Returns a list of your webhooks. The webhooks are returned sorted by creation date, with the most recent webhooks appearing first.

Query Parameters

nametyperequireddescriptionexample
event_typestringoptional
limitintegeroptionalA limit on the number of objects to be returned. Limit can range between 1 and 100 items. (default is 10)
starting_afterstringoptionalA cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.53fabc07b7987212a01acffc
ending_beforestringoptionalA cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.54c85cceb79872183cee5f3b

Responses

Status CodeResultType
200SuccessWebhookListModel

Create a webhook

post/webhooks

Creates a new webhook object.

Body Parameters

namerequireddescription
webhookoptional

Responses

Status CodeResultType
200SuccessWebhookModel