Update Product

curl --request PATCH \
  --url https://qwoty.app/api/products/{id} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "description_inherit_from_product": true,
  "primary_image_inherit_from_product": true,
  "reference": "<string>",
  "is_active": true,
  "category_ids": [
    {}
  ],
  "inventory": {
    "sku": "<string>"
  },
  "settings": {
    "unit_per_pack": 123
  },
  "accounting": {
    "ledger_account": "<string>"
  },
  "identifiers": {
    "crm": "<string>",
    "erp": "<string>",
    "accounting": "<string>"
  },
  "shipping": {
    "weight": 123,
    "weight_unit": "<string>",
    "height": 123,
    "length": 123,
    "width": 123,
    "length_unit": "<string>",
    "country_of_origin": "<string>",
    "harmonized_system_code": "<string>"
  },
  "primary_image_id": "<string>"
}
'

import requests

url = "https://qwoty.app/api/products/{id}"

payload = {
    "name": "<string>",
    "description": "<string>",
    "description_inherit_from_product": True,
    "primary_image_inherit_from_product": True,
    "reference": "<string>",
    "is_active": True,
    "category_ids": [{}],
    "inventory": { "sku": "<string>" },
    "settings": { "unit_per_pack": 123 },
    "accounting": { "ledger_account": "<string>" },
    "identifiers": {
        "crm": "<string>",
        "erp": "<string>",
        "accounting": "<string>"
    },
    "shipping": {
        "weight": 123,
        "weight_unit": "<string>",
        "height": 123,
        "length": 123,
        "width": 123,
        "length_unit": "<string>",
        "country_of_origin": "<string>",
        "harmonized_system_code": "<string>"
    },
    "primary_image_id": "<string>"
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    description: '<string>',
    description_inherit_from_product: true,
    primary_image_inherit_from_product: true,
    reference: '<string>',
    is_active: true,
    category_ids: [{}],
    inventory: {sku: '<string>'},
    settings: {unit_per_pack: 123},
    accounting: {ledger_account: '<string>'},
    identifiers: {crm: '<string>', erp: '<string>', accounting: '<string>'},
    shipping: {
      weight: 123,
      weight_unit: '<string>',
      height: 123,
      length: 123,
      width: 123,
      length_unit: '<string>',
      country_of_origin: '<string>',
      harmonized_system_code: '<string>'
    },
    primary_image_id: '<string>'
  })
};

