Working with Tags

Tags is one string which contains all the Tags of the entity combined together (separated by comma).
TagObjects is an array which contains all the Tags of the entity separately.

Select Tags

/api/v2/bugs?select={id,name,tags}

{
  "items": [
    {
      "id": 6366,
      "name": "Cleanup Sample Data link",
      "tags": "po"
    },
        {
      "id": 4613,
      "name": "Critical issue",
      "tags": "Hotfix 4, 4.0.12"
    }
  ]
}

/api/v2/bugs?select={id,name,tagobjects}

{
  "items": [
    {
      "id": 6366,
      "name": "Cleanup Sample Data link",
      "tagObjects": {"items":[{"resourceType":"Tag","id":22,"name":"po"}]}
    },
        {
      "id": 4613,
      "name": "Critical issue",
      "tagObjects": {"items":[{"resourceType":"Tag","id":99,"name":"Hotfix 4"},{"resourceType":"Tag","id":101,"name":"4.0.12"}]}
    }
  ]
}

Filters by Tags

These filters are helpful when you set up a view with General entities (such as User Stories, Tasks, Bugs, Requests, Features, Epics, Releases, Sprints (Iterations), Projects etc.) and the assigned Tags they have.

EntityFilterResult
Generalwhere=(TagObjects.Count==0)Entities with no tags assigned
Generalwhere=(TagObjects.Count>0)Entities having at least one tag assigned
Generalwhere=(TagObjects.Count(Name=='plugin')>0)Entities with “plugin” tag. The tag should contain exactly this single word
Generalwhere=(TagObjects.Count(Name=='plugin')==0)Negative filter. Entities with no “plugin” tag.

It is also possible to filter parent entities by tags assigned to parent entities. Say you can show a feature if a parent epic of this feature has been tagged with a specific tag.

EntityFilterResult
Featurewhere=(Epic.TagObjects.Count(Name=='plugin')>0)Features that are parts of Epics with “plugin” tag