Update a product configuration
Update a product configuration's editable fields. This is a partial update: only the fields you send change; any field you omit is left as-is. Send primaryProductCategory and primaryProductSubcategory together to change the category; sending only one returns 400. Returns 404 if the configuration does not exist or belongs to an organization your credential cannot access, and 409 if the change would duplicate another configuration's tax code. Send the target organization as Organization-Id when your credential owns more than one.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Target organization id (Organization-Id selector).
Target connection id; resolves to its organization.
Platform entity id; resolves to a connection's organization.
Optional source to disambiguate an Entity-Id.
Path parameters
The unique identifier of the product configuration.
Body
New top-level tax category. Send together with primaryProductSubcategory.
DigitalMiscPhysicalServicesNew tax subcategory display label.
Let the classifier choose among tax codes under this category.
Free-text note about this configuration.
Make this the organization's default configuration. Creating a new default clears the previous one.
Response
The unique identifier of this configuration.
The organization this configuration belongs to.
Top-level tax category derived from primaryProductCodeName. null only if the stored code no longer resolves to a published category.
DigitalMiscPhysicalServicesTax subcategory display label derived from primaryProductCodeName. null only if the stored code no longer resolves to a published subcategory.
The resolved product tax code this configuration applies. null only for a config predating this field's backfill, which has not yet been reclassified.
Whether the classifier may choose among tax codes under this configuration's category rather than always applying one fixed code.
Free-text note about this configuration. Empty when not set.
Whether this is the organization's default configuration, applied when no other configuration matches a product. At most one configuration per organization may be the default.
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request conflicts with existing state.
The request failed validation.