[feat/VM-7321] Lifecycle management updates to pyTenable APA schemas

- Add `accepted` to technique StatusEnum (Pydantic) and Marshmallow validation (VM-7321)
- Add PathStatusEnum and `path_status` field to VectorRow (Pydantic) (VM-7287)
- Add `path_status` field to VectorSchema (Marshmallow) with validation (VM-7287)
- Add path_status filter example to top_attack_paths_search docs (VM-7288)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: Naum Rabich

tenable/apa/findings/schema.py

@@ -46,7 +46,8 @@ class FindingSchema(Schema):
     vectorCount = fields.Int(allow_none=True)
     state = fields.Str(validate=v.OneOf(["open", "archive"]))
     status = fields.Str(validate=v.OneOf(["in_progress", "done",
-                                          "to_do", "in_review"]))
+                                          "to_do", "in_review",
+                                          "accepted"]))
     created = fields.Int(allow_none=True)
     is_active = fields.Bool(allow_none=True)
     has_history = fields.Bool(allow_none=True)

tenable/apa/vectors/schema.py

@@ -1,4 +1,4 @@
-from marshmallow import fields, Schema
+from marshmallow import fields, validate as v, Schema
 
 
 class SourceInformationSchema(Schema):
@@ -42,6 +42,11 @@ class VectorSchema(Schema):
     summary = fields.Str(allow_none=True)
     first_aes = fields.Raw(allow_none=True)
     last_acr = fields.Int(allow_none=True)
+    path_status = fields.Str(validate=v.OneOf(["to_do", "in_progress",
+                                                "in_review", "done",
+                                                "chain_prevented",
+                                                "accepted"]),
+                             allow_none=True)
 
 
 class VectorsPageSchema(Schema):

tenable/tenableone/attack_path/findings/schema.py

@@ -21,6 +21,7 @@ class StatusEnum(Enum):
     done = "done"
     to_do = "to_do"
     in_review = "in_review"
+    accepted = "accepted"
 
 
 class NodeInfoSchema(BaseModel):

tenable/tenableone/attack_path/vectors/api.py

@@ -190,6 +190,17 @@ def top_attack_paths_search(
             >>> for attack_path in response.data:
             ...     print(f"Attack Path: {attack_path.name}, Priority: {attack_path.priority}")
 
+            Filter by path_status to get only actionable paths
+
+            >>> filter_data = {
+            ...     "property": "path_status",
+            ...     "operator": "in",
+            ...     "value": ["to_do", "in_progress", "in_review"]
+            ... }
+            >>> response = t1.attack_path.vectors.top_attack_paths_search(
+            ...     filter=filter_data
+            ... )
+
             Simple search with default parameters
 
             >>> response = t1.attack_path.vectors.top_attack_paths_search()

tenable/tenableone/attack_path/vectors/schema.py

@@ -1,7 +1,18 @@
+from enum import Enum
+
 from pydantic import BaseModel, RootModel
 from typing import List, Optional, Any, Union
 
 
+class PathStatusEnum(Enum):
+    to_do = "to_do"
+    in_progress = "in_progress"
+    in_review = "in_review"
+    done = "done"
+    chain_prevented = "chain_prevented"
+    accepted = "accepted"
+
+
 class SourceInformationSchema(BaseModel):
     provider_detection_id: Optional[str] = None
     detection_code: Optional[str] = None
@@ -79,6 +90,7 @@ class VectorRow(BaseModel):
     summary: Optional[str] = None
     first_aes: Optional[float] = None
     last_acr: Optional[int] = None
+    path_status: Optional[PathStatusEnum] = None
 
 
 class DiscoverPageTableResponse(BaseModel):