API Documentation | Tag

List all tags in use in your account.

Fields

_cid string
The primary key
"/tag/datacenter:newyork"
A string containing a tag cid

Example

Listing Tags

All tags your account is using can be listed by performing a GET request on /tag

GET /tag
[{"cid":"/tag/datacenter:newyork"},{"cid":"/tag/datacenter:london"},{"cid":"/tag/datacenter:tokyo"},{"cid":"/tag/datacenter:melbourne"},{"cid":"/tag/todo:colin"},{"cid":"/tag/todo:mark"},{"cid":"/tag/todo:george"}]

(There's little point in fetching individual tags - they don't have any fields)

Deleting Tags

Deleting will remove the tag from all objects in your account, and can be done by simply performing a DELETE on the given tag

DELETE /tag/foo:bar

Updating and Adding New Tags

Tags cannot be added with this endpoint; instead you should add the tag to the individual objects. Tags are also not updateable; you would need to delete and then add the correct tag.