Absolute Adjustment | BigCommerce Developer Center

Override the existing inventory levels for an inventory item at a location. Use absolute adjustments as the default method for updating inventory. This endpoint batches requests, making them more resource friendly than the Catalog API. Absolute adjustments have lower complexity than relative adjustments, which synchronize with orders.

Limits

For maximum inventory levels, see Inventory adjustments.
Limit of 2000 items for payload length, see Optimizing performance for more information.

Override the existing inventory levels for an inventory item at a location. Use absolute adjustments as the default method for updating inventory. This endpoint batches requests, making them more resource friendly than the [Catalog API](/developer/api-reference/rest/admin/catalog/products#update-products-batch). Absolute adjustments have lower complexity than [relative adjustments](/developer/api-reference/rest/admin/management/inventory/adjustments#relative-adjustment), which synchronize with orders. **Limits** * For maximum inventory levels, see [Inventory adjustments](/developer/docs/admin/catalog-and-inventory/inventory-adjustments#inventory-adjustments). * Limit of 2000 items for payload length, see [Optimizing performance](/developer/docs/admin/catalog-and-inventory/inventory-adjustments#optimizing-performance) for more information.

Authentication

X-Auth-Tokenstring

OAuth scopes

UI Name	Permission	Parameter
Store Inventory	read-only	`store_inventory_read_only`
Store Inventory	modify	`store_inventory`

Authentication header

Header	Argument	Description
`X-Auth-Token`	`access_token`	For more about API accounts that generate `access_token`s, see API Accounts and OAuth Scopes.

### OAuth scopes | UI Name | Permission | Parameter | |:--------|:-----------|:----------| | Store Inventory | read-only | `store_inventory_read_only` | | Store Inventory | modify | `store_inventory` | ### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see [API Accounts and OAuth Scopes](/developer/docs/overview/api-fundamentals/api-accounts#api-accounts). | ### Further reading For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-fundamentals/api-accounts). For more about BigCommerce OAuth scopes, see [API Accounts and OAuth Scopes](/developer/docs/overview/api-fundamentals/api-accounts#oauth-scopes). For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).

Request

This endpoint expects an object.

itemslist of objectsRequired

One of the sku, product_id, or variant_id is required to identify the item.

reasonstringOptional

Reason for the adjustment operation.

Response

Request has been successfully processed.

transaction_idstring

Unique identifier of performed action.

Errors

422

Unprocessable Entity Error

1	import requests
2
3	url = "https://api.bigcommerce.com/stores/store_hash/v3/inventory/adjustments/absolute"
4
5	payload = {
6	"items": [
7	{
8	"location_id": 1,
9	"sku": "RE-130",
10	"quantity": 1,
11	"variant_id": 1
12	},
13	{
14	"location_id": 2,
15	"sku": "RE-130",
16	"quantity": 1,
17	"variant_id": 3
18	},
19	{
20	"location_id": 3,
21	"sku": "sku-4",
22	"quantity": 1
23	},
24	{
25	"location_id": 1,
26	"sku": "sku-5",
27	"quantity": 1
28	},
29	{
30	"location_id": 1,
31	"sku": "RE-130",
32	"quantity": 7,
33	"product_id": 111
34	}
35	],
36	"reason": "Absolute adjustment reason"
37	}
38	headers = {
39	"X-Auth-Token": "<apiKey>",
40	"Content-Type": "application/json"
41	}
42
43	response = requests.put(url, json=payload, headers=headers)
44
45	print(response.json())

1	{
2	"transaction_id": "string"
3	}