Restore Items
POST/api/items/restoreitems
Tier: Public — stable, supported for third-party integration.
Restores a set of previously consumed items, identified by item id and/or tag number.
Only items in state Consumed can be restored; any other current state yields
ItemNotConsumed. The item lands in state Restored, from which normal transitions
resume as if the item were Present. Unlike ItemController.ConsumeItems(...), no item-updated
system event is raised on restore.
Request
Responses
- 200
- 400
- 401
- 403
Returns a partial-success result — HTTP 200 even when some items fail. See
Items.RestoreItemsResultDto; an empty ItemsNotRestored list means all items were
restored.
InvalidOperation only on an unexpected exception.
Caller is not authenticated.
Caller does not have Update permission on the Item module.