@resolution/jira-api-client 0.1.0

package/src/openapi/platform/services/issues-service.ts

@@ -0,0 +1,3346 @@
+// 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 {
+  type IssueBean,
+  registerCommonValidationSchemas,
+  type User,
+} from "../models/common";
+import {
+  type ArchivedIssuesFilterRequest,
+  type ArchiveIssueAsyncRequest,
+  type CreatedIssue,
+  type CreatedIssues,
+  type ExportArchivedIssuesTaskProgressResponse,
+  type IssueArchivalSyncRequest,
+  type IssueArchivalSyncResponse,
+  type IssueChangelogIds,
+  type IssueCreateMetadata,
+  type IssueEvent,
+  type IssueLimitReportRequest,
+  type IssueLimitReportResponseBean,
+  type IssuesUpdateBean,
+  type IssueUpdateDetails,
+  type IssueUpdateMetadata,
+  type Notification,
+  type PageBeanChangelog,
+  type PageOfChangelogs,
+  type PageOfCreateMetaIssueTypes,
+  type PageOfCreateMetaIssueTypeWithField,
+  registerIssuesValidationSchemas,
+  type Transitions,
+} from "../models/issues";
+import { validationSchemaStorage } from "../validation-schema-storage";
+/**
+ * This resource represents Jira issues. Use it to:
+ *
+ *  *  create or edit issues, individually or in bulk.
+ *  *  retrieve metadata about the options for creating or editing issues.
+ *  *  delete an issue.
+ *  *  assign a user to an issue.
+ *  *  get issue changelogs.
+ *  *  send notifications about an issue.
+ *  *  get details of the transitions available for an issue.
+ *  *  transition an issue.
+ *  *  Archive issues.
+ *  *  Unarchive issues.
+ *  *  Export archived issues.
+ */
+export class IssuesService extends CommonHttpService {
+  /**
+   * Enables admins to archive up to 1000 issues in a single request using issue
+   * ID/key, returning details of the issue(s) archived in the process and the
+   * errors encountered, if any.
+   *
+   * **Note that:**
+   *
+   *  *  you can't archive subtasks directly, only through their parent issues
+   *  *  you can only archive issues from software, service management, and business
+   * projects
+   *
+   * **[Permissions](#permissions) required:** Jira admin or site admin: [global
+   * permission](https://confluence.atlassian.com/x/x4dKLg)
+   *
+   * **License required:** Premium or Enterprise
+   *
+   * **Signed-in users only:** This API can't be accessed anonymously.
+   *
+   * @returns Returned if there is at least one valid issue to archive in the request. The
+   * return message will include the count of archived issues and subtasks, as well
+   * as error details for issues which failed to get archived.
+   *
+   * example: {
+   *   "errors": {
+   *     "issueIsSubtask": {
+   *       "count": 3,
+   *       "issueIdsOrKeys": [
+   *         "ST-1",
+   *         "ST-2",
+   *         "ST-3"
+   *       ],
+   *       "message": "Issue is subtask."
+   *     },
+   *     "issuesInArchivedProjects": {
+   *       "count": 2,
+   *       "issueIdsOrKeys": [
+   *         "AR-1",
+   *         "AR-2"
+   *       ],
+   *       "message": "Issue exists in archived project."
+   *     },
+   *     "issuesInUnlicensedProjects": {
+   *       "count": 3,
+   *       "issueIdsOrKeys": [
+   *         "UL-1",
+   *         "UL-2",
+   *         "UL-3"
+   *       ],
+   *       "message": "Issues with these IDs are in unlicensed projects."
+   *     },
+   *     "issuesNotFound": {
+   *       "count": 3,
+   *       "issueIdsOrKeys": [
+   *         "PR-1",
+   *         "PR-2",
+   *         "PR-3"
+   *       ],
+   *       "message": "Issue not found."
+   *     }
+   *   },
+   *   "numberOfIssuesUpdated": 10
+   * }
+   * @path {PUT} /rest/api/3/issue/archive
+   * @scopes-current write:jira-work
+   * @scopes-beta write:issue:jira
+   */
+  archiveIssues({
+    issueArchivalSyncRequest,
+  }: {
+    /**
+     * Contains a list of issue keys or IDs to be archived.
+     *
+     * @example {
+     *     "issueIdsOrKeys": [
+     *         "PR-1",
+     *         "1001",
+     *         "PROJECT-2"
+     *     ]
+     * }
+     */
+    issueArchivalSyncRequest: IssueArchivalSyncRequest;
+  }): Promise<IssueArchivalSyncResponse> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue/archive",
+        method: "PUT",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: issueArchivalSyncRequest,
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: IssueArchivalSyncResponse;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "IssuesService.archiveIssues.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Enables admins to archive up to 100,000 issues in a single request using JQL,
+   * returning the URL to check the status of the submitted request.
+   *
+   * You can use the [get
+   * task](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-tasks/#api-rest-api-3-task-taskid-get)
+   * and [cancel
+   * task](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-tasks/#api-rest-api-3-task-taskid-cancel-post)
+   * APIs to manage the request.
+   *
+   * **Note that:**
+   *
+   *  *  you can't archive subtasks directly, only through their parent issues
+   *  *  you can only archive issues from software, service management, and business
+   * projects
+   *
+   * **[Permissions](#permissions) required:** Jira admin or site admin: [global
+   * permission](https://confluence.atlassian.com/x/x4dKLg)
+   *
+   * **License required:** Premium or Enterprise
+   *
+   * **Signed-in users only:** This API can't be accessed anonymously.
+   *
+   * **Rate limiting:** Only a single request per jira instance can be active at any
+   * given time.
+   *
+   * @returns Returns the URL to check the status of the submitted request.
+   *
+   * example: "https://your-domain.atlassian.net/rest/api/3/task/1010"
+   * @path {POST} /rest/api/3/issue/archive
+   * @scopes-current write:jira-work
+   * @scopes-beta write:issue:jira
+   */
+  archiveIssuesAsync({
+    archiveIssueAsyncRequest,
+  }: {
+    /**
+     * A JQL query specifying the issues to archive. Note that subtasks can only be
+     * archived through their parent issues.
+     *
+     * @example {
+     *     "jql": "project = FOO AND updated < -2y"
+     * }
+     */
+    archiveIssueAsyncRequest: ArchiveIssueAsyncRequest;
+  }): Promise<string> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue/archive",
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: archiveIssueAsyncRequest,
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          202: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 202;
+          mediaType: "application/json";
+          body: string;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "IssuesService.archiveIssuesAsync.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Assigns an issue to a user. Use this operation when the calling user does not
+   * have the *Edit Issues* permission but has the *Assign issue* permission for the
+   * project that the issue is in.
+   *
+   * If `name` or `accountId` is set to:
+   *
+   *  *  `"-1"`, the issue is assigned to the default assignee for the project.
+   *  *  `null`, the issue is set to unassigned.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:**
+   *
+   *  *  *Browse Projects* and *Assign Issues* [ project
+   * permission](https://confluence.atlassian.com/x/yodKLg) for the project that the
+   * issue is in.
+   *  *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is
+   * configured, issue-level security permission to view the issue.
+   *
+   * @returns Returned if the request is successful.
+   * @path {PUT} /rest/api/3/issue/{issueIdOrKey}/assignee
+   * @scopes-current write:jira-work
+   * @scopes-beta write:issue:jira
+   */
+  assignIssue({
+    issueIdOrKey,
+    user,
+  }: {
+    /** The ID or key of the issue to be assigned. */
+    issueIdOrKey: string;
+    /**
+     * The request object with the user that the issue is assigned to.
+     *
+     * @example {
+     *     "accountId": "5b10ac8d82e05b22cc7d4ef5"
+     * }
+     */
+    user: User;
+  }): Promise<void> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue/{issueIdOrKey}/assignee",
+        method: "PUT",
+        pathParams: {
+          issueIdOrKey,
+        },
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: user,
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          204: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 204;
+          mediaType: "application/json";
+          body: void;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator("IssuesService.assignIssue.response"),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Creates an issue or, where the option to create subtasks is enabled in Jira, a
+   * subtask. A transition may be applied, to move the issue or subtask to a
+   * workflow step other than the default start step, and issue properties set.
+   *
+   * The content of the issue or subtask is defined using `update` and `fields`. The
+   * fields that can be set in the issue or subtask are determined using the [ Get
+   * create issue metadata](#api-rest-api-3-issue-createmeta-get). These are the
+   * same fields that appear on the issue's create screen. Note that the
+   * `description`, `environment`, and any `textarea` type custom fields (multi-line
+   * text fields) take Atlassian Document Format content. Single line custom fields
+   * (`textfield`) accept a string and don't handle Atlassian Document Format
+   * content.
+   *
+   * Creating a subtask differs from creating an issue as follows:
+   *
+   *  *  `issueType` must be set to a subtask issue type (use [ Get create issue
+   * metadata](#api-rest-api-3-issue-createmeta-get) to find subtask issue types).
+   *  *  `parent` must contain the ID or key of the parent issue.
+   *
+   * In a next-gen project any issue may be made a child providing that the parent
+   * and child are members of the same project.
+   *
+   * **[Permissions](#permissions) required:** *Browse projects* and *Create issues*
+   * [project permissions](https://confluence.atlassian.com/x/yodKLg) for the
+   * project in which the issue or subtask is created.
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: {
+   *   "id": "10000",
+   *   "key": "ED-24",
+   *   "self": "https://your-domain.atlassian.net/rest/api/3/issue/10000",
+   *   "transition": {
+   *     "status": 200,
+   *     "errorCollection": {
+   *       "errorMessages": [],
+   *       "errors": {}
+   *     }
+   *   }
+   * }
+   * @path {POST} /rest/api/3/issue
+   * @scopes-current write:jira-work
+   * @scopes-beta write:issue:jira, write:comment:jira, write:comment.property:jira,
+   * write:attachment:jira, read:issue:jira
+   */
+  createIssue({
+    updateHistory,
+    issueUpdateDetails,
+  }: {
+    /**
+     * Whether the project in which the issue is created is added to the user's
+     * **Recently viewed** project list, as shown under **Projects** in Jira. When
+     * provided, the issue type and request type are added to the user's history for a
+     * project. These values are then used to provide defaults on the issue create
+     * screen.
+     */
+    updateHistory?: boolean;
+    /**
+     * @example {
+     *     "fields": {
+     *         "assignee": {
+     *             "id": "5b109f2e9729b51b54dc274d"
+     *         },
+     *         "components": [
+     *             {
+     *                 "id": "10000"
+     *             }
+     *         ],
+     *         "customfield_10000": "09/Jun/19",
+     *         "customfield_20000": "06/Jul/19 3:25 PM",
+     *         "customfield_30000": [
+     *             "10000",
+     *             "10002"
+     *         ],
+     *         "customfield_40000": {
+     *             "content": [
+     *                 {
+     *                     "content": [
+     *                         {
+     *                             "text": "Occurs on all orders",
+     *                             "type": "text"
+     *                         }
+     *                     ],
+     *                     "type": "paragraph"
+     *                 }
+     *             ],
+     *             "type": "doc",
+     *             "version": 1
+     *         },
+     *         "customfield_50000": {
+     *             "content": [
+     *                 {
+     *                     "content": [
+     *                         {
+     *                             "text": "Could impact day-to-day work.",
+     *                             "type": "text"
+     *                         }
+     *                     ],
+     *                     "type": "paragraph"
+     *                 }
+     *             ],
+     *             "type": "doc",
+     *             "version": 1
+     *         },
+     *         "customfield_60000": "jira-software-users",
+     *         "customfield_70000": [
+     *             "jira-administrators",
+     *             "jira-software-users"
+     *         ],
+     *         "customfield_80000": {
+     *             "value": "red"
+     *         },
+     *         "description": {
+     *             "content": [
+     *                 {
+     *                     "content": [
+     *                         {
+     *                             "text": "Order entry fails when selecting
+     * supplier.",
+     *                             "type": "text"
+     *                         }
+     *                     ],
+     *                     "type": "paragraph"
+     *                 }
+     *             ],
+     *             "type": "doc",
+     *             "version": 1
+     *         },
+     *         "duedate": "2019-05-11",
+     *         "environment": {
+     *             "content": [
+     *                 {
+     *                     "content": [
+     *                         {
+     *                             "text": "UAT",
+     *                             "type": "text"
+     *                         }
+     *                     ],
+     *                     "type": "paragraph"
+     *                 }
+     *             ],
+     *             "type": "doc",
+     *             "version": 1
+     *         },
+     *         "fixVersions": [
+     *             {
+     *                 "id": "10001"
+     *             }
+     *         ],
+     *         "issuetype": {
+     *             "id": "10000"
+     *         },
+     *         "labels": [
+     *             "bugfix",
+     *             "blitz_test"
+     *         ],
+     *         "parent": {
+     *             "key": "PROJ-123"
+     *         },
+     *         "priority": {
+     *             "id": "20000"
+     *         },
+     *         "project": {
+     *             "id": "10000"
+     *         },
+     *         "reporter": {
+     *             "id": "5b10a2844c20165700ede21g"
+     *         },
+     *         "security": {
+     *             "id": "10000"
+     *         },
+     *         "summary": "Main order flow broken",
+     *         "timetracking": {
+     *             "originalEstimate": "10",
+     *             "remainingEstimate": "5"
+     *         },
+     *         "versions": [
+     *             {
+     *                 "id": "10000"
+     *             }
+     *         ]
+     *     },
+     *     "update": {}
+     * }
+     */
+    issueUpdateDetails: IssueUpdateDetails;
+  }): Promise<CreatedIssue> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue",
+        method: "POST",
+        query: {
+          updateHistory,
+        },
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: issueUpdateDetails,
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          201: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 201;
+          mediaType: "application/json";
+          body: CreatedIssue;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator("IssuesService.createIssue.response"),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Creates upto **50** issues and, where the option to create subtasks is enabled
+   * in Jira, subtasks. Transitions may be applied, to move the issues or subtasks
+   * to a workflow step other than the default start step, and issue properties set.
+   *
+   * The content of each issue or subtask is defined using `update` and `fields`.
+   * The fields that can be set in the issue or subtask are determined using the [
+   * Get create issue metadata](#api-rest-api-3-issue-createmeta-get). These are the
+   * same fields that appear on the issues' create screens. Note that the
+   * `description`, `environment`, and any `textarea` type custom fields (multi-line
+   * text fields) take Atlassian Document Format content. Single line custom fields
+   * (`textfield`) accept a string and don't handle Atlassian Document Format
+   * content.
+   *
+   * Creating a subtask differs from creating an issue as follows:
+   *
+   *  *  `issueType` must be set to a subtask issue type (use [ Get create issue
+   * metadata](#api-rest-api-3-issue-createmeta-get) to find subtask issue types).
+   *  *  `parent` the must contain the ID or key of the parent issue.
+   *
+   * **[Permissions](#permissions) required:** *Browse projects* and *Create issues*
+   * [project permissions](https://confluence.atlassian.com/x/yodKLg) for the
+   * project in which each issue or subtask is created.
+   *
+   * @returns Returned if any of the issue or subtask creation requests were successful. A
+   * request may be unsuccessful when it:
+   *
+   *  *  is missing required fields.
+   *  *  contains invalid field values.
+   *  *  contains fields that cannot be set for the issue type.
+   *  *  is by a user who does not have the necessary permission.
+   *  *  is to create a subtype in a project different that of the parent issue.
+   *  *  is for a subtask when the option to create subtasks is disabled.
+   *  *  is invalid for any other reason.
+   *
+   * example: {
+   *   "issues": [
+   *     {
+   *       "id": "10000",
+   *       "key": "ED-24",
+   *       "self": "https://your-domain.atlassian.net/rest/api/3/issue/10000",
+   *       "transition": {
+   *         "status": 200,
+   *         "errorCollection": {
+   *           "errorMessages": [],
+   *           "errors": {}
+   *         }
+   *       }
+   *     },
+   *     {
+   *       "id": "10001",
+   *       "key": "ED-25",
+   *       "self": "https://your-domain.atlassian.net/rest/api/3/issue/10001"
+   *     }
+   *   ],
+   *   "errors": []
+   * }
+   * @path {POST} /rest/api/3/issue/bulk
+   * @scopes-current write:jira-work
+   * @scopes-beta write:issue:jira, write:comment:jira, write:comment.property:jira,
+   * write:attachment:jira, read:issue:jira
+   */
+  createIssues({
+    issuesUpdateBean,
+  }: {
+    /**
+     * @example {
+     *     "issueUpdates": [
+     *         {
+     *             "fields": {
+     *                 "assignee": {
+     *                     "id": "5b109f2e9729b51b54dc274d"
+     *                 },
+     *                 "components": [
+     *                     {
+     *                         "id": "10000"
+     *                     }
+     *                 ],
+     *                 "customfield_10000": "09/Jun/19",
+     *                 "customfield_20000": "06/Jul/19 3:25 PM",
+     *                 "customfield_30000": [
+     *                     "10000",
+     *                     "10002"
+     *                 ],
+     *                 "customfield_40000": {
+     *                     "content": [
+     *                         {
+     *                             "content": [
+     *                                 {
+     *                                     "text": "Occurs on all orders",
+     *                                     "type": "text"
+     *                                 }
+     *                             ],
+     *                             "type": "paragraph"
+     *                         }
+     *                     ],
+     *                     "type": "doc",
+     *                     "version": 1
+     *                 },
+     *                 "customfield_50000": {
+     *                     "content": [
+     *                         {
+     *                             "content": [
+     *                                 {
+     *                                     "text": "Could impact day-to-day work.",
+     *                                     "type": "text"
+     *                                 }
+     *                             ],
+     *                             "type": "paragraph"
+     *                         }
+     *                     ],
+     *                     "type": "doc",
+     *                     "version": 1
+     *                 },
+     *                 "customfield_60000": "jira-software-users",
+     *                 "customfield_70000": [
+     *                     "jira-administrators",
+     *                     "jira-software-users"
+     *                 ],
+     *                 "customfield_80000": {
+     *                     "value": "red"
+     *                 },
+     *                 "description": {
+     *                     "content": [
+     *                         {
+     *                             "content": [
+     *                                 {
+     *                                     "text": "Order entry fails when selecting
+     * supplier.",
+     *                                     "type": "text"
+     *                                 }
+     *                             ],
+     *                             "type": "paragraph"
+     *                         }
+     *                     ],
+     *                     "type": "doc",
+     *                     "version": 1
+     *                 },
+     *                 "duedate": "2011-03-11",
+     *                 "environment": {
+     *                     "content": [
+     *                         {
+     *                             "content": [
+     *                                 {
+     *                                     "text": "UAT",
+     *                                     "type": "text"
+     *                                 }
+     *                             ],
+     *                             "type": "paragraph"
+     *                         }
+     *                     ],
+     *                     "type": "doc",
+     *                     "version": 1
+     *                 },
+     *                 "fixVersions": [
+     *                     {
+     *                         "id": "10001"
+     *                     }
+     *                 ],
+     *                 "issuetype": {
+     *                     "id": "10000"
+     *                 },
+     *                 "labels": [
+     *                     "bugfix",
+     *                     "blitz_test"
+     *                 ],
+     *                 "priority": {
+     *                     "id": "20000"
+     *                 },
+     *                 "project": {
+     *                     "id": "10000"
+     *                 },
+     *                 "reporter": {
+     *                     "id": "5b10a2844c20165700ede21g"
+     *                 },
+     *                 "security": {
+     *                     "id": "10000"
+     *                 },
+     *                 "summary": "Main order flow broken",
+     *                 "timetracking": {
+     *                     "originalEstimate": "10",
+     *                     "remainingEstimate": "5"
+     *                 },
+     *                 "versions": [
+     *                     {
+     *                         "id": "10000"
+     *                     }
+     *                 ]
+     *             },
+     *             "update": {
+     *                 "worklog": [
+     *                     {
+     *                         "add": {
+     *                             "started": "2019-07-05T11:05:00.000+0000",
+     *                             "timeSpent": "60m"
+     *                         }
+     *                     }
+     *                 ]
+     *             }
+     *         },
+     *         {
+     *             "fields": {
+     *                 "assignee": {
+     *                     "id": "5b109f2e9729b51b54dc274d"
+     *                 },
+     *                 "components": [
+     *                     {
+     *                         "id": "10000"
+     *                     }
+     *                 ],
+     *                 "customfield_10000": "09/Jun/19",
+     *                 "customfield_20000": "06/Jul/19 3:25 PM",
+     *                 "customfield_30000": [
+     *                     "10000",
+     *                     "10002"
+     *                 ],
+     *                 "customfield_40000": {
+     *                     "content": [
+     *                         {
+     *                             "content": [
+     *                                 {
+     *                                     "text": "Occurs on all orders",
+     *                                     "type": "text"
+     *                                 }
+     *                             ],
+     *                             "type": "paragraph"
+     *                         }
+     *                     ],
+     *                     "type": "doc",
+     *                     "version": 1
+     *                 },
+     *                 "customfield_50000": {
+     *                     "content": [
+     *                         {
+     *                             "content": [
+     *                                 {
+     *                                     "text": "Could impact day-to-day work.",
+     *                                     "type": "text"
+     *                                 }
+     *                             ],
+     *                             "type": "paragraph"
+     *                         }
+     *                     ],
+     *                     "type": "doc",
+     *                     "version": 1
+     *                 },
+     *                 "customfield_60000": "jira-software-users",
+     *                 "customfield_70000": [
+     *                     "jira-administrators",
+     *                     "jira-software-users"
+     *                 ],
+     *                 "customfield_80000": {
+     *                     "value": "red"
+     *                 },
+     *                 "description": {
+     *                     "content": [
+     *                         {
+     *                             "content": [
+     *                                 {
+     *                                     "text": "Order remains pending after
+     * approved.",
+     *                                     "type": "text"
+     *                                 }
+     *                             ],
+     *                             "type": "paragraph"
+     *                         }
+     *                     ],
+     *                     "type": "doc",
+     *                     "version": 1
+     *                 },
+     *                 "duedate": "2019-04-16",
+     *                 "environment": {
+     *                     "content": [
+     *                         {
+     *                             "content": [
+     *                                 {
+     *                                     "text": "UAT",
+     *                                     "type": "text"
+     *                                 }
+     *                             ],
+     *                             "type": "paragraph"
+     *                         }
+     *                     ],
+     *                     "type": "doc",
+     *                     "version": 1
+     *                 },
+     *                 "fixVersions": [
+     *                     {
+     *                         "id": "10001"
+     *                     }
+     *                 ],
+     *                 "issuetype": {
+     *                     "id": "10000"
+     *                 },
+     *                 "labels": [
+     *                     "new_release"
+     *                 ],
+     *                 "priority": {
+     *                     "id": "20000"
+     *                 },
+     *                 "project": {
+     *                     "id": "1000"
+     *                 },
+     *                 "reporter": {
+     *                     "id": "5b10a2844c20165700ede21g"
+     *                 },
+     *                 "security": {
+     *                     "id": "10000"
+     *                 },
+     *                 "summary": "Order stuck in pending",
+     *                 "timetracking": {
+     *                     "originalEstimate": "15",
+     *                     "remainingEstimate": "5"
+     *                 },
+     *                 "versions": [
+     *                     {
+     *                         "id": "10000"
+     *                     }
+     *                 ]
+     *             },
+     *             "update": {}
+     *         }
+     *     ]
+     * }
+     */
+    issuesUpdateBean: IssuesUpdateBean;
+  }): Promise<CreatedIssues> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue/bulk",
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: issuesUpdateBean,
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          201: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 201;
+          mediaType: "application/json";
+          body: CreatedIssues;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "IssuesService.createIssues.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Deletes an issue.
+   *
+   * An issue cannot be deleted if it has one or more subtasks. To delete an issue
+   * with subtasks, set `deleteSubtasks`. This causes the issue's subtasks to be
+   * deleted with the issue.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:**
+   *
+   *  *  *Browse projects* and *Delete issues* [project
+   * permission](https://confluence.atlassian.com/x/yodKLg) for the project
+   * containing the issue.
+   *  *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is
+   * configured, issue-level security permission to view the issue.
+   *
+   * @path {DELETE} /rest/api/3/issue/{issueIdOrKey}
+   * @scopes-current write:jira-work
+   * @scopes-beta delete:issue:jira
+   */
+  deleteIssue({
+    issueIdOrKey,
+    deleteSubtasks,
+  }: {
+    /** The ID or key of the issue. */
+    issueIdOrKey: string;
+    /** Whether the issue's subtasks are deleted when the issue is deleted. */
+    deleteSubtasks?: "true" | "false";
+  }): Promise<void> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue/{issueIdOrKey}",
+        method: "DELETE",
+        pathParams: {
+          issueIdOrKey,
+        },
+        query: {
+          deleteSubtasks,
+        },
+      })
+      .then(commonHttpClient.discardResult);
+  }
+  /**
+   * Performs an issue transition and, if the transition has a screen, updates the
+   * fields from the transition screen.
+   *
+   * sortByCategory To update the fields on the transition screen, specify the
+   * fields in the `fields` or `update` parameters in the request body. Get details
+   * about the fields using [ Get
+   * transitions](#api-rest-api-3-issue-issueIdOrKey-transitions-get) with the
+   * `transitions.fields` expand.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:**
+   *
+   *  *  *Browse projects* and *Transition issues* [project
+   * permission](https://confluence.atlassian.com/x/yodKLg) for the project that the
+   * issue is in.
+   *  *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is
+   * configured, issue-level security permission to view the issue.
+   *
+   * @returns Returned if the request is successful.
+   * @path {POST} /rest/api/3/issue/{issueIdOrKey}/transitions
+   * @scopes-current write:jira-work
+   * @scopes-beta write:issue:jira, write:issue.property:jira
+   */
+  doTransition({
+    issueIdOrKey,
+    issueUpdateDetails,
+  }: {
+    /** The ID or key of the issue. */
+    issueIdOrKey: string;
+    /**
+     * @example {
+     *     "fields": {
+     *         "assignee": {
+     *             "name": "bob"
+     *         },
+     *         "resolution": {
+     *             "name": "Fixed"
+     *         }
+     *     },
+     *     "historyMetadata": {
+     *         "activityDescription": "Complete order processing",
+     *         "actor": {
+     *             "avatarUrl": "http://mysystem/avatar/tony.jpg",
+     *             "displayName": "Tony",
+     *             "id": "tony",
+     *             "type": "mysystem-user",
+     *             "url": "http://mysystem/users/tony"
+     *         },
+     *         "cause": {
+     *             "id": "myevent",
+     *             "type": "mysystem-event"
+     *         },
+     *         "description": "From the order testing process",
+     *         "extraData": {
+     *             "Iteration": "10a",
+     *             "Step": "4"
+     *         },
+     *         "generator": {
+     *             "id": "mysystem-1",
+     *             "type": "mysystem-application"
+     *         },
+     *         "type": "myplugin:type"
+     *     },
+     *     "transition": {
+     *         "id": "5"
+     *     },
+     *     "update": {
+     *         "comment": [
+     *             {
+     *                 "add": {
+     *                     "body": {
+     *                         "content": [
+     *                             {
+     *                                 "content": [
+     *                                     {
+     *                                         "text": "Bug has been fixed",
+     *                                         "type": "text"
+     *                                     }
+     *                                 ],
+     *                                 "type": "paragraph"
+     *                             }
+     *                         ],
+     *                         "type": "doc",
+     *                         "version": 1
+     *                     }
+     *                 }
+     *             }
+     *         ]
+     *     }
+     * }
+     */
+    issueUpdateDetails: IssueUpdateDetails;
+  }): Promise<void> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue/{issueIdOrKey}/transitions",
+        method: "POST",
+        pathParams: {
+          issueIdOrKey,
+        },
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: issueUpdateDetails,
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          204: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 204;
+          mediaType: "application/json";
+          body: void;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "IssuesService.doTransition.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Edits an issue. Issue properties may be updated as part of the edit. Please
+   * note that issue transition will be ignored as it is not supported yet.
+   *
+   * The edits to the issue's fields are defined using `update` and `fields`. The
+   * fields that can be edited are determined using [ Get edit issue
+   * metadata](#api-rest-api-3-issue-issueIdOrKey-editmeta-get).
+   *
+   * The parent field may be set by key or ID. For standard issue types, the parent
+   * may be removed by setting `update.parent.set.none` to *true*. Note that the
+   * `description`, `environment`, and any `textarea` type custom fields (multi-line
+   * text fields) take Atlassian Document Format content. Single line custom fields
+   * (`textfield`) accept a string and don't handle Atlassian Document Format
+   * content.
+   *
+   * Connect apps having an app user with *Administer Jira* [global
+   * permission](https://confluence.atlassian.com/x/x4dKLg), and Forge apps acting
+   * on behalf of users with *Administer Jira* [global
+   * permission](https://confluence.atlassian.com/x/x4dKLg), can override the screen
+   * security configuration using `overrideScreenSecurity` and
+   * `overrideEditableFlag`.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:**
+   *
+   *  *  *Browse projects* and *Edit issues* [project
+   * permission](https://confluence.atlassian.com/x/yodKLg) for the project that the
+   * issue is in.
+   *  *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is
+   * configured, issue-level security permission to view the issue.
+   *
+   * @returns * status: 200, mediaType: application/json
+   *
+   *    Returned if the request is successful and the `returnIssue` parameter is
+   * `true`
+   *
+   *  * status: 204, mediaType: application/json
+   *
+   *    Returned if the request is successful.
+   * @path {PUT} /rest/api/3/issue/{issueIdOrKey}
+   * @scopes-current write:jira-work
+   * @scopes-beta write:issue:jira
+   */
+  editIssue({
+    issueIdOrKey,
+    notifyUsers,
+    overrideScreenSecurity,
+    overrideEditableFlag,
+    returnIssue,
+    expand,
+    issueUpdateDetails,
+  }: {
+    /** The ID or key of the issue. */
+    issueIdOrKey: string;
+    /**
+     * Whether a notification email about the issue update is sent to all watchers. To
+     * disable the notification, administer Jira or administer project permissions are
+     * required. If the user doesn't have the necessary permission the request is
+     * ignored.
+     */
+    notifyUsers?: boolean;
+    /**
+     * Whether screen security is overridden to enable hidden fields to be edited.
+     * Available to Connect app users with *Administer Jira* [global
+     * permission](https://confluence.atlassian.com/x/x4dKLg) and Forge apps acting on
+     * behalf of users with *Administer Jira* [global
+     * permission](https://confluence.atlassian.com/x/x4dKLg).
+     */
+    overrideScreenSecurity?: boolean;
+    /**
+     * Whether screen security is overridden to enable uneditable fields to be edited.
+     * Available to Connect app users with *Administer Jira* [global
+     * permission](https://confluence.atlassian.com/x/x4dKLg) and Forge apps acting on
+     * behalf of users with *Administer Jira* [global
+     * permission](https://confluence.atlassian.com/x/x4dKLg).
+     */
+    overrideEditableFlag?: boolean;
+    /**
+     * Whether the response should contain the issue with fields edited in this
+     * request. The returned issue will have the same format as in the [Get issue
+     * API](#api-rest-api-3-issue-issueidorkey-get).
+     */
+    returnIssue?: boolean;
+    /**
+     * The Get issue API expand parameter to use in the response if the `returnIssue`
+     * parameter is `true`.
+     */
+    expand?: string;
+    /**
+     * @example {
+     *     "fields": {
+     *         "customfield_10000": {
+     *             "content": [
+     *                 {
+     *                     "content": [
+     *                         {
+     *                             "text": "Investigation underway",
+     *                             "type": "text"
+     *                         }
+     *                     ],
+     *                     "type": "paragraph"
+     *                 }
+     *             ],
+     *             "type": "doc",
+     *             "version": 1
+     *         },
+     *         "customfield_10010": 1,
+     *         "summary": "Completed orders still displaying in pending"
+     *     },
+     *     "historyMetadata": {
+     *         "activityDescription": "Complete order processing",
+     *         "actor": {
+     *             "avatarUrl": "http://mysystem/avatar/tony.jpg",
+     *             "displayName": "Tony",
+     *             "id": "tony",
+     *             "type": "mysystem-user",
+     *             "url": "http://mysystem/users/tony"
+     *         },
+     *         "cause": {
+     *             "id": "myevent",
+     *             "type": "mysystem-event"
+     *         },
+     *         "description": "From the order testing process",
+     *         "extraData": {
+     *             "Iteration": "10a",
+     *             "Step": "4"
+     *         },
+     *         "generator": {
+     *             "id": "mysystem-1",
+     *             "type": "mysystem-application"
+     *         },
+     *         "type": "myplugin:type"
+     *     },
+     *     "properties": [
+     *         {
+     *             "key": "key1",
+     *             "value": "Order number 10784"
+     *         },
+     *         {
+     *             "key": "key2",
+     *             "value": "Order number 10923"
+     *         }
+     *     ],
+     *     "update": {
+     *         "components": [
+     *             {
+     *                 "set": ""
+     *             }
+     *         ],
+     *         "labels": [
+     *             {
+     *                 "add": "triaged"
+     *             },
+     *             {
+     *                 "remove": "blocker"
+     *             }
+     *         ],
+     *         "summary": [
+     *             {
+     *                 "set": "Bug in business logic"
+     *             }
+     *         ],
+     *         "timetracking": [
+     *             {
+     *                 "edit": {
+     *                     "originalEstimate": "1w 1d",
+     *                     "remainingEstimate": "4d"
+     *                 }
+     *             }
+     *         ]
+     *     }
+     * }
+     */
+    issueUpdateDetails: IssueUpdateDetails;
+  }): Promise<
+    commonHttpClient.WithResponse<
+      | {
+          status: 200;
+          mediaType: "application/json";
+          body: unknown;
+        }
+      | {
+          status: 204;
+          mediaType: "application/json";
+          body: void;
+        }
+    >
+  > {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue/{issueIdOrKey}",
+        method: "PUT",
+        pathParams: {
+          issueIdOrKey,
+        },
+        query: {
+          notifyUsers,
+          overrideScreenSecurity,
+          overrideEditableFlag,
+          returnIssue,
+          expand,
+        },
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: issueUpdateDetails,
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+          204: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<
+          | {
+              status: 200;
+              mediaType: "application/json";
+              body: unknown;
+            }
+          | {
+              status: 204;
+              mediaType: "application/json";
+              body: void;
+            }
+        >(),
+      )
+      .then(
+        validationSchemaStorage.validator("IssuesService.editIssue.response"),
+      );
+  }
+  /**
+   * Enables admins to retrieve details of all archived issues. Upon a successful
+   * request, the admin who submitted it will receive an email with a link to
+   * download a CSV file with the issue details.
+   *
+   * Note that this API only exports the values of system fields and
+   * archival-specific fields (`ArchivedBy` and `ArchivedDate`). Custom fields
+   * aren't supported.
+   *
+   * **[Permissions](#permissions) required:** Jira admin or site admin: [global
+   * permission](https://confluence.atlassian.com/x/x4dKLg)
+   *
+   * **License required:** Premium or Enterprise
+   *
+   * **Signed-in users only:** This API can't be accessed anonymously.
+   *
+   * **Rate limiting:** Only a single request can be active at any given time.
+   *
+   * @returns Returns the details of your export task. You can use the [get
+   * task](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-tasks/#api-rest-api-3-task-taskid-get)
+   * API to view the progress of your request.
+   *
+   * example: {
+   *   "payload": "{projects=[FOO, BAR], reporters=[uuid-rep-001, uuid-rep-002],
+   * issueTypes=[10001, 10002], archivedDate={dateAfterInstant=2023-01-01,
+   * dateBeforeInstant=2023-01-12}, archivedBy=[uuid-rep-001, uuid-rep-002]}",
+   *   "progress": 0,
+   *   "status": "ENQUEUED",
+   *   "submittedTime": 1623230887000,
+   *   "taskId": "10990"
+   * }
+   * @path {PUT} /rest/api/3/issues/archive/export
+   * @scopes-current read:jira-work
+   * @scopes-beta read:issue:jira
+   */
+  exportArchivedIssues({
+    archivedIssuesFilterRequest,
+  }: {
+    /**
+     * You can filter the issues in your request by the `projects`, `archivedBy`,
+     * `archivedDate`, `issueTypes`, and `reporters` fields. All filters are optional.
+     * If you don't provide any filters, you'll get a list of up to one million
+     * archived issues.
+     *
+     * @example {
+     *     "archivedBy": [
+     *         "uuid-rep-001",
+     *         "uuid-rep-002"
+     *     ],
+     *     "archivedDate": {
+     *         "dateAfter": "2023-01-01",
+     *         "dateBefore": "2023-01-12"
+     *     },
+     *     "archivedDateRange": {
+     *         "dateAfter": "2023-01-01",
+     *         "dateBefore": "2023-01-12"
+     *     },
+     *     "issueTypes": [
+     *         "10001",
+     *         "10002"
+     *     ],
+     *     "projects": [
+     *         "FOO",
+     *         "BAR"
+     *     ],
+     *     "reporters": [
+     *         "uuid-rep-001",
+     *         "uuid-rep-002"
+     *     ]
+     * }
+     */
+    archivedIssuesFilterRequest: ArchivedIssuesFilterRequest;
+  }): Promise<ExportArchivedIssuesTaskProgressResponse> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issues/archive/export",
+        method: "PUT",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: archivedIssuesFilterRequest,
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          202: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 202;
+          mediaType: "application/json";
+          body: ExportArchivedIssuesTaskProgressResponse;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "IssuesService.exportArchivedIssues.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Returns a [paginated](#pagination) list of all changelogs for an issue sorted
+   * by date, starting from the oldest.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:**
+   *
+   *  *  *Browse projects* [project
+   * permission](https://confluence.atlassian.com/x/yodKLg) for the project that the
+   * issue is in.
+   *  *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is
+   * configured, issue-level security permission to view the issue.
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: {
+   *   "isLast": false,
+   *   "maxResults": 2,
+   *   "nextPage":
+   * "https://your-domain.atlassian.net/rest/api/3/issue/TT-1/changelog?&startAt=4&maxResults=2",
+   *   "self":
+   * "https://your-domain.atlassian.net/rest/api/3/issue/TT-1/changelog?startAt=2&maxResults=2",
+   *   "startAt": 2,
+   *   "total": 5,
+   *   "values": [
+   *     {
+   *       "author": {
+   *         "accountId": "5b10a2844c20165700ede21g",
+   *         "active": true,
+   *         "avatarUrls": {
+   *           "16x16":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16&s=16",
+   *           "24x24":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24&s=24",
+   *           "32x32":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32&s=32",
+   *           "48x48":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48&s=48"
+   *         },
+   *         "displayName": "Mia Krystof",
+   *         "emailAddress": "mia@example.com",
+   *         "self":
+   * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g",
+   *         "timeZone": "Australia/Sydney"
+   *       },
+   *       "created": "1970-01-18T06:27:50.429+0000",
+   *       "id": "10001",
+   *       "items": [
+   *         {
+   *           "field": "fields",
+   *           "fieldtype": "jira",
+   *           "fieldId": "fieldId",
+   *           "from": null,
+   *           "fromString": "",
+   *           "to": null,
+   *           "toString": "label-1"
+   *         }
+   *       ]
+   *     },
+   *     {
+   *       "author": {
+   *         "accountId": "5b10a2844c20165700ede21g",
+   *         "active": true,
+   *         "avatarUrls": {
+   *           "16x16":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16&s=16",
+   *           "24x24":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24&s=24",
+   *           "32x32":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32&s=32",
+   *           "48x48":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48&s=48"
+   *         },
+   *         "displayName": "Mia Krystof",
+   *         "emailAddress": "mia@example.com",
+   *         "self":
+   * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g",
+   *         "timeZone": "Australia/Sydney"
+   *       },
+   *       "created": "1970-01-18T06:27:51.429+0000",
+   *       "id": "10002",
+   *       "items": [
+   *         {
+   *           "field": "fields",
+   *           "fieldtype": "jira",
+   *           "fieldId": "fieldId",
+   *           "from": null,
+   *           "fromString": "label-1",
+   *           "to": null,
+   *           "toString": "label-1 label-2"
+   *         }
+   *       ]
+   *     }
+   *   ]
+   * }
+   * @path {GET} /rest/api/3/issue/{issueIdOrKey}/changelog
+   * @scopes-current read:jira-work
+   * @scopes-beta read:issue-meta:jira, read:avatar:jira, read:issue.changelog:jira
+   */
+  getChangeLogs({
+    issueIdOrKey,
+    startAt,
+    maxResults,
+  }: {
+    /** The ID or key of the issue. */
+    issueIdOrKey: 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;
+  }): Promise<PageBeanChangelog> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue/{issueIdOrKey}/changelog",
+        method: "GET",
+        pathParams: {
+          issueIdOrKey,
+        },
+        query: {
+          startAt,
+          maxResults,
+        },
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: PageBeanChangelog;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "IssuesService.getChangeLogs.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Returns changelogs for an issue specified by a list of changelog IDs.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:**
+   *
+   *  *  *Browse projects* [project
+   * permission](https://confluence.atlassian.com/x/yodKLg) for the project that the
+   * issue is in.
+   *  *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is
+   * configured, issue-level security permission to view the issue.
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: {
+   *   "histories": [
+   *     {
+   *       "author": {
+   *         "accountId": "5b10a2844c20165700ede21g",
+   *         "active": true,
+   *         "avatarUrls": {
+   *           "16x16":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16&s=16",
+   *           "24x24":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24&s=24",
+   *           "32x32":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32&s=32",
+   *           "48x48":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48&s=48"
+   *         },
+   *         "displayName": "Mia Krystof",
+   *         "emailAddress": "mia@example.com",
+   *         "self":
+   * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g",
+   *         "timeZone": "Australia/Sydney"
+   *       },
+   *       "created": "1970-01-18T06:27:50.429+0000",
+   *       "id": "10001",
+   *       "items": [
+   *         {
+   *           "field": "fields",
+   *           "fieldtype": "jira",
+   *           "fieldId": "fieldId",
+   *           "from": null,
+   *           "fromString": "",
+   *           "to": null,
+   *           "toString": "label-1"
+   *         }
+   *       ]
+   *     },
+   *     {
+   *       "author": {
+   *         "accountId": "5b10a2844c20165700ede21g",
+   *         "active": true,
+   *         "avatarUrls": {
+   *           "16x16":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16&s=16",
+   *           "24x24":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24&s=24",
+   *           "32x32":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32&s=32",
+   *           "48x48":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48&s=48"
+   *         },
+   *         "displayName": "Mia Krystof",
+   *         "emailAddress": "mia@example.com",
+   *         "self":
+   * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g",
+   *         "timeZone": "Australia/Sydney"
+   *       },
+   *       "created": "1970-01-18T06:27:51.429+0000",
+   *       "id": "10002",
+   *       "items": [
+   *         {
+   *           "field": "fields",
+   *           "fieldtype": "jira",
+   *           "fieldId": "fieldId",
+   *           "from": null,
+   *           "fromString": "label-1",
+   *           "to": null,
+   *           "toString": "label-1 label-2"
+   *         }
+   *       ]
+   *     }
+   *   ],
+   *   "maxResults": 2,
+   *   "startAt": 0,
+   *   "total": 2
+   * }
+   * @path {POST} /rest/api/3/issue/{issueIdOrKey}/changelog/list
+   * @scopes-current read:jira-work
+   * @scopes-beta read:issue-meta:jira, read:avatar:jira, read:issue.changelog:jira
+   */
+  getChangeLogsByIds({
+    issueIdOrKey,
+    issueChangelogIds,
+  }: {
+    /** The ID or key of the issue. */
+    issueIdOrKey: string;
+    /**
+     * @example {
+     *     "changelogIds": [
+     *         10001,
+     *         10002
+     *     ]
+     * }
+     */
+    issueChangelogIds: IssueChangelogIds;
+  }): Promise<PageOfChangelogs> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue/{issueIdOrKey}/changelog/list",
+        method: "POST",
+        pathParams: {
+          issueIdOrKey,
+        },
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: issueChangelogIds,
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: PageOfChangelogs;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "IssuesService.getChangeLogsByIds.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Returns details of projects, issue types within projects, and, when requested,
+   * the create screen fields for each issue type for the user. Use the information
+   * to populate the requests in [ Create issue](#api-rest-api-3-issue-post) and
+   * [Create issues](#api-rest-api-3-issue-bulk-post).
+   *
+   * Deprecated, see [Create Issue Meta Endpoint Deprecation
+   * Notice](https://developer.atlassian.com/cloud/jira/platform/changelog/#CHANGE-1304).
+   *
+   * The request can be restricted to specific projects or issue types using the
+   * query parameters. The response will contain information for the valid projects,
+   * issue types, or project and issue type combinations requested. Note that
+   * invalid project, issue type, or project and issue type combinations do not
+   * generate errors.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:** *Create issues* [project
+   * permission](https://confluence.atlassian.com/x/yodKLg) in the requested
+   * projects.
+   *
+   * @deprecated
+   * @returns Returned if the request is successful.
+   *
+   * example: {
+   *   "projects": [
+   *     {
+   *       "avatarUrls": {
+   *         "16x16":
+   * "https://your-domain.atlassian.net/secure/projectavatar?size=xsmall&pid=10000&avatarId=10011",
+   *         "24x24":
+   * "https://your-domain.atlassian.net/secure/projectavatar?size=small&pid=10000&avatarId=10011",
+   *         "32x32":
+   * "https://your-domain.atlassian.net/secure/projectavatar?size=medium&pid=10000&avatarId=10011",
+   *         "48x48":
+   * "https://your-domain.atlassian.net/secure/projectavatar?pid=10000&avatarId=10011"
+   *       },
+   *       "id": "10000",
+   *       "issuetypes": [
+   *         {
+   *           "description": "An error in the code",
+   *           "fields": {
+   *             "issuetype": {
+   *               "allowedValues": [
+   *                 "set"
+   *               ],
+   *               "autoCompleteUrl": "issuetype",
+   *               "hasDefaultValue": false,
+   *               "key": "issuetype",
+   *               "name": "Issue Type",
+   *               "required": true
+   *             }
+   *           },
+   *           "iconUrl":
+   * "https://your-domain.atlassian.net/images/icons/issuetypes/bug.png",
+   *           "id": "1",
+   *           "name": "Bug",
+   *           "self": "https://your-domain.atlassian.net/rest/api/3/issueType/1",
+   *           "subtask": false
+   *         }
+   *       ],
+   *       "key": "ED",
+   *       "name": "Edison Project",
+   *       "self": "https://your-domain.atlassian.net/rest/api/3/project/ED"
+   *     }
+   *   ]
+   * }
+   * @path {GET} /rest/api/3/issue/createmeta
+   * @scopes-current read:jira-work
+   * @scopes-beta read:issue-meta:jira, read:avatar:jira, read:field-configuration:jira
+   */
+  getCreateIssueMeta({
+    projectIds,
+    projectKeys,
+    issuetypeIds,
+    issuetypeNames,
+    expand,
+  }: {
+    /**
+     * List of project IDs. This parameter accepts a comma-separated list. Multiple
+     * project IDs can also be provided using an ampersand-separated list. For
+     * example, `projectIds=10000,10001&projectIds=10020,10021`. This parameter may be
+     * provided with `projectKeys`.
+     */
+    projectIds?: string[];
+    /**
+     * List of project keys. This parameter accepts a comma-separated list. Multiple
+     * project keys can also be provided using an ampersand-separated list. For
+     * example, `projectKeys=proj1,proj2&projectKeys=proj3`. This parameter may be
+     * provided with `projectIds`.
+     */
+    projectKeys?: string[];
+    /**
+     * List of issue type IDs. This parameter accepts a comma-separated list. Multiple
+     * issue type IDs can also be provided using an ampersand-separated list. For
+     * example, `issuetypeIds=10000,10001&issuetypeIds=10020,10021`. This parameter
+     * may be provided with `issuetypeNames`.
+     */
+    issuetypeIds?: string[];
+    /**
+     * List of issue type names. This parameter accepts a comma-separated list.
+     * Multiple issue type names can also be provided using an ampersand-separated
+     * list. For example, `issuetypeNames=name1,name2&issuetypeNames=name3`. This
+     * parameter may be provided with `issuetypeIds`.
+     */
+    issuetypeNames?: string[];
+    /**
+     * Use [expand](#expansion) to include additional information about issue metadata
+     * in the response. This parameter accepts `projects.issuetypes.fields`, which
+     * returns information about the fields in the issue creation screen for each
+     * issue type. Fields hidden from the screen are not returned. Use the information
+     * to populate the `fields` and `update` fields in [Create
+     * issue](#api-rest-api-3-issue-post) and [Create
+     * issues](#api-rest-api-3-issue-bulk-post).
+     */
+    expand?: string;
+  }): Promise<IssueCreateMetadata> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue/createmeta",
+        method: "GET",
+        query: {
+          projectIds,
+          projectKeys,
+          issuetypeIds,
+          issuetypeNames,
+          expand,
+        },
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: IssueCreateMetadata;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "IssuesService.getCreateIssueMeta.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Returns a page of field metadata for a specified project and issuetype id. Use
+   * the information to populate the requests in [ Create
+   * issue](#api-rest-api-3-issue-post) and [Create
+   * issues](#api-rest-api-3-issue-bulk-post).
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:** *Create issues* [project
+   * permission](https://confluence.atlassian.com/x/yodKLg) in the requested
+   * projects.
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: {
+   *   "fields": [
+   *     {
+   *       "fieldId": "assignee",
+   *       "hasDefaultValue": false,
+   *       "key": "assignee",
+   *       "name": "Assignee",
+   *       "operations": [
+   *         "set"
+   *       ],
+   *       "required": true
+   *     }
+   *   ],
+   *   "maxResults": 1,
+   *   "startAt": 0,
+   *   "total": 1
+   * }
+   * @path {GET} /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes/{issueTypeId}
+   * @scopes-current read:jira-work
+   * @scopes-beta read:issue-meta:jira, read:avatar:jira, read:field-configuration:jira
+   */
+  getCreateIssueMetaIssueTypeId({
+    projectIdOrKey,
+    issueTypeId,
+    startAt,
+    maxResults,
+  }: {
+    /** The ID or key of the project. */
+    projectIdOrKey: string;
+    /** The issuetype ID. */
+    issueTypeId: 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;
+  }): Promise<PageOfCreateMetaIssueTypeWithField> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes/{issueTypeId}",
+        method: "GET",
+        pathParams: {
+          projectIdOrKey,
+          issueTypeId,
+        },
+        query: {
+          startAt,
+          maxResults,
+        },
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: PageOfCreateMetaIssueTypeWithField;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "IssuesService.getCreateIssueMetaIssueTypeId.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Returns a page of issue type metadata for a specified project. Use the
+   * information to populate the requests in [ Create
+   * issue](#api-rest-api-3-issue-post) and [Create
+   * issues](#api-rest-api-3-issue-bulk-post).
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:** *Create issues* [project
+   * permission](https://confluence.atlassian.com/x/yodKLg) in the requested
+   * projects.
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: {
+   *   "issueTypes": [
+   *     {
+   *       "description": "An error in the code",
+   *       "iconUrl":
+   * "https://your-domain.atlassian.net/images/icons/issuetypes/bug.png",
+   *       "id": "1",
+   *       "name": "Bug",
+   *       "self": "https://your-domain.atlassian.net/rest/api/3/issueType/1",
+   *       "subtask": false
+   *     }
+   *   ],
+   *   "maxResults": 1,
+   *   "startAt": 0,
+   *   "total": 1
+   * }
+   * @path {GET} /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes
+   * @scopes-current read:jira-work
+   * @scopes-beta read:issue-meta:jira, read:avatar:jira, read:field-configuration:jira
+   */
+  getCreateIssueMetaIssueTypes({
+    projectIdOrKey,
+    startAt,
+    maxResults,
+  }: {
+    /** The ID or key of the project. */
+    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;
+  }): Promise<PageOfCreateMetaIssueTypes> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes",
+        method: "GET",
+        pathParams: {
+          projectIdOrKey,
+        },
+        query: {
+          startAt,
+          maxResults,
+        },
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: PageOfCreateMetaIssueTypes;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "IssuesService.getCreateIssueMetaIssueTypes.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Returns the edit screen fields for an issue that are visible to and editable by
+   * the user. Use the information to populate the requests in [Edit
+   * issue](#api-rest-api-3-issue-issueIdOrKey-put).
+   *
+   * This endpoint will check for these conditions:
+   *
+   * 1.  Field is available on a field screen - through screen, screen scheme, issue
+   * type screen scheme, and issue type scheme configuration.
+   * `overrideScreenSecurity=true` skips this condition.
+   * 2.  Field is visible in the [field
+   * configuration](https://support.atlassian.com/jira-cloud-administration/docs/change-a-field-configuration/).
+   * `overrideScreenSecurity=true` skips this condition.
+   * 3.  Field is shown on the issue: each field has different conditions here. For
+   * example: Attachment field only shows if attachments are enabled. Assignee only
+   * shows if user has permissions to assign the issue.
+   * 4.  If a field is custom then it must have valid custom field context,
+   * applicable for its project and issue type. All system fields are assumed to
+   * have context in all projects and all issue types.
+   * 5.  Issue has a project, issue type, and status defined.
+   * 6.  Issue is assigned to a valid workflow, and the current status has assigned
+   * a workflow step. `overrideEditableFlag=true` skips this condition.
+   * 7.  The current workflow step is editable. This is true by default, but [can be
+   * disabled by
+   * setting](https://support.atlassian.com/jira-cloud-administration/docs/use-workflow-properties/)
+   * the `jira.issue.editable` property to `false`. `overrideEditableFlag=true`
+   * skips this condition.
+   * 8.  User has [Edit issues
+   * permission](https://support.atlassian.com/jira-cloud-administration/docs/permissions-for-company-managed-projects/).
+   * 9.  Workflow permissions allow editing a field. This is true by default but
+   * [can be
+   * modified](https://support.atlassian.com/jira-cloud-administration/docs/use-workflow-properties/)
+   * using `jira.permission.*` workflow properties.
+   *
+   * Fields hidden using [Issue layout settings
+   * page](https://support.atlassian.com/jira-software-cloud/docs/configure-field-layout-in-the-issue-view/)
+   * remain editable.
+   *
+   * Connect apps having an app user with *Administer Jira* [global
+   * permission](https://confluence.atlassian.com/x/x4dKLg), and Forge apps acting
+   * on behalf of users with *Administer Jira* [global
+   * permission](https://confluence.atlassian.com/x/x4dKLg), can return additional
+   * details using:
+   *
+   *  *  `overrideScreenSecurity` When this flag is `true`, then this endpoint skips
+   * checking if fields are available through screens, and field configuration
+   * (conditions 1. and 2. from the list above).
+   *  *  `overrideEditableFlag` When this flag is `true`, then this endpoint skips
+   * checking if workflow is present and if the current step is editable (conditions
+   * 6. and 7. from the list above).
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:**
+   *
+   *  *  *Browse projects* [project
+   * permission](https://confluence.atlassian.com/x/yodKLg) for the project that the
+   * issue is in.
+   *  *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is
+   * configured, issue-level security permission to view the issue.
+   *
+   * Note: For any fields to be editable the user must have the *Edit issues*
+   * [project permission](https://confluence.atlassian.com/x/yodKLg) for the issue.
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: {
+   *   "fields": {
+   *     "summary": {
+   *       "allowedValues": [
+   *         "red",
+   *         "blue"
+   *       ],
+   *       "defaultValue": "red",
+   *       "hasDefaultValue": false,
+   *       "key": "field_key",
+   *       "name": "My Multi Select",
+   *       "operations": [
+   *         "set",
+   *         "add"
+   *       ],
+   *       "required": false,
+   *       "schema": {
+   *         "custom":
+   * "com.atlassian.jira.plugin.system.customfieldtypes:multiselect",
+   *         "customId": 10001,
+   *         "items": "option",
+   *         "type": "array"
+   *       }
+   *     }
+   *   }
+   * }
+   * @path {GET} /rest/api/3/issue/{issueIdOrKey}/editmeta
+   * @scopes-current read:jira-work
+   * @scopes-beta read:issue-meta:jira, read:field-configuration:jira
+   */
+  getEditIssueMeta({
+    issueIdOrKey,
+    overrideScreenSecurity,
+    overrideEditableFlag,
+  }: {
+    /** The ID or key of the issue. */
+    issueIdOrKey: string;
+    /**
+     * Whether hidden fields are returned. Available to Connect app users with
+     * *Administer Jira* [global
+     * permission](https://confluence.atlassian.com/x/x4dKLg) and Forge apps acting on
+     * behalf of users with *Administer Jira* [global
+     * permission](https://confluence.atlassian.com/x/x4dKLg).
+     */
+    overrideScreenSecurity?: boolean;
+    /**
+     * Whether non-editable fields are returned. Available to Connect app users with
+     * *Administer Jira* [global
+     * permission](https://confluence.atlassian.com/x/x4dKLg) and Forge apps acting on
+     * behalf of users with *Administer Jira* [global
+     * permission](https://confluence.atlassian.com/x/x4dKLg).
+     */
+    overrideEditableFlag?: boolean;
+  }): Promise<IssueUpdateMetadata> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue/{issueIdOrKey}/editmeta",
+        method: "GET",
+        pathParams: {
+          issueIdOrKey,
+        },
+        query: {
+          overrideScreenSecurity,
+          overrideEditableFlag,
+        },
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: IssueUpdateMetadata;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "IssuesService.getEditIssueMeta.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Returns all issue events.
+   *
+   * **[Permissions](#permissions) required:** *Administer Jira* [global
+   * permission](https://confluence.atlassian.com/x/x4dKLg).
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: [
+   *   {
+   *     "id": 1,
+   *     "name": "Issue Created"
+   *   },
+   *   {
+   *     "id": 2,
+   *     "name": "Issue Updated"
+   *   }
+   * ]
+   * @path {GET} /rest/api/3/events
+   * @scopes-current manage:jira-configuration
+   * @scopes-beta read:issue-event:jira
+   */
+  getEvents(): Promise<IssueEvent[]> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/events",
+        method: "GET",
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: IssueEvent[];
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator("IssuesService.getEvents.response"),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Returns the details for an issue.
+   *
+   * The issue is identified by its ID or key, however, if the identifier doesn't
+   * match an issue, a case-insensitive search and check for moved issues is
+   * performed. If a matching issue is found its details are returned, a 302 or
+   * other redirect is **not** returned. The issue key returned in the response is
+   * the key of the issue found.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required:**
+   *
+   *  *  *Browse projects* [project
+   * permission](https://confluence.atlassian.com/x/yodKLg) for the project that the
+   * issue is in.
+   *  *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is
+   * configured, issue-level security permission to view the issue.
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: {
+   *   "fields": {
+   *     "watcher": {
+   *       "isWatching": false,
+   *       "self":
+   * "https://your-domain.atlassian.net/rest/api/3/issue/EX-1/watchers",
+   *       "watchCount": 1,
+   *       "watchers": [
+   *         {
+   *           "accountId": "5b10a2844c20165700ede21g",
+   *           "active": false,
+   *           "displayName": "Mia Krystof",
+   *           "self":
+   * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
+   *         }
+   *       ]
+   *     },
+   *     "attachment": [
+   *       {
+   *         "author": {
+   *           "accountId": "5b10a2844c20165700ede21g",
+   *           "accountType": "atlassian",
+   *           "active": false,
+   *           "avatarUrls": {
+   *             "16x16":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16&s=16",
+   *             "24x24":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24&s=24",
+   *             "32x32":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32&s=32",
+   *             "48x48":
+   * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48&s=48"
+   *           },
+   *           "displayName": "Mia Krystof",
+   *           "key": "",
+   *           "name": "",
+   *           "self":
+   * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
+   *         },
+   *         "content":
+   * "https://your-domain.atlassian.net/jira/rest/api/3/attachment/content/10000",
+   *         "created": "2022-10-06T07:32:47.000+0000",
+   *         "filename": "picture.jpg",
+   *         "id": 10000,
+   *         "mimeType": "image/jpeg",
+   *         "self":
+   * "https://your-domain.atlassian.net/rest/api/3/attachments/10000",
+   *         "size": 23123,
+   *         "thumbnail":
+   * "https://your-domain.atlassian.net/jira/rest/api/3/attachment/thumbnail/10000"
+   *       }
+   *     ],
+   *     "sub-tasks": [
+   *       {
+   *         "id": "10000",
+   *         "outwardIssue": {
+   *           "fields": {
+   *             "status": {
+   *               "iconUrl":
+   * "https://your-domain.atlassian.net/images/icons/statuses/open.png",
+   *               "name": "Open"
+   *             }
+   *           },
+   *           "id": "10003",
+   *           "key": "ED-2",
+   *           "self": "https://your-domain.atlassian.net/rest/api/3/issue/ED-2"
+   *         },
+   *         "type": {
+   *           "id": "10000",
+   *           "inward": "Parent",
+   *           "name": "",
+   *           "outward": "Sub-task"
+   *         }
+   *       }
+   *     ],
+   *     "description": {
+   *       "type": "doc",
+   *       "version": 1,
+   *       "content": [
+   *         {
+   *           "type": "paragraph",
+   *           "content": [
+   *             {
+   *               "type": "text",
+   *               "text": "Main order flow broken"
+   *             }
+   *           ]
+   *         }
+   *       ]
+   *     },
+   *     "project": {
+   *       "avatarUrls": {
+   *         "16x16":
+   * "https://your-domain.atlassian.net/secure/projectavatar?size=xsmall&pid=10000",
+   *         "24x24":
+   * "https://your-domain.atlassian.net/secure/projectavatar?size=small&pid=10000",
+   *         "32x32":
+   * "https://your-domain.atlassian.net/secure/projectavatar?size=medium&pid=10000",
+   *         "48x48":
+   * "https://your-domain.atlassian.net/secure/projectavatar?size=large&pid=10000"
+   *       },
+   *       "id": "10000",
+   *       "insight": {
+   *         "lastIssueUpdateTime": "2021-04-22T05:37:05.000+0000",
+   *         "totalIssueCount": 100
+   *       },
+   *       "key": "EX",
+   *       "name": "Example",
+   *       "projectCategory": {
+   *         "description": "First Project Category",
+   *         "id": "10000",
+   *         "name": "FIRST",
+   *         "self":
+   * "https://your-domain.atlassian.net/rest/api/3/projectCategory/10000"
+   *       },
+   *       "self": "https://your-domain.atlassian.net/rest/api/3/project/EX",
+   *       "simplified": false,
+   *       "style": "classic"
+   *     },
+   *     "comment": [
+   *       {
+   *         "author": {
+   *           "accountId": "5b10a2844c20165700ede21g",
+   *           "active": false,
+   *           "displayName": "Mia Krystof",
+   *           "self":
+   * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
+   *         },
+   *         "body": {
+   *           "type": "doc",
+   *           "version": 1,
+   *           "content": [
+   *             {
+   *               "type": "paragraph",
+   *               "content": [
+   *                 {
+   *                   "type": "text",
+   *                   "text": "Lorem ipsum dolor sit amet, consectetur adipiscing
+   * elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis
+   * fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper."
+   *                 }
+   *               ]
+   *             }
+   *           ]
+   *         },
+   *         "created": "2021-01-17T12:34:00.000+0000",
+   *         "id": "10000",
+   *         "self":
+   * "https://your-domain.atlassian.net/rest/api/3/issue/10010/comment/10000",
+   *         "updateAuthor": {
+   *           "accountId": "5b10a2844c20165700ede21g",
+   *           "active": false,
+   *           "displayName": "Mia Krystof",
+   *           "self":
+   * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
+   *         },
+   *         "updated": "2021-01-18T23:45:00.000+0000",
+   *         "visibility": {
+   *           "identifier": "Administrators",
+   *           "type": "role",
+   *           "value": "Administrators"
+   *         }
+   *       }
+   *     ],
+   *     "issuelinks": [
+   *       {
+   *         "id": "10001",
+   *         "outwardIssue": {
+   *           "fields": {
+   *             "status": {
+   *               "iconUrl":
+   * "https://your-domain.atlassian.net/images/icons/statuses/open.png",
+   *               "name": "Open"
+   *             }
+   *           },
+   *           "id": "10004L",
+   *           "key": "PR-2",
+   *           "self": "https://your-domain.atlassian.net/rest/api/3/issue/PR-2"
+   *         },
+   *         "type": {
+   *           "id": "10000",
+   *           "inward": "depends on",
+   *           "name": "Dependent",
+   *           "outward": "is depended by"
+   *         }
+   *       },
+   *       {
+   *         "id": "10002",
+   *         "inwardIssue": {
+   *           "fields": {
+   *             "status": {
+   *               "iconUrl":
+   * "https://your-domain.atlassian.net/images/icons/statuses/open.png",
+   *               "name": "Open"
+   *             }
+   *           },
+   *           "id": "10004",
+   *           "key": "PR-3",
+   *           "self": "https://your-domain.atlassian.net/rest/api/3/issue/PR-3"
+   *         },
+   *         "type": {
+   *           "id": "10000",
+   *           "inward": "depends on",
+   *           "name": "Dependent",
+   *           "outward": "is depended by"
+   *         }
+   *       }
+   *     ],
+   *     "worklog": [
+   *       {
+   *         "author": {
+   *           "accountId": "5b10a2844c20165700ede21g",
+   *           "active": false,
+   *           "displayName": "Mia Krystof",
+   *           "self":
+   * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
+   *         },
+   *         "comment": {
+   *           "type": "doc",
+   *           "version": 1,
+   *           "content": [
+   *             {
+   *               "type": "paragraph",
+   *               "content": [
+   *                 {
+   *                   "type": "text",
+   *                   "text": "I did some work here."
+   *                 }
+   *               ]
+   *             }
+   *           ]
+   *         },
+   *         "id": "100028",
+   *         "issueId": "10002",
+   *         "self":
+   * "https://your-domain.atlassian.net/rest/api/3/issue/10010/worklog/10000",
+   *         "started": "2021-01-17T12:34:00.000+0000",
+   *         "timeSpent": "3h 20m",
+   *         "timeSpentSeconds": 12000,
+   *         "updateAuthor": {
+   *           "accountId": "5b10a2844c20165700ede21g",
+   *           "active": false,
+   *           "displayName": "Mia Krystof",
+   *           "self":
+   * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
+   *         },
+   *         "updated": "2021-01-18T23:45:00.000+0000",
+   *         "visibility": {
+   *           "identifier": "276f955c-63d7-42c8-9520-92d01dca0625",
+   *           "type": "group",
+   *           "value": "jira-developers"
+   *         }
+   *       }
+   *     ],
+   *     "updated": 1,
+   *     "timetracking": {
+   *       "originalEstimate": "10m",
+   *       "originalEstimateSeconds": 600,
+   *       "remainingEstimate": "3m",
+   *       "remainingEstimateSeconds": 200,
+   *       "timeSpent": "6m",
+   *       "timeSpentSeconds": 400
+   *     }
+   *   },
+   *   "id": "10002",
+   *   "key": "ED-1",
+   *   "self": "https://your-domain.atlassian.net/rest/api/3/issue/10002"
+   * }
+   * @path {GET} /rest/api/3/issue/{issueIdOrKey}
+   * @scopes-current read:jira-work
+   * @scopes-beta read:issue-meta:jira, read:issue-security-level:jira, read:issue.vote:jira,
+   * read:issue.changelog:jira, read:avatar:jira, read:issue:jira, read:status:jira,
+   * read:user:jira, read:field-configuration:jira
+   */
+  getIssue({
+    issueIdOrKey,
+    fields,
+    fieldsByKeys,
+    expand,
+    properties,
+    updateHistory,
+  }: {
+    /** The ID or key of the issue. */
+    issueIdOrKey: string;
+    /**
+     * A list of fields to return for the issue. This parameter accepts a
+     * comma-separated list. Use it to retrieve a subset of fields. Allowed values:
+     *
+     *  *  `*all` Returns all fields.
+     *  *  `*navigable` Returns navigable fields.
+     *  *  Any issue field, prefixed with a minus to exclude.
+     *
+     * Examples:
+     *
+     *  *  `summary,comment` Returns only the summary and comments fields.
+     *  *  `-description` Returns all (default) fields except description.
+     *  *  `*navigable,-comment` Returns all navigable fields except comment.
+     *
+     * This parameter may be specified multiple times. For example,
+     * `fields=field1,field2& fields=field3`.
+     *
+     * Note: All fields are returned by default. This differs from [Search for issues
+     * using JQL (GET)](#api-rest-api-3-search-get) and [Search for issues using JQL
+     * (POST)](#api-rest-api-3-search-post) where the default is all navigable fields.
+     */
+    fields?: string[];
+    /**
+     * Whether fields in `fields` are referenced by keys rather than IDs. This
+     * parameter is useful where fields have been added by a connect app and a field's
+     * key may differ from its ID.
+     */
+    fieldsByKeys?: boolean;
+    /**
+     * Use [expand](#expansion) to include additional information about the issues in
+     * the response. This parameter accepts a comma-separated list. Expand options
+     * include:
+     *
+     *  *  `renderedFields` Returns field values rendered in HTML format.
+     *  *  `names` Returns the display name of each field.
+     *  *  `schema` Returns the schema describing a field type.
+     *  *  `transitions` Returns all possible transitions for the issue.
+     *  *  `editmeta` Returns information about how each field can be edited.
+     *  *  `changelog` Returns a list of recent updates to an issue, sorted by date,
+     * starting from the most recent.
+     *  *  `versionedRepresentations` Returns a JSON array for each version of a
+     * field's value, with the highest number representing the most recent version.
+     * Note: When included in the request, the `fields` parameter is ignored.
+     */
+    expand?: string;
+    /**
+     * A list of issue properties to return for the issue. This parameter accepts a
+     * comma-separated list. Allowed values:
+     *
+     *  *  `*all` Returns all issue properties.
+     *  *  Any issue property key, prefixed with a minus to exclude.
+     *
+     * Examples:
+     *
+     *  *  `*all` Returns all properties.
+     *  *  `*all,-prop1` Returns all properties except `prop1`.
+     *  *  `prop1,prop2` Returns `prop1` and `prop2` properties.
+     *
+     * This parameter may be specified multiple times. For example,
+     * `properties=prop1,prop2& properties=prop3`.
+     */
+    properties?: string[];
+    /**
+     * Whether the project in which the issue is created is added to the user's
+     * **Recently viewed** project list, as shown under **Projects** in Jira. This
+     * also populates the [JQL issues search](#api-rest-api-3-search-get) `lastViewed`
+     * field.
+     */
+    updateHistory?: boolean;
+  }): Promise<IssueBean> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue/{issueIdOrKey}",
+        method: "GET",
+        pathParams: {
+          issueIdOrKey,
+        },
+        query: {
+          fields,
+          fieldsByKeys,
+          expand,
+          properties,
+          updateHistory,
+        },
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: IssueBean;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator("IssuesService.getIssue.response"),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Returns all issues breaching and approaching per-issue limits.
+   *
+   * **[Permissions](#permissions) required:**
+   *
+   *  *  *Browse projects* [project
+   * permission](https://confluence.atlassian.com/x/yodKLg) is required for the
+   * project the issues are in. Results may be incomplete otherwise
+   *  *  *Administer Jira* [global
+   * permission](https://confluence.atlassian.com/x/x4dKLg).
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: {
+   *   "issuesApproachingLimit": {
+   *     "attachment": {
+   *       "15070": 1822,
+   *       "15111": 1999
+   *     },
+   *     "comment": {
+   *       "10000": 4997,
+   *       "15073": 4999,
+   *       "15110": 5000
+   *     },
+   *     "remoteIssueLinks": {
+   *       "15107": 2000
+   *     },
+   *     "worklog": {
+   *       "15101": 4342
+   *     }
+   *   },
+   *   "issuesBreachingLimit": {
+   *     "attachment": {
+   *       "15057": 2005,
+   *       "15116": 2065,
+   *       "15117": 3005
+   *     },
+   *     "comment": {
+   *       "15055": 5202
+   *     },
+   *     "issuelinks": {
+   *       "15058": 2120
+   *     },
+   *     "remoteIssueLinks": {
+   *       "15059": 2094
+   *     },
+   *     "worklog": {
+   *       "15056": 5085,
+   *       "15169": 120864
+   *     }
+   *   },
+   *   "limits": {
+   *     "attachment": 2000,
+   *     "comment": 5000,
+   *     "issuelinks": 2000,
+   *     "remoteIssueLinks": 2000,
+   *     "worklog": 5000
+   *   }
+   * }
+   * @path {GET} /rest/api/3/issue/limit/report
+   * @scopes-current read:jira-work
+   * @scopes-beta read:project:jira, read:issue:jira
+   */
+  getIssueLimitReport({
+    issueLimitReportRequest,
+  }: {
+    issueLimitReportRequest: IssueLimitReportRequest;
+  }): Promise<IssueLimitReportResponseBean> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue/limit/report",
+        method: "GET",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: issueLimitReportRequest,
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: IssueLimitReportResponseBean;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "IssuesService.getIssueLimitReport.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Returns either all transitions or a transition that can be performed by the
+   * user on an issue, based on the issue's status.
+   *
+   * Note, if a request is made for a transition that does not exist or cannot be
+   * performed on the issue, given its status, the response will return any empty
+   * transitions list.
+   *
+   * This operation can be accessed anonymously.
+   *
+   * **[Permissions](#permissions) required: A list or transition is returned only
+   * when the user has:**
+   *
+   *  *  *Browse projects* [project
+   * permission](https://confluence.atlassian.com/x/yodKLg) for the project that the
+   * issue is in.
+   *  *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is
+   * configured, issue-level security permission to view the issue.
+   *
+   * However, if the user does not have the *Transition issues* [ project
+   * permission](https://confluence.atlassian.com/x/yodKLg) the response will not
+   * list any transitions.
+   *
+   * @returns Returned if the request is successful.
+   *
+   * example: {
+   *   "transitions": [
+   *     {
+   *       "fields": {
+   *         "summary": {
+   *           "allowedValues": [
+   *             "red",
+   *             "blue"
+   *           ],
+   *           "defaultValue": "red",
+   *           "hasDefaultValue": false,
+   *           "key": "field_key",
+   *           "name": "My Multi Select",
+   *           "operations": [
+   *             "set",
+   *             "add"
+   *           ],
+   *           "required": false,
+   *           "schema": {
+   *             "custom":
+   * "com.atlassian.jira.plugin.system.customfieldtypes:multiselect",
+   *             "customId": 10001,
+   *             "items": "option",
+   *             "type": "array"
+   *           }
+   *         }
+   *       },
+   *       "hasScreen": false,
+   *       "id": "2",
+   *       "isAvailable": true,
+   *       "isConditional": false,
+   *       "isGlobal": false,
+   *       "isInitial": false,
+   *       "name": "Close Issue",
+   *       "to": {
+   *         "description": "The issue is currently being worked on.",
+   *         "iconUrl":
+   * "https://your-domain.atlassian.net/images/icons/progress.gif",
+   *         "id": "10000",
+   *         "name": "In Progress",
+   *         "self": "https://your-domain.atlassian.net/rest/api/3/status/10000",
+   *         "statusCategory": {
+   *           "colorName": "yellow",
+   *           "id": 1,
+   *           "key": "in-flight",
+   *           "name": "In Progress",
+   *           "self":
+   * "https://your-domain.atlassian.net/rest/api/3/statuscategory/1"
+   *         }
+   *       }
+   *     },
+   *     {
+   *       "fields": {
+   *         "summary": {
+   *           "allowedValues": [
+   *             "red",
+   *             "blue"
+   *           ],
+   *           "defaultValue": "red",
+   *           "hasDefaultValue": false,
+   *           "key": "field_key",
+   *           "name": "My Multi Select",
+   *           "operations": [
+   *             "set",
+   *             "add"
+   *           ],
+   *           "required": false,
+   *           "schema": {
+   *             "custom":
+   * "com.atlassian.jira.plugin.system.customfieldtypes:multiselect",
+   *             "customId": 10001,
+   *             "items": "option",
+   *             "type": "array"
+   *           }
+   *         },
+   *         "colour": {
+   *           "allowedValues": [
+   *             "red",
+   *             "blue"
+   *           ],
+   *           "defaultValue": "red",
+   *           "hasDefaultValue": false,
+   *           "key": "field_key",
+   *           "name": "My Multi Select",
+   *           "operations": [
+   *             "set",
+   *             "add"
+   *           ],
+   *           "required": false,
+   *           "schema": {
+   *             "custom":
+   * "com.atlassian.jira.plugin.system.customfieldtypes:multiselect",
+   *             "customId": 10001,
+   *             "items": "option",
+   *             "type": "array"
+   *           }
+   *         }
+   *       },
+   *       "hasScreen": true,
+   *       "id": "711",
+   *       "name": "QA Review",
+   *       "to": {
+   *         "description": "The issue is closed.",
+   *         "iconUrl": "https://your-domain.atlassian.net/images/icons/closed.gif",
+   *         "id": "5",
+   *         "name": "Closed",
+   *         "self": "https://your-domain.atlassian.net/rest/api/3/status/5",
+   *         "statusCategory": {
+   *           "colorName": "green",
+   *           "id": 9,
+   *           "key": "completed",
+   *           "self":
+   * "https://your-domain.atlassian.net/rest/api/3/statuscategory/9"
+   *         }
+   *       }
+   *     }
+   *   ]
+   * }
+   * @path {GET} /rest/api/3/issue/{issueIdOrKey}/transitions
+   * @scopes-current read:jira-work
+   * @scopes-beta read:issue.transition:jira, read:status:jira, read:field-configuration:jira
+   */
+  getTransitions({
+    issueIdOrKey,
+    expand,
+    transitionId,
+    skipRemoteOnlyCondition,
+    includeUnavailableTransitions,
+    sortByOpsBarAndStatus,
+  }: {
+    /** The ID or key of the issue. */
+    issueIdOrKey: string;
+    /**
+     * Use [expand](#expansion) to include additional information about transitions in
+     * the response. This parameter accepts `transitions.fields`, which returns
+     * information about the fields in the transition screen for each transition.
+     * Fields hidden from the screen are not returned. Use this information to
+     * populate the `fields` and `update` fields in [Transition
+     * issue](#api-rest-api-3-issue-issueIdOrKey-transitions-post).
+     */
+    expand?: string;
+    /** The ID of the transition. */
+    transitionId?: string;
+    /**
+     * Whether transitions with the condition *Hide From User Condition* are included
+     * in the response.
+     */
+    skipRemoteOnlyCondition?: boolean;
+    /**
+     * Whether details of transitions that fail a condition are included in the
+     * response
+     */
+    includeUnavailableTransitions?: boolean;
+    /**
+     * Whether the transitions are sorted by ops-bar sequence value first then
+     * category order (Todo, In Progress, Done) or only by ops-bar sequence value.
+     */
+    sortByOpsBarAndStatus?: boolean;
+  }): Promise<Transitions> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue/{issueIdOrKey}/transitions",
+        method: "GET",
+        pathParams: {
+          issueIdOrKey,
+        },
+        query: {
+          expand,
+          transitionId,
+          skipRemoteOnlyCondition,
+          includeUnavailableTransitions,
+          sortByOpsBarAndStatus,
+        },
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: Transitions;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "IssuesService.getTransitions.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Creates an email notification for an issue and adds it to the mail queue.
+   *
+   * **[Permissions](#permissions) required:**
+   *
+   *  *  *Browse Projects* [project
+   * permission](https://confluence.atlassian.com/x/yodKLg) for the project that the
+   * issue is in.
+   *  *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is
+   * configured, issue-level security permission to view the issue.
+   *
+   * @returns Returned if the email is queued for sending.
+   * @path {POST} /rest/api/3/issue/{issueIdOrKey}/notify
+   * @scopes-current write:jira-work
+   * @scopes-beta send:notification:jira
+   */
+  notify({
+    issueIdOrKey,
+    notification,
+  }: {
+    /** ID or key of the issue that the notification is sent for. */
+    issueIdOrKey: string;
+    /**
+     * The request object for the notification and recipients.
+     *
+     * @example {
+     *     "htmlBody": "The <strong>latest</strong> test results for this ticket are
+     * now available.",
+     *     "restrict": {
+     *         "groupIds": [],
+     *         "groups": [
+     *             {
+     *                 "name": "notification-group"
+     *             }
+     *         ],
+     *         "permissions": [
+     *             {
+     *                 "key": "BROWSE"
+     *             }
+     *         ]
+     *     },
+     *     "subject": "Latest test results",
+     *     "textBody": "The latest test results for this ticket are now available.",
+     *     "to": {
+     *         "assignee": false,
+     *         "groupIds": [],
+     *         "groups": [
+     *             {
+     *                 "name": "notification-group"
+     *             }
+     *         ],
+     *         "reporter": false,
+     *         "users": [
+     *             {
+     *                 "accountId": "5b10a2844c20165700ede21g",
+     *                 "active": false
+     *             }
+     *         ],
+     *         "voters": true,
+     *         "watchers": true
+     *     }
+     * }
+     */
+    notification: Notification;
+  }): Promise<void> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue/{issueIdOrKey}/notify",
+        method: "POST",
+        pathParams: {
+          issueIdOrKey,
+        },
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: notification,
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          204: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 204;
+          mediaType: "application/json";
+          body: void;
+        }>(),
+      )
+      .then(validationSchemaStorage.validator("IssuesService.notify.response"))
+      .then(commonHttpClient.getBody);
+  }
+  /**
+   * Enables admins to unarchive up to 1000 issues in a single request using issue
+   * ID/key, returning details of the issue(s) unarchived in the process and the
+   * errors encountered, if any.
+   *
+   * **Note that:**
+   *
+   *  *  you can't unarchive subtasks directly, only through their parent issues
+   *  *  you can only unarchive issues from software, service management, and
+   * business projects
+   *
+   * **[Permissions](#permissions) required:** Jira admin or site admin: [global
+   * permission](https://confluence.atlassian.com/x/x4dKLg)
+   *
+   * **License required:** Premium or Enterprise
+   *
+   * **Signed-in users only:** This API can't be accessed anonymously.
+   *
+   * @returns Returned if there is at least one valid issue to unarchive in the request. It
+   * will return the count of unarchived issues, which also includes the count of
+   * the subtasks unarchived, and it will show the detailed errors for those issues
+   * which are not unarchived.
+   *
+   * example: {
+   *   "errors": {
+   *     "issueIsSubtask": {
+   *       "count": 3,
+   *       "issueIdsOrKeys": [
+   *         "ST-1",
+   *         "ST-2",
+   *         "ST-3"
+   *       ],
+   *       "message": "Issue is subtask."
+   *     },
+   *     "issuesInArchivedProjects": {
+   *       "count": 2,
+   *       "issueIdsOrKeys": [
+   *         "AR-1",
+   *         "AR-2"
+   *       ],
+   *       "message": "Issue exists in archived project."
+   *     },
+   *     "issuesNotFound": {
+   *       "count": 3,
+   *       "issueIdsOrKeys": [
+   *         "PR-1",
+   *         "PR-2",
+   *         "PR-3"
+   *       ],
+   *       "message": "Issue not found."
+   *     }
+   *   },
+   *   "numberOfIssuesUpdated": 10
+   * }
+   * @path {PUT} /rest/api/3/issue/unarchive
+   * @scopes-current write:jira-work
+   * @scopes-beta write:issue:jira
+   */
+  unarchiveIssues({
+    issueArchivalSyncRequest,
+  }: {
+    /**
+     * Contains a list of issue keys or IDs to be unarchived.
+     *
+     * @example {
+     *     "issueIdsOrKeys": [
+     *         "PR-1",
+     *         "1001",
+     *         "PROJECT-2"
+     *     ]
+     * }
+     */
+    issueArchivalSyncRequest: IssueArchivalSyncRequest;
+  }): Promise<IssueArchivalSyncResponse> {
+    return this.getClientInstance()
+      .request({
+        path: "/rest/api/3/issue/unarchive",
+        method: "PUT",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: issueArchivalSyncRequest,
+      })
+      .then(
+        this.getClientInstance().responseHandler({
+          200: {
+            "application/json": "json",
+          },
+        }),
+      )
+      .then(
+        commonHttpClient.castResponse<{
+          status: 200;
+          mediaType: "application/json";
+          body: IssueArchivalSyncResponse;
+        }>(),
+      )
+      .then(
+        validationSchemaStorage.validator(
+          "IssuesService.unarchiveIssues.response",
+        ),
+      )
+      .then(commonHttpClient.getBody);
+  }
+  static initialize() {
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.getEvents.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: z.array(validationSchemaStorage.lazy("IssueEvent")),
+        })
+        .describe("IssuesService.getEvents.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.createIssue.response",
+      z
+        .object({
+          status: z.literal(201),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("CreatedIssue"),
+        })
+        .describe("IssuesService.createIssue.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.getIssue.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("IssueBean"),
+        })
+        .describe("IssuesService.getIssue.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.editIssue.response",
+      z
+        .object({
+          status: z.number(),
+          mediaType: z.string(),
+          body: z.unknown(),
+        })
+        .superRefine(({ status: status, body: body }, ctx) => {
+          if (status === 200 || status === 204) {
+            z.unknown().parse(body);
+          } else {
+            ctx.addIssue({
+              code: z.ZodIssueCode.custom,
+              path: ["status"],
+              message: `Unexpected status code: ${status}`,
+            });
+          }
+        })
+        .describe("IssuesService.editIssue.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.assignIssue.response",
+      z
+        .object({
+          status: z.literal(204),
+          mediaType: z.literal("application/json"),
+          body: z.unknown(),
+        })
+        .describe("IssuesService.assignIssue.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.getChangeLogs.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("PageBeanChangelog"),
+        })
+        .describe("IssuesService.getChangeLogs.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.getChangeLogsByIds.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("PageOfChangelogs"),
+        })
+        .describe("IssuesService.getChangeLogsByIds.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.getEditIssueMeta.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("IssueUpdateMetadata"),
+        })
+        .describe("IssuesService.getEditIssueMeta.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.notify.response",
+      z
+        .object({
+          status: z.literal(204),
+          mediaType: z.literal("application/json"),
+          body: z.unknown(),
+        })
+        .describe("IssuesService.notify.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.getTransitions.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("Transitions"),
+        })
+        .describe("IssuesService.getTransitions.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.doTransition.response",
+      z
+        .object({
+          status: z.literal(204),
+          mediaType: z.literal("application/json"),
+          body: z.unknown(),
+        })
+        .describe("IssuesService.doTransition.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.archiveIssues.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("IssueArchivalSyncResponse"),
+        })
+        .describe("IssuesService.archiveIssues.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.archiveIssuesAsync.response",
+      z
+        .object({
+          status: z.literal(202),
+          mediaType: z.literal("application/json"),
+          body: z.string(),
+        })
+        .describe("IssuesService.archiveIssuesAsync.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.createIssues.response",
+      z
+        .object({
+          status: z.literal(201),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("CreatedIssues"),
+        })
+        .describe("IssuesService.createIssues.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.getCreateIssueMeta.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("IssueCreateMetadata"),
+        })
+        .describe("IssuesService.getCreateIssueMeta.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.getCreateIssueMetaIssueTypes.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("PageOfCreateMetaIssueTypes"),
+        })
+        .describe("IssuesService.getCreateIssueMetaIssueTypes.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.getCreateIssueMetaIssueTypeId.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy(
+            "PageOfCreateMetaIssueTypeWithField",
+          ),
+        })
+        .describe("IssuesService.getCreateIssueMetaIssueTypeId.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.getIssueLimitReport.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("IssueLimitReportResponseBean"),
+        })
+        .describe("IssuesService.getIssueLimitReport.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.unarchiveIssues.response",
+      z
+        .object({
+          status: z.literal(200),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy("IssueArchivalSyncResponse"),
+        })
+        .describe("IssuesService.unarchiveIssues.response"),
+    );
+    validationSchemaStorage.registerExtensible(
+      "IssuesService.exportArchivedIssues.response",
+      z
+        .object({
+          status: z.literal(202),
+          mediaType: z.literal("application/json"),
+          body: validationSchemaStorage.lazy(
+            "ExportArchivedIssuesTaskProgressResponse",
+          ),
+        })
+        .describe("IssuesService.exportArchivedIssues.response"),
+    );
+    validationSchemaStorage.registerOnce([
+      registerIssuesValidationSchemas,
+      registerCommonValidationSchemas,
+    ]);
+  }
+}