Book a bulk stock change or structured location transfer
The API runs on your application instance. Schemas and field names come directly from the OpenAPI specification. Session-authenticated requests require a session on that instance.
bearerAuthAuthorizationBearer <inv_ token>id*stringuuidIdempotency-Key?stringUUID identifying one queue operation; safe to reuse for retries.
uuidX-Organization-ID?stringOrganization membership selected for this request. User-bound credentials may select any active membership; standalone tokens may only repeat their pinned organization ID.
uuidapplication/json- body
delta*integerPositive receipts and negative issues. Structured transfers require zero because the global balance does not change.
-2000000000 <= value <= 2000000000quantity?integerRequired and positive for a structured transfer; otherwise it must equal the absolute delta when provided.
0 <= value <= 2000000000type*string"receipt""issue""adjustment""return""waste""transfer"reason?|length <= 240note?stringlength <= 20000location?|length <= 240fromLocationResourceId?|Structured source location for an issue or transfer.
uuidtoLocationResourceId?|Structured destination location for a receipt or transfer.
uuidcontactId?|Active customer or supplier associated with this movement.
uuidoccurredAt?stringdate-timetotalPriceCents?|Signed transaction value; negative values can represent outbound revenue. Inbound prices must be nonnegative.
-2000000000 <= value <= 2000000000priceCurrency?|3 <= length <= 3Replayed the original stock movement response
curl -X POST 'https://inventory.example.com/api/v1/resources/497f6eca-6276-4993-bfeb-53cbbbba6f08/stock/movements' \ -H 'Content-Type: application/json' \ -d '{ "delta": -2000000000, "type": "receipt"}'