4.39. Editor - Delete a unit
| Id | 4.39. |
| Description |
As an Editor,
I want to be able to delete a unit that was created by mistake,
So that I can improve the quality and reliability of the register. |
| Priority | Medium |
| Actors | Editor |
| API Calls | DELETE /units/<unit-id> |
| Linked Processes | |
| Status | Implemented |
Preconditions
- The User must be authenticated and have the Editor role.
- The User has a unit id that he wants to delete
- The User has a valid reason to delete the unit
Postconditions
- The system returns a confirmation that the unit has been marked as “to be deleted”.
Main flow
- The Editor uses an API call to delete a specific unit by ID (DELETE).
- The system validates the input parameters.
- The system marks the unit as well as its connections as “to be deleted”. WARNING: If the unit is used anywhere else in the system, the unit is marked as deleted but kept in the database.
- The system returns a confirmation that the unit 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] Unit not found
Error returned by the system if the given unit 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.