TRtrykintsugi
Products

Update product

Changed on

The Update Product API allows users to modify the details of an existing product identified by its unique product_id. You can retrieve supported categories and subcategories from the GET /products/categories endpoint, or browse the full catalog with descriptions and examples in the Product Categories guide

put/v1/products/{product_id}

Request

  • Base URL
    https://api.trykintsugi.com
  • URL
    https://api.trykintsugi.com/v1/products/{product_id}
  • Auth
    API key in header X-API-KEY

Path parameters

product_idstring required

Unique identifier of the product to be updated.

Headers

x-organization-idstring nullable required

The unique identifier for the organization making the request

Request body

OR

Response

Successfully retrieved product by id

idstring required
external_idstring required
skustring[] nullable required
codestring required
namestring required
descriptionstring nullable required
status'APPROVED' | 'PARTIALLY_APPROVED' | 'PENDING' | 'ARCHIVED' required
product_categorystring required

Main category of the product. For example, Physical, Digital, etc. You can retrieve supported categories from GET /products/categories endpoint

product_subcategorystring required

Tax subcategory display label of the product (e.g. 'General Clothing'). List supported values from GET /products/categories.

tax_exemptboolean required
source'BIGCOMMERCE' | 'BESTBUY' | 'BUNNY' | 'CHARGEBEE' | 'SHOPIFY' | 'SHOPLINE' | 'ECWID' | 'STRIPE' | 'AMAZON' | 'TIKTOK' | 'CUSTOM' | 'UNKNOWN' | 'IMPORT' | 'ZUORA' | 'APIDECK' | 'QUICKBOOKS' | 'API' | 'APPLE_APP_STORE' | 'GOOGLE_APP_STORE' | 'WALMART' | 'PAYPAL' | 'NETSUITE' | 'XERO' | 'MAXIO' | 'RECURLY' | 'SALESFORCE' | 'ETSY' | 'EBAY' | 'WIX' | 'SQUARESPACE' | 'WOOCOMMERCE' | 'MAGENTO' | 'MACYS' | 'BILLING_PLATFORM' | 'DEEL' | 'RIPPLING' | 'GUSTO' | 'FACEBOOK' | 'FRESHBOOKS' | 'OTHER' | 'ORDWAY' | 'INSTAGRAM' | 'PINTEREST' | 'WAYFAIR' | 'WISH' | 'POS' | 'TARGET' | 'NEWEGG' | 'GROUPON' | 'GOOGLE_EXPRESS' | 'NOCNOC' | 'MERCADO_LIBRE' | 'MODALYST' | 'NORDSTROM' | 'FAIRE' | 'FRISBII_BILLING' | 'SHOPWARE' | 'ZOHO' | 'ZOHO_BOOKS' | 'SAGE-INTACCT' | 'AIRWALLEX' | 'ORB' | 'ZENSKAR' | 'MICROSOFT_DYNAMICS_365' | 'KICKSTARTER' | 'INTERNAL_ERP' | 'RILLET' | 'CAMPFIRE' | 'KILL_BILL' | 'PROVISION' | 'VERTEX_O_SERIES' | 'CHECKOUTCHAMP' | 'DUALENTRY' | 'ODOO' | 'BILL_COM' | 'INTUIT_ENTERPRISE_SUITE' | 'ACUMATICA' | 'PLENTYONE' | 'HYPERLINE' | 'OPENMETER' | 'SALEOR' required
connection_idstring nullable required
classification_failedboolean nullable required
store_namestring nullable
source_taxonomy_typestring nullable
source_taxonomy_codestring nullable
source_taxonomy_idstring nullable
source_taxonomy_namestring nullable
source_taxonomy_categoriesobject[] nullable
source_taxonomy_metadataobject nullable

Example response

{
  "product_subcategory": "General Clothing"
}

Changes

  • b00368d67377Revision changes
    • warning

      added the new SALEOR enum value to the response property for the response status

  • cf78c16e3186Revision changes
    • warning

      added the new FRISBII_BILLING enum value to the response property for the response status