Updates multiple product variants

PATCH

/2025-07/product/:productId/variants

PATCH

/2025-07/product/:productId/variants

1 import requests
2 
3 url = "https://api.shipbob.com/2025-07/product/productId/variants"
4 
5 payload = {
6     "additional_hazmat_attributes": {
7         "charge_state_percentage": 0.1,
8         "container_type": "string",
9         "lithium_battery_packaging": "string",
10         "lithium_battery_type": "string",
11         "magnet": True,
12         "net_volume": 0.1,
13         "net_weight": 0.1,
14         "container_metal": True
15     },
16     "barcodes": [
17         {
18             "sticker_url": "string",
19             "value": "string"
20         }
21     ],
22     "bundle_definition": [
23         {
24             "quantity": 0,
25             "variant_id": 0
26         }
27     ],
28     "channel_metadata": [
29         {
30             "asin": "string",
31             "fnsku": "string",
32             "fulfillment_channel": "string",
33             "channel_id": 0,
34             "channel_name": "string",
35             "currency": "string",
36             "id": 0,
37             "is_inventory_sync_enabled": True,
38             "legacy_product_id": 0,
39             "platform": "string",
40             "platform_identifier": "string",
41             "platform_inventory_item_id": "string",
42             "price": 0.1,
43             "seller_sku": "string"
44         }
45     ],
46     "customs": {
47         "country_code_of_origin": "string",
48         "currency": "string",
49         "description": "string",
50         "hs_tariff_code": "string",
51         "is321_eligible": True,
52         "value": 0
53     },
54     "dimension": {
55         "height": 0.1,
56         "length": 0.1,
57         "width": 0.1
58     },
59     "fulfillment_settings": {
60         "dangerous_goods": True,
61         "is_bpm_parcel": True,
62         "is_case_pick": True,
63         "msds_url": "string",
64         "requires_prop65": True,
65         "serial_scan": {
66             "exact_character_length": 0,
67             "is_enabled": True,
68             "prefix": "string",
69             "suffix": "string"
70         }
71     },
72     "gtin": "string",
73     "id": 0,
74     "is_digital": True,
75     "lot_information": {
76         "is_lot": True,
77         "minimum_shelf_life_days": 0
78     },
79     "name": "string",
80     "packaging_material_type_id": 0,
81     "packaging_requirement_id": 0,
82     "return_preferences": {
83         "backup_action_id": 0,
84         "instructions": "string",
85         "primary_action_id": 0,
86         "return_to_sender_backup_action_id": 0,
87         "return_to_sender_primary_action_id": 0
88     },
89     "reviews_pending": [0],
90     "sku": "string",
91     "status": 1,
92     "upc": "string",
93     "weight": 0.1
94 }
95 headers = {
96     "Authorization": "Bearer <token>",
97     "Content-Type": "application/json"
98 }
99 
100 response = requests.patch(url, json=payload, headers=headers)
101 
102 print(response.json())

200Products_updatesMultipleProductVariants_example

