atoms_get_item

Get the complete details of a single item by its ID, including relationships, test history, and metadata. Use this after discovering item IDs via atoms_list_items or atoms_search.

Parameters

Parameter	Type	Required	Description
`project_id`	`string (UUID)`	Yes	The project containing the item
`item_id`	`string`	Yes	The item identifier, e.g. `"REQ-001"`, `"TC-050"`

Example Response

{
  "status": "success",
  "data": {
    "id": "REQ-001",
    "type": "requirement",
    "title": "System shall maintain audit trail",
    "summary": "All user actions must be logged with timestamp and actor",
    "body": "The system shall record every create, update, and delete operation...",
    "tags": {
      "domains": ["security", "compliance"],
      "level": "System"
    },
    "ownership": {
      "created_by": "user_abc123",
      "created_at": "2025-11-01T10:00:00Z",
      "updated_by": "user_def456",
      "updated_at": "2025-12-15T14:30:00Z"
    },
    "relationships": {
      "parents": ["REQ-000"],
      "children": ["REQ-002", "REQ-003"],
      "related": [],
      "verifies": [],
      "verified_by": ["TC-012", "TC-013"]
    },
    "links": [],
    "status": null,
    "metadata": {
      "created_at": "2025-11-01T10:00:00Z",
      "created_by": "user_abc123",
      "updated_at": "2025-12-15T14:30:00Z",
      "updated_by": "user_def456"
    }
  }
}

For test-case items, the response also includes test execution data:

{
  "status": "success",
  "data": {
    "id": "TC-012",
    "type": "test-case",
    "title": "Verify audit log entries are created on login",
    "latest_result": {
      "result": "passed",
      "note": "Verified in sprint 12 regression",
      "recorded_at": "2025-12-20T09:15:00Z"
    },
    "test_results": [
      {
        "result": "passed",
        "note": "Verified in sprint 12 regression",
        "recorded_at": "2025-12-20T09:15:00Z"
      },
      {
        "result": "failed",
        "note": "Timeout on staging environment",
        "recorded_at": "2025-12-10T16:45:00Z"
      }
    ]
  }
}

Notes

This tool is read-only and does not modify any data (readOnlyHint: true).
The relationships object shows all traceability links: parents, children, related, verifies, and verified_by.
For test-case items, latest_result provides the most recent execution outcome, while test_results contains the full history.
Use atoms_list_items or atoms_search first to discover valid item IDs.

Parameters

Example Response

Notes

On this page