fetch('https://qwoty.app/api/products/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://qwoty.app/api/products/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'description' => '<string>',
    'description_inherit_from_product' => true,
    'primary_image_inherit_from_product' => true,
    'reference' => '<string>',
    'is_active' => true,
    'category_ids' => [
        [
                
        ]
    ],
    'inventory' => [
        'sku' => '<string>'
    ],
    'settings' => [
        'unit_per_pack' => 123
    ],
    'accounting' => [
        'ledger_account' => '<string>'
    ],
    'identifiers' => [
        'crm' => '<string>',
        'erp' => '<string>',
        'accounting' => '<string>'
    ],
    'shipping' => [
        'weight' => 123,
        'weight_unit' => '<string>',
        'height' => 123,
        'length' => 123,
        'width' => 123,
        'length_unit' => '<string>',
        'country_of_origin' => '<string>',
        'harmonized_system_code' => '<string>'
    ],
    'primary_image_id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://qwoty.app/api/products/{id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"description_inherit_from_product\": true,\n  \"primary_image_inherit_from_product\": true,\n  \"reference\": \"<string>\",\n  \"is_active\": true,\n  \"category_ids\": [\n    {}\n  ],\n  \"inventory\": {\n    \"sku\": \"<string>\"\n  },\n  \"settings\": {\n    \"unit_per_pack\": 123\n  },\n  \"accounting\": {\n    \"ledger_account\": \"<string>\"\n  },\n  \"identifiers\": {\n    \"crm\": \"<string>\",\n    \"erp\": \"<string>\",\n    \"accounting\": \"<string>\"\n  },\n  \"shipping\": {\n    \"weight\": 123,\n    \"weight_unit\": \"<string>\",\n    \"height\": 123,\n    \"length\": 123,\n    \"width\": 123,\n    \"length_unit\": \"<string>\",\n    \"country_of_origin\": \"<string>\",\n    \"harmonized_system_code\": \"<string>\"\n  },\n  \"primary_image_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://qwoty.app/api/products/{id}")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"description_inherit_from_product\": true,\n  \"primary_image_inherit_from_product\": true,\n  \"reference\": \"<string>\",\n  \"is_active\": true,\n  \"category_ids\": [\n    {}\n  ],\n  \"inventory\": {\n    \"sku\": \"<string>\"\n  },\n  \"settings\": {\n    \"unit_per_pack\": 123\n  },\n  \"accounting\": {\n    \"ledger_account\": \"<string>\"\n  },\n  \"identifiers\": {\n    \"crm\": \"<string>\",\n    \"erp\": \"<string>\",\n    \"accounting\": \"<string>\"\n  },\n  \"shipping\": {\n    \"weight\": 123,\n    \"weight_unit\": \"<string>\",\n    \"height\": 123,\n    \"length\": 123,\n    \"width\": 123,\n    \"length_unit\": \"<string>\",\n    \"country_of_origin\": \"<string>\",\n    \"harmonized_system_code\": \"<string>\"\n  },\n  \"primary_image_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://qwoty.app/api/products/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"description_inherit_from_product\": true,\n  \"primary_image_inherit_from_product\": true,\n  \"reference\": \"<string>\",\n  \"is_active\": true,\n  \"category_ids\": [\n    {}\n  ],\n  \"inventory\": {\n    \"sku\": \"<string>\"\n  },\n  \"settings\": {\n    \"unit_per_pack\": 123\n  },\n  \"accounting\": {\n    \"ledger_account\": \"<string>\"\n  },\n  \"identifiers\": {\n    \"crm\": \"<string>\",\n    \"erp\": \"<string>\",\n    \"accounting\": \"<string>\"\n  },\n  \"shipping\": {\n    \"weight\": 123,\n    \"weight_unit\": \"<string>\",\n    \"height\": 123,\n    \"length\": 123,\n    \"width\": 123,\n    \"length_unit\": \"<string>\",\n    \"country_of_origin\": \"<string>\",\n    \"harmonized_system_code\": \"<string>\"\n  },\n  \"primary_image_id\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "product_parent_id": "660e8400-e29b-41d4-a716-446655440001",
    "workspace_id": "880e8400-e29b-41d4-a716-446655440003",
    "name": "Updated Product Name",
    "api_name": "updated_product_name",
    "reference": "PROD-001",
    "description": "Updated description",
    "description_inherit_from_product": true,
    "primary_image_inherit_from_product": true,
    "is_active": false,
    "is_default": true,
    "catalogs": [
      {
        "id": "770e8400-e29b-41d4-a716-446655440002",
        "name": "Main Catalog",
        "api_name": "catalog_main"
      }
    ],
    "categories": [],
    "settings": {
      "unit_per_pack": 1,
      "product_type": "physical",
      "language_code": null,
      "unit_of_measure": null,
      "recurrence_type": "one_off"
    },
    "shipping": {
      "weight": 2.8,
      "weight_unit": "kg",
      "length": 30,
      "width": 20,
      "height": 10,
      "length_unit": "cm",
      "country_of_origin": "FR",
      "harmonized_system_code": "8471.30"
    },
    "inventory": {
      "sku": "WID-PRE-001"
    },
    "identifiers": {
      "crm": "crm_123",
      "accounting": "acc_789",
      "erp": "erp_456"
    },
    "accounting": {
      "ledger_account": "4010"
    },
    "primary_image_id": null,
    "parent_primary_image_id": null,
    "options": [],
    "prices": [
      {
        "id": "ee0e8400-e29b-41d4-a716-446655440030",
        "key": "updated_product_name.standard",
        "pricebook": { "id": "ff0e8400-e29b-41d4-a716-446655440031", "name": "Standard", "api_name": "standard", "type": "fixed" },
        "billing_frequency": null,
        "pricing_model": "flat",
        "amount": 1990
      }
    ],
    "created_at": "2024-12-21T10:30:00Z",
    "updated_at": "2024-12-21T14:45:00Z"
  }
}

PATCH

api

products

{id}

Update Product