1 [
2   {
3     "additional_hazmat_attributes": {
4       "charge_state_percentage": 0.1,
5       "container_type": "string",
6       "lithium_battery_packaging": "string",
7       "lithium_battery_type": "string",
8       "magnet": true,
9       "net_volume": 0.1,
10       "net_weight": 0.1,
11       "container_metal": true
12     },
13     "associated_bundles": [
14       {
15         "product_id": 0,
16         "product_name": "string",
17         "quantity": 0,
18         "variant_id": 0,
19         "variant_sku": "string"
20       }
21     ],
22     "barcodes": [
23       {
24         "sticker_url": "string",
25         "value": "string"
26       }
27     ],
28     "bundle_definition": [
29       {
30         "product_id": 0,
31         "quantity": 0,
32         "variant_id": 0,
33         "variant_name": "string",
34         "variant_sku": "string"
35       }
36     ],
37     "channel_metadata": [
38       {
39         "channel_id": 0,
40         "channel_name": "string",
41         "currency": "string",
42         "id": 0,
43         "is_inventory_sync_enabled": true,
44         "legacy_product_id": 0,
45         "platform": "string",
46         "platform_identifier": "string",
47         "platform_inventory_item_id": "string",
48         "price": 0.1,
49         "seller_sku": "string"
50       }
51     ],
52     "created_on": "2019-08-24T14:15:22Z",
53     "customs": {
54       "country_code_of_origin": "string",
55       "currency": "string",
56       "description": "string",
57       "hs_tariff_code": "string",
58       "is321_eligible": true,
59       "value": 0
60     },
61     "dimension": {
62       "height": 0.1,
63       "is_locked": true,
64       "length": 0.1,
65       "source": "string",
66       "unit": "string",
67       "width": 0.1
68     },
69     "fulfillment_settings": {
70       "dangerous_goods": true,
71       "is_bpm_parcel": true,
72       "is_case_pick": true,
73       "msds_url": "string",
74       "requires_prop65": true,
75       "serial_scan": {
76         "exact_character_length": 0,
77         "is_enabled": true,
78         "prefix": "string",
79         "suffix": "string"
80       }
81     },
82     "gtin": "string",
83     "id": 0,
84     "inventory": {
85       "inventory_id": 0,
86       "on_hand_qty": 0
87     },
88     "is_digital": true,
89     "is_image_uploaded": true,
90     "lot_information": {
91       "is_lot": true,
92       "minimum_shelf_life_days": 0
93     },
94     "merge_children": [
95       {
96         "channel_ids": [
97           0
98         ],
99         "completed_at": "2019-08-24T14:15:22Z",
100         "inventory_id": 0,
101         "variant_id": 0,
102         "variant_name": "string"
103       }
104     ],
105     "name": "string",
106     "packaging_material_type": {
107       "id": 0,
108       "name": "string"
109     },
110     "packaging_requirement": {
111       "id": 0,
112       "name": "string"
113     },
114     "return_preferences": {
115       "backup_action": {
116         "id": 0,
117         "name": "string"
118       },
119       "instructions": "string",
120       "primary_action": {
121         "id": 0,
122         "name": "string"
123       },
124       "return_to_sender_backup_action": {
125         "id": 0,
126         "name": "string"
127       },
128       "return_to_sender_primary_action": {
129         "id": 0,
130         "name": "string"
131       }
132     },
133     "reviews_pending": [
134       "string"
135     ],
136     "sku": "string",
137     "status": "string",
138     "upc": "string",
139     "updated_on": "2019-08-24T14:15:22Z",
140     "weight": {
141       "unit": "string",
142       "weight": 0.1
143     }
144   }
145 ]

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token

AuthorizationBearer

OAuth2 authentication using JWT tokens

Path parameters

productIdstringRequiredformat: "int64"

Request

This endpoint expects an object.

additional_hazmat_attributesobjectOptional

barcodeslist of objects or nullOptional

bundle_definitionlist of objects or nullOptional

channel_metadatalist of objects or nullOptional

customsobjectOptional

dimensionobjectOptional

fulfillment_settingsobjectOptional

gtinstring or nullOptional

idlongOptional

is_digitalbooleanOptional

lot_informationobjectOptional

namestring or nullOptional

packaging_material_type_idinteger or nullOptional

packaging_requirement_idinteger or nullOptional

return_preferencesobjectOptional

reviews_pendinglist of enums or nullOptional

Allowed values:

skustring or nullOptional

statusenumOptional

Allowed values:

upcstring or nullOptional

weightdoubleOptional

Response

Success

additional_hazmat_attributesobject or null

associated_bundleslist of objects or null

barcodeslist of objects or null

bundle_definitionlist of objects or null

channel_metadatalist of objects or null

created_ondatetime or null

customsobject or null

dimensionobject or null

fulfillment_settingsobject or null

gtinstring or null

idlong or null

inventoryobject or null

is_digitalboolean or null

is_image_uploadedboolean or null

lot_informationobject or null

merge_childrenlist of objects or null

namestring or null

packaging_material_typeobject or null

packaging_requirementobject or null

return_preferencesobject or null

reviews_pendinglist of strings or null

skustring or null

statusstring or null

upcstring or null

updated_ondatetime or null

weightobject or null