Tool Reference
atoms_delete_item
Soft-delete an item (preserves for audit trail)
Soft-delete an item by setting its deleted_at timestamp. The row is never physically removed from the database, preserving the full audit trail for compliance and traceability.
This action is irreversible via the MCP server. Only a project admin can restore a soft-deleted item through the ATOMS dashboard.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string (UUID) | Yes | The project containing the item |
item_id | string | Yes | The item to delete, e.g. "REQ-005", "TC-022" |
Example Response
{
"status": "success",
"data": {
"id": "REQ-005",
"title": "Deprecated logging requirement",
"type": "requirement",
"deleted": true,
"message": "Item REQ-005 has been soft-deleted"
}
}Notes
- This tool modifies data and is marked as destructive (
readOnlyHint: false,destructiveHint: true). - The item is preserved in
change_historyforever : soft-deletion only hides the item from normal queries. - Existing relationships pointing to a deleted item remain in the database but are excluded from traceability views.
- Deleted items no longer appear in
atoms_list_items,atoms_search, or coverage calculations.