Skip to main content

4.42. Editor - Delete an equipment

Id 4.42.
Description

As an Editor,

 

I want to be able to delete an equipment that was created by mistake or has been decommissioned,

 

So that I can improve the quality and reliability of the register.
Priority High
Actors Editor
API Calls DELETE /equipments/<equipment-id>
Linked Processes
Status Implemented

Preconditions

  1. The User must be authenticated and have the Editor role.
  2. The User has a equipment id that he wants to delete
  3. The User has a valid reason to delete the equipment

Postconditions

  1. The system returns a confirmation that the equipment has been marked as “to be deleted”.

Main flow

  1. The Editor uses an API call to delete a specific equipment by ID (DELETE).
  2. The system validates the input parameters.
  3. The system marks the equipment as “to be deleted”. WARNING: If the equipment is already used somewhere else in the system, the equipment is marked as deleted but is kept in the database.
  4. The system returns a confirmation that the equipment has been marked as “to be deleted”.

Exceptions

[400 Bad Request] Invalid input:

If mandatory fields are missing or invalid, the system returns an error message.

[404 Not Found] Equipment not found

Error returned by the system if the given equipment does not exist.

[500 Internal Server Error] System Error

If the system fails to save changes due to an internal error, it displays an appropriate message and logs the error for further investigation.

No comments to display

Back to top