Skip to main content
PATCH
Update a store product

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required
Pattern: ^[0-9]+$

Body

application/json
data
object
required

Response

A product as it is sold at a single store, carrying its price, barcodes, department, and inventory settings.

id
string
required

Unique identifier for the record.

active
boolean
required

Whether the product is active.

barcode
string
required

Primary barcode.

brand
string | null
required

Brand name.

country_of_origin
string | null
required

ISO 3166-1 alpha-3 country code of origin.

Required string length: 3
created_at
string<date-time>
required

When the record was created.

department_id
string
required

ID of the store department this product belongs to.

Pattern: ^[0-9]+$
description
string | null
required

Short description, intended for character-limited use cases (e.g., printed receipts).

ebt_enabled
boolean
required

Whether the product is eligible for EBT/SNAP payment.

ecommerce_enabled
boolean
required

Whether the product is available for e-commerce.

food_modifier_categories
object[]
required

Food modifier categories, and their modifiers, available for this product, ordered by category priority.

is_blackhawk_gift_card
boolean
required

Whether the product is a Blackhawk gift card.

is_reloadable_blackhawk_gift_card
boolean
required

Whether the product is a reloadable Blackhawk gift card.

is_tippable
boolean
required

Whether purchases of this product can include a tip.

item_modifiers
object[]
required

Item modifiers available for this product.

loyalty_points_per_dollar
string | null
required

Loyalty points earned per dollar spent. Null defaults to one point per dollar.

Pattern: ^[0-9]+(\.[0-9]+)?$
Example:

"199.99"

manual_item
boolean
required

Whether the product is entered manually at the register rather than scanned.

maximum_retail_price
string<positive-monetary> | null
required

Upper bound for the retail price, in dollars. This is typically only used for variable-priced gift cards.

Pattern: ^[0-9]+(\.[0-9]+)?$
Example:

"199.99"

min_customer_age
integer | null
required

Minimum customer age, in years, required to purchase.

minimum_retail_price
string<positive-monetary> | null
required

Lower bound for the retail price, in dollars. This is typically only used for variable-priced gift cards.

Pattern: ^[0-9]+(\.[0-9]+)?$
Example:

"199.99"

name
string
required

Human-readable product name.

prompt_for_quantity
boolean
required

Whether the register prompts for a quantity when the product is scanned.

retail_price
string<positive-monetary> | null
required

Current shelf/retail price in dollars.

Pattern: ^[0-9]+(\.[0-9]+)?$
Example:

"199.99"

sold_by_weight
boolean
required

Whether the product is sold by weight rather than by unit.

store_id
string
required

ID of the store this product belongs to.

Pattern: ^[0-9]+$
sync_to_deli_scales
boolean
default:false
required

Whether the product is synchronized to deli scales.

target_margin
string | null
required

Target gross margin for pricing decisions, as a whole-number percentage (35 means 35%).

Pattern: ^-?[0-9]+(\.[0-9]+)?$
Example:

"199.99"

tax_rates
object[]
required

Tax rates applied to this product at the register.

updated_at
string<date-time>
required

When the record was last changed.

variable_sale_price
boolean
required

Whether the sale price is entered at the register instead of fixed.

variable_weights
object[]
required

Preset weights for products sold by weight.

wic_enabled
boolean
required

Whether the product is eligible for WIC payment.

active_vendor
object

The vendor currently supplying this product.

active_vendor_product
object

The vendor catalog entry currently supplying this product.

inventory
object

Current inventory levels. Included when requested via include=inventory.

store_vendor_products
object[]

Vendor catalog entries for this product.