@rbaileysr/zephyr-managed-api 1.3.6 → 1.3.8

package/dist/groups/Private/PrivateTestCaseArchiving.js

@@ -0,0 +1,265 @@
+/*!
+ * Copyright Adaptavist 2025 (c) All rights reserved
+ */
+import { PrivateBase } from './PrivateBase';
+import { BadRequestError, UnauthorizedError, ForbiddenError, NotFoundError, ServerError, UnexpectedError, } from '../../utils';
+export class PrivateTestCaseArchiving extends PrivateBase {
+    constructor(apiConnection) {
+        super(apiConnection);
+    }
+    /**
+     * Get archived test cases using private API
+     *
+     * Retrieves a paginated list of archived test cases for a project.
+     * The archived flag is not available in the public API, so this method
+     * provides access to archived test cases.
+     *
+     * ⚠️ WARNING: This uses a private Zephyr API endpoint that is not officially supported.
+     * The endpoint may change or be removed at any time without notice.
+     *
+     * @param credentials - Private API credentials
+     * @param request - Get archived test cases request
+     * @param request.projectId - Jira project ID (numeric, not the project key)
+     * @param request.maxResults - Maximum number of results to return (default: 50)
+     * @param request.startAt - Zero-indexed starting position (default: 0)
+     * @param request.query - Optional query string for filtering (e.g., "testCase.name CONTAINS 'test'")
+     * @returns Paginated list of archived test cases
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {ServerError} If the server returns an error
+     *
+     * @example
+     * ```typescript
+     * // Get first page of archived test cases
+     * const archived = await api.Private.TestCaseArchiving.getArchivedTestCases(credentials, {
+     *   projectId: 10316,
+     *   maxResults: 50,
+     *   startAt: 0
+     * });
+     *
+     * // Get archived test cases with custom query
+     * const filtered = await api.Private.TestCaseArchiving.getArchivedTestCases(credentials, {
+     *   projectId: 10316,
+     *   query: "testCase.name CONTAINS 'migration'"
+     * });
+     * ```
+     */
+    async getArchivedTestCases(credentials, request) {
+        // Get Context JWT
+        const contextJwt = await this.getContextJwt(credentials);
+        // Build query string
+        const maxResults = request.maxResults ?? 50;
+        const startAt = request.startAt ?? 0;
+        const query = request.query ?? `testCase.projectId IN (${request.projectId}) ORDER BY testCase.name ASC`;
+        // Build fields list (matching the example)
+        const fields = 'id,key,projectId,name,averageTime,estimatedTime,labels,folderId,componentId,status(id,name,i18nKey,color),priority(id,name,i18nKey,color),lastTestResultStatus(name,i18nKey,color),majorVersion,createdOn,createdBy,updatedOn,updatedBy,customFieldValues,owner,folderId';
+        // Build URL
+        const params = new URLSearchParams({
+            fields,
+            query,
+            startAt: String(startAt),
+            maxResults: String(maxResults),
+            archived: 'true',
+        });
+        const url = `${this.privateApiBaseUrl}/testcase/search?${params.toString()}`;
+        const headers = {
+            accept: 'application/json',
+            authorization: `JWT ${contextJwt}`,
+            'jira-project-id': String(request.projectId),
+        };
+        try {
+            const response = await fetch(url, {
+                method: 'GET',
+                headers,
+            });
+            if (!response.ok) {
+                if (response.status === 400) {
+                    throw new BadRequestError(`Invalid request parameters for getting archived test cases.`);
+                }
+                if (response.status === 401) {
+                    throw new UnauthorizedError('Failed to authenticate. Please check your credentials.');
+                }
+                if (response.status === 403) {
+                    throw new ForbiddenError('Insufficient permissions to get archived test cases.');
+                }
+                throw new ServerError(`Failed to get archived test cases. Status: ${response.status}`, response.status, response.statusText);
+            }
+            const data = (await response.json());
+            return data;
+        }
+        catch (error) {
+            if (error instanceof BadRequestError ||
+                error instanceof UnauthorizedError ||
+                error instanceof ForbiddenError ||
+                error instanceof NotFoundError ||
+                error instanceof ServerError ||
+                error instanceof UnexpectedError) {
+                throw error;
+            }
+            throw new UnexpectedError(`Unexpected error while getting archived test cases for project ${request.projectId}`, error);
+        }
+    }
+    /**
+     * Archive test cases using private API
+     *
+     * Archives one or more test cases. This is a bulk operation that accepts
+     * an array of test case IDs.
+     *
+     * ⚠️ WARNING: This uses a private Zephyr API endpoint that is not officially supported.
+     * The endpoint may change or be removed at any time without notice.
+     *
+     * @param credentials - Private API credentials
+     * @param request - Archive test cases request
+     * @param request.projectId - Jira project ID (numeric, not the project key)
+     * @param request.testCaseIds - Array of test case IDs to archive
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {ServerError} If the server returns an error
+     *
+     * @example
+     * ```typescript
+     * // Archive a single test case
+     * await api.Private.TestCaseArchiving.archiveTestCases(credentials, {
+     *   projectId: 10316,
+     *   testCaseIds: [288004503]
+     * });
+     *
+     * // Archive multiple test cases
+     * await api.Private.TestCaseArchiving.archiveTestCases(credentials, {
+     *   projectId: 10316,
+     *   testCaseIds: [288004503, 288004504, 288004505]
+     * });
+     * ```
+     */
+    async archiveTestCases(credentials, request) {
+        // Get Context JWT
+        const contextJwt = await this.getContextJwt(credentials);
+        // Validate input
+        if (!request.testCaseIds || request.testCaseIds.length === 0) {
+            throw new BadRequestError('At least one test case ID is required for archiving.');
+        }
+        const url = `${this.privateApiBaseUrl}/testcase/bulk/archive`;
+        const headers = {
+            'Content-Type': 'application/json',
+            accept: 'application/json',
+            authorization: `JWT ${contextJwt}`,
+            'jira-project-id': String(request.projectId),
+        };
+        // Body is an array of test case IDs
+        const body = JSON.stringify(request.testCaseIds);
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers,
+                body,
+            });
+            if (!response.ok) {
+                if (response.status === 400) {
+                    throw new BadRequestError(`Invalid request parameters for archiving test cases.`);
+                }
+                if (response.status === 401) {
+                    throw new UnauthorizedError('Failed to authenticate. Please check your credentials.');
+                }
+                if (response.status === 403) {
+                    throw new ForbiddenError('Insufficient permissions to archive test cases.');
+                }
+                throw new ServerError(`Failed to archive test cases. Status: ${response.status}`, response.status, response.statusText);
+            }
+            // Response is empty on success
+        }
+        catch (error) {
+            if (error instanceof BadRequestError ||
+                error instanceof UnauthorizedError ||
+                error instanceof ForbiddenError ||
+                error instanceof NotFoundError ||
+                error instanceof ServerError ||
+                error instanceof UnexpectedError) {
+                throw error;
+            }
+            throw new UnexpectedError(`Unexpected error while archiving test cases for project ${request.projectId}`, error);
+        }
+    }
+    /**
+     * Unarchive test cases using private API
+     *
+     * Unarchives one or more test cases. This is a bulk operation that accepts
+     * an array of test case IDs.
+     *
+     * ⚠️ WARNING: This uses a private Zephyr API endpoint that is not officially supported.
+     * The endpoint may change or be removed at any time without notice.
+     *
+     * @param credentials - Private API credentials
+     * @param request - Unarchive test cases request
+     * @param request.projectId - Jira project ID (numeric, not the project key)
+     * @param request.testCaseIds - Array of test case IDs to unarchive
+     * @throws {BadRequestError} If the request is invalid
+     * @throws {UnauthorizedError} If authentication fails
+     * @throws {ForbiddenError} If the user doesn't have permission
+     * @throws {ServerError} If the server returns an error
+     *
+     * @example
+     * ```typescript
+     * // Unarchive a single test case
+     * await api.Private.TestCaseArchiving.unarchiveTestCases(credentials, {
+     *   projectId: 10316,
+     *   testCaseIds: [288004503]
+     * });
+     *
+     * // Unarchive multiple test cases
+     * await api.Private.TestCaseArchiving.unarchiveTestCases(credentials, {
+     *   projectId: 10316,
+     *   testCaseIds: [288004503, 288004504, 288004505]
+     * });
+     * ```
+     */
+    async unarchiveTestCases(credentials, request) {
+        // Get Context JWT
+        const contextJwt = await this.getContextJwt(credentials);
+        // Validate input
+        if (!request.testCaseIds || request.testCaseIds.length === 0) {
+            throw new BadRequestError('At least one test case ID is required for unarchiving.');
+        }
+        const url = `${this.privateApiBaseUrl}/testcase/bulk/unarchive`;
+        const headers = {
+            'Content-Type': 'application/json',
+            accept: 'application/json',
+            authorization: `JWT ${contextJwt}`,
+            'jira-project-id': String(request.projectId),
+        };
+        // Body is an array of test case IDs
+        const body = JSON.stringify(request.testCaseIds);
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers,
+                body,
+            });
+            if (!response.ok) {
+                if (response.status === 400) {
+                    throw new BadRequestError(`Invalid request parameters for unarchiving test cases.`);
+                }
+                if (response.status === 401) {
+                    throw new UnauthorizedError('Failed to authenticate. Please check your credentials.');
+                }
+                if (response.status === 403) {
+                    throw new ForbiddenError('Insufficient permissions to unarchive test cases.');
+                }
+                throw new ServerError(`Failed to unarchive test cases. Status: ${response.status}`, response.status, response.statusText);
+            }
+            // Response is empty on success
+        }
+        catch (error) {
+            if (error instanceof BadRequestError ||
+                error instanceof UnauthorizedError ||
+                error instanceof ForbiddenError ||
+                error instanceof NotFoundError ||
+                error instanceof ServerError ||
+                error instanceof UnexpectedError) {
+                throw error;
+            }
+            throw new UnexpectedError(`Unexpected error while unarchiving test cases for project ${request.projectId}`, error);
+        }
+    }
+}

