@browserstack/mcp-server 1.5.0-beta.11 → 1.5.0-beta.12

package/capability/tm.capability-index.json

@@ -1,7 +1,7 @@
 {
   "schema_version": 1,
-  "version": "1.4",
-  "build_id": "f6a3eca0_2026-09-09T14:21:54Z",
+  "version": "1.5",
+  "build_id": "bd02ae3b_2026-09-10T11:51:51Z",
   "tm": {
     "summary": "BrowserStack Test Management API (v1 — the SSO/OAuth app API, session-authenticated).",
     "capabilities": [
@@ -21,7 +21,8 @@
             "name": "test_run_id",
             "type": "string",
             "required": true,
-            "example": "TR-14"
+            "example": "TR-14",
+            "pattern": "^(TR-)?[0-9]+$"
           }
         ],
         "body": [
@@ -161,7 +162,8 @@
             "name": "test_plan_ids",
             "type": "array",
             "required": true,
-            "description": "Plan INTEGER ids."
+            "description": "Plan INTEGER ids.",
+            "minItems": 1
           }
         ],
         "intent": "Archive test plans in bulk (reversible — prefer this over delete)",
@@ -209,13 +211,15 @@
             "name": "test_run_id",
             "type": "string",
             "required": true,
-            "example": "TR-14"
+            "example": "TR-14",
+            "pattern": "^(TR-)?[0-9]+$"
           }
         ],
         "query": [
           {
             "name": "include_subfolders_tc",
-            "type": "boolean"
+            "type": "boolean",
+            "default": false
           }
         ],
         "body": [
@@ -504,7 +508,9 @@
             "name": "result_ids",
             "type": "array",
             "required": true,
-            "description": "Result INTEGER ids. Non-empty, max 300."
+            "description": "Result INTEGER ids. Non-empty, max 300.",
+            "minItems": 1,
+            "maxItems": 300
           }
         ],
         "intent": "Delete test results in bulk — PARTIAL SUCCESS is normal, always read `skipped`",
@@ -739,13 +745,15 @@
             "name": "test_run_id",
             "type": "string",
             "required": true,
