Start free trial

Create manual inventory adjustment

POST/api/v1/inventory/adjustments

Create a manual inventory adjustment for a variant at a specific location. If no location is specified, the adjustment is applied to the default location.

Operation ID: create_inventory_adjustment_api_v1_inventory_adjustments_post·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Request body

Schema: InventoryAdjustmentRequest

variant_idstringrequired

Product variant UUID to adjust.

quantity_changeintegerrequired

Quantity change: positive to add, negative to subtract. Cannot be zero.

reasonstringrequired

Adjustment reason. Prefer one of the canonical values: shrinkage | damage | expired | count_variance | theft | transfer | return | receipt_correction | found | other. Free-text values are accepted for backward compatibility.

reason_codestring

Optional canonical reason code (overrides reason for reporting). See InventoryAdjustmentReason for valid values.

location_idstring

Location UUID where adjustment applies. Uses default location if not specified.

Responses

201Successful Response

Schema: SuccessEnvelope_InventoryAdjustmentResponse_

successboolean
messagestring
codestring
dataInventoryAdjustmentResponse

422Validation Error

Schema: HTTPValidationError

detailarray · ValidationErrorValidationError
5 fields
locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject