Tool Reference
atoms_update_item
Update an existing item's fields (partial update)
Update one or more fields on an existing item. This is a partial update : only the fields you provide are changed; all other fields remain untouched.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string (UUID) | Yes | The project containing the item |
item_id | string | Yes | The item to update, e.g. "REQ-001", "TC-050" |
title | string | No | New title (1-500 characters) |
body | string | No | New rich text content |
summary | string | No | New brief summary |
domains | string[] | No | Replacement domain tags (overwrites existing) |
level | string | No | New hierarchy level |
status | string | No | Test status: passed, failed, blocked, or not-run |
Example Response
{
"status": "success",
"data": {
"id": "REQ-001",
"title": "System shall maintain a complete audit trail",
"type": "requirement",
"updated_fields": ["title", "summary"]
}
}Notes
- This tool modifies data (
readOnlyHint: false,destructiveHint: false,idempotentHint: true). - Only provided fields are written. Omitted fields are left unchanged.
- A
change_historyentry is logged with the old and new values for every changed field, enabling full diff reconstruction. - The
statusfield is primarily useful for test-case items. Setting it on a requirement or note is allowed but has no functional effect. - The
domainsarray is a full replacement : pass the complete list of desired tags, not just additions.