curl --request PATCH \
  --url https://qwoty.app/api/products/{id} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "description_inherit_from_product": true,
  "primary_image_inherit_from_product": true,
  "reference": "<string>",
  "is_active": true,
  "category_ids": [
    {}
  ],
  "inventory": {
    "sku": "<string>"
  },
  "settings": {
    "unit_per_pack": 123
  },
  "accounting": {
    "ledger_account": "<string>"
  },
  "identifiers": {
    "crm": "<string>",
    "erp": "<string>",
    "accounting": "<string>"
  },
  "shipping": {
    "weight": 123,
    "weight_unit": "<string>",
    "height": 123,
    "length": 123,
    "width": 123,
    "length_unit": "<string>",
    "country_of_origin": "<string>",
    "harmonized_system_code": "<string>"
  },
  "primary_image_id": "<string>"
}
'

import requests

url = "https://qwoty.app/api/products/{id}"

payload = {
    "name": "<string>",
    "description": "<string>",
    "description_inherit_from_product": True,
    "primary_image_inherit_from_product": True,
    "reference": "<string>",
    "is_active": True,
    "category_ids": [{}],
    "inventory": { "sku": "<string>" },
    "settings": { "unit_per_pack": 123 },
    "accounting": { "ledger_account": "<string>" },
    "identifiers": {
        "crm": "<string>",
        "erp": "<string>",
        "accounting": "<string>"
    },
    "shipping": {
        "weight": 123,
        "weight_unit": "<string>",
        "height": 123,
        "length": 123,
        "width": 123,
        "length_unit": "<string>",
        "country_of_origin": "<string>",
        "harmonized_system_code": "<string>"
    },
    "primary_image_id": "<string>"
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    description: '<string>',
    description_inherit_from_product: true,
    primary_image_inherit_from_product: true,
    reference: '<string>',
    is_active: true,
    category_ids: [{}],
    inventory: {sku: '<string>'},
    settings: {unit_per_pack: 123},
    accounting: {ledger_account: '<string>'},
    identifiers: {crm: '<string>', erp: '<string>', accounting: '<string>'},
    shipping: {
      weight: 123,
      weight_unit: '<string>',
      height: 123,
      length: 123,
      width: 123,
      length_unit: '<string>',
      country_of_origin: '<string>',
      harmonized_system_code: '<string>'
    },
    primary_image_id: '<string>'
  })
};