-            "example": "TR-14"
+            "example": "TR-14",
+            "pattern": "^(TR-)?[0-9]+$"
           }
         ],
         "query": [
           {
             "name": "include_subfolders_tc",
-            "type": "boolean"
+            "type": "boolean",
+            "default": false
           },
           {
             "name": "status_id",
@@ -917,7 +925,14 @@
               {
                 "name": "operation",
                 "type": "string",
-                "required": true
+                "required": true,
+                "values": [
+                  "add",
+                  "remove",
+                  "replace",
+                  "empty",
+                  "ignore"
+                ]
               },
               {
                 "name": "value",
@@ -934,7 +949,14 @@
               {
                 "name": "operation",
                 "type": "string",
-                "required": true
+                "required": true,
+                "values": [
+                  "add",
+                  "remove",
+                  "replace",
+                  "empty",
+                  "ignore"
+                ]
               },
               {
                 "name": "value",
@@ -957,7 +979,12 @@
               {
                 "name": "operation",
                 "type": "string",
-                "required": true
+                "required": true,
+                "values": [
+                  "replace",
+                  "empty",
+                  "ignore"
+                ]
               },
               {
                 "name": "value",
@@ -973,7 +1000,12 @@
               {
                 "name": "operation",
                 "type": "string",
-                "required": true
+                "required": true,
+                "values": [
+                  "replace",
+                  "empty",
+                  "ignore"
+                ]
               },
               {
                 "name": "value",
@@ -989,7 +1021,12 @@
               {
                 "name": "operation",
                 "type": "string",
-                "required": true
+                "required": true,
+                "values": [
+                  "replace",
+                  "empty",
+                  "ignore"
+                ]
               },
               {
                 "name": "value",
@@ -1005,7 +1042,12 @@
               {
                 "name": "operation",
                 "type": "string",
-                "required": true
+                "required": true,
+                "values": [
+                  "replace",
+                  "empty",
+                  "ignore"
+                ]
               },
               {
                 "name": "value",
@@ -1022,7 +1064,12 @@
               {
                 "name": "operation",
                 "type": "string",
-                "required": true
+                "required": true,
+                "values": [
+                  "replace",
+                  "empty",
+                  "ignore"
+                ]
               },
               {
                 "name": "value",
@@ -1039,7 +1086,12 @@
               {
                 "name": "operation",
                 "type": "string",
-                "required": true
+                "required": true,
+                "values": [
+                  "replace",
+                  "empty",
+                  "ignore"
+                ]
               },
               {
                 "name": "value",
@@ -1056,7 +1108,12 @@
               {
                 "name": "operation",
                 "type": "string",
-                "required": true
+                "required": true,
+                "values": [
+                  "replace",
+                  "empty",
+                  "ignore"
+                ]
               },
               {
                 "name": "value",
@@ -1072,7 +1129,12 @@
               {
                 "name": "operation",
                 "type": "string",
-                "required": true
+                "required": true,
+                "values": [
+                  "replace",
+                  "empty",
+                  "ignore"
+                ]
               },
               {
                 "name": "value",
@@ -1089,7 +1151,14 @@
               {
                 "name": "operation",
                 "type": "string",
-                "required": true
+                "required": true,
+                "values": [
+                  "add",
+                  "remove",
+                  "replace",
+                  "empty",
+                  "ignore"
+                ]
               },
               {
                 "name": "value",
@@ -1359,7 +1428,8 @@
             "name": "test_plan_ids",
             "type": "array",
             "required": true,
-            "description": "Plan INTEGER ids."
+            "description": "Plan INTEGER ids.",
+            "minItems": 1
           }
         ],
         "intent": "Un-archive test plans in bulk (undo bulk-archive)",
@@ -1450,6 +1520,7 @@
           {
             "name": "copy_all_sub_plans",
             "type": "boolean",
+            "default": false,
             "json_path": "/test_plan/copy_all_sub_plans"
           },
           {
@@ -1503,29 +1574,34 @@
             "name": "test_run_id",
             "type": "string",
             "required": true,
-            "example": "TR-14"
+            "example": "TR-14",
+            "pattern": "^(TR-)?[0-9]+$"
           }
         ],
         "body": [
           {
             "name": "copy_tc_assignee",
             "type": "boolean",
-            "description": "Copy test case assignees from the original run"
+            "description": "Copy test case assignees from the original run",
+            "default": false
           },
           {
             "name": "copy_issues",
             "type": "boolean",
-            "description": "Copy issues linked to the original run"
+            "description": "Copy issues linked to the original run",
+            "default": false
           },
           {
             "name": "copy_tags",
             "type": "boolean",
-            "description": "Copy tags from the original run"
+            "description": "Copy tags from the original run",
+            "default": false
           },
           {
             "name": "copy_all_cases",
             "type": "boolean",
-            "description": "Include all test cases in the cloned run"
+            "description": "Include all test cases in the cloned run",
+            "default": false
           },
           {
             "name": "status",
@@ -1651,7 +1727,8 @@
             "name": "test_run_id",
             "type": "string",
             "required": true,
-            "example": "TR-14"
+            "example": "TR-14",
+            "pattern": "^(TR-)?[0-9]+$"
           }
         ],
         "intent": "Close a test run",
@@ -1732,13 +1809,15 @@
             "name": "async",
             "type": "boolean",
             "example": true,
-            "description": "Whether to process asynchronously via background job"
+            "description": "Whether to process asynchronously via background job",
+            "default": true
           },
           {
             "name": "copy_test_cases",
             "type": "boolean",
             "example": true,
-            "description": "Whether to copy test cases within folder"
+            "description": "Whether to copy test cases within folder",
+            "default": true
           }
         ],
         "intent": "Copy a folder to another location",
@@ -2275,7 +2354,8 @@
           {
             "name": "field_name",
             "type": "string",
-            "required": true
+            "required": true,
+            "maxLength": 255
           },
           {
             "name": "field_type",
@@ -2304,7 +2384,8 @@
               "TestPlan",
               "ExploratorySession"
             ],
-            "description": "Which entity the field hangs off. One field belongs to exactly one."
+            "description": "Which entity the field hangs off. One field belongs to exactly one.",
+            "default": "TestCase"
           },
           {
             "name": "is_required",
@@ -2338,7 +2419,8 @@
           },
           {
             "name": "place_holder_text",
-            "type": "string"
+            "type": "string",
+            "maxLength": 256
           },
           {
             "name": "default_value",
@@ -2392,6 +2474,7 @@
             "type": "string",
             "required": true,
             "description": "Name of the dataset.",
+            "minLength": 1,
             "json_path": "/dataset/name"
           },
           {
@@ -2403,13 +2486,16 @@
               {
                 "name": "name",
                 "type": "string",
-                "required": true
+                "required": true,
+                "pattern": "^[\\p{L}][\\p{L}\\p{N}_]*$"
               },
               {
                 "name": "uuid",
                 "type": "string"
               }
             ],
+            "minItems": 1,
+            "maxItems": 40,
             "json_path": "/dataset/variables"
           },
           {
@@ -2426,13 +2512,16 @@
               {
                 "name": "row_data",
                 "type": "array",
-                "required": true
+                "required": true,
+                "minItems": 1
               },
               {
                 "name": "uuid",
                 "type": "string"
               }
             ],
+            "minItems": 1,
+            "maxItems": 100,
             "json_path": "/dataset/rows"
           }
         ],
@@ -2521,6 +2610,8 @@
             "type": "integer",
             "example": 60,
             "description": "Planned duration in minutes.",
+            "minimum": 0,
+            "maximum": 2147483647,
             "json_path": "/exploratory_session/timebox_duration"
           },
           {
@@ -2776,7 +2867,8 @@
             "name": "name",
             "type": "string",
             "required": true,
-            "description": "Name of the filter"
+            "description": "Name of the filter",
+            "minLength": 1
           },
           {
             "name": "entity",
@@ -3274,7 +3366,8 @@
               {
                 "name": "order",
                 "type": "integer",
-                "required": true
+                "required": true,
+                "minimum": 1
               },
               {
                 "name": "step",
@@ -3719,12 +3812,14 @@
             "name": "start_date",
             "type": "string",
             "description": "ISO-8601 date.",
+            "format": "date",
             "json_path": "/test_plan/start_date"
           },
           {
             "name": "end_date",
             "type": "string",
             "description": "ISO-8601 date.",
+            "format": "date",
             "json_path": "/test_plan/end_date"
           },
           {
@@ -3838,7 +3933,8 @@
             "name": "test_run_id",
             "type": "string",
             "required": true,
-            "example": "TR-14"
+            "example": "TR-14",
+            "pattern": "^(TR-)?[0-9]+$"
           },
           {
             "name": "test_case_id",
@@ -4884,7 +4980,8 @@
             "name": "test_run_id",
             "type": "string",
             "required": true,
-            "example": "TR-14"
+            "example": "TR-14",
+            "pattern": "^(TR-)?[0-9]+$"
           }
         ],
         "intent": "delete test run",
@@ -5560,7 +5657,8 @@
             "name": "test_run_id",
             "type": "string",
             "required": true,
-            "example": "TR-14"
+            "example": "TR-14",
+            "pattern": "^(TR-)?[0-9]+$"
           }
         ],
         "body": [
@@ -5811,12 +5909,14 @@
             "name": "start_date",
             "type": "string",
             "example": "2025-01-01",
+            "format": "date",
             "json_path": "/filters/start_date"
           },
           {
             "name": "end_date",
             "type": "string",
             "example": "2025-12-31",
+            "format": "date",
             "json_path": "/filters/end_date"
           },
           {
@@ -6418,7 +6518,8 @@
         "query": [
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "default": 1
           }
         ],
         "intent": "Get test cases linked to a dataset",
@@ -6487,7 +6588,8 @@
           },
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "default": 1
           }
         ],
         "intent": "Get dataset variables/columns.",
