REST API: Tags

Tags can be attached to tickets, notices and solutions. Tags cannot be created or updated alone, but are always submitted in conjunction with create/update of an asset type.

List

GET /tags.xml?type=#{ticket|notice|solution}

Returns all tags for the given asset type in your help desk.

Response

Status: 200 OK

<tags>
  <tag>
    <count type="NilClass">10</count>
    <id>63</id>
    <name>printer</name>
  </tag>
  <tag>
    <count type="NilClass">8</count>
    <id>62</id>
    <name>XP</name>
  </tag>
  ...
</tags>

List assets associated with given tags

GET /tags/#{tags}?type=#{ticket|notice|solution}

Returns all assets associated with the given tags. Delimit tags with "+". The list is paginated using offsets. If 15 elements are returned (the page limit), use ?page=15 to check for the next 15 and so on.

Response

Status: 200 OK

<tickets>
  <ticket>
    ...
  </ticket>
  <ticket>
    ...
  </ticket>
  ...
</tickets>