jira.js
    Preparing search index...

    Function createIssue

    • 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. 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 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 required: Browse projects and Create issues project permissions for the project in which the issue or subtask is created.

      Parameters

      • client: Client
      • parameters: {
            fields?: Record<string, any>;
            historyMetadata?: {
                activityDescription?: string;
                activityDescriptionKey?: string;
                actor?: {
                    avatarUrl?: string;
                    displayName?: string;
                    displayNameKey?: string;
                    id?: string;
                    type?: string;
                    url?: string;
                    [key: string]: unknown;
                };
                cause?: {
                    avatarUrl?: string;
                    displayName?: string;
                    displayNameKey?: string;
                    id?: string;
                    type?: string;
                    url?: string;
                    [key: string]: unknown;
                };
                description?: string;
                descriptionKey?: string;
                emailDescription?: string;
                emailDescriptionKey?: string;
                extraData?: Record<string, any>;
                generator?: {
                    avatarUrl?: string;
                    displayName?: string;
                    displayNameKey?: string;
                    id?: string;
                    type?: string;
                    url?: string;
                    [key: string]: unknown;
                };
                type?: string;
                [key: string]: unknown;
            };
            properties?: { key?: string; value?: unknown; [key: string]: unknown }[];
            transition?: {
                expand?: string;
                fields?: Record<string, any>;
                hasScreen?: boolean;
                id?: string;
                isAvailable?: boolean;
                isConditional?: boolean;
                isGlobal?: boolean;
                isInitial?: boolean;
                looped?: boolean;
                name?: string;
                to?: {
                    description?: string;
                    iconUrl?: string;
                    id?: string;
                    name?: string;
                    scope?: {
                        project?: {
                            avatarUrls?: {
                                "16x16"?: ...;
                                "24x24"?: ...;
                                "32x32"?: ...;
                                "48x48"?: ...;
                                [key: ...]: ...;
                            };
                            id?: string;
                            key?: string;
                            name?: string;
                            projectCategory?: {
                                description?: ...;
                                id?: ...;
                                name?: ...;
                                self?: ...;
                                [key: ...]: ...;
                            };
                            projectTypeKey?: | (...) & (...)
                            | "software"
                            | "service_desk"
                            | "business"
                            | "product_discovery"
                            | "customer_service";
                            self?: string;
                            simplified?: boolean;
                            [key: string]: unknown;
                        };
                        type?: string & {}
                        | "PROJECT"
                        | "TEMPLATE";
                        [key: string]: unknown;
                    };
                    self?: string;
                    statusCategory?: {
                        colorName?: string;
                        id?: number;
                        key?: string;
                        name?: string;
                        self?: string;
                        [key: string]: unknown;
                    };
                    untranslatedName?: string;
                    [key: string]: unknown;
                };
                [key: string]: unknown;
            };
            update?: Record<string, any>;
            updateHistory?: boolean;
        }
        • Optionalfields?: Record<string, any>

          List of issue screen fields to update, specifying the sub-field to update and its value for each field. This field provides a straightforward option when setting a sub-field. When multiple sub-fields or other operations are required, use update. Fields included in here cannot be included in update.

        • OptionalhistoryMetadata?: {
              activityDescription?: string;
              activityDescriptionKey?: string;
              actor?: {
                  avatarUrl?: string;
                  displayName?: string;
                  displayNameKey?: string;
                  id?: string;
                  type?: string;
                  url?: string;
                  [key: string]: unknown;
              };
              cause?: {
                  avatarUrl?: string;
                  displayName?: string;
                  displayNameKey?: string;
                  id?: string;
                  type?: string;
                  url?: string;
                  [key: string]: unknown;
              };
              description?: string;
              descriptionKey?: string;
              emailDescription?: string;
              emailDescriptionKey?: string;
              extraData?: Record<string, any>;
              generator?: {
                  avatarUrl?: string;
                  displayName?: string;
                  displayNameKey?: string;
                  id?: string;
                  type?: string;
                  url?: string;
                  [key: string]: unknown;
              };
              type?: string;
              [key: string]: unknown;
          }
          • OptionalactivityDescription?: string

            The activity described in the history record.

          • OptionalactivityDescriptionKey?: string

            The key of the activity described in the history record.

          • Optionalactor?: {
                avatarUrl?: string;
                displayName?: string;
                displayNameKey?: string;
                id?: string;
                type?: string;
                url?: string;
                [key: string]: unknown;
            }
            • OptionalavatarUrl?: string

              The URL to an avatar for the user or system associated with a history record.

            • OptionaldisplayName?: string

              The display name of the user or system associated with a history record.

            • OptionaldisplayNameKey?: string

              The key of the display name of the user or system associated with a history record.

            • Optionalid?: string

              The ID of the user or system associated with a history record.

            • Optionaltype?: string

              The type of the user or system associated with a history record.

            • Optionalurl?: string

              The URL of the user or system associated with a history record.

          • Optionalcause?: {
                avatarUrl?: string;
                displayName?: string;
                displayNameKey?: string;
                id?: string;
                type?: string;
                url?: string;
                [key: string]: unknown;
            }
            • OptionalavatarUrl?: string

              The URL to an avatar for the user or system associated with a history record.

            • OptionaldisplayName?: string

              The display name of the user or system associated with a history record.

            • OptionaldisplayNameKey?: string

              The key of the display name of the user or system associated with a history record.

            • Optionalid?: string

              The ID of the user or system associated with a history record.

            • Optionaltype?: string

              The type of the user or system associated with a history record.

            • Optionalurl?: string

              The URL of the user or system associated with a history record.

          • Optionaldescription?: string

            The description of the history record.

          • OptionaldescriptionKey?: string

            The description key of the history record.

          • OptionalemailDescription?: string

            The description of the email address associated the history record.

          • OptionalemailDescriptionKey?: string

            The description key of the email address associated the history record.

          • OptionalextraData?: Record<string, any>

            Additional arbitrary information about the history record.

          • Optionalgenerator?: {
                avatarUrl?: string;
                displayName?: string;
                displayNameKey?: string;
                id?: string;
                type?: string;
                url?: string;
                [key: string]: unknown;
            }
            • OptionalavatarUrl?: string

              The URL to an avatar for the user or system associated with a history record.

            • OptionaldisplayName?: string

              The display name of the user or system associated with a history record.

            • OptionaldisplayNameKey?: string

              The key of the display name of the user or system associated with a history record.

            • Optionalid?: string

              The ID of the user or system associated with a history record.

            • Optionaltype?: string

              The type of the user or system associated with a history record.

            • Optionalurl?: string

              The URL of the user or system associated with a history record.

          • Optionaltype?: string

            The type of the history record.

        • Optionalproperties?: { key?: string; value?: unknown; [key: string]: unknown }[]

          Details of issue properties to be add or update.

        • Optionaltransition?: {
              expand?: string;
              fields?: Record<string, any>;
              hasScreen?: boolean;
              id?: string;
              isAvailable?: boolean;
              isConditional?: boolean;
              isGlobal?: boolean;
              isInitial?: boolean;
              looped?: boolean;
              name?: string;
              to?: {
                  description?: string;
                  iconUrl?: string;
                  id?: string;
                  name?: string;
                  scope?: {
                      project?: {
                          avatarUrls?: {
                              "16x16"?: ...;
                              "24x24"?: ...;
                              "32x32"?: ...;
                              "48x48"?: ...;
                              [key: ...]: ...;
                          };
                          id?: string;
                          key?: string;
                          name?: string;
                          projectCategory?: {
                              description?: ...;
                              id?: ...;
                              name?: ...;
                              self?: ...;
                              [key: ...]: ...;
                          };
                          projectTypeKey?: | (...) & (...)
                          | "software"
                          | "service_desk"
                          | "business"
                          | "product_discovery"
                          | "customer_service";
                          self?: string;
                          simplified?: boolean;
                          [key: string]: unknown;
                      };
                      type?: string & {}
                      | "PROJECT"
                      | "TEMPLATE";
                      [key: string]: unknown;
                  };
                  self?: string;
                  statusCategory?: {
                      colorName?: string;
                      id?: number;
                      key?: string;
                      name?: string;
                      self?: string;
                      [key: string]: unknown;
                  };
                  untranslatedName?: string;
                  [key: string]: unknown;
              };
              [key: string]: unknown;
          }
          • Optionalexpand?: string

            Expand options that include additional transition details in the response.

          • Optionalfields?: Record<string, any>

            Details of the fields associated with the issue transition screen. Use this information to populate fields and update in a transition request.

          • OptionalhasScreen?: boolean

            Whether there is a screen associated with the issue transition.

          • Optionalid?: string

            The ID of the issue transition. Required when specifying a transition to undertake.

          • OptionalisAvailable?: boolean

            Whether the transition is available to be performed.

          • OptionalisConditional?: boolean

            Whether the issue has to meet criteria before the issue transition is applied.

          • OptionalisGlobal?: boolean

            Whether the issue transition is global, that is, the transition is applied to issues regardless of their status.

          • OptionalisInitial?: boolean

            Whether this is the initial issue transition for the workflow.

          • Optionallooped?: boolean
          • Optionalname?: string

            The name of the issue transition.

          • Optionalto?: {
                description?: string;
                iconUrl?: string;
                id?: string;
                name?: string;
                scope?: {
                    project?: {
                        avatarUrls?: {
                            "16x16"?: ...;
                            "24x24"?: ...;
                            "32x32"?: ...;
                            "48x48"?: ...;
                            [key: ...]: ...;
                        };
                        id?: string;
                        key?: string;
                        name?: string;
                        projectCategory?: {
                            description?: ...;
                            id?: ...;
                            name?: ...;
                            self?: ...;
                            [key: ...]: ...;
                        };
                        projectTypeKey?: | (...) & (...)
                        | "software"
                        | "service_desk"
                        | "business"
                        | "product_discovery"
                        | "customer_service";
                        self?: string;
                        simplified?: boolean;
                        [key: string]: unknown;
                    };
                    type?: string & {}
                    | "PROJECT"
                    | "TEMPLATE";
                    [key: string]: unknown;
                };
                self?: string;
                statusCategory?: {
                    colorName?: string;
                    id?: number;
                    key?: string;
                    name?: string;
                    self?: string;
                    [key: string]: unknown;
                };
                untranslatedName?: string;
                [key: string]: unknown;
            }
            • Optionaldescription?: string

              The description of the status.

            • OptionaliconUrl?: string

              The URL of the icon used to represent the status.

            • Optionalid?: string

              The ID of the status.

            • Optionalname?: string

              The name of the status.

            • Optionalscope?: {
                  project?: {
                      avatarUrls?: {
                          "16x16"?: ...;
                          "24x24"?: ...;
                          "32x32"?: ...;
                          "48x48"?: ...;
                          [key: ...]: ...;
                      };
                      id?: string;
                      key?: string;
                      name?: string;
                      projectCategory?: {
                          description?: ...;
                          id?: ...;
                          name?: ...;
                          self?: ...;
                          [key: ...]: ...;
                      };
                      projectTypeKey?: | (...) & (...)
                      | "software"
                      | "service_desk"
                      | "business"
                      | "product_discovery"
                      | "customer_service";
                      self?: string;
                      simplified?: boolean;
                      [key: string]: unknown;
                  };
                  type?: string & {}
                  | "PROJECT"
                  | "TEMPLATE";
                  [key: string]: unknown;
              }
              • Optionalproject?: {
                    avatarUrls?: {
                        "16x16"?: ...;
                        "24x24"?: ...;
                        "32x32"?: ...;
                        "48x48"?: ...;
                        [key: ...]: ...;
                    };
                    id?: string;
                    key?: string;
                    name?: string;
                    projectCategory?: {
                        description?: ...;
                        id?: ...;
                        name?: ...;
                        self?: ...;
                        [key: ...]: ...;
                    };
                    projectTypeKey?: | (...) & (...)
                    | "software"
                    | "service_desk"
                    | "business"
                    | "product_discovery"
                    | "customer_service";
                    self?: string;
                    simplified?: boolean;
                    [key: string]: unknown;
                }
                • OptionalavatarUrls?: { "16x16"?: ...; "24x24"?: ...; "32x32"?: ...; "48x48"?: ...; [key: ...]: ... }
                  • Optional16x16?: ...

                    The URL of the item's 16x16 pixel avatar.

                  • Optional24x24?: ...

                    The URL of the item's 24x24 pixel avatar.

                  • Optional32x32?: ...

                    The URL of the item's 32x32 pixel avatar.

                  • Optional48x48?: ...

                    The URL of the item's 48x48 pixel avatar.

                • Optionalid?: string

                  The ID of the project.

                • Optionalkey?: string

                  The key of the project.

                • Optionalname?: string

                  The name of the project.

                • OptionalprojectCategory?: { description?: ...; id?: ...; name?: ...; self?: ...; [key: ...]: ... }
                  • Optionaldescription?: ...

                    The name of the project category.

                  • Optionalid?: ...

                    The ID of the project category.

                  • Optionalname?: ...

                    The description of the project category.

                  • Optionalself?: ...

                    The URL of the project category.

                • OptionalprojectTypeKey?:
                      | (...) & (...)
                      | "software"
                      | "service_desk"
                      | "business"
                      | "product_discovery"
                      | "customer_service"

                  The project type of the project.

                • Optionalself?: string

                  The URL of the project details.

                • Optionalsimplified?: boolean

                  Whether or not the project is simplified.

              • Optionaltype?: string & {} | "PROJECT" | "TEMPLATE"

                The type of scope.

            • Optionalself?: string

              The URL of the status.

            • OptionalstatusCategory?: {
                  colorName?: string;
                  id?: number;
                  key?: string;
                  name?: string;
                  self?: string;
                  [key: string]: unknown;
              }
              • OptionalcolorName?: string

                The name of the color used to represent the status category.

              • Optionalid?: number

                The ID of the status category.

              • Optionalkey?: string

                The key of the status category.

              • Optionalname?: string

                The name of the status category.

              • Optionalself?: string

                The URL of the status category.

            • OptionaluntranslatedName?: string
        • Optionalupdate?: Record<string, any>

          A Map containing the field field name and a list of operations to perform on the issue screen field. Note that fields included in here cannot be included in fields.

        • OptionalupdateHistory?: boolean

          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.

      • Optionaloptions: RequestOptions

      Returns Promise<
          {
              id: string;
              key: string;
              self: string;
              transition?: {
                  errorCollection?: {
                      errorMessages?: string[];
                      errors?: Record<string, any>;
                      status?: number;
                      [key: string]: unknown;
                  };
                  status?: number;
                  warningCollection?: { warnings?: string[]; [key: string]: unknown };
                  [key: string]: unknown;
              };
              watchers?: {
                  errorCollection?: {
                      errorMessages?: string[];
                      errors?: Record<string, any>;
                      status?: number;
                      [key: string]: unknown;
                  };
                  status?: number;
                  warningCollection?: { warnings?: string[]; [key: string]: unknown };
                  [key: string]: unknown;
              };
              [key: string]: unknown;
          },
      >