@@ -7031,15 +7133,18 @@
             "values": [
               "time_period",
               "session_selection"
-            ]
+            ],
+            "default": "time_period"
           },
           {
             "name": "start_date",
-            "type": "string"
+            "type": "string",
+            "format": "date"
           },
           {
             "name": "end_date",
-            "type": "string"
+            "type": "string",
+            "format": "date"
           },
           {
             "name": "session_ids",
@@ -7419,7 +7524,7 @@
                 },
                 "info": {
                   "type": "object",
-                  "description": "Pagination/meta info passthrough from the upstream service"
+                  "description": "Pagination/meta info passthrough from the backing service"
                 },
                 "meta_data": {
                   "type": "object",
@@ -7507,16 +7612,19 @@
         "query": [
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1,
+            "default": 1
           },
           {
             "name": "count",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1
           },
           {
             "name": "q[query]",
             "type": "string",
-            "example": "example-project"
+            "example": "jdoe"
           },
           {
             "name": "q[identifier]",
@@ -7563,11 +7671,14 @@
         "query": [
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1,
+            "default": 1
           },
           {
             "name": "count",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1
           }
         ],
         "intent": "Get all projects (minified dropdown) — has NO name search",
@@ -7691,12 +7802,14 @@
           },
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "default": 1
           },
           {
             "name": "today",
             "type": "string",
-            "example": "2025-05-13"
+            "example": "2025-05-13",
+            "format": "date"
           }
         ],
         "intent": "Retrieve a scheduled report's config and data — the general report read",
