Rename an asset
POST/asset/:assetId/rename
Rename an asset, typically to correct a misread container number. Moves everything recorded under {assetId} (live location, history, ledger events, open and closed visits, media, tickets and the appointment arrival) to the new ID. If the new ID is already an asset at the tenant, the two are merged. A rename is not a departure: it closes no visit and bills nothing. Retrying the same rename after a failure completes it. Allowed for tenant API keys and for users with the Admin, Operations or Sysadmin role.
Request
Responses
- 200
- 400
- 401
- 404
- 409
- 422
successful operation
The new ID is missing or invalid, or is unchanged from {assetId}
Unauthorized, or a user caller lacks the Admin, Operations or Sysadmin role
No asset with that ID
Both IDs carry an open visit, or the asset changed during the rename (retry)
The asset has too much history to rename online