Status 412
The record has changed
precondition_failed
When it happens
The version in If-Match is not current: the record changed after you read it. For If-None-Match: * — the record already exists.
What to do
Read the record again, apply your change to the fresh data and send it with the new ETag.
Can’t find the answer, or the error keeps coming back? Write to us and quote the X-Request-Id from the response so we can find the request. Contact us
Endpoints that return it
- patch
/categories/{category}Change a catalog category - delete
/categories/{category}Archive a catalog category - patch
/categories/by-external-id/{external_id}Create or change a catalog category by its external ID - patch
/products/{product}Change a product card: fields, categories, external ID - delete
/products/{product}Archive a product with its variants - patch
/products/by-external-id/{external_id}Create or update a product with its variants by its external ID - put
/products/{product}/optionsReplace the product options and lay out its variants - patch
/variants/{variant}Update a product variant - delete
/variants/{variant}Archive a product variant - patch
/variants/by-external-id/{external_id}Create or update a variant by its external ID - put
/variants/{variant}/recipeReplace the recipe of a variant: components and the yield of a prep - patch
/products/{product}/media/{media}Move a gallery photo or make it primary - delete
/products/{product}/media/{media}Remove a photo from the product gallery - patch
/modifier-groups/{group}Update a modifier group and its option set - delete
/modifier-groups/{group}Archive a modifier group - patch
/modifier-groups/by-external-id/{external_id}Create or update a modifier group by external ID - put
/products/{product}/modifier-groupsReplace the product modifier groups and their option surcharges by variant - patch
/recommendation-rules/{rule}Change a recommendation rule - delete
/recommendation-rules/{rule}Delete a recommendation rule - patch
/price-lists/{price_list}Update a price list: adjustment and rounding, and the name of a wholesale list; a location list's rule changes prices at all its locations - delete
/price-lists/{price_list}Delete a wholesale price list; its assignment to customers is removed with consent - post
/price-lists/{price_list}/itemsSet fixed variant prices in a price list in bulk - post
/price-lists/{price_list}/items/removeRemove fixed variant prices from a price list in bulk - post
/price-lists/{price_list}/modifier-itemsSet fixed modifier option surcharges in a price list in bulk - post
/price-lists/{price_list}/modifier-items/removeRemove fixed modifier option surcharges from a price list in bulk - patch
/draft-orders/{draft}Change a draft order: customer, delivery, payment method and items - delete
/draft-orders/{draft}Delete a draft order - post
/draft-orders/{draft}/completePlace the order from a draft: invoice the customer or record the payment as received - patch
/customers/{customer}Update a customer's name, language and external ID - patch
/customers/by-external-id/{external_id}Create or update a customer by its external ID - post
/customers/{customer}/wholesale-price-listAssign a wholesale price list to a customer or remove it - patch
/customers/{customer}/addresses/{address}Update a customer's address - delete
/customers/{customer}/addresses/{address}Delete an address from a customer's address book - put
/customers/{customer}/fiscal-profileReplace a customer's tax details; null makes them a retail customer - patch
/customer-groups/{customer_group}Change a group's name, description or activity - delete
/customer-groups/{customer_group}Delete a group: its memberships go with it, and discount rules and broadcasts stop targeting it - patch
/money-transactions/{transaction}Update a money transaction: only the category, counterparty and description of a transaction with a source document - delete
/money-transactions/{transaction}Delete a manual money transaction and restore the account balance - patch
/money-transfers/{money_transfer}Update a whole transfer in place: accounts, amounts, fee, date and description - delete
/money-transfers/{money_transfer}Delete a transfer with all its legs - patch
/suppliers/{supplier}Update a supplier's tax details, payment terms and external ID - patch
/suppliers/by-external-id/{external_id}Create or update a supplier by its external ID - patch
/supplier-bills/{supplier_bill}Change a draft supplier bill - delete
/supplier-bills/{supplier_bill}Delete a draft supplier bill - post
/supplier-bills/{supplier_bill}/postPost a supplier bill: it enters payables and the purchase ledger - post
/supplier-bills/{supplier_bill}/voidVoid a supplier bill together with its payments and offsets - post
/supplier-bills/{supplier_bill}/approveApprove a posted supplier bill for payment - post
/supplier-bills/{supplier_bill}/revoke-approvalRevoke the payment approval of a supplier bill - post
/supplier-bills/{supplier_bill}/payments/out-of-bandMark a supplier bill as paid outside the system - delete
/supplier-bills/{supplier_bill}/payments/{supplier_bill_payment}Cancel a supplier bill payment - patch
/purchase-orders/{purchase_order}Change a purchase order: a draft in full, a placed order’s lines, date and note with a revision - delete
/purchase-orders/{purchase_order}Delete a draft purchase order - post
/purchase-orders/{purchase_order}/placeMark a draft as placed with the supplier - post
/purchase-orders/{purchase_order}/cancelCancel a placed purchase order - post
/purchase-orders/{purchase_order}/closeClose a received purchase order - patch
/webhook-endpoints/{endpoint}Update a webhook endpoint: URL, description, event types, status - delete
/webhook-endpoints/{endpoint}Delete a webhook endpoint
Response body
application/problem+json · Problem
typestringrequiredMachine type of the problem: a stable code to branch on, such as insufficient_scope. Every type has a page in the error catalog.
titlestringrequiredShort summary of the problem in the language of the request.
statusintegerrequiredHTTP status of the response.
detailstringExplanation of this occurrence in the language of the request.