Tagging Category APIs
The Category service provides operations to create, read, update, delete, and enumerate categories.
Operations
post
Create Category
Creates a category. To invoke this operation, you need the create category privilege.
Creates a category. To invoke this operation, you need the create category privilege.
get
List Category
Enumerates the categories in the system. To invoke this operation, you need the read privilege on the individual categories. The list will only contain those categories for which you have read privileges.
Enumerates the categories in the system. To invoke this operation, you need the read privilege on the individual categories. The list will only contain those categories for which you have read privileges.
get
Get Category
Fetches the category information for the given category identifier. In order to view the category information, you need the read privilege on the category.
Fetches the category information for the given category identifier. In order to view the category information, you need the read privilege on the category.
patch
Update Category
Updates an existing category. To invoke this operation, you need the edit privilege on the category.
Updates an existing category. To invoke this operation, you need the edit privilege on the category.
delete
Delete Category
Deletes an existing category. To invoke this operation, you need the delete privilege on the category.
Deletes an existing category. To invoke this operation, you need the delete privilege on the category.
post
Add To Used By Category
Adds the usedByEntity to the CategoryModel.used-by subscribers set for the specified category. If the usedByEntity is already in the set, then this becomes an idempotent no-op. To invoke this operation, you need the modify CategoryModel.used-by privilege on the category.
Adds the usedByEntity to the CategoryModel.used-by subscribers set for the specified category. If the usedByEntity is already in the set, then this becomes an idempotent no-op. To invoke this operation, you need the modify CategoryModel.used-by privilege on the category.
post
Remove From Used By Category
Removes the usedByEntity from the CategoryModel.used-by subscribers set. If the usedByEntity is not using this category, then this becomes a no-op. To invoke this operation, you need the modify CategoryModel.used-by privilege on the category.
Removes the usedByEntity from the CategoryModel.used-by subscribers set. If the usedByEntity is not using this category, then this becomes a no-op. To invoke this operation, you need the modify CategoryModel.used-by privilege on the category.
post
Revoke Propagating Permissions Category
Revokes all propagating permissions on the given category. You should then attach a direct permission with tagging privileges on the given category. To invoke this operation, you need category related privileges (direct or propagating) on the concerned category.
Revokes all propagating permissions on the given category. You should then attach a direct permission with tagging privileges on the given category. To invoke this operation, you need category related privileges (direct or propagating) on the concerned category.
post
List Used Categories Category
Enumerates all categories for which the usedByEntity is part of the CategoryModel.used-by subscribers set. To invoke this operation, you need the read privilege on the individual categories.
Enumerates all categories for which the usedByEntity is part of the CategoryModel.used-by subscribers set. To invoke this operation, you need the read privilege on the individual categories.