fetch('https://qwoty.app/api/products/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://qwoty.app/api/products/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'description' => '<string>',
    'description_inherit_from_product' => true,
    'primary_image_inherit_from_product' => true,
    'reference' => '<string>',
    'is_active' => true,
    'category_ids' => [
        [
                
        ]
    ],
    'inventory' => [
        'sku' => '<string>'
    ],
    'settings' => [
        'unit_per_pack' => 123
    ],
    'accounting' => [
        'ledger_account' => '<string>'
    ],
    'identifiers' => [
        'crm' => '<string>',
        'erp' => '<string>',
        'accounting' => '<string>'
    ],
    'shipping' => [
        'weight' => 123,
        'weight_unit' => '<string>',
        'height' => 123,
        'length' => 123,
        'width' => 123,
        'length_unit' => '<string>',
        'country_of_origin' => '<string>',
        'harmonized_system_code' => '<string>'
    ],
    'primary_image_id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://qwoty.app/api/products/{id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"description_inherit_from_product\": true,\n  \"primary_image_inherit_from_product\": true,\n  \"reference\": \"<string>\",\n  \"is_active\": true,\n  \"category_ids\": [\n    {}\n  ],\n  \"inventory\": {\n    \"sku\": \"<string>\"\n  },\n  \"settings\": {\n    \"unit_per_pack\": 123\n  },\n  \"accounting\": {\n    \"ledger_account\": \"<string>\"\n  },\n  \"identifiers\": {\n    \"crm\": \"<string>\",\n    \"erp\": \"<string>\",\n    \"accounting\": \"<string>\"\n  },\n  \"shipping\": {\n    \"weight\": 123,\n    \"weight_unit\": \"<string>\",\n    \"height\": 123,\n    \"length\": 123,\n    \"width\": 123,\n    \"length_unit\": \"<string>\",\n    \"country_of_origin\": \"<string>\",\n    \"harmonized_system_code\": \"<string>\"\n  },\n  \"primary_image_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://qwoty.app/api/products/{id}")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"description_inherit_from_product\": true,\n  \"primary_image_inherit_from_product\": true,\n  \"reference\": \"<string>\",\n  \"is_active\": true,\n  \"category_ids\": [\n    {}\n  ],\n  \"inventory\": {\n    \"sku\": \"<string>\"\n  },\n  \"settings\": {\n    \"unit_per_pack\": 123\n  },\n  \"accounting\": {\n    \"ledger_account\": \"<string>\"\n  },\n  \"identifiers\": {\n    \"crm\": \"<string>\",\n    \"erp\": \"<string>\",\n    \"accounting\": \"<string>\"\n  },\n  \"shipping\": {\n    \"weight\": 123,\n    \"weight_unit\": \"<string>\",\n    \"height\": 123,\n    \"length\": 123,\n    \"width\": 123,\n    \"length_unit\": \"<string>\",\n    \"country_of_origin\": \"<string>\",\n    \"harmonized_system_code\": \"<string>\"\n  },\n  \"primary_image_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://qwoty.app/api/products/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"description_inherit_from_product\": true,\n  \"primary_image_inherit_from_product\": true,\n  \"reference\": \"<string>\",\n  \"is_active\": true,\n  \"category_ids\": [\n    {}\n  ],\n  \"inventory\": {\n    \"sku\": \"<string>\"\n  },\n  \"settings\": {\n    \"unit_per_pack\": 123\n  },\n  \"accounting\": {\n    \"ledger_account\": \"<string>\"\n  },\n  \"identifiers\": {\n    \"crm\": \"<string>\",\n    \"erp\": \"<string>\",\n    \"accounting\": \"<string>\"\n  },\n  \"shipping\": {\n    \"weight\": 123,\n    \"weight_unit\": \"<string>\",\n    \"height\": 123,\n    \"length\": 123,\n    \"width\": 123,\n    \"length_unit\": \"<string>\",\n    \"country_of_origin\": \"<string>\",\n    \"harmonized_system_code\": \"<string>\"\n  },\n  \"primary_image_id\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "product_parent_id": "660e8400-e29b-41d4-a716-446655440001",
    "workspace_id": "880e8400-e29b-41d4-a716-446655440003",
    "name": "Updated Product Name",
    "api_name": "updated_product_name",
    "reference": "PROD-001",
    "description": "Updated description",
    "description_inherit_from_product": true,
    "primary_image_inherit_from_product": true,
    "is_active": false,
    "is_default": true,
    "catalogs": [
      {
        "id": "770e8400-e29b-41d4-a716-446655440002",
        "name": "Main Catalog",
        "api_name": "catalog_main"
      }
    ],
    "categories": [],
    "settings": {
      "unit_per_pack": 1,
      "product_type": "physical",
      "language_code": null,
      "unit_of_measure": null,
      "recurrence_type": "one_off"
    },
    "shipping": {
      "weight": 2.8,
      "weight_unit": "kg",
      "length": 30,
      "width": 20,
      "height": 10,
      "length_unit": "cm",
      "country_of_origin": "FR",
      "harmonized_system_code": "8471.30"
    },
    "inventory": {
      "sku": "WID-PRE-001"
    },
    "identifiers": {
      "crm": "crm_123",
      "accounting": "acc_789",
      "erp": "erp_456"
    },
    "accounting": {
      "ledger_account": "4010"
    },
    "primary_image_id": null,
    "parent_primary_image_id": null,
    "options": [],
    "prices": [
      {
        "id": "ee0e8400-e29b-41d4-a716-446655440030",
        "key": "updated_product_name.standard",
        "pricebook": { "id": "ff0e8400-e29b-41d4-a716-446655440031", "name": "Standard", "api_name": "standard", "type": "fixed" },
        "billing_frequency": null,
        "pricing_model": "flat",
        "amount": 1990
      }
    ],
    "created_at": "2024-12-21T10:30:00Z",
    "updated_at": "2024-12-21T14:45:00Z"
  }
}

Authorization

string

required

Bearer token for authentication. Format: Bearer qwoty_your_token

Path Parameters

string

required

UUID of the product to update

Request Body

string

Product name

string

Product description

boolean

Whether to inherit description from parent product

boolean

Whether to inherit primary image from parent product

string

Internal reference

boolean

Active status

array

Category UUIDs to link to the parent product. Replaces all existing category links.

object

Inventory information

Show Inventory

string

Stock Keeping Unit

object

Product settings

Show Settings

number

