Bulk update product variants
Updates multiple product variants in a single batch operation. Supports partial updates to variant properties including name, status, stock levels, dimensions, and custom fields. Processes up to 50 variants per batch. Returns arrays of successful and failed updates.
/api/v1/{team_slug}/{app_slug}/variants/bulkAuthorizationBearer token · headerrequiredManagement API token, sent as Authorization: Bearer <token>.
team_slugstringrequiredTeam slug
app_slugstringrequiredApp slug
application/jsonVariants data to update
variantsinternal_pkg_webserver_v1.BulkPatchVariantItem[]requiredShow propertiesHide properties
internal_pkg_webserver_v1.BulkPatchVariantItemcustom_fieldsobjectCustom fields - null or empty string removes the field, other values merge with existing
idstringrequiredpurchase_pricegithub_com_enadhq_nabbit_internal_pkg_webserver_models.PurchasePriceShow propertiesHide properties
currencystringvalue_centsintegerstatusstringStatus of the product
activedraftinactivearchivedstockinternal_pkg_webserver_v1.InputVariantStock[]Stock level of the variant
Show propertiesHide properties
internal_pkg_webserver_v1.InputVariantStockinventory_datestringISO 8601 date format with time zone e.g. 2024-12-12T09:13:31.039Z.
quantityintegerwarehouse_slugstringrequiredvalidate_stockbooleanvariant_dimensionsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.DimensionsShow propertiesHide properties
capacity_milliliterintegerthe capacity in milliliter
depthintegerThe products depth in millimeter
diameterintegerthe products diameter in millimeter
heightintegerThe products height in millimeter
lengthintegerThe products length in millimeter
weightintegerThe products weight in grams
widthintegerThe products width in millimeter
variant_group_idstringvariant_namestringName of the variant
Variants updated successfully
datainternal_pkg_webserver_v1.BulkPatchVariantsResponserequiredShow propertiesHide properties
failedinternal_pkg_webserver_v1.BulkPatchFailedUpdate[] | nullShow propertiesHide properties
internal_pkg_webserver_v1.BulkPatchFailedUpdateidstringreasonstringsuccessfulgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Variant[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.Variantattributesgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Attribute[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.Attributecreated_atstringdescriptionstring | nullfilterableboolean | nullidstringkeystringnamestring | nulltemplate_keystringtemplate_namestringtranslatableboolean | nulltranslationsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.AttributeTranslationsShow propertiesHide properties
descriptiongithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[]namegithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[]updated_atstring | nullvaluesobject | nullcreated_atstringcustom_fieldsobject | nullidstringimagesgithub_com_enadhq_nabbit_internal_pkg_webserver_models.ImageWithPriority[] | nullImages of the product
Show propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.ImageWithPriorityaltstring | nullapp_idstring | nullattributesgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Attribute[] | nullblurhashstringcopyrightstring | nullcustomobject | nullfolder_idstringidstringparent_idstring | nullpriorityintegerpublicbooleanstatusstringtitlestring | nulltranslationsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.ImageTranslationShow propertiesHide properties
altgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[] | nullcopyrightgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[] | nulltitlegithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[] | nullurlstringlistingsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.VariantListingsShow propertiesHide properties
smartgithub_com_enadhq_nabbit_internal_pkg_webserver_models.VariantListing[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.VariantListingidstringslugstringstaticgithub_com_enadhq_nabbit_internal_pkg_webserver_models.VariantListing[] | nullparent_product_idstringpurchase_pricegithub_com_enadhq_nabbit_internal_pkg_webserver_models.PurchasePrice | nullShow propertiesHide properties
currencystringvalue_centsintegernullshipping_attributesstring[] | nullstatusstringstore_groupgithub_com_enadhq_nabbit_internal_pkg_webserver_models.ProductVariantStoreGroupWithPrices[] | nullProduct StoreGroup
Show propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.ProductVariantStoreGroupWithPricescreated_atstringidstringnamestringpricesgithub_com_enadhq_nabbit_internal_pkg_webserver_models.ProductVariantPrice[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.ProductVariantPriceamount_cents_with_taxintegercreated_atstringidstringmarketgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Marketon_salebooleanreference_price_with_taxinteger | nullsale_end_timestampstring | nullsale_price_with_taxinteger | nullsale_start_timestampstring | nullstatusgithub_com_enadhq_nabbit_internal_pkg_webserver_models.PriceStatusactiveinactivedraftupdated_atstring | nullslugstringstore_typestringupdated_atstring | nulltagsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Tag[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.Tagattributesgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Attribute[] | nullcreated_atstringfilterablebooleanidstringkeystringmarketsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Market[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.Marketactivebooleancountry_codesstring[] | nullcreated_atstringcurrency_codestringidstringlocalestringnamestringslugstringupdated_atstring | nullnamestringschedulesgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Job[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.Jobadd_category_namesstring[]add_collection_namesstring[]add_tag_namesstring[]execute_atstringDate when the job should run
finished_atstring | nullIf a job is finished will this timestamp be filled
group_idstringidstringitem_idstringitem_namestringitem_typestringremove_category_namesstring[]remove_collection_namesstring[]remove_tag_namesstring[]to_amount_cents_with_taxinteger | nullto_market_idstringto_market_statusstringto_on_saleboolean | nullto_sale_amount_cents_with_taxinteger | nullto_start_sale_timestampstringto_statusstring | nullto_stop_sale_timestampstringto_store_group_idstringstatusstringtranslationsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.TagTranslationsShow propertiesHide properties
namegithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[]updated_atstring | nulltranslationsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.ProductVariantTranslationsShow propertiesHide properties
namegithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.Translationidstringlocalestringvaluestringupdated_atstring | nullvalidate_stockbooleanvariant_dimensionsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Dimensions | nullShow propertiesHide properties
capacity_milliliterintegerthe capacity in milliliter
depthintegerThe products depth in millimeter
diameterintegerthe products diameter in millimeter
heightintegerThe products height in millimeter
lengthintegerThe products length in millimeter
weightintegerThe products weight in grams
widthintegerThe products width in millimeter
nullvariant_group_idstringvariant_namestringvariant_numberstringvideosgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Video[] | nullVideos of the product
Show propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.Videoattributesgithub_com_enadhq_nabbit_internal_pkg_webserver_models.Attribute[] | nulldescriptionstringfolder_idstringidstringpathstringpublicbooleanstatusstringtitlestringtranslationsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.VideoTranslationsShow propertiesHide properties
descriptiongithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[] | nulltitlegithub_com_enadhq_nabbit_internal_pkg_webserver_models.Translation[] | nullvariantsgithub_com_enadhq_nabbit_internal_pkg_webserver_models.VideoVariant[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.VideoVariantformatstringheightintegerurlstringwidthintegerwarehouse_variant_stockgithub_com_enadhq_nabbit_internal_pkg_webserver_models.WarehouseVariantStock[] | nullShow propertiesHide properties
github_com_enadhq_nabbit_internal_pkg_webserver_models.WarehouseVariantStockavailable_onlinebooleancreated_atstringidstringinventory_datestring | nullquantityintegerupdated_atstring | nullwarehouse_namestringwarehouse_slugstringdetailsstring[]Additional contextual information about the response. Used to provide supplementary details beyond the main data payload, such as validation warnings or processing notes
successbooleanrequiredInvalid request
detailsstring[]messagestringsuccessbooleanrequiredUnauthorized access
detailsstring[]messagestringsuccessbooleanrequiredInternal server error
detailsstring[]messagestringsuccessbooleanrequired