> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arcade.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Changes to the Arcade API, newest first.

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.

**2026-11-05**

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.

**2026-11-04**

Webhooks

**New:** jobs from `patterns/create`, refines, `products/create` and `products/generate` send a signed `job.succeeded` or `job.failed` [webhook](https://docs.arcade.ai/webhooks.md) 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.

**2026-11-04**

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.

**2026-11-03**

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`.

**2026-10-20**

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`.

**2026-10-14**

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`.

**2026-10-14**

Original artwork

**New:** you can [upload your own artwork](https://docs.arcade.ai/uploads.md) as a pattern and make products from it with `products/create`.

**2026-10-11**

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.

**2026-10-10**

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](https://docs.arcade.ai/jewelry-quickstart.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.