jira.js
    Preparing search index...

    Function createUiModification

    • Creates a UI modification. UI modification can only be created by Forge apps.

      Each app can define up to 3000 UI modifications. Each UI modification can define up to 1000 contexts. The same context can be assigned to maximum 100 UI modifications.

      Context types:

      • Jira contexts: For Jira view types, use projectId and issueTypeId. One field can act as a wildcard. Supported Jira views:

        • GIC - Jira global issue create
        • IssueView - Jira issue view
        • IssueTransition - Jira issue transition

      • Jira Service Management contexts: For Jira Service Management view types, use portalId and requestTypeId. Wildcards are not supported. Supported JSM views:

        • JSMRequestCreate - Jira Service Management request create portal view

      • Agent view contexts: For Agent view types, use projectId and issueTypeId like Jira contexts, and optionally set requestTypeId. portalId must not be set. One of projectId, issueTypeId, or viewType can act as a wildcard. Supported Agent views:

        • GICAgentView - Agent view variant of Jira global issue create
        • IssueViewAgentView - Agent view variant of Jira issue view
        • IssueTransitionAgentView - Agent view variant of Jira issue transition

      Permissions required:

      • None if the UI modification is created without contexts.
      • Browse projects project permission for one or more projects, if the UI modification is created with contexts.

      The new write:app-data:jira OAuth scope is 100% optional now, and not using it won't break your app. However, we recommend adding it to your app's scope list because we will eventually make it mandatory.

      Parameters

      • client: Client
      • parameters: {
            contexts?: {
                id?: string;
                isAvailable?: boolean;
                issueTypeId?: string;
                portalId?: string;
                projectId?: string;
                requestTypeId?: string;
                viewType?:
                    | string & {}
                    | "GIC"
                    | "IssueView"
                    | "IssueTransition"
                    | "JSMRequestCreate"
                    | "GICAgentView"
                    | "IssueViewAgentView"
                    | "IssueTransitionAgentView";
                [key: string]: unknown;
            }[];
            data?: string;
            description?: string;
            name: string;
        }
        • Optionalcontexts?: {
              id?: string;
              isAvailable?: boolean;
              issueTypeId?: string;
              portalId?: string;
              projectId?: string;
              requestTypeId?: string;
              viewType?:
                  | string & {}
                  | "GIC"
                  | "IssueView"
                  | "IssueTransition"
                  | "JSMRequestCreate"
                  | "GICAgentView"
                  | "IssueViewAgentView"
                  | "IssueTransitionAgentView";
              [key: string]: unknown;
          }[]

          List of contexts of the UI modification. The maximum number of contexts is 1000.

        • Optionaldata?: string

          The data of the UI modification. The maximum size of the data is 50000 characters.

        • Optionaldescription?: string

          The description of the UI modification. The maximum length is 255 characters.

        • name: string

          The name of the UI modification. The maximum length is 255 characters.

      • Optionaloptions: RequestOptions

      Returns Promise<{ id: string; self: string; [key: string]: unknown }>

    Settings
    Member Visibility