jira.js
    Preparing search index...

    Function createCustomerRequest

    • This method creates a customer request in a service desk.

      The JSON request must include the service desk and customer request type, as well as any fields that are required for the request type. A list of the fields required by a customer request type can be obtained using servicedesk/{serviceDeskId}/requesttype/{requestTypeId}/field.

      The fields required for a customer request type depend on the user's permissions:

      • raiseOnBehalfOf is not available to Users who have the customer permission only.
      • requestParticipants is not available to Users who have the customer permission only or if the feature is turned off for customers.

      requestFieldValues is a map of Jira field IDs and their values. See Field input formats, for details of each field's JSON semantics and the values they can take.

      Permissions required: Permission to create requests in the specified service desk.

      Parameters

      • client: Client
      • parameters: {
            channel?: string;
            form?: { answers?: Record<string, any>; [key: string]: unknown };
            isAdfRequest?: boolean;
            raiseOnBehalfOf?: string;
            requestFieldValues?: Record<string, any>;
            requestParticipants?: string[];
            requestTypeId?: string;
            serviceDeskId?: string;
        }
        • Optionalchannel?: string

          (Experimental) Shows extra information for the request channel.

        • Optionalform?: { answers?: Record<string, any>; [key: string]: unknown }
          • Optionalanswers?: Record<string, any>

            JSON mapping of form field answers containing form field IDs and corresponding values.

        • OptionalisAdfRequest?: boolean

          (Experimental) Whether to accept rich text fields in Atlassian Document Format (ADF).

        • OptionalraiseOnBehalfOf?: string

          The accountId of the customer that the request is being raised on behalf of.

        • OptionalrequestFieldValues?: Record<string, any>

          JSON map of Jira field IDs and their values representing the content of the request.

        • OptionalrequestParticipants?: string[]

          List of customers to participate in the request, as a list of accountId values.

        • OptionalrequestTypeId?: string

          ID of the request type for the request.

        • OptionalserviceDeskId?: string

          ID of the service desk in which to create the request.

      • Optionaloptions: RequestOptions

      Returns Promise<
          {
              _expands?: string[];
              _links?: {
                  agent?: string;
                  jiraRest?: string;
                  self?: string;
                  web?: string;
                  [key: string]: unknown;
              };
              actions?: {
                  addAttachment?: { allowed?: boolean; [key: string]: unknown };
                  addComment?: { allowed?: boolean; [key: string]: unknown };
                  addParticipant?: { allowed?: boolean; [key: string]: unknown };
                  removeParticipant?: { allowed?: boolean; [key: string]: unknown };
                  [key: string]: unknown;
              };
              attachments?: {
                  _expands?: string[];
                  _links?: {
                      base?: string;
                      context?: string;
                      next?: string;
                      prev?: string;
                      self?: string;
                      [key: string]: unknown;
                  };
                  isLastPage?: boolean;
                  limit?: number;
                  size?: number;
                  start?: number;
                  values?: {
                      _links?: {
                          content?: string;
                          jiraRest?: string;
                          self?: string;
                          thumbnail?: string;
                          [key: string]: unknown;
                      };
                      author?: {
                          _links?: {
                              avatarUrls?: ...;
                              jiraRest?: ...;
                              self?: ...;
                              [key: ...]: ...;
                          };
                          accountId?: string;
                          active?: boolean;
                          displayName?: string;
                          emailAddress?: string;
                          key?: string;
                          name?: string;
                          timeZone?: string;
                          [key: string]: unknown;
                      };
                      created?: {
                          epochMillis?: number;
                          friendly?: string;
                          iso8601?: string;
                          jira?: string;
                          [key: string]: unknown;
                      };
                      filename?: string;
                      mimeType?: string;
                      size?: number;
                      [key: string]: unknown;
                  }[];
                  [key: string]: unknown;
              };
              comments?: {
                  _expands?: string[];
                  _links?: {
                      base?: string;
                      context?: string;
                      next?: string;
                      prev?: string;
                      self?: string;
                      [key: string]: unknown;
                  };
                  isLastPage?: boolean;
                  limit?: number;
                  size?: number;
                  start?: number;
                  values?: {
                      _expands?: string[];
                      _links?: { self?: string; [key: string]: unknown };
                      attachments?: {
                          _expands?: (...)[];
                          _links?: {
                              base?: ...;
                              context?: ...;
                              next?: ...;
                              prev?: ...;
                              self?: ...;
                              [key: ...]: ...;
                          };
                          isLastPage?: boolean;
                          limit?: number;
                          size?: number;
                          start?: number;
                          values?: (...)[];
                          [key: string]: unknown;
                      };
                      author?: {
                          _links?: {
                              avatarUrls?: ...;
                              jiraRest?: ...;
                              self?: ...;
                              [key: ...]: ...;
                          };
                          accountId?: string;
                          active?: boolean;
                          displayName?: string;
                          emailAddress?: string;
                          key?: string;
                          name?: string;
                          timeZone?: string;
                          [key: string]: unknown;
                      };
                      body?: string;
                      created?: {
                          epochMillis?: number;
                          friendly?: string;
                          iso8601?: string;
                          jira?: string;
                          [key: string]: unknown;
                      };
                      id?: string;
                      public?: boolean;
                      renderedBody?: { html?: string; [key: string]: unknown };
                      [key: string]: unknown;
                  }[];
                  [key: string]: unknown;
              };
              createdDate?: {
                  epochMillis?: number;
                  friendly?: string;
                  iso8601?: string;
                  jira?: string;
                  [key: string]: unknown;
              };
              currentStatus?: {
                  status?: string;
                  statusCategory?: | string & {}
                  | "NEW"
                  | "DONE"
                  | "UNDEFINED"
                  | "INDETERMINATE";
                  statusDate?: {
                      epochMillis?: number;
                      friendly?: string;
                      iso8601?: string;
                      jira?: string;
                      [key: string]: unknown;
                  };
                  [key: string]: unknown;
              };
              issueId?: string;
              issueKey?: string;
              participants?: {
                  _expands?: string[];
                  _links?: {
                      base?: string;
                      context?: string;
                      next?: string;
                      prev?: string;
                      self?: string;
                      [key: string]: unknown;
                  };
                  isLastPage?: boolean;
                  limit?: number;
                  size?: number;
                  start?: number;
                  values?: {
                      _links?: {
                          avatarUrls?: Record<(...), (...)>;
                          jiraRest?: string;
                          self?: string;
                          [key: string]: unknown;
                      };
                      accountId?: string;
                      active?: boolean;
                      displayName?: string;
                      emailAddress?: string;
                      key?: string;
                      name?: string;
                      timeZone?: string;
                      [key: string]: unknown;
                  }[];
                  [key: string]: unknown;
              };
              reporter?: {
                  _links?: {
                      avatarUrls?: Record<string, any>;
                      jiraRest?: string;
                      self?: string;
                      [key: string]: unknown;
                  };
                  accountId?: string;
                  active?: boolean;
                  displayName?: string;
                  emailAddress?: string;
                  key?: string;
                  name?: string;
                  timeZone?: string;
                  [key: string]: unknown;
              };
              requestFieldValues?: {
                  fieldId?: string;
                  label?: string;
                  renderedValue?: Record<string, any>;
                  value?: unknown;
                  [key: string]: unknown;
              }[];
              requestType?: {
                  _expands?: string[];
                  _links?: { self?: string; [key: string]: unknown };
                  canCreateRequest?: boolean;
                  description?: string;
                  fields?: {
                      canAddRequestParticipants?: boolean;
                      canRaiseOnBehalfOf?: boolean;
                      requestTypeFields?: {
                          defaultValues?: (...)[];
                          description?: string;
                          fieldId?: string;
                          jiraSchema?: {
                              configuration?: ...;
                              custom?: ...;
                              customId?: ...;
                              items?: ...;
                              system?: ...;
                              type: ...;
                              [key: ...]: ...;
                          };
                          name?: string;
                          presetValues?: (...)[];
                          required?: boolean;
                          validValues?: (...)[];
                          visible?: boolean;
                          [key: string]: unknown;
                      }[];
                      [key: string]: unknown;
                  };
                  groupIds?: string[];
                  helpText?: string;
                  icon?: {
                      _links?: { iconUrls?: Record<string, any>; [key: string]: unknown };
                      id?: string;
                      [key: string]: unknown;
                  };
                  id?: string;
                  issueTypeId?: string;
                  name?: string;
                  portalId?: string;
                  practice?: string;
                  restrictionStatus?: string & {}
                  | "OPEN"
                  | "RESTRICTED";
                  serviceDeskId?: string;
                  [key: string]: unknown;
              };
              requestTypeId?: string;
              serviceDesk?: {
                  _links?: { self?: string; [key: string]: unknown };
                  id?: string;
                  projectId?: string;
                  projectKey?: string;
                  projectName?: string;
                  projectTypeKey?: string;
                  [key: string]: unknown;
              };
              serviceDeskId?: string;
              sla?: {
                  _expands?: string[];
                  _links?: {
                      base?: string;
                      context?: string;
                      next?: string;
                      prev?: string;
                      self?: string;
                      [key: string]: unknown;
                  };
                  isLastPage?: boolean;
                  limit?: number;
                  size?: number;
                  start?: number;
                  values?: {
                      _links?: { self?: string; [key: string]: unknown };
                      completedCycles?: {
                          breached?: (...) | (...) | (...);
                          breachTime?: (...) | (...);
                          elapsedTime?: (...) | (...);
                          goalDuration?: (...) | (...);
                          remainingTime?: (...) | (...);
                          startTime?: (...) | (...);
                          stopTime?: (...) | (...);
                          [key: string]: unknown;
                      }[];
                      id?: string;
                      name?: string;
                      ongoingCycle?: {
                          breached?: boolean;
                          breachTime?: {
                              epochMillis?: ...;
                              friendly?: ...;
                              iso8601?: ...;
                              jira?: ...;
                              [key: ...]: ...;
                          };
                          elapsedTime?: { friendly?: ...; millis?: ...; [key: ...]: ... };
                          goalDuration?: { friendly?: ...; millis?: ...; [key: ...]: ... };
                          paused?: boolean;
                          remainingTime?: { friendly?: ...; millis?: ...; [key: ...]: ... };
                          startTime?: {
                              epochMillis?: ...;
                              friendly?: ...;
                              iso8601?: ...;
                              jira?: ...;
                              [key: ...]: ...;
                          };
                          withinCalendarHours?: boolean;
                          [key: string]: unknown;
                      };
                      slaDisplayFormat?: string;
                      [key: string]: unknown;
                  }[];
                  [key: string]: unknown;
              };
              status?: {
                  _expands?: string[];
                  _links?: {
                      base?: string;
                      context?: string;
                      next?: string;
                      prev?: string;
                      self?: string;
                      [key: string]: unknown;
                  };
                  isLastPage?: boolean;
                  limit?: number;
                  size?: number;
                  start?: number;
                  values?: {
                      status?: string;
                      statusCategory?: | string & {}
                      | "NEW"
                      | "DONE"
                      | "UNDEFINED"
                      | "INDETERMINATE";
                      statusDate?: {
                          epochMillis?: number;
                          friendly?: string;
                          iso8601?: string;
                          jira?: string;
                          [key: string]: unknown;
                      };
                      [key: string]: unknown;
                  }[];
                  [key: string]: unknown;
              };
              summary?: string;
              [key: string]: unknown;
          },
      >

    Settings
    Member Visibility