Jira Software Cloud
Jira Service Management
Confluence Cloud
Atlassian Admin Cloud
✂
Filters
A filter is a saved issue search. Jira users can search for issues using different criteria in basic or advanced search, and then save their results as a filter, becoming the filter’s owner.
The owner can decide what to do with their filter—either make it private for personal use or share it with different entities, such as users, projects, or groups. If the filter is private, only the owner and Jira admin can view and modify it.
This resource represents filters. Use it to get, create, update, or delete filters. Also use it to configure the columns for a filter and set favorite filters.
Create Filter
This method creates a new filter. The filter is shared according to the default share scope. The filter is not selected as a favorite, the method returns the following information:
1
package main
2
3
import (
4
"context"
5
"fmt"
6
"github.com/ctreminiom/go-atlassian/jira/v2"
7
"github.com/ctreminiom/go-atlassian/pkg/infra/models"
8
"github.com/google/uuid"
9
"log"
10
"os"
11
)
12
13
func main() {
14
15
var (
16
host = os.Getenv("HOST")
17
mail = os.Getenv("MAIL")
18
token = os.Getenv("TOKEN")
19
)
20
21
atlassian, err := v2.New(nil, host)
22
if err != nil {
23
return
24
}
25
26
atlassian.Auth.SetBasicAuth(mail, token)
27
28
newFilterBody := models.FilterPayloadScheme{
29
Name: fmt.Sprintf("Filter #%v", uuid.New().String()),
30
Description: "Filter's description",
31
JQL: "issuetype = Bug",
32
Favorite: false,
33
SharePermissions: []*models.SharePermissionScheme{
34
{
35
Type: "project",
36
Project: &models.ProjectScheme{
37
ID: "10000",
38
},
39
Role: nil,
40
Group: nil,
41
},
42
{
43
Type: "group",
44
Group: &models.GroupScheme{Name: "jira-administrators"},
45
},
46
},
47
}
48
49
filter, response, err := atlassian.Filter.Create(context.Background(), &newFilterBody)
50
if err != nil {
51
log.Fatal(err)
52
}
53
54
log.Println("HTTP Endpoint Used", response.Endpoint)
55
log.Printf("The filter has been created: %v - %v", filter.ID, filter.Name)
56
}
57
Copied!
Filter permissions on the UI interface
🧚♀️ Tips: You can extract the following struct tags
1
type FilterScheme struct {
2
Self string `json:"self,omitempty"`
3
ID string `json:"id,omitempty"`
4
Name string `json:"name,omitempty"`
5
Owner *UserScheme `json:"owner,omitempty"`
6
Jql string `json:"jql,omitempty"`
7
ViewURL string `json:"viewUrl,omitempty"`
8
SearchURL string `json:"searchUrl,omitempty"`
9
Favourite bool `json:"favourite,omitempty"`
10
FavouritedCount int `json:"favouritedCount,omitempty"`
11
SharePermissions []*SharePermissionScheme `json:"sharePermissions,omitempty"`
12
ShareUsers *FilterUsersScheme `json:"sharedUsers,omitempty"`
13
Subscriptions *FilterSubscriptionScheme `json:"subscriptions,omitempty"`
14
}
15
16
type FilterSubscriptionPageScheme struct {
17
Size int `json:"size,omitempty"`
18
Items []*FilterSubscriptionScheme `json:"items,omitempty"`
19
MaxResults int `json:"max-results,omitempty"`
20
StartIndex int `json:"start-index,omitempty"`
21
EndIndex int `json:"end-index,omitempty"`
22
}
23
24
type FilterSubscriptionScheme struct {
25
ID int `json:"id,omitempty"`
26
User *UserScheme `json:"user,omitempty"`
27
Group *GroupScheme `json:"group,omitempty"`
28
}
29
30
type FilterUsersScheme struct {
31
Size int `json:"size,omitempty"`
32
Items []*UserScheme `json:"items,omitempty"`
33
MaxResults int `json:"max-results,omitempty"`
34
StartIndex int `json:"start-index,omitempty"`
35
EndIndex int `json:"end-index,omitempty"`
36
}
Copied!
Get Favorites
This method returns the visible favorite filters of the user, the method returns the following information:
1
package main
2
3
import (
4
"context"
5
"github.com/ctreminiom/go-atlassian/jira/v2"
6
"log"
7
"os"
8
)
9
10
func main() {
11
12
var (
13
host = os.Getenv("HOST")
14
mail = os.Getenv("MAIL")
15
token = os.Getenv("TOKEN")
16
)
17
18
atlassian, err := v2.New(nil, host)
19
if err != nil {
20
return
21
}
22
23
atlassian.Auth.SetBasicAuth(mail, token)
24
25
filters, response, err := atlassian.Filter.Favorite(context.Background())
26
if err != nil {
27
return
28
}
29
30
log.Println("HTTP Endpoint Used", response.Endpoint)
31
log.Println("favorite filters", len(filters))
32
33
for _, filter := range filters {
34
log.Println(filter)
35
}
36
37
}
38
Copied!
Get My Filters
Returns the filters owned by the user. If
includeFavourites is true, the user's visible favorite filters are also returned, the method returns the following information:1
package main
2
3
import (
4
"context"
5
"github.com/ctreminiom/go-atlassian/jira/v2"
6
"log"
7
"os"
8
)
9
10
func main() {
11
12
var (
13
host = os.Getenv("HOST")
14
mail = os.Getenv("MAIL")
15
token = os.Getenv("TOKEN")
16
)
17
18
atlassian, err := v2.New(nil, host)
19
if err != nil {
20
log.Fatal(err)
21
}
22
23
atlassian.Auth.SetBasicAuth(mail, token)
24
25
myFilters, response, err := atlassian.Filter.My(context.Background(), false, []string{"sharedUsers", "subscriptions"})
26
if err != nil {
27
log.Fatal(err)
28
}
29
30
log.Println("Response HTTP Code", response.Code)
31
log.Println("HTTP Endpoint Used", response.Endpoint)
32
log.Println("my filters", len(myFilters))
33
34
for _, filter := range myFilters {
35
log.Println(filter.ID)
36
37
for _, shareUser := range filter.ShareUsers.Items {
38
log.Println(shareUser.Name, shareUser.DisplayName)
39
}
40
41
for _, subscription := range filter.Subscriptions.Items {
42
log.Println(subscription.ID)
43
}
44
45
}
46
47
}
Copied!
Search Filters
- specific filters, by defining
idonly. - 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.
- 🔒 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.
- for.
- filters shared with a public project.
- filters shared with the public.
1
package main
2
3
import (
4
"context"
5
"github.com/ctreminiom/go-atlassian/jira/v2"
6
"github.com/ctreminiom/go-atlassian/pkg/infra/models"
7
"log"
8
"os"
9
)
10
11
func main() {
12
13
var (
14
host = os.Getenv("HOST")
15
mail = os.Getenv("MAIL")
16
token = os.Getenv("TOKEN")
17
)
18
19
atlassian, err := v2.New(nil, host)
20
if err != nil {
21
return
22
}
23
24
atlassian.Auth.SetBasicAuth(mail, token)
25
26
options := models.FilterSearchOptionScheme{
27
Name: "",
28
AccountID: "",
29
Group: "",
30
ProjectID: 0,
31
IDs: nil,
32
OrderBy: "description",
33
Expand: nil,
34
}
35
36
filters, response, err := atlassian.Filter.Search(context.Background(), &options, 0, 10)
37
if err != nil {
38
if response != nil {
39
log.Println("HTTP Endpoint Used", response.Endpoint)
40
}
41
return
42
}
43
44
log.Println("HTTP Endpoint Used", response.Endpoint)
45
log.Println("Filters found", len(filters.Values))
46
}
47
Copied!
Get Filter
This method returns a filter using the ID as a parameter, the method returns the following information:
1
package main
2
3
import (
4
"context"
5
"github.com/ctreminiom/go-atlassian/jira/v2"
6
"log"
7
"os"
8
)
9
10
func main() {
11
12
var (
13
host = os.Getenv("HOST")
14
mail = os.Getenv("MAIL")
15
token = os.Getenv("TOKEN")
16
)
17
18
atlassian, err := v2.New(nil, host)
19
if err != nil {
20
return
21
}
22
23
atlassian.Auth.SetBasicAuth(mail, token)
24
25
filter, response, err := atlassian.Filter.Get(context.Background(), 1, nil)
26
if err != nil {
27
log.Fatal(err)
28
}
29
30
log.Println("HTTP Endpoint Used", response.Endpoint)
31
log.Println("Get Filter result", filter.Name, filter.Name)
32
}
33
Copied!
🧚♀️ Tips: You can extract the following struct tags
1
type FilterScheme struct {
2
Self string `json:"self,omitempty"`
3
ID string `json:"id,omitempty"`
4
Name string `json:"name,omitempty"`
5
Owner *UserScheme `json:"owner,omitempty"`
6
Jql string `json:"jql,omitempty"`
7
ViewURL string `json:"viewUrl,omitempty"`
8
SearchURL string `json:"searchUrl,omitempty"`
9
Favourite bool `json:"favourite,omitempty"`
10
FavouritedCount int `json:"favouritedCount,omitempty"`
11
SharePermissions []*SharePermissionScheme `json:"sharePermissions,omitempty"`
12
ShareUsers *FilterUsersScheme `json:"sharedUsers,omitempty"`
13
Subscriptions *FilterSubscriptionScheme `json:"subscriptions,omitempty"`
14
}
15
16
type FilterSubscriptionPageScheme struct {
17
Size int `json:"size,omitempty"`
18
Items []*FilterSubscriptionScheme `json:"items,omitempty"`
19
MaxResults int `json:"max-results,omitempty"`
20
StartIndex int `json:"start-index,omitempty"`
21
EndIndex int `json:"end-index,omitempty"`
22
}
23
24
type FilterSubscriptionScheme struct {
25
ID int `json:"id,omitempty"`
26
User *UserScheme `json:"user,omitempty"`
27
Group *GroupScheme `json:"group,omitempty"`
28
}
29
30
type FilterUsersScheme struct {
31
Size int `json:"size,omitempty"`
32
Items []*UserScheme `json:"items,omitempty"`
33
MaxResults int `json:"max-results,omitempty"`
34
StartIndex int `json:"start-index,omitempty"`
35
EndIndex int `json:"end-index,omitempty"`
36
}
Copied!
Update Filter
This method updates a filter. Use this operation to update a filter's name, description, JQL, or sharing, the method returns the following information:
1
package main
2
3
import (
4
"context"
5
"github.com/ctreminiom/go-atlassian/jira/v2"
6
"github.com/ctreminiom/go-atlassian/pkg/infra/models"
7
"log"
8
"os"
9
)
10
11
func main() {
12
13
var (
14
host = os.Getenv("HOST")
15
mail = os.Getenv("MAIL")
16
token = os.Getenv("TOKEN")
17
)
18
19
atlassian, err := v2.New(nil, host)
20
if err != nil {
21
return
22
}
23
24
atlassian.Auth.SetBasicAuth(mail, token)
25
26
payload := models.FilterPayloadScheme{
27
JQL: "issuetype = Story",
28
}
29
30
filter, response, err := atlassian.Filter.Update(context.Background(), 1, &payload)
31
if err != nil {
32
return
33
}
34
35
log.Println("HTTP Endpoint Used", response.Endpoint)
36
log.Println("new JQL filter value", filter.Jql)
37
}
38
Copied!
Delete Filter
1
package main
2
3
import (
4
"context"
5
"github.com/ctreminiom/go-atlassian/jira/v2"
6
"log"
7
"os"
8
)
9
10
func main() {
11
12
var (
13
host = os.Getenv("HOST")
14
mail = os.Getenv("MAIL")
15
token = os.Getenv("TOKEN")
16
)
17
18
atlassian, err := v2.New(nil, host)
19
if err != nil {
20
return
21
}
22
23
atlassian.Auth.SetBasicAuth(mail, token)
24
25
response, err := atlassian.Filter.Delete(context.Background(), 1)
26
if err != nil {
27
return
28
}
29
30
log.Println("HTTP Endpoint Used", response.Endpoint)
31
}
Copied!
Change filter owner
The Jira Cloud platform REST API
Official Documentation
Changes the owner of the filter.
1
package main
2
3
import (
4
"context"
5
"github.com/ctreminiom/go-atlassian/jira/v2"
6
"log"
7
"os"
8
)
9
10
func main() {
11
12
var (
13
host = os.Getenv("HOST")
14
mail = os.Getenv("MAIL")
15
token = os.Getenv("TOKEN")
16
)
17
18
atlassian, err := v2.New(nil, host)
19
if err != nil {
20
return
21
}
22
23
atlassian.Auth.SetBasicAuth(mail, token)
24
25
response, err := atlassian.Filter.Change(context.Background(), 1, "asda03333")
26
if err != nil {
27
return
28
}
29
30
log.Println("HTTP Endpoint Used", response.Endpoint)
31
}gg
Copied!
Last modified 1mo ago
Export as PDF
Copy link