Perform an operation on items

POST /items/batch/:action

Status codes

  • 200 on success
  • 400 on invalid request

Path parameters

  • action: One of deactivate, activate, delete, restore.
deactivate

This operation will set the archived timestamp to now. This also removes the items from the list of active items and place them on the list of archived ones. If any of the items is already deleted, then it stays in the deleted items list and remains deleted.

activate

This operation will remove the archived timestamp and move the items to the active items list. If any of the items is already deleted, then it stays in the deleted items list and remains deleted.

delete

This operation will set the deleted timestamp to now. This in turn makes the items only appear in the deleted items list.

restore

This operation will remove the deleted timestamp and move the items back to the active/archived items list. If any of the items was also deactivated, restore won't activate it automatically.

Request properties

  • ids: An array of item ids to read.

Response properties

  • updated: The number of items affected by the operation. If an item's state was not affected because the same operation was performed on it already, it won't be counted.