jira.js
    Preparing search index...

    Function getFiltersPaginated

    • Returns a paginated list of filters. Use this operation to get:

      • Specific filters, by defining id only.
      • Filters that match all of the specified attributes. For example, all filters for a user with a particular word in their name. When multiple attributes are specified only filters matching all attributes are returned.

      This operation can be accessed anonymously.

      Permissions required: None, however, only the following filters that match the query parameters are returned:

      • Filters owned by the user.
      • Filters shared with a group that the user is a member of.
      • Filters shared with a private project that the user has Browse projects project permission for.
      • Filters shared with a public project.
      • Filters shared with the public.

      Parameters

      • client: Client
      • Optionalparameters: {
            accountId?: string;
            expand?:
                | string
                | string[]
                | string & {}
                | (
                    | "description"
                    | string & {}
                    | "jql"
                    | "viewUrl"
                    | "owner"
                    | "searchUrl"
                    | "favourite"
                    | "editPermissions"
                    | "sharePermissions"
                    | "isWritable"
                    | "approximateLastUsed"
                    | "favouritedCount"
                    | "subscriptions"
                )[];
            filterName?: string;
            groupId?: string;
            groupname?: string;
            id?: number[];
            isSubstringMatch?: boolean;
            maxResults?: number;
            orderBy?: | "name"
            | "id"
            | "description"
            | string & {}
            | "owner"
            | "-description"
            | "+description"
            | "-name"
            | "+name"
            | "-id"
            | "+id"
            | "-owner"
            | "+owner"
            | "favourite_count"
            | "-favourite_count"
            | "+favourite_count"
            | "is_favourite"
            | "-is_favourite"
            | "+is_favourite"
            | "is_shared"
            | "-is_shared"
            | "+is_shared";
            overrideSharePermissions?: boolean;
            projectId?: number;
            startAt?: number;
        }
        • OptionalaccountId?: string

          User account ID used to return filters with the matching owner.accountId. This parameter cannot be used with owner.

        • Optionalexpand?:
              | string
              | string[]
              | string & {}
              | (
                  | "description"
                  | string & {}
                  | "jql"
                  | "viewUrl"
                  | "owner"
                  | "searchUrl"
                  | "favourite"
                  | "editPermissions"
                  | "sharePermissions"
                  | "isWritable"
                  | "approximateLastUsed"
                  | "favouritedCount"
                  | "subscriptions"
              )[]

          Use expand to include additional information about filter in the response. This parameter accepts a comma-separated list. Expand options include:

          • description Returns the description of the filter.
          • favourite Returns an indicator of whether the user has set the filter as a favorite.
          • favouritedCount Returns a count of how many users have set this filter as a favorite.
          • jql Returns the JQL query that the filter uses.
          • owner Returns the owner of the filter.
          • searchUrl Returns a URL to perform the filter's JQL query.
          • sharePermissions Returns the share permissions defined for the filter.
          • editPermissions Returns the edit permissions defined for the filter.
          • isWritable Returns whether the current user has permission to edit the filter.
          • approximateLastUsed [Experimental] Returns the approximate date and time when the filter was last evaluated.
          • subscriptions Returns the users that are subscribed to the filter.
          • viewUrl Returns a URL to view the filter.
        • OptionalfilterName?: string

          String used to perform a case-insensitive partial match with name.

        • OptionalgroupId?: string

          Group ID used to returns filters that are shared with a group that matches sharePermissions.group.groupId. This parameter cannot be used with the groupname parameter.

        • Optionalgroupname?: string

          As a group's name can change, use of groupId is recommended to identify a group. Group name used to returns filters that are shared with a group that matches sharePermissions.group.groupname. This parameter cannot be used with the groupId parameter.

        • Optionalid?: number[]

          The list of filter IDs. To include multiple IDs, provide an ampersand-separated list. For example, id=10000&id=10001. Do not exceed 200 filter IDs.

        • OptionalisSubstringMatch?: boolean

          When true this will perform a case-insensitive substring match for the provided filterName. When false the filter name will be searched using full text search syntax.

        • OptionalmaxResults?: number

          The maximum number of items to return per page.

        • OptionalorderBy?:
              | "name"
              | "id"
              | "description"
              | string & {}
              | "owner"
              | "-description"
              | "+description"
              | "-name"
              | "+name"
              | "-id"
              | "+id"
              | "-owner"
              | "+owner"
              | "favourite_count"
              | "-favourite_count"
              | "+favourite_count"
              | "is_favourite"
              | "-is_favourite"
              | "+is_favourite"
              | "is_shared"
              | "-is_shared"
              | "+is_shared"

          Order the results by a field:

          • description Sorts by filter description. Note that this sorting works independently of whether the expand to display the description field is in use.
          • favourite_count Sorts by the count of how many users have this filter as a favorite.
          • is_favourite Sorts by whether the filter is marked as a favorite.
          • id Sorts by filter ID.
          • name Sorts by filter name.
          • owner Sorts by the ID of the filter owner.
          • is_shared Sorts by whether the filter is shared.
        • OptionaloverrideSharePermissions?: boolean

          EXPERIMENTAL: Whether share permissions are overridden to enable filters with any share permissions to be returned. Available to users with Administer Jira global permission.

        • OptionalprojectId?: number

          Project ID used to returns filters that are shared with a project that matches sharePermissions.project.id.

        • OptionalstartAt?: number

          The index of the first item to return in a page of results (page offset).

      • Optionaloptions: RequestOptions

      Returns Promise<
          {
              isLast: boolean;
              maxResults: number;
              nextPage?: string;
              self?: string;
              startAt: number;
              total: number;
              values: {
                  approximateLastUsed?: Date;
                  description?: string;
                  editPermissions?: {
                      group?: {
                          groupId?: string
                          | null;
                          name?: string;
                          self?: string;
                          [key: string]: unknown;
                      };
                      id?: number;
                      project?: {
                          archived?: boolean;
                          archivedBy?: {
                              accountId?: ...;
                              accountType?: ...;
                              active?: ...;
                              applicationRoles?: ...;
                              appType?: ...;
                              avatarUrls?: ...;
                              displayName?: ...;
                              emailAddress?: ...;
                              expand?: ...;
                              groups?: ...;
                              guest?: ...;
                              locale?: ...;
                              self?: ...;
                              timeZone?: ...;
                              [key: ...]: ...;
                          };
                          archivedDate?: Date;
                          assigneeType?: (...) & (...)
                          | "PROJECT_LEAD"
                          | "UNASSIGNED";
                          avatarUrls?: {
                              "16x16"?: ...;
                              "24x24"?: ...;
                              "32x32"?: ...;
                              "48x48"?: ...;
                              [key: ...]: ...;
                          };
                          components?: (...)[];
                          deleted?: boolean;
                          deletedBy?: {
                              accountId?: ...;
                              accountType?: ...;
                              active?: ...;
                              applicationRoles?: ...;
                              appType?: ...;
                              avatarUrls?: ...;
                              displayName?: ...;
                              emailAddress?: ...;
                              expand?: ...;
                              groups?: ...;
                              guest?: ...;
                              locale?: ...;
                              self?: ...;
                              timeZone?: ...;
                              [key: ...]: ...;
                          };
                          deletedDate?: Date;
                          description?: string;
                          email?: string;
                          entityId?: string;
                          expand?: string;
                          favourite?: boolean;
                          id?: string;
                          insight?: {
                              lastIssueUpdateTime?: ...;
                              totalIssueCount?: ...;
                              [key: ...]: ...;
                          };
                          isPrivate?: boolean;
                          issueTypeHierarchy?: { levels?: ...; [key: ...]: ... };
                          issueTypes?: (...)[];
                          key?: string;
                          landingPageInfo?: {
                              attributes?: ...;
                              boardId?: ...;
                              boardName?: ...;
                              projectKey?: ...;
                              projectType?: ...;
                              queueCategory?: ...;
                              queueId?: ...;
                              queueName?: ...;
                              simpleBoard?: ...;
                              simplified?: ...;
                              url?: ...;
                              [key: ...]: ...;
                          };
                          lead?: {
                              accountId?: ...;
                              accountType?: ...;
                              active?: ...;
                              applicationRoles?: ...;
                              appType?: ...;
                              avatarUrls?: ...;
                              displayName?: ...;
                              emailAddress?: ...;
                              expand?: ...;
                              groups?: ...;
                              guest?: ...;
                              locale?: ...;
                              self?: ...;
                              timeZone?: ...;
                              [key: ...]: ...;
                          };
                          name?: string;
                          permissions?: { canEdit?: ...; [key: ...]: ... };
                          projectCategory?: {
                              description?: ...;
                              id?: ...;
                              name?: ...;
                              self?: ...;
                              [key: ...]: ...;
                          };
                          projectTypeKey?: | (...) & (...)
                          | "software"
                          | "service_desk"
                          | "business"
                          | "product_discovery"
                          | "customer_service";
                          properties?: Record<(...), (...)>;
                          retentionTillDate?: Date;
                          roles?: Record<(...), (...)>;
                          self?: string;
                          simplified?: boolean;
                          style?: "classic" | (...) & (...) | "next-gen";
                          url?: string;
                          uuid?: string;
                          versions?: (...)[];
                          [key: string]: unknown;
                      };
                      role?: {
                          actors?: (...)[];
                          admin?: boolean;
                          currentUserRole?: boolean;
                          default?: boolean;
                          description?: string;
                          id?: number;
                          name?: string;
                          roleConfigurable?: boolean;
                          scope?: { project?: ...; type?: ...; [key: ...]: ... };
                          self?: string;
                          translatedName?: string;
                          [key: string]: unknown;
                      };
                      type: | "global"
                      | "user"
                      | "group"
                      | string & {}
                      | "project"
                      | "projectRole"
                      | "loggedin"
                      | "authenticated"
                      | "project-unknown";
                      user?: {
                          accountId?: string;
                          active?: boolean;
                          avatarUrls?: {
                              "16x16"?: ...;
                              "24x24"?: ...;
                              "32x32"?: ...;
                              "48x48"?: ...;
                              [key: ...]: ...;
                          };
                          displayName?: string;
                          self?: string;
                          [key: string]: unknown;
                      };
                      [key: string]: unknown;
                  }[];
                  expand?: string;
                  favourite?: boolean;
                  favouritedCount?: number;
                  id?: string;
                  jql?: string;
                  name: string;
                  owner?: {
                      accountId?: string;
                      accountType?: "unknown"
                      | string & {}
                      | "atlassian"
                      | "app"
                      | "customer";
                      active?: boolean;
                      applicationRoles?: {
                          callback?: { [key: string]: unknown };
                          items?: {
                              defaultGroups?: ...;
                              defaultGroupsDetails?: ...;
                              defined?: ...;
                              groupDetails?: ...;
                              groups?: ...;
                              hasUnlimitedSeats?: ...;
                              key?: ...;
                              name?: ...;
                              numberOfSeats?: ...;
                              platform?: ...;
                              remainingSeats?: ...;
                              selectedByDefault?: ...;
                              userCount?: ...;
                              userCountDescription?: ...;
                              [key: ...]: ...;
                          }[];
                          "max-results"?: number;
                          pagingCallback?: { [key: string]: unknown };
                          size?: number;
                          [key: string]: unknown;
                      };
                      appType?: string;
                      avatarUrls?: {
                          "16x16"?: string;
                          "24x24"?: string;
                          "32x32"?: string;
                          "48x48"?: string;
                          [key: string]: unknown;
                      };
                      displayName?: string;
                      emailAddress?: string;
                      expand?: string;
                      groups?: {
                          callback?: { [key: string]: unknown };
                          items?: { groupId?: ...; name?: ...; self?: ...; [key: ...]: ... }[];
                          "max-results"?: number;
                          pagingCallback?: { [key: string]: unknown };
                          size?: number;
                          [key: string]: unknown;
                      };
                      guest?: boolean;
                      locale?: string;
                      self?: string;
                      timeZone?: string;
                      [key: string]: unknown;
                  };
                  searchUrl?: string;
                  self?: string;
                  sharePermissions?: {
                      group?: {
                          groupId?: string
                          | null;
                          name?: string;
                          self?: string;
                          [key: string]: unknown;
                      };
                      id?: number;
                      project?: {
                          archived?: boolean;
                          archivedBy?: {
                              accountId?: ...;
                              accountType?: ...;
                              active?: ...;
                              applicationRoles?: ...;
                              appType?: ...;
                              avatarUrls?: ...;
                              displayName?: ...;
                              emailAddress?: ...;
                              expand?: ...;
                              groups?: ...;
                              guest?: ...;
                              locale?: ...;
                              self?: ...;
                              timeZone?: ...;
                              [key: ...]: ...;
                          };
                          archivedDate?: Date;
                          assigneeType?: (...) & (...)
                          | "PROJECT_LEAD"
                          | "UNASSIGNED";
                          avatarUrls?: {
                              "16x16"?: ...;
                              "24x24"?: ...;
                              "32x32"?: ...;
                              "48x48"?: ...;
                              [key: ...]: ...;
                          };
                          components?: (...)[];
                          deleted?: boolean;
                          deletedBy?: {
                              accountId?: ...;
                              accountType?: ...;
                              active?: ...;
                              applicationRoles?: ...;
                              appType?: ...;
                              avatarUrls?: ...;
                              displayName?: ...;
                              emailAddress?: ...;
                              expand?: ...;
                              groups?: ...;
                              guest?: ...;
                              locale?: ...;
                              self?: ...;
                              timeZone?: ...;
                              [key: ...]: ...;
                          };
                          deletedDate?: Date;
                          description?: string;
                          email?: string;
                          entityId?: string;
                          expand?: string;
                          favourite?: boolean;
                          id?: string;
                          insight?: {
                              lastIssueUpdateTime?: ...;
                              totalIssueCount?: ...;
                              [key: ...]: ...;
                          };
                          isPrivate?: boolean;
                          issueTypeHierarchy?: { levels?: ...; [key: ...]: ... };
                          issueTypes?: (...)[];
                          key?: string;
                          landingPageInfo?: {
                              attributes?: ...;
                              boardId?: ...;
                              boardName?: ...;
                              projectKey?: ...;
                              projectType?: ...;
                              queueCategory?: ...;
                              queueId?: ...;
                              queueName?: ...;
                              simpleBoard?: ...;
                              simplified?: ...;
                              url?: ...;
                              [key: ...]: ...;
                          };
                          lead?: {
                              accountId?: ...;
                              accountType?: ...;
                              active?: ...;
                              applicationRoles?: ...;
                              appType?: ...;
                              avatarUrls?: ...;
                              displayName?: ...;
                              emailAddress?: ...;
                              expand?: ...;
                              groups?: ...;
                              guest?: ...;
                              locale?: ...;
                              self?: ...;
                              timeZone?: ...;
                              [key: ...]: ...;
                          };
                          name?: string;
                          permissions?: { canEdit?: ...; [key: ...]: ... };
                          projectCategory?: {
                              description?: ...;
                              id?: ...;
                              name?: ...;
                              self?: ...;
                              [key: ...]: ...;
                          };
                          projectTypeKey?: | (...) & (...)
                          | "software"
                          | "service_desk"
                          | "business"
                          | "product_discovery"
                          | "customer_service";
                          properties?: Record<(...), (...)>;
                          retentionTillDate?: Date;
                          roles?: Record<(...), (...)>;
                          self?: string;
                          simplified?: boolean;
                          style?: "classic" | (...) & (...) | "next-gen";
                          url?: string;
                          uuid?: string;
                          versions?: (...)[];
                          [key: string]: unknown;
                      };
                      role?: {
                          actors?: (...)[];
                          admin?: boolean;
                          currentUserRole?: boolean;
                          default?: boolean;
                          description?: string;
                          id?: number;
                          name?: string;
                          roleConfigurable?: boolean;
                          scope?: { project?: ...; type?: ...; [key: ...]: ... };
                          self?: string;
                          translatedName?: string;
                          [key: string]: unknown;
                      };
                      type: | "global"
                      | "user"
                      | "group"
                      | string & {}
                      | "project"
                      | "projectRole"
                      | "loggedin"
                      | "authenticated"
                      | "project-unknown";
                      user?: {
                          accountId?: string;
                          active?: boolean;
                          avatarUrls?: {
                              "16x16"?: ...;
                              "24x24"?: ...;
                              "32x32"?: ...;
                              "48x48"?: ...;
                              [key: ...]: ...;
                          };
                          displayName?: string;
                          self?: string;
                          [key: string]: unknown;
                      };
                      [key: string]: unknown;
                  }[];
                  subscriptions?: {
                      group?: {
                          groupId?: string
                          | null;
                          name?: string;
                          self?: string;
                          [key: string]: unknown;
                      };
                      id?: number;
                      user?: {
                          accountId?: string;
                          accountType?: | "unknown"
                          | (...) & (...)
                          | "atlassian"
                          | "app"
                          | "customer";
                          active?: boolean;
                          applicationRoles?: {
                              callback?: ...;
                              items?: ...;
                              "max-results"?: ...;
                              pagingCallback?: ...;
                              size?: ...;
                              [key: ...]: ...;
                          };
                          appType?: string;
                          avatarUrls?: {
                              "16x16"?: ...;
                              "24x24"?: ...;
                              "32x32"?: ...;
                              "48x48"?: ...;
                              [key: ...]: ...;
                          };
                          displayName?: string;
                          emailAddress?: string;
                          expand?: string;
                          groups?: {
                              callback?: ...;
                              items?: ...;
                              "max-results"?: ...;
                              pagingCallback?: ...;
                              size?: ...;
                              [key: ...]: ...;
                          };
                          guest?: boolean;
                          locale?: string;
                          self?: string;
                          timeZone?: string;
                          [key: string]: unknown;
                      };
                      [key: string]: unknown;
                  }[];
                  viewUrl?: string;
                  [key: string]: unknown;
              }[];
              [key: string]: unknown;
          },
      >

    Settings
    Member Visibility