Tagging Tag APIs

Tagging Tag APIs

The Tag service provides operations to create, read, update, delete, and enumerate tags.

Operations
POST
Add To Used By Tag Id
Adds the usedByEntity to the TagModel.used-by subscribers set. If the usedByEntity is already in the set, then this becomes a no-op. To invoke this operation, you need the modify TagModel.used-by privilege on the tag.
POST
Create Tag
Creates a tag. To invoke this operation, you need the create tag privilege on the input category.
GET
List Tag
Enumerates the tags in the system. To invoke this operation, you need read privilege on the individual tags. The list will only contain tags for which you have read privileges.
DELETE
Delete Tag Id Tag
Deletes an existing tag. To invoke this operation, you need the delete privilege on the tag.
GET
Get Tag Id Tag
Fetches the tag information for the given tag identifier. To invoke this operation, you need the read privilege on the tag in order to view the tag info.
PATCH
Update Tag Id Tag
Updates an existing tag. To invoke this operation, you need the edit privilege on the tag.
POST
List Tags For Category Category Id
Enumerates all tags for the given category. To invoke this operation, you need the read privilege on the given category and the individual tags in that category.
POST
List Used Tags
Enumerates all tags for which the usedByEntity is part of the TagModel.used-by subscribers set. To invoke this operation, you need the read privilege on the individual tags.
POST
Remove From Used By Tag Id
Removes the usedByEntity from the TagModel.used-by subscribers set. If the usedByEntity is not using this tag, then this becomes a no-op. To invoke this operation, you need modify TagModel.used-by privilege on the tag.
POST
Revoke Propagating Permissions Tag Id
Revokes all propagating permissions on the given tag. You should then attach a direct permission with tagging privileges on the given tag. To invoke this operation, you need tag related privileges (direct or propagating) on the concerned tag.