Skip to main content
Each entry is dated by the day the change reached the API. A Breaking change means an existing integration may need an update. After the change, the error for an outdated request says what to call instead.
Maker details on products/get
New: products/get can return details about the product’s maker. Pass includeMakerDetails: true, and the response includes maker.details:
  • manufacturingDays and shippingDays, each as { min, max }.
  • The maker’s location, story, production process, reviews and policies.
The two day ranges describe the maker, not this product, and assume standard shipping to any destination.maker.details is null when the details are temporarily unavailable.
Webhooks
New: jobs from patterns/create, refines, products/create and products/generate send a signed job.succeeded or job.failed webhook when they finish. Add a destination in Arcade Studio under Settings → API keys → Manage webhooks. Polling with jobs/get keeps working.Changed: a job interrupted by a restart now finishes on its own. Before, it finished only when you next read it.Changed: a late result no longer replaces a job’s final result.
Lowest price in a category
New: categories/get returns startingPrice: the lowest price in the category across all makers, including shipping and duty, with the selections that give that price.It is a starting price, not a quote. It is null when no price is available, and always null in a jewelry category.
categoryId removed from patterns/create
Breaking: patterns/create no longer takes a categoryId. Sending one returns 422. To make a product from a prompt, call products/generate.Breaking: a job that patterns/create started with a categoryId is now a product job, and its result is { "productId": ... }. This applies to jobs started before this change too. To get the product’s pattern, call products/get.
Out of credits
New: you can tell when a request or job failed because the account ran out of credits, and offer the user credits or a plan:
  • A refused request has data.reason set to insufficient_credits.
  • A failed job has error.reason set to insufficient_credits.
Products from a prompt
New: products/generate makes one product from a prompt, in a print or jewelry category. It takes only requestId, prompt and categoryId. Its job is a product job, and the job’s result is { "productId": ... }.Deprecated: categoryId on patterns/create. Use products/generate instead. The field was removed on 2026-11-03.Breaking:
  • A job started by products/generate finishes when the product is built, not when its image is generated. To get the product’s pattern, call products/get.
  • A jewelry product’s image is not a pattern. patterns/list doesn’t list it. patterns/get, every refine and products/create return 400 for it, and so does using it as a reference.
  • A categoryId that doesn’t exist or isn’t offered returns 404.
Original artwork
New: you can upload your own artwork as a pattern and make products from it with products/create.
Jewelry prompt check
New: a products/generate request whose prompt clearly doesn’t fit its jewelry category returns 400, and no job starts. The message names the category.
Jewelry
New: jewelry categories. Every category from categories/list and categories/get now has a world, either print or jewelry. A category can also name the group it belongs to. See the jewelry quickstart.