@@ -7771,7 +7884,8 @@
           },
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "default": 1
           }
         ],
         "intent": "Fetch one report widget/section — works for EVERY report type.",
@@ -7867,7 +7981,8 @@
           },
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "default": 1
           }
         ],
         "intent": "Get summary statistics for a scheduled report — run and traceability types ONLY",
@@ -7917,7 +8032,8 @@
           {
             "name": "include_folder_hierarchy",
             "type": "boolean",
-            "description": "Whether to include folder hierarchy in the response"
+            "description": "Whether to include folder hierarchy in the response",
+            "default": false
           },
           {
             "name": "p",
@@ -8018,11 +8134,13 @@
         "query": [
           {
             "name": "paginated",
-            "type": "boolean"
+            "type": "boolean",
+            "default": false
           },
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "default": 1
           }
         ],
         "intent": "Get shared steps",
@@ -8071,7 +8189,8 @@
         "query": [
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "default": 1
           },
           {
             "name": "q[query]",
@@ -8079,7 +8198,8 @@
           },
           {
             "name": "pre_fetch",
-            "type": "boolean"
+            "type": "boolean",
+            "default": false
           }
         ],
         "intent": "Get all shared steps for a project",
@@ -8475,7 +8595,9 @@
           {
             "name": "versions[]",
             "type": "array",
-            "required": true
+            "required": true,
+            "minItems": 2,
+            "maxItems": 2
           }
         ],
         "intent": "Get test case history diff",
@@ -8709,7 +8831,8 @@
             "name": "test_run_id",
             "type": "string",
             "required": true,
-            "example": "TR-14"
+            "example": "TR-14",
+            "pattern": "^(TR-)?[0-9]+$"
           }
         ],
         "query": [
@@ -8760,7 +8883,9 @@
         "query": [
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1,
+            "default": 1
           },
           {
             "name": "per_page",
@@ -8891,7 +9016,8 @@
           },
           {
             "name": "today",
-            "type": "string"
+            "type": "string",
+            "format": "date"
           }
         ],
         "intent": "Execution-trend chart data for ONE plan or ONE run (XOR)",
