Return checked-out units
Up to 200 unique inventoryItemIds. Give each unit’s return shelf and a reason. All succeed or none do. In addition to inventory:read, this needs its operation scope and the approving member’s inventory.write permission.
/inventory/checkouts/{id}/returnAuthorizationOAuth2 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:moveidstring<uuid>requiredapplication/jsonitemsobject[]requiredShow propertiesHide properties
objectinventoryItemIdstring<uuid>requiredtoLocationIdstring<uuid>requiredreasonstringrequiredSuccess
idstring<uuid>requiredcreatedAtstring<date-time>requiredupdatedAtstring<date-time>requiredorderNumberstringrequiredversionintegerrequireddestinationLabelstringrequiredreasonstringrequiredexternalRefstring | nullrequiredShow propertiesHide properties
stringnullshippedAtstring<date-time> | nullrequiredShow propertiesHide properties
string<date-time>nullitemsobject[]requiredShow propertiesHide properties
objectinventoryItemIdstring<uuid>requiredassetNumberstringrequiredstatusstringrequiredoutreturnedreturnedAtstring<date-time> | nullrequiredShow propertiesHide properties
string<date-time>nullreturnLocationIdstring<uuid> | nullrequiredShow propertiesHide properties
string<uuid>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>[]not_found
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>[]
