@resolution/jira-api-client 0.1.0

package/src/openapi/platform/services/project-versions-service.ts

@@ -0,0 +1,1287 @@
+// DO NOT EDIT!
+// This file is generated by "api-typescript-generator".
+// To update this file run "yarn build:openapi".
+import { z } from "zod";
+
+import * as commonHttpClient from "../core/common-http-client";
+import { CommonHttpService } from "../core/common-http-service";
+import {
+  registerCommonValidationSchemas,
+  type Version,
+} from "../models/common";
+import {
+  type DeleteAndReplaceVersionBean,
+  type PageBeanVersion,
+  registerProjectVersionsValidationSchemas,
+  type VersionIssueCounts,
+  type VersionMoveBean,
+  type VersionRelatedWork,
+  type VersionUnresolvedIssuesCount,
+} from "../models/project-versions";
+import { validationSchemaStorage } from "../validation-schema-storage";
+/**
+ * This resource represents project versions. Use it to get, get lists of, create,
+ * update, move, merge, and delete project versions. This resource also provides
+ * counts of issues by version.
+ */
+export class ProjectVersionsService extends CommonHttpService {
+  /**
+   * Creates a related work for the given version. You can only create a generic
+   * link type of related works via this API. relatedWorkId will be auto-generated
+   * UUID, that does not need to be provided.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:** *Resolve issues:* and *Edit issues*
+   * [Managing project
+   * permissions](https://confluence.atlassian.com/adminjiraserver/managing-project-permissions-938847145.html)
+   * for the project that contains the version.
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: {
+   *   "category": "Design",
+   *   "relatedWorkId": "fabcdef6-7878-1234-beaf-43211234abcd",
+   *   "title": "Design link",
+   *   "url": "https://www.atlassian.com"
+   * }
+   * @path {POST} /rest/api/3/version/{id}/relatedwork
+   * @scopes-current write:jira-work
+   * @scopes-beta write:issue:jira
+   */
+  createRelatedWork({
+    id,
+    versionRelatedWork,
+  }: {
+    id: string;
+    /**
+     * @example {
+     *     "category": "Design",
+     *     "title": "Design link",
+     *     "url": "https://www.atlassian.com"
+     * }
+     */
+    versionRelatedWork: VersionRelatedWork;
+  }): Promise<VersionRelatedWork> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/version/{id}/relatedwork",
+        method: "POST",
+        pathParams: {
+          id,
+        },
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: versionRelatedWork,
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          201: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 201;
+          mediaType: "application/json";
+          body: VersionRelatedWork;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "ProjectVersionsService.createRelatedWork.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Creates a project version.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:** *Administer Jira* [global
+   * permission](https://confluence.atlassian.com/x/x4dKLg) or *Administer Projects*
+   * [project permission](https://confluence.atlassian.com/x/yodKLg) for the project
+   * the version is added to.
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: {
+   *   "archived": false,
+   *   "description": "An excellent version",
+   *   "id": "10000",
+   *   "name": "New Version 1",
+   *   "project": "PXA",
+   *   "projectId": 10000,
+   *   "releaseDate": "2010-07-06",
+   *   "released": true,
+   *   "self": "https://your-domain.atlassian.net/rest/api/3/version/10000",
+   *   "userReleaseDate": "6/Jul/2010"
+   * }
+   * @path {POST} /rest/api/3/version
+   * @scopes-current manage:jira-project
+   * @scopes-beta write:project-version:jira, read:project-version:jira
+   */
+  createVersion({
+    version,
+  }: {
+    /**
+     * @example {
+     *     "archived": false,
+     *     "description": "An excellent version",
+     *     "name": "New Version 1",
+     *     "projectId": 10000,
+     *     "releaseDate": "2010-07-06",
+     *     "released": true
+     * }
+     */
+    version: Version;
+  }): Promise<Version> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/version",
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: version,
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          201: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 201;
+          mediaType: "application/json";
+          body: Version;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "ProjectVersionsService.createVersion.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Deletes a project version.
+   *
+   * Alternative versions can be provided to update issues that use the deleted
+   * version in `fixVersion`, `affectedVersion`, or any version picker custom
+   * fields. If alternatives are not provided, occurrences of `fixVersion`,
+   * `affectedVersion`, and any version picker custom field, that contain the
+   * deleted version, are cleared. Any replacement version must be in the same
+   * project as the version being deleted and cannot be the version being deleted.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:** *Administer Jira* [global
+   * permission](https://confluence.atlassian.com/x/x4dKLg) or *Administer Projects*
+   * [project permission](https://confluence.atlassian.com/x/yodKLg) for the project
+   * that contains the version.
+   *
+   * @returns Returned if the version is deleted.
+   * @path {POST} /rest/api/3/version/{id}/removeAndSwap
+   * @scopes-current manage:jira-project
+   * @scopes-beta delete:project-version:jira, write:project-version:jira
+   */
+  deleteAndReplaceVersion({
+    id,
+    deleteAndReplaceVersionBean,
+  }: {
+    /** The ID of the version. */
+    id: string;
+    deleteAndReplaceVersionBean: DeleteAndReplaceVersionBean;
+  }): Promise<void> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/version/{id}/removeAndSwap",
+        method: "POST",
+        pathParams: {
+          id,
+        },
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: deleteAndReplaceVersionBean,
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          204: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 204;
+          mediaType: "application/json";
+          body: void;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "ProjectVersionsService.deleteAndReplaceVersion.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Deletes the given related work for the given version.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:** *Resolve issues:* and *Edit issues*
+   * [Managing project
+   * permissions](https://confluence.atlassian.com/adminjiraserver/managing-project-permissions-938847145.html)
+   * for the project that contains the version.
+   *
+   * @path {DELETE} /rest/api/3/version/{versionId}/relatedwork/{relatedWorkId}
+   * @scopes-current write:jira-work
+   * @scopes-beta write:issue:jira
+   */
+  deleteRelatedWork({
+    versionId,
+    relatedWorkId,
+  }: {
+    /** The ID of the version that the target related work belongs to. */
+    versionId: string;
+    /** The ID of the related work to delete. */
+    relatedWorkId: string;
+  }): Promise<void> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/version/{versionId}/relatedwork/{relatedWorkId}",
+        method: "DELETE",
+        pathParams: {
+          versionId,
+          relatedWorkId,
+        },
+      })
+      .then(commonHttpClient.discardResult);
+  }
+  /**
+   * Deletes a project version.
+   *
+   * Deprecated, use [ Delete and replace
+   * version](#api-rest-api-3-version-id-removeAndSwap-post) that supports swapping
+   * version values in custom fields, in addition to the swapping for `fixVersion`
+   * and `affectedVersion` provided in this resource.
+   *
+   * Alternative versions can be provided to update issues that use the deleted
+   * version in `fixVersion` or `affectedVersion`. If alternatives are not provided,
+   * occurrences of `fixVersion` and `affectedVersion` that contain the deleted
+   * version are cleared.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:** *Administer Jira* [global
+   * permission](https://confluence.atlassian.com/x/x4dKLg) or *Administer Projects*
+   * [project permission](https://confluence.atlassian.com/x/yodKLg) for the project
+   * that contains the version.
+   *
+   * @deprecated
+   * @path {DELETE} /rest/api/3/version/{id}
+   * @scopes-current manage:jira-project
+   * @scopes-beta delete:project-version:jira
+   */
+  deleteVersion({
+    id,
+    moveFixIssuesTo,
+    moveAffectedIssuesTo,
+  }: {
+    /** The ID of the version. */
+    id: string;
+    /**
+     * The ID of the version to update `fixVersion` to when the field contains the
+     * deleted version. The replacement version must be in the same project as the
+     * version being deleted and cannot be the version being deleted.
+     */
+    moveFixIssuesTo?: string;
+    /**
+     * The ID of the version to update `affectedVersion` to when the field contains
+     * the deleted version. The replacement version must be in the same project as the
+     * version being deleted and cannot be the version being deleted.
+     */
+    moveAffectedIssuesTo?: string;
+  }): Promise<void> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/version/{id}",
+        method: "DELETE",
+        pathParams: {
+          id,
+        },
+        query: {
+          moveFixIssuesTo,
+          moveAffectedIssuesTo,
+        },
+      })
+      .then(commonHttpClient.discardResult);
+  }
+  /**
+   * Returns all versions in a project. The response is not paginated. Use [Get
+   * project versions paginated](#api-rest-api-3-project-projectIdOrKey-version-get)
+   * if you want to get the versions in a project with pagination.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:** *Browse Projects* [project
+   * permission](https://confluence.atlassian.com/x/yodKLg) for the project.
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: [
+   *   {
+   *     "archived": false,
+   *     "description": "An excellent version",
+   *     "id": "10000",
+   *     "name": "New Version 1",
+   *     "overdue": true,
+   *     "projectId": 10000,
+   *     "releaseDate": 1278385482288,
+   *     "releaseDateSet": false,
+   *     "released": true,
+   *     "self": "https://your-domain.atlassian.net/rest/api/3/version/10000",
+   *     "startDateSet": false,
+   *     "userReleaseDate": "6/Jul/2010"
+   *   },
+   *   {
+   *     "archived": false,
+   *     "description": "Minor Bugfix version",
+   *     "id": "10010",
+   *     "issuesStatusForFixVersion": {
+   *       "done": 100,
+   *       "inProgress": 20,
+   *       "toDo": 10,
+   *       "unmapped": 0
+   *     },
+   *     "name": "Next Version",
+   *     "overdue": false,
+   *     "projectId": 10000,
+   *     "releaseDateSet": false,
+   *     "released": false,
+   *     "self": "https://your-domain.atlassian.net/rest/api/3/version/10010",
+   *     "startDateSet": false
+   *   }
+   * ]
+   * @path {GET} /rest/api/3/project/{projectIdOrKey}/versions
+   * @scopes-current read:jira-work
+   * @scopes-beta read:project-version:jira
+   */
+  getProjectVersions({
+    projectIdOrKey,
+    expand,
+  }: {
+    /** The project ID or project key (case sensitive). */
+    projectIdOrKey: string;
+    /**
+     * Use [expand](#expansion) to include additional information in the response.
+     * This parameter accepts `operations`, which returns actions that can be
+     * performed on the version.
+     */
+    expand?: string;
+  }): Promise<Version[]> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/project/{projectIdOrKey}/versions",
+        method: "GET",
+        pathParams: {
+          projectIdOrKey,
+        },
+        query: {
+          expand,
+        },
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: Version[];
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "ProjectVersionsService.getProjectVersions.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Returns a [paginated](#pagination) list of all versions in a project. See the
+   * [Get project versions](#api-rest-api-3-project-projectIdOrKey-versions-get)
+   * resource if you want to get a full list of versions without pagination.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:** *Browse Projects* [project
+   * permission](https://confluence.atlassian.com/x/yodKLg) for the project.
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: {
+   *   "isLast": false,
+   *   "maxResults": 2,
+   *   "nextPage":
+   * "https://your-domain.atlassian.net/rest/api/3/project/PR/version?startAt=2&maxResults=2",
+   *   "self":
+   * "https://your-domain.atlassian.net/rest/api/3/project/PR/version?startAt=0&maxResults=2",
+   *   "startAt": 0,
+   *   "total": 7,
+   *   "values": [
+   *     {
+   *       "archived": false,
+   *       "description": "An excellent version",
+   *       "id": "10000",
+   *       "name": "New Version 1",
+   *       "overdue": true,
+   *       "projectId": 10000,
+   *       "releaseDate": "2010-07-06",
+   *       "released": true,
+   *       "self": "https://your-domain.atlassian.net/rest/api/3/version/10000",
+   *       "userReleaseDate": "6/Jul/2010"
+   *     },
+   *     {
+   *       "archived": false,
+   *       "description": "Minor Bugfix version",
+   *       "id": "10010",
+   *       "issuesStatusForFixVersion": {
+   *         "done": 100,
+   *         "inProgress": 20,
+   *         "toDo": 10,
+   *         "unmapped": 0
+   *       },
+   *       "name": "Next Version",
+   *       "overdue": false,
+   *       "projectId": 10000,
+   *       "released": false,
+   *       "self": "https://your-domain.atlassian.net/rest/api/3/version/10010"
+   *     }
+   *   ]
+   * }
+   * @path {GET} /rest/api/3/project/{projectIdOrKey}/version
+   * @scopes-current read:jira-work
+   * @scopes-beta read:project-version:jira
+   */
+  getProjectVersionsPaginated({
+    projectIdOrKey,
+    startAt,
+    maxResults,
+    orderBy,
+    query,
+    status,
+    expand,
+  }: {
+    /** The project ID or project key (case sensitive). */
+    projectIdOrKey: string;
+    /** The index of the first item to return in a page of results (page offset). */
+    startAt?: number;
+    /** The maximum number of items to return per page. */
+    maxResults?: number;
+    /**
+     * [Order](#ordering) the results by a field:
+     *
+     *  *  `description` Sorts by version description.
+     *  *  `name` Sorts by version name.
+     *  *  `releaseDate` Sorts by release date, starting with the oldest date.
+     * Versions with no release date are listed last.
+     *  *  `sequence` Sorts by the order of appearance in the user interface.
+     *  *  `startDate` Sorts by start date, starting with the oldest date. Versions
+     * with no start date are listed last.
+     */
+    orderBy?:
+      | "description"
+      | "-description"
+      | "+description"
+      | "name"
+      | "-name"
+      | "+name"
+      | "releaseDate"
+      | "-releaseDate"
+      | "+releaseDate"
+      | "sequence"
+      | "-sequence"
+      | "+sequence"
+      | "startDate"
+      | "-startDate"
+      | "+startDate";
+    /**
+     * Filter the results using a literal string. Versions with matching `name` or
+     * `description` are returned (case insensitive).
+     */
+    query?: string;
+    /**
+     * A list of status values used to filter the results by version status. This
+     * parameter accepts a comma-separated list. The status values are `released`,
+     * `unreleased`, and `archived`.
+     */
+    status?: string;
+    /**
+     * Use [expand](#expansion) to include additional information in the response.
+     * This parameter accepts a comma-separated list. Expand options include:
+     *
+     *  *  `issuesstatus` Returns the number of issues in each status category for
+     * each version.
+     *  *  `operations` Returns actions that can be performed on the specified version.
+     *  *  `driver` Returns the Atlassian account ID of the version driver.
+     *  *  `approvers` Returns a list containing the approvers for this version.
+     */
+    expand?: string;
+  }): Promise<PageBeanVersion> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/project/{projectIdOrKey}/version",
+        method: "GET",
+        pathParams: {
+          projectIdOrKey,
+        },
+        query: {
+          startAt,
+          maxResults,
+          orderBy,
+          query,
+          status,
+          expand,
+        },
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: PageBeanVersion;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "ProjectVersionsService.getProjectVersionsPaginated.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Returns related work items for the given version id.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:** *Browse projects* [project
+   * permission](https://confluence.atlassian.com/x/yodKLg) for the project
+   * containing the version.
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: [
+   *   {
+   *     "category": "Design",
+   *     "issueId": 10001,
+   *     "relatedWorkId": "fabcdef6-7878-1234-beaf-43211234abcd",
+   *     "title": "Design link",
+   *     "url": "https://www.atlassian.com"
+   *   },
+   *   {
+   *     "category": "Communications",
+   *     "relatedWorkId": "fabcdef6-7878-1234-beaf-43211234abce",
+   *     "title": "Chat application",
+   *     "url": "https://www.atlassian.com"
+   *   },
+   *   {
+   *     "category": "External Link",
+   *     "issueId": 10003,
+   *     "relatedWorkId": "fabcdef6-7878-1234-beaf-43211234abcf",
+   *     "url": "https://www.atlassian.com"
+   *   }
+   * ]
+   * @path {GET} /rest/api/3/version/{id}/relatedwork
+   * @scopes-current read:jira-work
+   * @scopes-beta read:project-version:jira
+   */
+  getRelatedWork({
+    id,
+  }: {
+    /** The ID of the version. */
+    id: string;
+  }): Promise<VersionRelatedWork[]> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/version/{id}/relatedwork",
+        method: "GET",
+        pathParams: {
+          id,
+        },
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: VersionRelatedWork[];
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "ProjectVersionsService.getRelatedWork.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Returns a project version.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:** *Browse projects* [project
+   * permission](https://confluence.atlassian.com/x/yodKLg) for the project
+   * containing the version.
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: {
+   *   "archived": false,
+   *   "description": "An excellent version",
+   *   "id": "10000",
+   *   "name": "New Version 1",
+   *   "overdue": true,
+   *   "projectId": 10000,
+   *   "releaseDate": "2010-07-06",
+   *   "released": true,
+   *   "self": "https://your-domain.atlassian.net/rest/api/3/version/10000",
+   *   "userReleaseDate": "6/Jul/2010"
+   * }
+   * @path {GET} /rest/api/3/version/{id}
+   * @scopes-current read:jira-work
+   * @scopes-beta read:project-version:jira
+   */
+  getVersion({
+    id,
+    expand,
+  }: {
+    /** The ID of the version. */
+    id: string;
+    /**
+     * Use [expand](#expansion) to include additional information about version in the
+     * response. This parameter accepts a comma-separated list. Expand options include:
+     *
+     *  *  `operations` Returns the list of operations available for this version.
+     *  *  `issuesstatus` Returns the count of issues in this version for each of the
+     * status categories *to do*, *in progress*, *done*, and *unmapped*. The
+     * *unmapped* property represents the number of issues with a status other than
+     * *to do*, *in progress*, and *done*.
+     *  *  `driver` Returns the Atlassian account ID of the version driver.
+     *  *  `approvers` Returns a list containing the Atlassian account IDs of
+     * approvers for this version.
+     */
+    expand?: string;
+  }): Promise<Version> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/version/{id}",
+        method: "GET",
+        pathParams: {
+          id,
+        },
+        query: {
+          expand,
+        },
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: Version;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "ProjectVersionsService.getVersion.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Returns the following counts for a version:
+   *
+   *  *  Number of issues where the `fixVersion` is set to the version.
+   *  *  Number of issues where the `affectedVersion` is set to the version.
+   *  *  Number of issues where a version custom field is set to the version.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:** *Browse projects* project permission
+   * for the project that contains the version.
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: {
+   *   "customFieldUsage": [
+   *     {
+   *       "customFieldId": 10000,
+   *       "fieldName": "Field1",
+   *       "issueCountWithVersionInCustomField": 2
+   *     },
+   *     {
+   *       "customFieldId": 10010,
+   *       "fieldName": "Field2",
+   *       "issueCountWithVersionInCustomField": 3
+   *     }
+   *   ],
+   *   "issueCountWithCustomFieldsShowingVersion": 54,
+   *   "issuesAffectedCount": 101,
+   *   "issuesFixedCount": 23,
+   *   "self": "https://your-domain.atlassian.net/rest/api/3/version/10000"
+   * }
+   * @path {GET} /rest/api/3/version/{id}/relatedIssueCounts
+   * @scopes-current read:jira-work
+   * @scopes-beta read:field:jira, read:project-version:jira
+   */
+  getVersionRelatedIssues({
+    id,
+  }: {
+    /** The ID of the version. */
+    id: string;
+  }): Promise<VersionIssueCounts> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/version/{id}/relatedIssueCounts",
+        method: "GET",
+        pathParams: {
+          id,
+        },
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: VersionIssueCounts;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "ProjectVersionsService.getVersionRelatedIssues.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Returns counts of the issues and unresolved issues for the project version.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:** *Browse projects* project permission
+   * for the project that contains the version.
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: {
+   *   "issuesCount": 30,
+   *   "issuesUnresolvedCount": 23,
+   *   "self": "https://your-domain.atlassian.net/rest/api/3/version/10000"
+   * }
+   * @path {GET} /rest/api/3/version/{id}/unresolvedIssueCount
+   * @scopes-current read:jira-work
+   * @scopes-beta read:project-version:jira
+   */
+  getVersionUnresolvedIssues({
+    id,
+  }: {
+    /** The ID of the version. */
+    id: string;
+  }): Promise<VersionUnresolvedIssuesCount> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/version/{id}/unresolvedIssueCount",
+        method: "GET",
+        pathParams: {
+          id,
+        },
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: VersionUnresolvedIssuesCount;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "ProjectVersionsService.getVersionUnresolvedIssues.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Merges two project versions. The merge is completed by deleting the version
+   * specified in `id` and replacing any occurrences of its ID in `fixVersion` with
+   * the version ID specified in `moveIssuesTo`.
+   *
+   * Consider using [ Delete and replace
+   * version](#api-rest-api-3-version-id-removeAndSwap-post) instead. This resource
+   * supports swapping version values in `fixVersion`, `affectedVersion`, and custom
+   * fields.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:** *Administer Jira* [global
+   * permission](https://confluence.atlassian.com/x/x4dKLg) or *Administer Projects*
+   * [project permission](https://confluence.atlassian.com/x/yodKLg) for the project
+   * that contains the version.
+   *
+   * @returns Returned if the version is deleted.
+   * @path {PUT} /rest/api/3/version/{id}/mergeto/{moveIssuesTo}
+   * @scopes-current manage:jira-project
+   * @scopes-beta delete:project-version:jira, write:project-version:jira
+   */
+  mergeVersions({
+    id,
+    moveIssuesTo,
+  }: {
+    /** The ID of the version to delete. */
+    id: string;
+    /** The ID of the version to merge into. */
+    moveIssuesTo: string;
+  }): Promise<void> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/version/{id}/mergeto/{moveIssuesTo}",
+        method: "PUT",
+        pathParams: {
+          id,
+          moveIssuesTo,
+        },
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          204: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 204;
+          mediaType: "application/json";
+          body: void;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "ProjectVersionsService.mergeVersions.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Modifies the version's sequence within the project, which affects the display
+   * order of the versions in Jira.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:** *Browse projects* project permission
+   * for the project that contains the version.
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: {
+   *   "archived": false,
+   *   "description": "An excellent version",
+   *   "id": "10000",
+   *   "name": "New Version 1",
+   *   "overdue": true,
+   *   "projectId": 10000,
+   *   "releaseDate": "2010-07-06",
+   *   "released": true,
+   *   "self": "https://your-domain.atlassian.net/rest/api/3/version/10000",
+   *   "userReleaseDate": "6/Jul/2010"
+   * }
+   * @path {POST} /rest/api/3/version/{id}/move
+   * @scopes-current manage:jira-project
+   * @scopes-beta write:project-version:jira, read:project-version:jira
+   */
+  moveVersion({
+    id,
+    versionMoveBean,
+  }: {
+    /** The ID of the version to be moved. */
+    id: string;
+    /**
+     * @example {
+     *     "after": "https://your-domain.atlassian.net/rest/api/~ver~/version/10000"
+     * }
+     */
+    versionMoveBean: VersionMoveBean;
+  }): Promise<Version> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/version/{id}/move",
+        method: "POST",
+        pathParams: {
+          id,
+        },
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: versionMoveBean,
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: Version;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "ProjectVersionsService.moveVersion.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Updates the given related work. You can only update generic link related works
+   * via Rest APIs. Any archived version related works can't be edited.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:** *Resolve issues:* and *Edit issues*
+   * [Managing project
+   * permissions](https://confluence.atlassian.com/adminjiraserver/managing-project-permissions-938847145.html)
+   * for the project that contains the version.
+   *
+   * @returns Returned if the request is successful together with updated related work.
+   *
+   * example: {
+   *   "category": "Design",
+   *   "relatedWorkId": "fabcdef6-7878-1234-beaf-43211234abcd",
+   *   "title": "Design link",
+   *   "url": "https://www.atlassian.com"
+   * }
+   * @path {PUT} /rest/api/3/version/{id}/relatedwork
+   * @scopes-current write:jira-work
+   * @scopes-beta write:issue:jira
+   */
+  updateRelatedWork({
+    id,
+    versionRelatedWork,
+  }: {
+    /**
+     * The ID of the version to update the related work on. For the related work id,
+     * pass it to the input JSON.
+     */
+    id: string;
+    /**
+     * @example {
+     *     "category": "Design",
+     *     "relatedWorkId": "fabcdef6-7878-1234-beaf-43211234abcd",
+     *     "title": "Design link",
+     *     "url": "https://www.atlassian.com"
+     * }
+     */
+    versionRelatedWork: VersionRelatedWork;
+  }): Promise<VersionRelatedWork> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/version/{id}/relatedwork",
+        method: "PUT",
+        pathParams: {
+          id,
+        },
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: versionRelatedWork,
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: VersionRelatedWork;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "ProjectVersionsService.updateRelatedWork.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Updates a project version.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:** *Administer Jira* [global
+   * permission](https://confluence.atlassian.com/x/x4dKLg) or *Administer Projects*
+   * [project permission](https://confluence.atlassian.com/x/yodKLg) for the project
+   * that contains the version.
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: {
+   *   "archived": false,
+   *   "description": "An excellent version",
+   *   "id": "10000",
+   *   "name": "New Version 1",
+   *   "project": "PXA",
+   *   "projectId": 10000,
+   *   "releaseDate": "2010-07-06",
+   *   "released": true,
+   *   "self": "https://your-domain.atlassian.net/rest/api/3/version/10000",
+   *   "userReleaseDate": "6/Jul/2010"
+   * }
+   * @path {PUT} /rest/api/3/version/{id}
+   * @scopes-current manage:jira-project
+   * @scopes-beta write:project-version:jira, read:project-version:jira
+   */
+  updateVersion({
+    id,
+    version,
+  }: {
+    /** The ID of the version. */
+    id: string;
+    /**
+     * @example {
+     *     "archived": false,
+     *     "description": "An excellent version",
+     *     "id": "10000",
+     *     "name": "New Version 1",
+     *     "overdue": true,
+     *     "projectId": 10000,
+     *     "releaseDate": "2010-07-06",
+     *     "released": true,
+     *     "self": "https://your-domain.atlassian.net/rest/api/~ver~/version/10000",
+     *     "userReleaseDate": "6/Jul/2010"
+     * }
+     */
+    version: Version;
+  }): Promise<Version> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/version/{id}",
+        method: "PUT",
+        pathParams: {
+          id,
+        },
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: version,
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: Version;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "ProjectVersionsService.updateVersion.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  static initialize() {
+    validationSchemaStorage.registerExtensible(
+      "ProjectVersionsService.getProjectVersionsPaginated.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("PageBeanVersion"),
+        })
+        .describe(
+          "ProjectVersionsService.getProjectVersionsPaginated.response",
+        ),
+    );
+    validationSchemaStorage.registerExtensible(
+      "ProjectVersionsService.getProjectVersions.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: z.array(validationSchemaStorage.lazy("Version")),
+        })
+        .describe("ProjectVersionsService.getProjectVersions.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "ProjectVersionsService.createVersion.response",
+      z
+        .object({
+          status: z.literal(201),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("Version"),
+        })
+        .describe("ProjectVersionsService.createVersion.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "ProjectVersionsService.getVersion.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("Version"),
+        })
+        .describe("ProjectVersionsService.getVersion.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "ProjectVersionsService.updateVersion.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("Version"),
+        })
+        .describe("ProjectVersionsService.updateVersion.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "ProjectVersionsService.mergeVersions.response",
+      z
+        .object({
+          status: z.literal(204),
+          mediaType: z.literal("application/json"),
+          body: z.unknown(),
+        })
+        .describe("ProjectVersionsService.mergeVersions.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "ProjectVersionsService.moveVersion.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("Version"),
+        })
+        .describe("ProjectVersionsService.moveVersion.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "ProjectVersionsService.getVersionRelatedIssues.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("VersionIssueCounts"),
+        })
+        .describe("ProjectVersionsService.getVersionRelatedIssues.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "ProjectVersionsService.getRelatedWork.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: z.array(validationSchemaStorage.lazy("VersionRelatedWork")),
+        })
+        .describe("ProjectVersionsService.getRelatedWork.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "ProjectVersionsService.updateRelatedWork.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("VersionRelatedWork"),
+        })
+        .describe("ProjectVersionsService.updateRelatedWork.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "ProjectVersionsService.createRelatedWork.response",
+      z
+        .object({
+          status: z.literal(201),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("VersionRelatedWork"),
+        })
+        .describe("ProjectVersionsService.createRelatedWork.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "ProjectVersionsService.deleteAndReplaceVersion.response",
+      z
+        .object({
+          status: z.literal(204),
+          mediaType: z.literal("application/json"),
+          body: z.unknown(),
+        })
+        .describe("ProjectVersionsService.deleteAndReplaceVersion.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "ProjectVersionsService.getVersionUnresolvedIssues.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("VersionUnresolvedIssuesCount"),
+        })
+        .describe("ProjectVersionsService.getVersionUnresolvedIssues.response"),
+    );
+    validationSchemaStorage.registerOnce([
+      registerProjectVersionsValidationSchemas,
+      registerCommonValidationSchemas,
+    ]);
+  }
+}