@@ -8992,7 +9118,9 @@
         "query": [
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1,
+            "default": 1
           },
           {
             "name": "include_sub_test_plan_runs",
@@ -9050,7 +9178,9 @@
         "query": [
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1,
+            "default": 1
           },
           {
             "name": "per_page",
@@ -9110,7 +9240,8 @@
             "name": "test_run_id",
             "type": "string",
             "required": true,
-            "example": "TR-14"
+            "example": "TR-14",
+            "pattern": "^(TR-)?[0-9]+$"
           },
           {
             "name": "test_case_id",
@@ -9377,11 +9508,13 @@
         "query": [
           {
             "name": "ignore_run_type",
-            "type": "boolean"
+            "type": "boolean",
+            "default": false
           },
           {
             "name": "include_test_plan",
-            "type": "boolean"
+            "type": "boolean",
+            "default": false
           }
         ],
         "intent": "Get all the test runs for a project",
@@ -9593,7 +9726,9 @@
         "query": [
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1,
+            "default": 1
           }
         ],
         "intent": "List archived test plans",
@@ -9685,7 +9820,8 @@
           },
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "default": 1
           }
         ],
         "intent": "List datasets for a project.",
@@ -9751,7 +9887,8 @@
         "query": [
           {
             "name": "page",
-            "type": "integer"
+            "type": "integer",
+            "default": 1
           },
           {
             "name": "entity_type",
@@ -9810,12 +9947,14 @@
           {
             "name": "page",
             "type": "integer",
-            "example": 1
+            "example": 1,
+            "default": 1
           },
           {
             "name": "per_page",
             "type": "integer",
-            "example": 30
+            "example": 30,
+            "default": 30
           }
         ],
         "intent": "List defects for an exploratory session",
@@ -9905,12 +10044,14 @@
           {
             "name": "page",
             "type": "integer",
-            "example": 1
+            "example": 1,
+            "default": 1
           },
           {
             "name": "per_page",
             "type": "integer",
-            "example": 50
+            "example": 50,
+            "default": 50
           }
         ],
         "intent": "List logs for an exploratory session",
@@ -9966,12 +10107,14 @@
           {
             "name": "page",
             "type": "integer",
-            "example": 1
+            "example": 1,
+            "default": 1
           },
           {
             "name": "per_page",
             "type": "integer",
-            "example": 30
+            "example": 30,
+            "default": 30
           },
           {
             "name": "q[session_state]",
@@ -9980,7 +10123,8 @@
               "active",
               "closed"
             ],
-            "example": "active"
+            "example": "active",
+            "default": "active"
           },
           {
             "name": "q[assignee]",
@@ -10000,12 +10144,14 @@
           {
             "name": "q[created_at_from]",
             "type": "string",
-            "example": "2026-01-01"
+            "example": "2026-01-01",
+            "format": "date"
           },
           {
             "name": "q[created_at_to]",
             "type": "string",
-            "example": "2026-01-31"
+            "example": "2026-01-31",
+            "format": "date"
           },
           {
             "name": "q[tags][]",
@@ -10103,7 +10249,9 @@
           },
           {
             "name": "page",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1,
+            "default": 1
           }
         ],
         "intent": "List filters",
@@ -10204,7 +10352,9 @@
         "query": [
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1,
+            "default": 1
           },
           {
             "name": "per_page",
@@ -10259,11 +10409,13 @@
           {
             "name": "q",
             "type": "string",
-            "example": "example-project"
+            "example": "jdoe"
           },
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1,
+            "default": 1
           },
           {
             "name": "sort_by",
@@ -10280,7 +10432,8 @@
           {
             "name": "is_hidden_projects",
             "type": "boolean",
-            "example": true
+            "example": true,
+            "default": false
           }
         ],
         "intent": "List projects for a group.",
@@ -10351,7 +10504,8 @@
           },
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1
           }
         ],
         "intent": "List all the scheduled reports",
