1. Operations
2. cis
3. tagging
4. tag

## cis tagging tag: add to used by

Adds the `used_by_entity` to the cis.tagging.tag_model.used_by subscribers set. If the `used_by_entity` is already in the set, then this becomes a no-op. To invoke this operation, you need the modify cis.tagging.tag_model.used_by privilege on the tag.

### Request:

#### HTTP request

POST https://{server}/rest/com/vmware/cis/tagging/tag/id:{tag_id}?~action=add-to-used-by

#### Path Parameters

Name | Type | Description
--- | --- | ---
Required
tag_id | string | The identifier of the input tag.

#### Request Body Structure:

- JSON
- XML

{
"used_by_entity": "string"
}
<?xml version="1.0" ?>
<ns0:AddToUsedBy-Input xmlns:ns0="http://vmware.com/cis/tagging/tag" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<used_by_entity>string</used_by_entity>
</ns0:AddToUsedBy-Input>

#### Request Body Parameters:

Name | Type | Description
--- | --- | ---
bold = required
used_by_entity | string | The name of the user to be added to the cis.tagging.tag_model.used_by set.

### Response:

#### HTTP Status Code: 200

None

#### Errors:

HTTP Status Code | Type | Description
--- | --- | ---
404 | not_found | if the tag for the given `tag_id` does not exist in the system.
403 | unauthorized | if you do not have the privilege to add an entity to the cis.tagging.tag_model.used_by field.