# Spree Commerce documentation: v6.x API Reference Admin API Endpoints Products > Spree Commerce is an open-source headless commerce platform. The backend runs as a Docker image (ghcr.io/spree/spree) and exposes REST Store and Admin APIs with OpenAPI specs, TypeScript SDKs (@spree/sdk, @spree/admin-sdk), webhooks and an MCP server with read and write tools, plus a React admin dashboard, a Next.js storefront, B2B and wholesale (companies, customer-specific catalogs and price lists) and a built-in multi-vendor marketplace. Start with `npx create-spree-app@latest my-store`: you need only Node.js, Git and Docker. ## Products - [List product custom fields](https://spreecommerce.org/docs/api-reference/admin-api/products/list-product-custom-fields.md): Returns the product's custom field values. - [Create a product custom field](https://spreecommerce.org/docs/api-reference/admin-api/products/create-a-product-custom-field.md): Sets a custom field value on the product. Requires an existing CustomFieldDefinition; pass its prefixed `cfdef_…` id. - [Show a product custom field](https://spreecommerce.org/docs/api-reference/admin-api/products/show-a-product-custom-field.md): **Required scope:** `read_products` (for API-key authentication). - [Delete a product custom field](https://spreecommerce.org/docs/api-reference/admin-api/products/delete-a-product-custom-field.md): **Required scope:** `write_products` (for API-key authentication). - [Update a product custom field](https://spreecommerce.org/docs/api-reference/admin-api/products/update-a-product-custom-field.md): Updates the custom field's `value`. The linked definition cannot be changed — delete and recreate to switch. - [List product digital assets](https://spreecommerce.org/docs/api-reference/admin-api/products/list-product-digital-assets.md): Returns the downloadable files attached to the product's variants, oldest first. - [Create a product digital asset](https://spreecommerce.org/docs/api-reference/admin-api/products/create-a-product-digital-asset.md): Attaches a downloadable file to one of the product's variants (the default variant when `variant_id` is omitted). Upload the file first through `POST /api/v3/admin/files` with `visibility: 'private'`, then send its `signed_id` here. A provider-backed asset sends `provider_type` and `provider_setting… - [Update a product digital asset](https://spreecommerce.org/docs/api-reference/admin-api/products/update-a-product-digital-asset.md): Changes an asset's download limits, or replaces its file with a new private `signed_id`. Links customers already received keep working and serve the new file. - [List product translations](https://spreecommerce.org/docs/api-reference/admin-api/products/list-product-translations.md): Returns the full translation matrix for the product: the source value and content type per translatable field, plus the translated value for every supported locale. - [List products](https://spreecommerce.org/docs/api-reference/admin-api/products/list-products.md): Returns a paginated list of products for the current store. - [Create a product](https://spreecommerce.org/docs/api-reference/admin-api/products/create-a-product.md): Creates a new product. Supports nested variants with prices and option types. - [Get a product](https://spreecommerce.org/docs/api-reference/admin-api/products/get-a-product.md): Returns a single product by ID. - [Delete a product](https://spreecommerce.org/docs/api-reference/admin-api/products/delete-a-product.md): Soft-deletes a product. - [Update a product](https://spreecommerce.org/docs/api-reference/admin-api/products/update-a-product.md): Updates a product. Only provided fields are updated. - [Clone a product](https://spreecommerce.org/docs/api-reference/admin-api/products/clone-a-product.md): Creates a draft copy of a product, named "COPY OF …", with its variants, prices, stock locations, images, categories, channels and tags; stock on hand starts at zero. Use it to start a similar product from an existing one instead of building it from scratch. - [Bulk-update product status](https://spreecommerce.org/docs/api-reference/admin-api/products/bulk-update-product-status.md): Sets `status` on each product in `ids`. Reindexes the affected products for search. Cross-store IDs are silently dropped. Returns counts. - [Bulk-add products to categories](https://spreecommerce.org/docs/api-reference/admin-api/products/bulk-add-products-to-categories.md): Attaches each product in `ids` to every category (category) in `category_ids`. Categories from sibling stores are silently ignored. - [Bulk-remove products from categories](https://spreecommerce.org/docs/api-reference/admin-api/products/bulk-remove-products-from-categories.md): Detaches each product in `ids` from every category in `category_ids`. - [Bulk-add products to collections](https://spreecommerce.org/docs/api-reference/admin-api/products/bulk-add-products-to-collections.md): Attaches each product in `ids` to every manual collection in `collection_ids`. Automatic (rule-based) and sibling-store collections are silently ignored. - [Bulk-remove products from collections](https://spreecommerce.org/docs/api-reference/admin-api/products/bulk-remove-products-from-collections.md): Detaches each product in `ids` from every collection in `collection_ids`. - [Bulk-add products to channels](https://spreecommerce.org/docs/api-reference/admin-api/products/bulk-add-products-to-channels.md): Publishes each product in `ids` on every channel in `channel_ids`. Idempotent — re-publishing on an existing channel is a no-op. Channels from sibling stores are silently ignored. - [Bulk-remove products from channels](https://spreecommerce.org/docs/api-reference/admin-api/products/bulk-remove-products-from-channels.md): Unpublishes each product in `ids` from every channel in `channel_ids`. - [Bulk-add tags to products](https://spreecommerce.org/docs/api-reference/admin-api/products/bulk-add-tags-to-products.md): Adds each tag name in `tags` to every product in `ids`. Tags are upserted by name. - [Bulk-remove tags from products](https://spreecommerce.org/docs/api-reference/admin-api/products/bulk-remove-tags-from-products.md): Removes each tag in `tags` from every product in `ids`. - [Bulk-delete products](https://spreecommerce.org/docs/api-reference/admin-api/products/bulk-delete-products.md): Soft-deletes each product in `ids`. Returns the count actually destroyed. - [Approve a submitted product](https://spreecommerce.org/docs/api-reference/admin-api/products/approve-a-submitted-product.md): Puts a product a seller submitted for review on sale, and closes the submission. Only a product awaiting review can be approved. - [Reject a submitted product](https://spreecommerce.org/docs/api-reference/admin-api/products/reject-a-submitted-product.md): Turns down a product a seller submitted for review. The `reason` is sent back to the seller, who can fix the product and submit it again. - [Activate a product](https://spreecommerce.org/docs/api-reference/admin-api/products/activate-a-product.md): Puts one product on sale. Runs the activation workflow, so its hooks and the `product.activated` event fire, which `bulk_status_update` does not. A product awaiting review is refused: approve or reject it instead. - [Archive a product](https://spreecommerce.org/docs/api-reference/admin-api/products/archive-a-product.md): Takes one product off sale and archives it; activating it puts it back on sale. Runs the archive workflow, so its hooks and its event fire. A product awaiting review is refused: approve or reject it instead. - [Move a product back to draft](https://spreecommerce.org/docs/api-reference/admin-api/products/move-a-product-back-to-draft.md): Takes one product off sale, back to a draft. Runs the draft workflow, so its hooks and its event fire. A product awaiting review is refused: approve or reject it instead. - [Translation coverage for a resource type](https://spreecommerce.org/docs/api-reference/admin-api/products/translation-coverage-for-a-resource-type.md): Reports how much of each record is translated into each of the store's non-default locales, plus per-locale totals. A record counts as covered for a locale only when every one of its translatable fields is filled in. ## OpenAPI Specs - [admin](/docs/api-reference/admin.yaml)