@@ -10450,7 +10604,8 @@
               "TestResult",
               "TestPlan",
               "ExploratorySession"
-            ]
+            ],
+            "default": "TestCase"
           },
           {
             "name": "project",
@@ -10505,11 +10660,14 @@
         "query": [
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1,
+            "default": 1
           },
           {
             "name": "include_sub_plans",
-            "type": "boolean"
+            "type": "boolean",
+            "default": false
           },
           {
             "name": "status",
@@ -10574,7 +10732,8 @@
               "TestResult",
               "TestPlan",
               "ExploratorySession"
-            ]
+            ],
+            "default": "TestCase"
           },
           {
             "name": "field_source",
@@ -10583,7 +10742,8 @@
               "system",
               "custom",
               "all"
-            ]
+            ],
+            "default": "all"
           },
           {
             "name": "field_type",
@@ -11228,7 +11388,9 @@
           },
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1,
+            "default": 1
           }
         ],
         "intent": "Search group tags for an entity type",
@@ -11298,15 +11460,21 @@
           },
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1,
+            "default": 1
           },
           {
             "name": "page_size",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "default": 30
           },
           {
             "name": "include_test_plan",
-            "type": "boolean"
+            "type": "boolean",
+            "default": false
           }
         ],
         "intent": "Search for entities within a project",
@@ -11553,13 +11721,18 @@
             "name": "p",
             "type": "integer",
             "example": 1,
-            "description": "Page number"
+            "description": "Page number",
+            "minimum": 1,
+            "default": 1
           },
           {
             "name": "per_page",
             "type": "integer",
             "example": 5,
-            "description": "Results per page. Rows are large and vary with the data, so probe rather than assume: send p=1 with a moderate per_page and take the rows that actually come back as your ceiling (for entity=test-cases a row is ~40 keys / 5-9 KB, so start around 5). Then keep per_page FIXED for the whole walk — the offset is (p-1)*per_page, so changing it part-way shifts the window and SKIPS rows (page 1 at 5 then "
+            "description": "Results per page. Rows are large and vary with the data, so probe rather than assume: send p=1 with a moderate per_page and take the rows that actually come back as your ceiling (for entity=test-cases a row is ~40 keys / 5-9 KB, so start around 5). Then keep per_page FIXED for the whole walk — the offset is (p-1)*per_page, so changing it part-way shifts the window and SKIPS rows (page 1 at 5 then ",
+            "minimum": 1,
+            "maximum": 100,
+            "default": 25
           },
           {
             "name": "fields",
@@ -11638,11 +11811,16 @@
           },
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1,
+            "default": 1
           },
           {
             "name": "page_size",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "default": 30
           }
         ],
         "intent": "Search users with access to a project",
@@ -11694,11 +11872,16 @@
           },
           {
             "name": "p",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1,
+            "default": 1
           },
           {
             "name": "page_size",
-            "type": "integer"
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "default": 30
           }
         ],
         "intent": "Search test case tags",
@@ -12146,7 +12329,8 @@
           },
           {
             "name": "entity_type",
-            "type": "string"
+            "type": "string",
+            "default": "TestCase"
           },
           {
             "name": "place_holder_text",
@@ -12206,6 +12390,7 @@
             "name": "name",
             "type": "string",
             "description": "Updated name of the dataset.",
+            "minLength": 1,
             "json_path": "/dataset/name"
           },
           {
@@ -12216,13 +12401,16 @@
               {
                 "name": "name",
                 "type": "string",
-                "required": true
+                "required": true,
+                "pattern": "^[\\p{L}][\\p{L}\\p{N}_]*$"
               },
               {
                 "name": "uuid",
                 "type": "string"
               }
             ],
+            "minItems": 1,
+            "maxItems": 40,
             "json_path": "/dataset/variables"
           },
           {
@@ -12238,13 +12426,16 @@
               {
                 "name": "row_data",
                 "type": "array",
-                "required": true
+                "required": true,
+                "minItems": 1
               },
               {
                 "name": "uuid",
                 "type": "string"
               }
             ],