package/dist/groups/Private.d.ts

@@ -9,6 +9,8 @@ import { PrivateVersions } from './Private/PrivateVersions';
 import { PrivateAttachments } from './Private/PrivateAttachments';
 import { PrivateAuthentication } from './Private/PrivateAuthentication';
 import { PrivateVersionControl } from './Private/PrivateVersionControl';
+import { PrivateExtendedData } from './Private/PrivateExtendedData';
+import { PrivateTestCaseArchiving } from './Private/PrivateTestCaseArchiving';
 /**
  * Private API group for accessing Zephyr's private/unofficial endpoints
  *
@@ -40,6 +42,16 @@ export declare class PrivateGroup extends PrivateBase {
      * Version Control sub-group - Get version-specific data (links, test script, test steps)
      */
     readonly VersionControl: PrivateVersionControl;
+    /**
+     * Extended Data sub-group - Get and set extended data (iterations, versions) for Test Cycles and Test Executions
+     * Supplements public API with extended data not available in public endpoints
+     */
+    readonly ExtendedData: PrivateExtendedData;
+    /**
+     * Test Case Archiving sub-group - List, archive, and unarchive test cases
+     * Provides access to archived test cases and archiving operations not available in public API
+     */
+    readonly TestCaseArchiving: PrivateTestCaseArchiving;
     constructor(apiConnection?: ZephyrApiConnection);
 }
 //# sourceMappingURL=Private.d.ts.map

