Can I change a product's variants through the API, and what does the API cover?

changeapi

Yes. The public API can replace the variants of a product, and it can list them.

  • Replace variants: PUT /v1/drops/{drop_id}/products/{product_id}/variants. This replaces all variants on the product with the list you send. It is not a partial update, so send the full set you want to keep. If anything in your list is invalid, nothing is changed and the error tells you which rows to fix.
  • List variants: GET /v1/products/{product_id}/variants.
  • Change product details: PATCH /v1/products/{product_id} changes the title, description, certificate and letter insert only.

Changes reach your store when you publish the drop (POST /v1/drops/{drop_id}/publish).

If the product has already sold. Replacing variants removes the old ones and creates new ones with new ids. Sold counts are not carried over, so each new limited edition starts again at number 1. The API has no call to mark numbers as sold. After replacing, open the product in the Sell app, click the figure in the Editions sold column and tick the numbers that have already been sold. Save the new variant ids too, because orders placed through the API refer to them.

The API covers uploads, drops, products and variants, page styles, recommendations, publishing, orders and invoices. Hand-signing is not part of it.

API access must be switched on for your account first. The full reference is at https://sell.creativehub.io/api-docs. See How to create API tokens.

If you are deciding which sizes and frames to offer as variants, framed prints explained covers what each option means for the buyer.

Still need a hand?

Ask the in-app help assistant from your creativehub dashboard, or email us — a real person replies. info@creativehub.io