Tagging Tag APIs
The Tag service provides operations to create, read, update, delete, and enumerate tags.
Operations
post
Create Tag
Creates a tag. To invoke this operation, you need the create tag privilege on the input category.
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.
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.
get
Get 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.
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
Updates an existing tag. To invoke this operation, you need the edit privilege on the tag.
Updates an existing tag. To invoke this operation, you need the edit privilege on the tag.
delete
Delete Tag
Deletes an existing tag. To invoke this operation, you need the delete privilege on the tag.
Deletes an existing tag. To invoke this operation, you need the delete privilege on the tag.
post
Add To Used By Tag
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.
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
Remove From Used By Tag
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.
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
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.
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.
post
List Tags For Category Tag
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.
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 Tag
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.
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.