package/dist/groups/Private.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Private.d.ts","sourceRoot":"","sources":["../../groups/Private.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyDH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AASxE;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC5C;;OAEG;IACH,SAAgB,cAAc,EAAE,qBAAqB,CAAC;IAEtD;;OAEG;IACH,SAAgB,QAAQ,EAAE,eAAe,CAAC;IAE1C;;OAEG;IACH,SAAgB,MAAM,EAAE,aAAa,CAAC;IAEtC;;OAEG;IACH,SAAgB,QAAQ,EAAE,eAAe,CAAC;IAE1C;;OAEG;IACH,SAAgB,WAAW,EAAE,kBAAkB,CAAC;IAEhD;;OAEG;IACH,SAAgB,cAAc,EAAE,qBAAqB,CAAC;gBAE1C,aAAa,CAAC,EAAE,mBAAmB;CAU/C"}
+{"version":3,"file":"Private.d.ts","sourceRoot":"","sources":["../../groups/Private.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyDH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAS9E;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC5C;;OAEG;IACH,SAAgB,cAAc,EAAE,qBAAqB,CAAC;IAEtD;;OAEG;IACH,SAAgB,QAAQ,EAAE,eAAe,CAAC;IAE1C;;OAEG;IACH,SAAgB,MAAM,EAAE,aAAa,CAAC;IAEtC;;OAEG;IACH,SAAgB,QAAQ,EAAE,eAAe,CAAC;IAE1C;;OAEG;IACH,SAAgB,WAAW,EAAE,kBAAkB,CAAC;IAEhD;;OAEG;IACH,SAAgB,cAAc,EAAE,qBAAqB,CAAC;IAEtD;;;OAGG;IACH,SAAgB,YAAY,EAAE,mBAAmB,CAAC;IAElD;;;OAGG;IACH,SAAgB,iBAAiB,EAAE,wBAAwB,CAAC;gBAEhD,aAAa,CAAC,EAAE,mBAAmB;CAY/C"}

package/dist/groups/Private.js

@@ -8,6 +8,8 @@ import { PrivateVersions } from './Private/PrivateVersions';
 import { PrivateAttachments } from './Private/PrivateAttachments';
 import { PrivateAuthentication } from './Private/PrivateAuthentication';
 import { PrivateVersionControl } from './Private/PrivateVersionControl';
+import { PrivateExtendedData } from './Private/PrivateExtendedData';
+import { PrivateTestCaseArchiving } from './Private/PrivateTestCaseArchiving';
 /**
  * Private API group for accessing Zephyr's private/unofficial endpoints
  *
@@ -23,5 +25,7 @@ export class PrivateGroup extends PrivateBase {
         this.Versions = new PrivateVersions(apiConnection);
         this.Attachments = new PrivateAttachments(apiConnection);
         this.VersionControl = new PrivateVersionControl(apiConnection);
+        this.ExtendedData = new PrivateExtendedData(apiConnection);
+        this.TestCaseArchiving = new PrivateTestCaseArchiving(apiConnection);
     }
 }

package/dist/groups/TestExecution.d.ts

@@ -68,6 +68,8 @@ export declare class TestExecutionGroup {
      * Creates a new test execution for a test case within a test cycle. Required fields include projectKey, testCaseKey, testCycleKey, and statusName.
      * Optional fields include environmentName, actualEndDate, executionTime, executedById, assignedToId, comment, and customFields.
      *
+     * Note: This API returns an empty response. To get the created test execution details, use listTestExecutions() or getTestExecution().
+     *
      * @param request - Create test execution request
      * @param request.body - Test execution data
      * @param request.body.projectKey - Jira project key (required)
@@ -81,11 +83,11 @@ export declare class TestExecutionGroup {
      * @param request.body.assignedToId - Account ID of user assigned to the test (optional)
      * @param request.body.comment - Comment added against overall test case execution (optional)
      * @param request.body.customFields - Custom field values (optional)
-     * @returns Created test execution with id and self link
+     * @returns Promise that resolves when creation is complete
      *
      * @see {@link https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Executions/operation/createTestExecution Official API Documentation}
      */
-    createTestExecution(request: CreateTestExecutionRequest): Promise<CreatedResource>;
+    createTestExecution(request: CreateTestExecutionRequest): Promise<void>;
     /**
      * Update a test execution
      *

package/dist/groups/TestExecution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TestExecution.d.ts","sourceRoot":"","sources":["../../groups/TestExecution.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AAEH,OAAO,KAAK,EACX,aAAa,EACb,iBAAiB,EACjB,4BAA4B,EAC5B,yBAAyB,EACzB,gCAAgC,EAChC,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,EAC1B,gCAAgC,EAChC,gCAAgC,EAChC,8BAA8B,EAC9B,mCAAmC,EACnC,qBAAqB,EACrB,0BAA0B,EAC1B,IAAI,EACJ,eAAe,EACf,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,qBAAa,kBAAkB;IAClB,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,mBAAmB;IAE5C;;;;;;;;;;;;;;;;;;OAkBG;IACG,kBAAkB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAMzF;;;;;;;;;;;;;;;;;OAiBG;IACG,yBAAyB,CAAC,OAAO,CAAC,EAAE,gCAAgC,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAMlH;;;;;;;;;;;OAWG;IACG,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC;IAUhF;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,eAAe,CAAC;IASxF;;;;;;;;;;;;;;;;;;OAkBG;IACG,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7E;;;;;;;;;;;;;OAaG;IACG,yBAAyB,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAY/G;;;;;;;;;;;;;OAaG;IACG,yBAAyB,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzF;;;;;;;;;;;OAWG;IACG,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrF;;;;;;;;;OASG;IACG,sBAAsB,CAAC,oBAAoB,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAKnG;;;;;;;;;;;;;OAaG;IACG,4BAA4B,CAAC,OAAO,EAAE,mCAAmC,GAAG,OAAO,CAAC,eAAe,CAAC;CAQ1G"}
+{"version":3,"file":"TestExecution.d.ts","sourceRoot":"","sources":["../../groups/TestExecution.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AAEH,OAAO,KAAK,EACX,aAAa,EACb,iBAAiB,EACjB,4BAA4B,EAC5B,yBAAyB,EACzB,gCAAgC,EAChC,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,EAC1B,gCAAgC,EAChC,gCAAgC,EAChC,8BAA8B,EAC9B,mCAAmC,EACnC,qBAAqB,EACrB,0BAA0B,EAC1B,IAAI,EACJ,eAAe,EACf,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,qBAAa,kBAAkB;IAClB,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,mBAAmB;IAE5C;;;;;;;;;;;;;;;;;;OAkBG;IACG,kBAAkB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAMzF;;;;;;;;;;;;;;;;;OAiBG;IACG,yBAAyB,CAAC,OAAO,CAAC,EAAE,gCAAgC,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAMlH;;;;;;;;;;;OAWG;IACG,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC;IAUhF;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7E;;;;;;;;;;;;;;;;;;OAkBG;IACG,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7E;;;;;;;;;;;;;OAaG;IACG,yBAAyB,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAY/G;;;;;;;;;;;;;OAaG;IACG,yBAAyB,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzF;;;;;;;;;;;OAWG;IACG,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrF;;;;;;;;;OASG;IACG,sBAAsB,CAAC,oBAAoB,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAKnG;;;;;;;;;;;;;OAaG;IACG,4BAA4B,CAAC,OAAO,EAAE,mCAAmC,GAAG,OAAO,CAAC,eAAe,CAAC;CAQ1G"}

package/dist/groups/TestExecution.js

@@ -80,6 +80,8 @@ export class TestExecutionGroup {
      * Creates a new test execution for a test case within a test cycle. Required fields include projectKey, testCaseKey, testCycleKey, and statusName.
      * Optional fields include environmentName, actualEndDate, executionTime, executedById, assignedToId, comment, and customFields.
      *
+     * Note: This API returns an empty response. To get the created test execution details, use listTestExecutions() or getTestExecution().
+     *
      * @param request - Create test execution request
      * @param request.body - Test execution data
      * @param request.body.projectKey - Jira project key (required)
@@ -93,7 +95,7 @@ export class TestExecutionGroup {
      * @param request.body.assignedToId - Account ID of user assigned to the test (optional)
      * @param request.body.comment - Comment added against overall test case execution (optional)
      * @param request.body.customFields - Custom field values (optional)
-     * @returns Created test execution with id and self link
+     * @returns Promise that resolves when creation is complete
      *
      * @see {@link https://support.smartbear.com/zephyr-scale-cloud/api-docs/#tag/Test-Executions/operation/createTestExecution Official API Documentation}
      */
@@ -103,7 +105,9 @@ export class TestExecutionGroup {
             headers: { 'Content-Type': 'application/json' },
             body: buildRequestBody(request.body),
         });
