About
Tagging is an organizational device that can be used to organize and group resources. It is available for:
- /users/
- /bots/
- /scripts/
- /jobs/
- /npm_packages/
- /schema_definitions/
HTTP Resources
When you are request a list of resources, or a specific resource it will contain a tags array which contains the individual tag names. Each of the resources above has specific tag HTTP routes. Let"s use bot as example:
GET /bots/tags
Returns a string array containing unique tags of all bots.
RESPONSE
["a","b","c","d"]
GET /bots/:id/tags
Returns all the bot tags.
RESPONSE
["a","c"]
PUT /bots/:id/tags
Add a tag to the given bot.
PUT
{"tag":"new"}
RESPONSE
["a","c","new"]
DELETE /bots/:id/tags
Remove a specific tag from the resource.
PUT
{"tag":"a"}
RESPONSE
["c","new"]