TagItems & Filtering by Tags

[Luke 37065]

You're aware of the Tag property on items:

"Tags":[ 
      "tag1",
      "tag2"
   ]

But going forward, please switch all usage to the new TagItems property:

"TagItems":[ 
      { 
         "Name":"tag1",
         "Id":600107
      },
      { 
         "Name":"tag2",
         "Id":600108
      }
   ]

This gives you the Name and Id of each tag assigned to the item. We'll be sending both back now, which means temporarily there will be a little bit of bloat in the api.

 

Filtering by Tags

 

All list api's now have a TagIds filter. You can use the above tag id's to filter based on tag id's, comma-delimited.

 

You can still filter using the tag name with the Tags param, but this should only be used in situations where you do not have the tag id, like for example voice input.