-        return parseResponse(response);
+        if (!response.ok) {
+            await parseResponse(response);
+        }
     }
     /**
      * Update a test execution

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rbaileysr/zephyr-managed-api",
-  "version": "1.3.6",
+  "version": "1.3.8",
   "description": "Managed API wrapper for Zephyr Cloud REST API v2 - Comprehensive type-safe access to all Zephyr API endpoints for ScriptRunner Connect",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -43,4 +43,3 @@
     "README.md"
   ]
 }
-

package/dist/types.d.ts

@@ -1967,17 +1967,17 @@ export interface GetDataSetsRequest {
 /**
  * Config type for archive/unarchive operations
  */
-export type ConfigType = 'Environment' | 'Iteration';
+export type ConfigType = 'Environment' | 'Iteration' | 'TestCaseStatus' | 'TestPlanStatus' | 'TestCycleStatus' | 'TestExecutionStatus';
 /**
  * Archive config request for private API
  */
 export interface ArchiveConfigRequest {
     /**
-     * Type of config item: 'Environment' or 'Iteration'
+     * Type of config item: 'Environment', 'Iteration', 'TestCaseStatus', 'TestPlanStatus', 'TestCycleStatus', or 'TestExecutionStatus'
      */
     type: ConfigType;
     /**
-     * Numeric ID of the environment or iteration to archive
+     * Numeric ID of the config item to archive/unarchive
      */
     id: number;
     /**
@@ -2078,4 +2078,264 @@ export interface TestExecutionStepIssueLink {
  * Test execution step issue link list
  */
 export type TestExecutionStepIssueLinkList = TestExecutionStepIssueLink[];
+/**
+ * Get test cycle iteration request for private API
+ * Supplements public getTestCycle() with iteration data
+ */
+export interface GetTestCycleIterationRequest {
+    /**
+     * Test cycle key (e.g., "M12-R1")
+     */
+    testCycleKey: string;
+    /**
+     * Jira project ID (numeric, not the project key)
+     */
+    projectId: number;
+}
+/**
+ * Test cycle iteration response from private API
+ */
+export interface TestCycleIterationResponse {
+    /**
+     * Numeric ID of the test cycle
+     */
+    id: number;
+    /**
+     * Test cycle key (e.g., "M12-R1")
+     */
+    key: string;
+    /**
+     * Iteration ID if set, null if not set
+     */
+    iterationId: number | null;
+}
+/**
+ * Update test cycle iteration request for private API
+ * Supplements public updateTestCycle() with iteration data
+ */
+export interface UpdateTestCycleIterationRequest {
+    /**
+     * Test cycle key (e.g., "M12-R1")
+     */
+    testCycleKey: string;
+    /**
+     * Jira project ID (numeric, not the project key)
+     */
+    projectId: number;
+    /**
+     * Iteration ID to set, or null to clear the iteration
+     */
+    iterationId: number | null;
+}
+/**
+ * Get test execution iteration request for private API
+ * Supplements public getTestExecution() with iteration data
+ */
+export interface GetTestExecutionIterationRequest {
+    /**
+     * Test execution key (e.g., "M12-E1")
+     */
+    testExecutionKey: string;
+    /**
+     * Jira project ID (numeric, not the project key)
+     */
+    projectId: number;
+}
+/**
+ * Test execution iteration response from private API
+ */
+export interface TestExecutionIterationResponse {
+    /**
+     * Numeric ID of the test execution
+     */
+    id: number;
+    /**
+     * Test execution key (e.g., "M12-E1")
+     */
+    key: string;
+    /**
+     * Iteration ID if set, null if not set
+     */
+    iterationId: number | null;
+}
+/**
+ * Update test execution iteration request for private API
+ * Supplements public updateTestExecution() with iteration data
+ */
+export interface UpdateTestExecutionIterationRequest {
+    /**
+     * Test execution key (e.g., "M12-E1")
+     */
+    testExecutionKey: string;
+    /**
+     * Jira project ID (numeric, not the project key)
+     */
+    projectId: number;
+    /**
+     * Iteration ID to set, or null to clear the iteration
+     */
+    iterationId: number | null;
+}
+/**
+ * Get test execution version request for private API
+ * Supplements public getTestExecution() with version data
+ */
+export interface GetTestExecutionVersionRequest {
+    /**
+     * Test execution key (e.g., "M12-E1")
+     */
+    testExecutionKey: string;
+    /**
+     * Jira project ID (numeric, not the project key)
+     */
+    projectId: number;
+}
+/**
+ * Test execution version response from private API
+ */
+export interface TestExecutionVersionResponse {
+    /**
+     * Numeric ID of the test execution
+     */
+    id: number;
+    /**
+     * Test execution key (e.g., "M12-E1")
+     */
+    key: string;
+    /**
+     * Jira version ID (release version) if set, null if not set
+     */
+    jiraVersionId: number | null;
+}
+/**
+ * Update test execution version request for private API
+ * Supplements public updateTestExecution() with version data
+ */
+export interface UpdateTestExecutionVersionRequest {
+    /**
+     * Test execution key (e.g., "M12-E1")
+     */
+    testExecutionKey: string;
+    /**
+     * Jira project ID (numeric, not the project key)
+     */
+    projectId: number;
+    /**
+     * Jira version ID to set, or null to clear the version
+     */
+    jiraVersionId: number | null;
+}
+/**
+ * Private API archived test case status
+ */
+export interface PrivateArchivedTestCaseStatus {
+    id: number;
+    name: string;
+    color: string;
+}
+/**
+ * Private API archived test case priority
+ */
+export interface PrivateArchivedTestCasePriority {
+    id: number;
+    name: string;
+    color: string;
+}
+/**
+ * Private API archived test case last test result status
+ */
+export interface PrivateArchivedTestCaseLastTestResultStatus {
+    name: string;
+    color: string;
+}
+/**
+ * Private API archived test case custom field value
+ */
+export interface PrivateArchivedTestCaseCustomFieldValue {
+    customFieldId: number;
+    stringValue?: string;
+    intValue?: number;
+    decimalValue?: number;
+    booleanValue?: boolean;
+    dateValue?: string;
+}
+/**
+ * Private API archived test case (from search endpoint)
+ */
+export interface PrivateArchivedTestCase {
+    id: number;
+    key: string;
+    projectId: number;
+    name: string;
+    majorVersion: number;
+    owner?: string;
+    componentId?: string;
+    estimatedTime?: number;
+    createdBy: string;
+    createdOn: string;
+    updatedOn?: string;
+    updatedBy?: string;
+    status?: PrivateArchivedTestCaseStatus;
+    priority?: PrivateArchivedTestCasePriority;
+    labels?: string[];
+    lastTestResultStatus?: PrivateArchivedTestCaseLastTestResultStatus;
+    customFieldValues?: PrivateArchivedTestCaseCustomFieldValue[];
+}
+/**
+ * Private API archived test case search response
+ */
+export interface PrivateArchivedTestCaseSearchResponse {
+    maxResults: number;
+    startAt: number;
+    total: number;
+    results: PrivateArchivedTestCase[];
+}
+/**
+ * Get archived test cases request for private API
+ */
+export interface GetArchivedTestCasesRequest {
+    /**
+     * Jira project ID (numeric, not the project key)
+     */
+    projectId: number;
+    /**
+     * Maximum number of results to return (default: 50)
+     */
+    maxResults?: number;
+    /**
+     * Zero-indexed starting position (default: 0)
+     */
+    startAt?: number;
+    /**
+     * Optional query string for filtering (e.g., "testCase.name CONTAINS 'test'")
+     * If not provided, defaults to ordering by name ASC
+     */
+    query?: string;
+}
+/**
+ * Archive test cases request for private API
+ */
+export interface ArchiveTestCasesRequest {
+    /**
+     * Jira project ID (numeric, not the project key)
+     */
+    projectId: number;
+    /**
+     * Array of test case IDs to archive
+     */
+    testCaseIds: number[];
+}
+/**
+ * Unarchive test cases request for private API
+ */
+export interface UnarchiveTestCasesRequest {
+    /**
+     * Jira project ID (numeric, not the project key)
+     */
+    projectId: number;
+    /**
+     * Array of test case IDs to unarchive
+     */
+    testCaseIds: number[];
+}
 //# sourceMappingURL=types.d.ts.map