Number of units per pack

object

Accounting information

Show Accounting

string

Ledger account code

object

External system identifiers

Show Identifiers

string

External CRM ID

string

External ERP ID

string

External accounting ID

object

Shipping information

Show Shipping

number

Shipping weight

string

Shipping weight unit (kg, lbs)

number

Shipping height

number

Shipping length

number

Shipping width

string

Shipping length unit (cm, in, etc.)

string

Country of origin for shipping

string

HS code for customs

string

UUID of the primary media to associate with this product. Set to null to remove the primary image.

Fields such as api_name are creation-only: they may appear on the resource but cannot be sent in a PATCH body (the API returns 400 with a validation detail if they are).

Examples

curl -X PATCH https://qwoty.app/api/products/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer qwoty_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Product Name",
    "description": "Updated description",
    "is_active": false
  }'

const productId = '550e8400-e29b-41d4-a716-446655440000'

const response = await fetch(`https://qwoty.app/api/products/${productId}`, {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer qwoty_your_token',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Updated Product Name',
    description: 'Updated description',
    is_active: false,
  }),
})

const data = await response.json()

import requests

product_id = '550e8400-e29b-41d4-a716-446655440000'

response = requests.patch(
    f'https://qwoty.app/api/products/{product_id}',
    headers={
        'Authorization': 'Bearer qwoty_your_token',
        'Content-Type': 'application/json'
    },
    json={
        'name': 'Updated Product Name',
        'description': 'Updated description',
        'is_active': False
    }
)

data = response.json()

Response

boolean

Indicates if the request was successful

object

The updated product object with all fields, including the prices array

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "product_parent_id": "660e8400-e29b-41d4-a716-446655440001",
    "workspace_id": "880e8400-e29b-41d4-a716-446655440003",
    "name": "Updated Product Name",
    "api_name": "updated_product_name",
    "reference": "PROD-001",
    "description": "Updated description",
    "description_inherit_from_product": true,
    "primary_image_inherit_from_product": true,
    "is_active": false,
    "is_default": true,
    "catalogs": [
      {
        "id": "770e8400-e29b-41d4-a716-446655440002",
        "name": "Main Catalog",
        "api_name": "catalog_main"
      }
    ],
    "categories": [],
    "settings": {
      "unit_per_pack": 1,
      "product_type": "physical",
      "language_code": null,
      "unit_of_measure": null,
      "recurrence_type": "one_off"
    },
    "shipping": {
      "weight": 2.8,
      "weight_unit": "kg",
      "length": 30,
      "width": 20,
      "height": 10,
      "length_unit": "cm",
      "country_of_origin": "FR",
      "harmonized_system_code": "8471.30"
    },
    "inventory": {
      "sku": "WID-PRE-001"
    },
    "identifiers": {
      "crm": "crm_123",
      "accounting": "acc_789",
      "erp": "erp_456"
    },
    "accounting": {
      "ledger_account": "4010"
    },
    "primary_image_id": null,
    "parent_primary_image_id": null,
    "options": [],
    "prices": [
      {
        "id": "ee0e8400-e29b-41d4-a716-446655440030",
        "key": "updated_product_name.standard",
        "pricebook": { "id": "ff0e8400-e29b-41d4-a716-446655440031", "name": "Standard", "api_name": "standard", "type": "fixed" },
        "billing_frequency": null,
        "pricing_model": "flat",
        "amount": 1990
      }
    ],
    "created_at": "2024-12-21T10:30:00Z",
    "updated_at": "2024-12-21T14:45:00Z"
  }
}

Error Responses

{
  "success": false,
  "error": "Product not found"
}

{
  "success": false,
  "error": "Validation error",
  "details": {
    "name": "Name must be at least 2 characters"
  }
}

{
  "error": "Validation error",
  "details": ["Field 'reference' is read-only or unknown"]
}

{
  "success": false,
  "error": "Invalid or expired token"
}

Last modified on October 28, 2026

Catalogs

Categories

Product Parents

Products

Prices

Payment Terms

Customers

Contacts

Addresses

Quotes

Media

Tokens

Update Product

Authorization

Path Parameters

Request Body

Examples

Response

Error Responses

​Authorization

​Path Parameters

​Request Body

​Examples

​Response

​Error Responses

Authorization

Path Parameters

Request Body

Examples

Response

Error Responses