@rbaileysr/zephyr-managed-api 1.3.8 → 1.3.10

package/README.md

@@ -44,29 +44,29 @@ const apiEU = createZephyrApi(
 ## Supported API calls
 
 - [fetch](https://docs.adaptavist.com/src/managed-apis/managed-api-abstractions)
-- Project
+- ### Project
     - [listProjects](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Projects/operation/listProjects)
     - [getProject](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Projects/operation/getProject)
-- Status
+- ### Status
     - [listStatuses](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Statuses/operation/listStatuses)
     - [getStatus](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Statuses/operation/getStatus)
     - [createStatus](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Statuses/operation/createStatus)
     - [updateStatus](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Statuses/operation/updateStatus)
-- Priority
+- ### Priority
     - [listPriorities](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Priorities/operation/listPriorities)
     - [getPriority](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Priorities/operation/getPriority)
     - [createPriority](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Priorities/operation/createPriority)
     - [updatePriority](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Priorities/operation/updatePriority)
-- Environment
+- ### Environment
     - [listEnvironments](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Environments/operation/listEnvironments)
     - [getEnvironment](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Environments/operation/getEnvironment)
     - [createEnvironment](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Environments/operation/createEnvironment)
     - [updateEnvironment](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Environments/operation/updateEnvironment)
-- Folder
+- ### Folder
     - [listFolders](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Folders/operation/listFolders)
     - [getFolder](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Folders/operation/getFolder)
     - [createFolder](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Folders/operation/createFolder)
-- TestCase
+- ### TestCase
     - [listTestCases](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Cases/operation/listTestCases)
     - [listTestCasesCursorPaginated](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Cases/operation/listTestCasesCursorPaginated)
     - [getTestCase](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Cases/operation/getTestCase)
@@ -81,7 +81,7 @@ const apiEU = createZephyrApi(
     - [createTestCaseTestScript](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Cases/operation/createTestCaseTestScript)
     - [getTestCaseTestSteps](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Cases/operation/getTestCaseTestSteps)
     - [createTestCaseTestSteps](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Cases/operation/createTestCaseTestSteps)
-- TestCycle
+- ### TestCycle
     - [listTestCycles](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Cycles/operation/listTestCycles)
     - [getTestCycle](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Cycles/operation/getTestCycle)
     - [createTestCycle](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Cycles/operation/createTestCycle)
@@ -89,14 +89,14 @@ const apiEU = createZephyrApi(
     - [getTestCycleLinks](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Cycles/operation/getTestCycleLinks)
     - [createTestCycleIssueLink](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Cycles/operation/createTestCycleIssueLink)
     - [createTestCycleWebLink](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Cycles/operation/createTestCycleWebLink)
-- TestPlan
+- ### TestPlan
     - [listTestPlans](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Plans/operation/listTestPlans)
     - [getTestPlan](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Plans/operation/getTestPlan)
     - [createTestPlan](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Plans/operation/createTestPlan)
     - [createTestPlanIssueLink](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Plans/operation/createTestPlanIssueLink)
     - [createTestPlanWebLink](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Plans/operation/createTestPlanWebLink)
     - [createTestPlanTestCycleLink](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Plans/operation/createTestPlanTestCycleLink)
-- TestExecution
+- ### TestExecution
     - [listTestExecutions](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Executions/operation/listTestExecutions)
     - [listTestExecutionsNextgen](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Executions/operation/listTestExecutionsNextgen)
     - [getTestExecution](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Executions/operation/getTestExecution)
@@ -107,59 +107,65 @@ const apiEU = createZephyrApi(
     - [syncTestExecutionScript](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Executions/operation/syncTestExecutionScript)
     - [listTestExecutionLinks](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Executions/operation/listTestExecutionLinks)
     - [createTestExecutionIssueLink](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Executions/operation/createTestExecutionIssueLink)
-- Link
+- ### Link
     - [deleteLink](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Links/operation/deleteLink)
-- IssueLink
+- ### IssueLink
     - [getIssueLinkTestCases](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Issue-Links/operation/getIssueLinkTestCases)
     - [getIssueLinkTestCycles](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Issue-Links/operation/getIssueLinkTestCycles)
     - [getIssueLinkTestPlans](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Issue-Links/operation/getIssueLinkTestPlans)
     - [getIssueLinkExecutions](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Issue-Links/operation/getIssueLinkExecutions)
-- Automation
+- ### Automation
     - [createCustomExecutions](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Automation/operation/createCustomExecutions)
     - [createCucumberExecutions](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Automation/operation/createCucumberExecutions)
     - [createJUnitExecutions](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Automation/operation/createJUnitExecutions)
     - [retrieveBDDTestCases](https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Automation/operation/retrieveBDDTestCases)
-- Private ⚠️
-> **⚠️ WARNING: Private API Methods**
-> 
-> The following methods use Zephyr's private/unofficial API endpoints that are:
-> - **Not officially supported** by SmartBear
-> - **Not part of the public API documentation**
-> - **Subject to change at any time** without notice
-> - **Not covered by Standard Support**
-> 
-> Use these methods at your own risk. They may break with future Zephyr updates.
-
-    - Authentication
-        - **getContextJwt** - Get Jira Context JWT token (required for all private API calls)
-    - Comments
-        - **Test Case**: `getTestCaseComments`, `createTestCaseComment`
-        - **Test Cycle**: `getTestCycleComments`, `createTestCycleComment`
-        - **Test Plan**: `getTestPlanComments`, `createTestPlanComment`
-    - Config
-        - **CustomFields**: `createCustomField`, `getCustomFields`
-        - **Labels**: `getLabels`, `createLabel`
-        - **Iterations**: `getIterations`, `createIteration`
-        - **DataSets**: `getDataSets`, `createDataSet`, `updateDataSet`
-        - **archiveConfig** - Archive a config item (Environment, Iteration, or Status)
-        - **unarchiveConfig** - Unarchive a config item (Environment, Iteration, or Status)
-    - Versions
-        - **createTestCaseVersion** - Create a new test case version
-    - Attachments
-        - **Test Case**: `getTestCaseAttachments`, `downloadAttachment`, `createTestCaseAttachment`
-        - **Test Step**: `getTestStepAttachments`, `downloadTestStepAttachment`, `createTestStepAttachment`
-        - **Test Cycle**: `getTestCycleAttachments`, `downloadTestCycleAttachment`, `createTestCycleAttachment`
-        - **Test Plan**: `getTestPlanAttachments`, `downloadTestPlanAttachment`, `createTestPlanAttachment`
-        - **Test Execution**: `getTestExecutionAttachments`, `downloadTestExecutionAttachment`, `createTestExecutionAttachment`
-        - **Test Execution Step**: `getTestExecutionStepAttachments`, `downloadTestExecutionStepAttachment`, `createTestExecutionStepAttachment`
-    - VersionControl
-        - **Test Case (version-specific)**: `getTestCaseIssueLinks`, `getTestCaseWebLinks`, `getTestCaseTestScript`, `getTestCaseTestSteps`
-        - **Test Execution Step**: `getTestExecutionStepIssueLinks`, `createTestExecutionStepIssueLink`
-    - ExtendedData (supplements public API with extended data: iterations and versions)
-        - **Test Cycle**: `getTestCycleIteration`, `updateTestCycleIteration`
-        - **Test Execution**: `getTestExecutionIteration`, `updateTestExecutionIteration`, `getTestExecutionVersion`, `updateTestExecutionVersion`
-    - TestCaseArchiving (access archived test cases and archiving operations)
-        - **Test Case**: `getArchivedTestCases`, `archiveTestCases`, `unarchiveTestCases`
+- ### **Private** ⚠️
+  > **⚠️ WARNING: Private API Methods**
+  > 
+  > The following methods use Zephyr's private/unofficial API endpoints that are:
+  > - **Not officially supported** by SmartBear
+  > - **Not part of the public API documentation**
+  > - **Subject to change at any time** without notice
+  > - **Not covered by Standard Support**
+  > 
+  > Use these methods at your own risk. They may break with future Zephyr updates.
+  - ### Authentication
+      - **getContextJwt** - Get Jira Context JWT token (required for all private API calls)
+      - **enableZephyrForProject** - Enable Zephyr for a Jira project
+      - **isZephyrEnabledForProject** - Check if Zephyr is enabled for a Jira project
+  - ### Comments
+      - **Test Case**: `getTestCaseComments`, `createTestCaseComment`
+      - **Test Cycle**: `getTestCycleComments`, `createTestCycleComment`
+      - **Test Plan**: `getTestPlanComments`, `createTestPlanComment`
+  - ### Config
+      - **CustomFields**: `createCustomField`, `getCustomFields`
+      - **Labels**: `getLabels`, `createLabel`
+      - **Iterations**: `getIterations`, `createIteration`
+      - **DataSets**: `getDataSets`, `createDataSet`, `updateDataSet`
+      - **archiveConfig** - Archive a config item (Environment, Iteration, or Status)
+      - **unarchiveConfig** - Unarchive a config item (Environment, Iteration, or Status)
+  - ### Versions
+      - **createTestCaseVersion** - Create a new test case version
+  - ### Attachments
+      - **Test Case**: `getTestCaseAttachments`, `downloadAttachment`, `createTestCaseAttachment`
+      - **Test Step**: `getTestStepAttachments`, `downloadTestStepAttachment`, `createTestStepAttachment`
+      - **Test Cycle**: `getTestCycleAttachments`, `downloadTestCycleAttachment`, `createTestCycleAttachment`
+      - **Test Plan**: `getTestPlanAttachments`, `downloadTestPlanAttachment`, `createTestPlanAttachment`
+      - **Test Execution**: `getTestExecutionAttachments`, `downloadTestExecutionAttachment`, `createTestExecutionAttachment`
+      - **Test Execution Step**: `getTestExecutionStepAttachments`, `downloadTestExecutionStepAttachment`, `createTestExecutionStepAttachment`
+  - ### VersionControl
+      - **Test Case (version-specific)**: `getTestCaseIssueLinks`, `getTestCaseWebLinks`, `getTestCaseTestScript`, `getTestCaseTestSteps`
+      - **Test Execution Step**: `getTestExecutionStepIssueLinks`, `createTestExecutionStepIssueLink`
+  - ### ExtendedData (supplements public API with extended data: iterations and versions)
+      - **Test Cycle**: `getTestCycleIteration`, `updateTestCycleIteration`
+      - **Test Execution**: `getTestExecutionIteration`, `updateTestExecutionIteration`, `getTestExecutionVersion`, `updateTestExecutionVersion`
+  - ### TestCaseArchiving (access archived test cases and archiving operations)
+      - **Test Case**: `getArchivedTestCases`, `archiveTestCases`, `unarchiveTestCases`
+  - ### TestScriptData (manage test script data: Parameters and Test Data)
+      - **Test Case**: `setTestCaseParamTypeToParameter`, `setTestCaseParameters`, `setTestCaseParamTypeToTestData`, `setTestCaseTestData`, `getTestCaseTestData`, `hasTestCaseTestData`
+  - ### TestExecutions (create and update test executions for test cases with test data)
+      - **Test Execution**: `createTestExecutionWithTestData`, `updateTestExecution`, `getTestExecutionSteps`, `updateTestExecutionStepStatus`, `updateTestExecutionStepComment`
+      - **Test Cycle**: `getTestCycleItems`
 
 ## Private API Authentication
 
@@ -184,135 +190,82 @@ const credentials = {
 
 // Get Context JWT token
 const contextJwt = await api.Private.Authentication.getContextJwt(credentials);
+
+// Check if Zephyr is enabled for a project
+const status = await api.Private.Authentication.isZephyrEnabledForProject(credentials, {
+  projectId: 10349
+});
+// Returns: { id: 10349, key: 'D1', permissionSystemEnabled: false, kanoahTestsEnabled: true, active: 1 }
+
+// Enable Zephyr for a project
+await api.Private.Authentication.enableZephyrForProject(credentials, {
+  projectId: 10349
+});
 ```
 
-### Example: Create Custom Field
+### Example: Config Operations
 
 ```typescript
-// Create a custom field for test cases
+// Create custom field
 const customField = await api.Private.Config.CustomFields.createCustomField(
-  credentials,
-  'TEST_CASE',
-  {
+  credentials, 'TEST_CASE', {
     projectId: 10017,
     name: 'Build Number',
     type: 'SINGLE_LINE_TEXT',
-    required: false,
-    index: 4,
-    category: 'TEST_CASE',
-    archived: false
+    required: false
   }
 );
-```
-
-### Example: Create Label
 
-```typescript
-// Create a new label
+// Create label
 await api.Private.Config.Labels.createLabel(credentials, {
   projectId: 10233,
   name: 'automated'
 });
 
-// Get all labels
-const labels = await api.Private.Config.Labels.getLabels(credentials, {
-    projectId: 10233
-});
-```
-
-### Example: Create Iteration
-
-```typescript
-// Create a new iteration
+// Create iteration
 const iteration = await api.Private.Config.Iterations.createIteration(credentials, {
   projectId: 10233,
   name: 'Sprint 1',
   description: 'First sprint of Q1'
 });
 
-// Get all iterations
-const iterations = await api.Private.Config.Iterations.getIterations(credentials, {
-    projectId: 10233
-});
-```
-
-### Example: Create and Update Data Set
-
-```typescript
-// Create a new data set (empty)
+// Create and update data set
 const dataSet = await api.Private.Config.DataSets.createDataSet(credentials, {
   projectId: 10233,
   name: 'Environment'
 });
-
-// Add items/options to the data set
-const updatedDataSet = await api.Private.Config.DataSets.updateDataSet(credentials, {
+await api.Private.Config.DataSets.updateDataSet(credentials, {
   id: dataSet.id,
-  name: 'Environment',
   projectId: 10233,
   items: [
     { name: 'Production', index: 0, archived: false },
-    { name: 'Staging', index: 1, archived: false },
-    { name: 'Development', index: 2, archived: false }
+    { name: 'Staging', index: 1, archived: false }
   ]
 });
-
-// Get all data sets
-const dataSets = await api.Private.Config.DataSets.getDataSets(credentials, {
-    projectId: 10233
-});
 ```
 
 ### Example: Archive and Unarchive Config Items
 
 ```typescript
-// Archive an environment
-const archivedEnv = await api.Private.Config.archiveConfig(credentials, {
+// Archive an environment or iteration
+await api.Private.Config.archiveConfig(credentials, {
   type: 'Environment',
   id: 10873400,
   projectId: 10233
 });
 
-// Unarchive an iteration
-const unarchivedIteration = await api.Private.Config.unarchiveConfig(credentials, {
-  type: 'Iteration',
-  id: 10909775,
-  projectId: 10233
-});
-
-// Archive a test case status
-const archivedTestCaseStatus = await api.Private.Config.archiveConfig(credentials, {
+// Archive statuses (supports: TestCaseStatus, TestPlanStatus, TestCycleStatus, TestExecutionStatus)
+await api.Private.Config.archiveConfig(credentials, {
   type: 'TestCaseStatus',
   id: 10952238,
   projectId: 10313
 });
 
-// Archive a test plan status
-const archivedTestPlanStatus = await api.Private.Config.archiveConfig(credentials, {
-  type: 'TestPlanStatus',
-  id: 10952241,
-  projectId: 10313
-});
-
-// Archive a test cycle status
-const archivedTestCycleStatus = await api.Private.Config.archiveConfig(credentials, {
-  type: 'TestCycleStatus',
-  id: 10952244,
-  projectId: 10313
-});
-
-// Archive a test execution status
-const archivedTestExecutionStatus = await api.Private.Config.archiveConfig(credentials, {
-  type: 'TestExecutionStatus',
-  id: 10952247,
-  projectId: 10313
-});
-
-// Unarchive any status (same types supported)
-const unarchivedStatus = await api.Private.Config.unarchiveConfig(credentials, {
-  type: 'TestCaseStatus',
-  id: 10952238,
-  projectId: 10313
+// Unarchive any config item (same types supported)
+await api.Private.Config.unarchiveConfig(credentials, {
+  type: 'Iteration',
+  id: 10909775,
+  projectId: 10233
 });
 ```
 
@@ -347,211 +300,228 @@ const attachment = await api.Private.Attachments.createTestCaseAttachment(
 );
 ```
 
-### Example: Get Version-Specific Data
+### Example: Version-Specific Data
 
 ```typescript
-// Get issue links for current version
+// Get version-specific data for test cases (version parameter is optional, defaults to latest)
 const issueLinks = await api.Private.VersionControl.getTestCaseIssueLinks(credentials, {
   testCaseKey: 'PROJ-T1',
-    projectId: 10233
-});
-
-// Get web links for version 2 (previous version)
-const webLinks = await api.Private.VersionControl.getTestCaseWebLinks(credentials, {
-  testCaseKey: 'PROJ-T1',
-    projectId: 10233,
-  version: 2
+  projectId: 10233,
+  version: 2  // Get links for version 2
 });
 
-// Get test script for version 3
 const testScript = await api.Private.VersionControl.getTestCaseTestScript(credentials, {
-  testCaseKey: 'PROJ-T1',
-    projectId: 10233,
-  version: 3
-});
-
-// Get test steps for version 4 (current version, if there are 4 versions total)
-const testSteps = await api.Private.VersionControl.getTestCaseTestSteps(credentials, {
   testCaseKey: 'PROJ-T1',
   projectId: 10233,
-  version: 4
+  version: 3
 });
 
-// Get issue links for a test execution step (useful for migration)
-const stepIssueLinks = await api.Private.VersionControl.getTestExecutionStepIssueLinks(credentials, {
+// Test execution step issue links
+const stepLinks = await api.Private.VersionControl.getTestExecutionStepIssueLinks(credentials, {
   testExecutionKey: 'PROJ-E1',
   stepIndex: 0,
   projectId: 10233
 });
-// Returns: [{ id: 169099471, issueId: '66019', type: 'BLOCKS' }, ...]
 
-// Create an issue link for a test execution step
-const stepLink = await api.Private.VersionControl.createTestExecutionStepIssueLink(credentials, {
+await api.Private.VersionControl.createTestExecutionStepIssueLink(credentials, {
   testExecutionKey: 'PROJ-E1',
   stepIndex: 0,
   issueId: 66019,
-  type: 'RELATED',
   projectId: 10233
 });
+// Note: Link type is always 'RELATED' (typeId 3) - the API does not support choosing link types
 ```
 
-### Example: Get and Set Extended Data (Supplements Public API)
+### Example: Extended Data (Supplements Public API)
 
-The public API does not support getting or setting iterations for Test Cycles and Test Executions, or Jira version IDs (release versions) for Test Executions. Use the `ExtendedData` sub-group to supplement public API calls with this additional data.
+The public API does not support iterations for Test Cycles/Executions or Jira version IDs for Test Executions. Use `ExtendedData` to supplement public API calls.
 
 ```typescript
-// === Test Cycle Iteration ===
-
-// Create test cycle with public API
+// Test Cycle: Set/get iteration
 const testCycle = await api.TestCycle.createTestCycle({
   projectKey: 'M12',
   name: 'Sprint 1 Testing'
 });
-
-// Set iteration using private API (supplements createTestCycle)
 await api.Private.ExtendedData.updateTestCycleIteration(credentials, {
   testCycleKey: testCycle.key,
   projectId: 10313,
   iterationId: 10952254
 });
-
-// Get iteration data (supplements getTestCycle)
-const testCycleIteration = await api.Private.ExtendedData.getTestCycleIteration(credentials, {
+const cycleIteration = await api.Private.ExtendedData.getTestCycleIteration(credentials, {
   testCycleKey: 'M12-R1',
   projectId: 10313
 });
-console.log('Test Cycle Iteration ID:', testCycleIteration.iterationId); // null if not set
-
-// === Test Execution Iteration ===
 
-// Create test execution with public API (returns void)
+// Test Execution: Set/get iteration and version
 await api.TestExecution.createTestExecution({
   projectKey: 'M12',
   testCaseKey: 'M12-T1',
   testCycleKey: 'M12-R1',
   statusName: 'Pass'
 });
-
-// Note: createTestExecution returns no data, so you need to know the execution key
-// or look it up using listTestExecutions() after creation
-
-// Set iteration using private API (supplements createTestExecution)
+// Note: createTestExecution returns void - use known key or look up via listTestExecutions()
 await api.Private.ExtendedData.updateTestExecutionIteration(credentials, {
-  testExecutionKey: 'M12-E1', // Use known key or look up after creation
+  testExecutionKey: 'M12-E1',
   projectId: 10313,
   iterationId: 10952254
 });
-
-// Get iteration data (supplements getTestExecution)
-const testExecutionIteration = await api.Private.ExtendedData.getTestExecutionIteration(credentials, {
-  testExecutionKey: 'M12-E1',
-  projectId: 10313
+await api.Private.ExtendedData.updateTestExecutionVersion(credentials, {
+  testExecutionKey: 'M15-E3',
+  projectId: 10316,
+  jiraVersionId: 10102
 });
-console.log('Test Execution Iteration ID:', testExecutionIteration.iterationId); // null if not set
 
-// Clear iteration by setting to null
+// Clear by setting to null
 await api.Private.ExtendedData.updateTestCycleIteration(credentials, {
   testCycleKey: 'M12-R1',
   projectId: 10313,
   iterationId: null
 });
+```
 
-// === Test Execution Version (Release Version) ===
-
-// Create test execution with public API (returns void)
-await api.TestExecution.createTestExecution({
-  projectKey: 'M15',
-  testCaseKey: 'M15-T3',
-  testCycleKey: 'M15-R1',
-  statusName: 'Pass'
-});
+### Example: Test Case Archiving
 
-// Note: createTestExecution returns no data, so you need to know the execution key
-// or look it up using listTestExecutions() after creation
+The public API does not expose the archived flag. Use `TestCaseArchiving` to list, archive, and unarchive test cases.
 
-// Set Jira version ID (release version) using private API (supplements createTestExecution)
-await api.Private.ExtendedData.updateTestExecutionVersion(credentials, {
-  testExecutionKey: 'M15-E3', // Use known key or look up after creation
+```typescript
+// Get archived test cases (paginated, optional query filter)
+const archived = await api.Private.TestCaseArchiving.getArchivedTestCases(credentials, {
   projectId: 10316,
-  jiraVersionId: 10102
+  maxResults: 50,
+  startAt: 0,
+  query: "testCase.name CONTAINS 'migration'"  // optional
 });
 
-// Get version data (supplements getTestExecution)
-const testExecutionVersion = await api.Private.ExtendedData.getTestExecutionVersion(credentials, {
-  testExecutionKey: 'M15-E3',
-  projectId: 10316
+// Archive test cases (single or multiple)
+await api.Private.TestCaseArchiving.archiveTestCases(credentials, {
+  projectId: 10316,
+  testCaseIds: [288004503, 288004504, 288004505]
 });
-console.log('Jira Version ID:', testExecutionVersion.jiraVersionId); // null if not set
 
-// Clear version by setting to null
-await api.Private.ExtendedData.updateTestExecutionVersion(credentials, {
-  testExecutionKey: 'M15-E3',
+// Unarchive test cases
+await api.Private.TestCaseArchiving.unarchiveTestCases(credentials, {
   projectId: 10316,
-  jiraVersionId: null
+  testCaseIds: [288004503]
 });
 ```
 
-### Example: Test Case Archiving
+### Test Script Data
 
-The public API does not expose the archived flag on test cases. Use the `TestCaseArchiving` sub-group to list archived test cases and perform archiving/unarchiving operations.
+The public API does not expose test script data (Parameters and Test Data). Use `TestScriptData` to manage this data.
 
 ```typescript
-// === Get Archived Test Cases ===
-
-// Get first page of archived test cases
-const archived = await api.Private.TestCaseArchiving.getArchivedTestCases(credentials, {
-  projectId: 10316,
-  maxResults: 50,
-  startAt: 0
+// Check if test case has test script data
+const hasData = await api.Private.TestScriptData.hasTestCaseTestData(credentials, {
+  testCaseKey: 'M14-T6',
+  projectId: 10315
 });
-console.log(`Found ${archived.total} archived test cases`);
-archived.results.forEach(tc => {
-  console.log(`- ${tc.key}: ${tc.name}`);
+// Returns: { hasData: true, type: 'PARAMETER' } or { hasData: false, type: null }
+
+// Get test script data
+const testData = await api.Private.TestScriptData.getTestCaseTestData(credentials, {
+  testCaseKey: 'M14-T6',
+  projectId: 10315
 });
+// Returns: { paramType: 'PARAMETER' | 'TEST_DATA' | null, parameters: [...], testData: [...] }
 
-// Get archived test cases with custom query filter
-const filtered = await api.Private.TestCaseArchiving.getArchivedTestCases(credentials, {
-  projectId: 10316,
-  query: "testCase.name CONTAINS 'migration'",
-  maxResults: 100
+// Set test case to use Parameters
+await api.Private.TestScriptData.setTestCaseParamTypeToParameter(credentials, {
+  testCaseKey: 'M14-T6',
+  projectId: 10315
 });
 
-// === Archive Test Cases ===
+// Set parameters
+await api.Private.TestScriptData.setTestCaseParameters(credentials, {
+  testCaseKey: 'M14-T6',
+  projectId: 10315,
+  parameters: [
+    { index: 0, name: 'param1', defaultValue: 'value1' },
+    { index: 1, name: 'param2', defaultValue: 'value2' }
+  ]
+});
 
-// Archive a single test case
-await api.Private.TestCaseArchiving.archiveTestCases(credentials, {
-  projectId: 10316,
-  testCaseIds: [288004503]
+// Set test case to use Test Data
+await api.Private.TestScriptData.setTestCaseParamTypeToTestData(credentials, {
+  testCaseKey: 'M14-T6',
+  projectId: 10315
 });
 
-// Archive multiple test cases
-await api.Private.TestCaseArchiving.archiveTestCases(credentials, {
-  projectId: 10316,
-  testCaseIds: [288004503, 288004504, 288004505]
+// Set test data (simplified array format)
+await api.Private.TestScriptData.setTestCaseTestData(credentials, {
+  testCaseKey: 'M14-T6',
+  projectId: 10315,
+  testData: [
+    // Row 1
+    [
+      { columnName: 'Dataset Column', type: 'data_set', index: 0, dataSetItemId: 936037 },
+      { columnName: 'Custom Column', type: 'free_text_input', index: 1, value: 'test value' }
+    ]
+  ]
 });
+```
 
-// === Unarchive Test Cases ===
+### Test Executions with Test Data
 
-// Unarchive a single test case
-await api.Private.TestCaseArchiving.unarchiveTestCases(credentials, {
-  projectId: 10316,
-  testCaseIds: [288004503]
-});
+The public API does not correctly handle creating test executions for test cases with test data or test cases with "Call to Test" steps that reference test cases with test data. Use `TestExecutions` to create and update these executions.
 
-// Unarchive multiple test cases
-await api.Private.TestCaseArchiving.unarchiveTestCases(credentials, {
-  projectId: 10316,
-  testCaseIds: [288004503, 288004504, 288004505]
+```typescript
+// Create test execution for test case with test data
+// This automatically handles the two-step process:
+// 1. Creates execution via public API
+// 2. Gets testRunItemId from private API
+// 3. Creates actual execution via private API
+const execution = await api.Private.TestExecutions.createTestExecutionWithTestData(credentials, {
+  testCaseKey: 'M14-T6',
+  testCycleKey: 'M14-R1',
+  assignedTo: '5d259f2e0b81c60c239bed83', // optional
+  projectId: 10315
+});
+// Returns: { id: 2065132733, key: 'M14-E18' }
+
+// Get test cycle items (to find testRunItemId for a test case)
+const items = await api.Private.TestExecutions.getTestCycleItems(credentials, {
+  testCycleKey: 'M14-R1',
+  projectId: 10315
+});
+
+// Update parent test execution
+await api.Private.TestExecutions.updateTestExecution(credentials, {
+  testExecutionKey: 'M14-E18',
+  id: 2065132733, // Optional if testExecutionKey is provided
+  actualStartDate: '2025-12-24T13:02:50.233Z',
+  executionDate: '2025-12-24T13:02:50.233Z',
+  executionTime: 0,
+  testResultStatusId: 10952941,
+  projectId: 10315
+});
+
+// Get test execution steps (to get step IDs for updates)
+const steps = await api.Private.TestExecutions.getTestExecutionSteps(credentials, {
+  testCycleKey: 'M14-R1',
+  testRunItemId: 1443476310, // From getTestCycleItems
+  projectId: 10315
+});
+
+// Update test execution step status
+await api.Private.TestExecutions.updateTestExecutionStepStatus(credentials, {
+  id: 6287896613, // From getTestExecutionSteps
+  testResultStatusId: 10952942,
+  executionDate: '2025-12-24T13:02:50.232Z',
+  projectId: 10315
+});
+
+// Update test execution step comment (actual result)
+await api.Private.TestExecutions.updateTestExecutionStepComment(credentials, {
+  id: 6287896613, // From getTestExecutionSteps
+  comment: 'Test passed successfully',
+  projectId: 10315
 });
 ```
 
-**Note:** Version numbers are absolute (1-based: 1 = first version ever created, 2 = second version, etc. The highest number is the current/latest version). Use `listTestCaseVersions()` to find the total number of versions and identify the latest. If `version` is not provided, the latest version is used.
-
-**Important Notes:**
-- Private API methods require a `PrivateApiCredentials` object with `userEmail`, `apiToken`, and `jiraInstanceUrl`
-- The Context JWT token expires after 15 minutes and must be retrieved for each private API call
-- All private API methods automatically handle Context JWT retrieval internally
-- Methods that accept keys (like `testCaseKey`) automatically look up numeric IDs when needed
+**Notes:**
+- Version numbers are absolute (1-based). Use `listTestCaseVersions()` to find available versions. If `version` is not provided, the latest version is used.
+- Private API methods require `PrivateApiCredentials` (`userEmail`, `apiToken`, `jiraInstanceUrl`). Context JWT tokens expire after 15 minutes and are automatically retrieved internally.
+- Methods accept keys (e.g., `testCaseKey`) and automatically look up numeric IDs when needed.
 
 ## Contact
 
@@ -559,6 +529,29 @@ Feel free to drop ideas, suggestions or improvements into our [Community hub](ht
 
 ## Changelog
 
+### 1.3.10
+
+- **Added**: New `TestScriptData` sub-group under Private API for managing test script data (Parameters and Test Data)
+- **Added**: `setTestCaseParamTypeToParameter()` - Set test case param type to Parameter
+- **Added**: `setTestCaseParameters()` - Set parameters array for a test case
+- **Added**: `setTestCaseParamTypeToTestData()` - Set test case param type to Test Data
+- **Added**: `setTestCaseTestData()` - Set test data array for a test case (simplified array format)
+- **Added**: `getTestCaseTestData()` - Get test script data (paramType, parameters, testData) for a test case
+- **Added**: `hasTestCaseTestData()` - Check if test case has test script data (Parameters or Test Data)
+- **Added**: New `TestExecutions` sub-group under Private API for creating and updating test executions for test cases with test data
+- **Added**: `createTestExecutionWithTestData()` - Create test execution for test case with test data (handles full workflow automatically)
+- **Added**: `getTestCycleItems()` - Get test cycle items (testRunItems) for a test cycle
+- **Added**: `updateTestExecution()` - Update parent test execution information
+- **Added**: `getTestExecutionSteps()` - Get test execution steps (returns only IDs and basic info needed for updates)
+- **Added**: `updateTestExecutionStepStatus()` - Update test execution step status
+- **Added**: `updateTestExecutionStepComment()` - Update test execution step comment (actual result)
+- **Added**: `enableZephyrForProject()` - Enable Zephyr for a Jira project (under Authentication sub-group)
+- **Added**: `isZephyrEnabledForProject()` - Check if Zephyr is enabled for a Jira project (under Authentication sub-group)
+
+### 1.3.9
+
+- **Changed**: Readme fixes
+
 ### 1.3.8
 
 - **Added**: `getTestExecutionVersion()` - Get Jira version ID (release version) for a test execution (supplements public `getTestExecution()`)