Allocate won or bought units in a batch
Up to 200 unique IDs. All succeed or none do. In addition to inventory:read, this needs its operation scope and the approving member’s inventory.write permission.
/inventory/commitments/allocate-batchAuthorizationOAuth2 access token · headerrequiredAuthorization code flow (PKCE S256 required). Send resource=https://api.toreca-cloud.com/partner/v1 with the authorization, token and refresh requests. Access tokens last 15 minutes; refresh tokens last 90 days and rotate on every refresh.
inventory:readinventory:writeapplication/jsoncommitmentsobject[]requiredShow propertiesHide properties
objectidstring<uuid>requiredallocationRefstringSuccess
commitmentsCommitment[]requiredShow propertiesHide properties
Commitmentidstring<uuid>requiredcreatedAtstring<date-time>requiredupdatedAtstring<date-time>requiredinventoryItemIdstring<uuid>requiredassetNumberstringrequiredpurposestringrequiredoripasalelabelstringrequiredexternalRefstring | nullrequiredShow propertiesHide properties
stringnullstatusstringrequiredon_saleallocatedshippingblockedshippedreleasedendedallocatedAtstring<date-time> | nullrequiredShow propertiesHide properties
string<date-time>nullallocationRefstring | nullrequiredShow propertiesHide properties
stringnullshipmentIdstring<uuid> | nullrequiredShow propertiesHide properties
string<uuid>nullclosedAtstring<date-time> | nullrequiredShow propertiesHide properties
string<date-time>nullinvalid_request: a parameter is invalid.
errorstringrequiredThe error code
scopestringWith insufficient_scope, the missing scope
requestIdstring<uuid>inventoryItemIdsstring<uuid>[]holdIdsstring<uuid>[]commitmentIdsstring<uuid>[]invalid_token: the token is missing, expired, or for another resource.
errorstringrequiredThe error code
scopestringWith insufficient_scope, the missing scope
requestIdstring<uuid>inventoryItemIdsstring<uuid>[]holdIdsstring<uuid>[]commitmentIdsstring<uuid>[]One of insufficient_scope, connection_revoked, client_disabled or forbidden.
errorstringrequiredThe error code
scopestringWith insufficient_scope, the missing scope
requestIdstring<uuid>inventoryItemIdsstring<uuid>[]holdIdsstring<uuid>[]commitmentIdsstring<uuid>[]Conflict, reused requestId or receipt not confirmed
errorstringrequiredThe error code
scopestringWith insufficient_scope, the missing scope
requestIdstring<uuid>inventoryItemIdsstring<uuid>[]holdIdsstring<uuid>[]commitmentIdsstring<uuid>[]The state, target or value refuses the operation. Inspect error and affected IDs.
errorstringrequiredThe error code
scopestringWith insufficient_scope, the missing scope
requestIdstring<uuid>inventoryItemIdsstring<uuid>[]holdIdsstring<uuid>[]commitmentIdsstring<uuid>[]