+            "minItems": 1,
+            "maxItems": 100,
             "json_path": "/dataset/rows"
           }
         ],
@@ -12336,6 +12527,8 @@
             "type": "integer",
             "example": 90,
             "description": "Updated planned duration in minutes.",
+            "minimum": 0,
+            "maximum": 2147483647,
             "json_path": "/exploratory_session/timebox_duration"
           },
           {
@@ -12343,6 +12536,8 @@
             "type": "integer",
             "example": 45,
             "description": "Tracked duration in minutes.",
+            "minimum": 0,
+            "maximum": 2147483647,
             "json_path": "/exploratory_session/duration"
           },
           {
@@ -12350,6 +12545,8 @@
             "type": "integer",
             "example": 50,
             "description": "Final actual duration in minutes.",
+            "minimum": 0,
+            "maximum": 2147483647,
             "json_path": "/exploratory_session/actual_duration"
           },
           {
@@ -12612,7 +12809,8 @@
             "name": "name",
             "type": "string",
             "required": true,
-            "description": "Name of the filter"
+            "description": "Name of the filter",
+            "minLength": 1
           },
           {
             "name": "entity",
@@ -12689,7 +12887,8 @@
             "name": "test_run_id",
             "type": "string",
             "required": true,
-            "example": "TR-14"
+            "example": "TR-14",
+            "pattern": "^(TR-)?[0-9]+$"
           },
           {
             "name": "test_case_id",
@@ -13306,12 +13505,14 @@
             "name": "start_date",
             "type": "string",
             "description": "ISO-8601 date.",
+            "format": "date",
             "json_path": "/test_plan/start_date"
           },
           {
             "name": "end_date",
             "type": "string",
             "description": "ISO-8601 date.",
+            "format": "date",
             "json_path": "/test_plan/end_date"
           },
           {
@@ -17238,13 +17439,13 @@
             "type": "string",
             "format": "uri",
             "description": "Pre-signed S3 URL for viewing (inline, ~26 min expiry)",
-            "example": "https://example.com/media/1/2921471/86de8094..."
+            "example": "https://example.com/media/genric/1/2921471/86de8094..."
           },
           "download_url": {
             "type": "string",
             "format": "uri",
             "description": "Pre-signed S3 URL for downloading (attachment, ~26 min expiry)",
-            "example": "https://example.com/media/1/2921471/86de8094..."
+            "example": "https://example.com/media/genric/1/2921471/86de8094..."
           },
           "content_type": {
             "type": "string",
@@ -18355,7 +18556,7 @@
             },
             "selection": {
               "type": "object",
-              "description": "The primary project's persisted folder-structured test-case selection (with select_all / per-folder flags + unique_test_case_count), in the same shape as the test-run edit/selection endpoint. `{}` when the report has no saved selection for the primary project. Used by the Edit dialog to re-check saved test cases (including folder/project-level select_all, which the flat ids cannot represent).",
+              "description": "the primary project's persisted folder-structured test-case selection (with select_all / per-folder flags + unique_test_case_count), in the same shape as the test-run edit/selection endpoint. `{}` when the report has no saved selection for the primary project. Used by the Edit dialog to re-check saved test cases (including folder/project-level select_all, which the flat ids cannot represent).",
               "example": {
                 "select_all": false,
                 "folders": {
@@ -18372,7 +18573,7 @@
             },
             "shared_selection": {
               "type": "object",
-              "description": "Per-project folder-structured selection for the report's non-primary projects, keyed by project id ({ \"<project_id>\": <selection> }). Present only for cross-project Test Case Activity reports; `{}` otherwise.",
+              "description": "per-project folder-structured selection for the report's non-primary projects, keyed by project id ({ \"<project_id>\": <selection> }). Present only for cross-project Test Case Activity reports; `{}` otherwise.",
               "example": {
                 "10209": {
                   "select_all": true,
@@ -19953,7 +20154,7 @@
           "The read detail has NO data wrapper: the plan sits under a top-level test_plan key, and test_plan.identifier is the TP-NNN / STP-NNN.",
           "Sub-plans are HIDDEN by default in the list. Without include_sub_plans=true you see only top-level plans, so a sub-plan the user named will look missing.",
           "name IS REQUIRED ON EVERY PLAN UPDATE, including one that only touches test_runs. Omit it and the call is rejected with 400 {success: false, error: 'Invalid Update Params'} however valid the rest of the body is — the server's edit branch is gated on name being present. Read the plan first and echo its current name back unchanged. Only a pure plan_status transition and a reviewers-only edit are exempt. Verified live: {test_plan: {test_runs: [198]}} 400s; adding name makes the identical call succeed.",
-          "Run ids in test_runs are the INTEGER uuid from a run read — NOT the run's id field, which is the TR-NNN string on every run endpoint (list, plan's run list, single detail alike). Identifiers are forwarded to the upstream service uncoerced and fail upstream (observed 502 Upstream service error). Take uuid, never id.",
+          "Run ids in test_runs are the INTEGER uuid from a run read — NOT the run's id field, which is the TR-NNN string on every run endpoint (list, plan's run list, single detail alike). Identifiers are forwarded to the backing service uncoerced and fail upstream (observed 502 Upstream backing-service error). Take uuid, never id.",
           "Linking a run MOVES it: a run belongs to at most one plan, so linking silently unlinks it from the plan that held it, with nothing in the 200 to say so. Read the runs' current membership first and tell the user which plans will lose runs. Verified live.",
           "test_runs accepts an id array OR a bulk-selection object {select_all, de_selected_ids, search_query}. select_all means 'the newest active runs', NOT 'everything matching' — and `filters` is accepted but SILENTLY IGNORED, so a filtered select_all links the whole recent set. Narrow with search_query (name/identifier substring) or send explicit ids. Verified live.",
           "bulk-archive / bulk-retrieve go ASYNC above the bulk threshold and return {success, async: true, unique_id} — the plans are NOT changed yet. Re-read to confirm; see async-jobs.",
@@ -20013,7 +20214,7 @@
           "Only test_case_ids / selection / shared_selection put cases in a run. `filters` and `dynamic_filter` are a forward-sync rule, NOT a selection: a create carrying only `filters` returns 200 with ZERO cases, and sets is_dynamic: true even though you did not ask. Verified live.",
           "Dynamic runs match on nine fields only: priority, status, category, owner, automation_status, automation_state, folder, tags, issues. created_at/updated_at are stored and echoed on read but NEVER matched, so a 'last 7 days' dynamic run drops the date window and over-collects forever. Create runs static unless the user explicitly asks for sync.",
           "test_run.run_state is MANDATORY on create and edit (new_run | in_progress | under_review | rejected | done | closed). It is validated before the selection, so a bare 400 'invalid data' means a bad test_run field — NOT a bad selection shape.",
-          "A run's `id` FIELD is the TR-NNN STRING, not the integer — on the project list, a plan's linked-run list and the single-run detail alike. The integer lives in `uuid` ({id: 'TR-90', uuid: 198}). Paths tolerate either form, which hides this; bodies and UI paths do not. Carrying `id` into a test plan's test_runs array sends a string that reaches the upstream service uncoerced and 502s there. Take `uuid` whenever a run id leaves a read.",
+          "A run's `id` FIELD is the TR-NNN STRING, not the integer — on the project list, a plan's linked-run list and the single-run detail alike. The integer lives in `uuid` ({id: 'TR-90', uuid: 198}). Paths tolerate either form, which hides this; bodies and UI paths do not. Carrying `id` into a test plan's test_runs array sends a string that reaches the backing service uncoerced and 502s there. Take `uuid` whenever a run id leaves a read.",
           "Full lifecycle is exposed: create, edit, assign, bulk-assign cases, bulk-edit results, clone, close, delete."
         ]
       },