Update a product
inventory:products.writehttps://api.holded.com/api/v2/products/{productId}Replaces all mutable fields of an existing product. This is a full replacement — any field you omit will be reset to its default value. To avoid accidentally clearing data, first fetch the product with GET, modify the fields you need, and send back the full object. Stock levels are managed separately via the stock endpoint.
Parameters
Path parameters
stringrequiredProduct ID (24-char hex ObjectId)
Request body
Product name
Product description
Stock keeping unit code
Barcode value
Unit sale price as a decimal string
nullUnit cost price as a decimal string
nullUnit purchase price as a decimal string
nullWeight in account default unit
nullList of tag names
Tax keys applied to this product. Accepts the human tax name (e.g. "IVA 21%") or the internal key (e.g. "s_iva_21"); resolved automatically.
Whether the product is available for sale
Whether the product is available for purchase
Whether the product is archived
Variants of the product (for variants, lots and serial numbers product types). Sending this field replaces all existing variants.
Variant identifier
Only for LOTS products
Only for LOTS and serial number products. ISO 8601 format. Accepts date (YYYY-MM-DD) or datetime (e.g. 2025-01-01T00:00:00+00:00)
Only for LOTS and serial number products. ISO 8601 format. Accepts date (YYYY-MM-DD) or datetime (e.g. 2025-12-31T00:00:00+00:00)
Items included in this pack product. Sending this field replaces all existing pack items.
Product ID or "productId#variantId"
Show lot start date in documents. Only for LOTS products.
Show lot end date in documents. Only for LOTS products.
Default warehouse identifier for this product
Sales channel identifier for this product
Expense/purchases accounting account identifier for this product
Request
import requests
url = "https://api.holded.com/api/v2/products/{productId}"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
payload = {
"name": "string",
"description": "string",
"sku": "string",
"barcode": "string",
"price": "49.99",
"cost": "29.99",
"purchase_price": "19.99",
"weight": 0,
"tags": [
"string"
],
"taxes": [
"s_iva_21"
],
"for_sale": false,
"for_purchase": false,
"archived": false,
"variants": [
{
"id": "string",
"sku": "string",
"barcode": "string",
"price": "19.99",
"cost": "string",
"purchase_price": "string",
"stock": 0,
"description": "string",
"weight": 0,
"factory_code": "string",
"archived": false,
"lot_number": "string",
"start_date": "2025-01-01",
"end_date": "2025-12-31"
}
],
"pack_items": [
{
"product_selection": "507f1f77bcf86cd799439011",
"units": 2
}
],
"show_start_date": false,
"show_end_date": false,
"warehouse_id": "string",
"sales_channel_id": "string",
"exp_account_id": "string"
}
response = requests.put(url, headers=headers, json=payload)
print(response.json())Responses
Response
{
"id": "string"
}Success responses
200Product updatedapplication/jsonError responses
400Bad requestapplication/json401Invalid or missing API keyapplication/json403Insufficient permissionsapplication/json404Product not foundapplication/json422Validation errorapplication/json429Rate limit exceededapplication/json