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

## cis tagging tag association: detach

Detaches the tag from the given object. If the tag is already removed from the object, then this operation is a no-op and an error will not be thrown. To invoke this operation, you need the attach tag privilege on the tag and the read privilege on the object.

### Request:

#### HTTP request

POST https://{server}/rest/com/vmware/cis/tagging/tag-association/id:{tag_id}?~action=detach

#### Path Parameters

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

#### Request Body Structure:

- JSON
- XML

{
"object_id": {
"id": "obj-103",
"type": "string"
}
}
<?xml version="1.0" ?>
<ns0:Detach-Input xmlns:ns0="http://vmware.com/cis/tagging/tag_association" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<object_id>
<id>obj-103</id>
<type>string</type>
</object_id>
</ns0:Detach-Input>

#### Request Body Parameters:

Name | Type | Description
--- | --- | ---
bold = required
object_id | dynamic_ID | The identifier of the input object.
object_id.type | string | The type of resource being identified (for example `com.acme.Person`). Services that contain operations for creating and deleting resources typically contain a constant specifying the resource type for the resources being created and deleted. The API metamodel metadata services include a service that allows retrieving all the known resource types.
object_id.id | string | The identifier for a resource whose type is specified by vapi.std.dynamic_ID.type. When clients pass a value of this structure as a parameter, the field `type` must contain the actual resource type. When operations return a value of this structure as a result, the field `type` will contain the actual resource type.

### 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 detach the tag or do not have the privilege to read the given object.