Detach a conversation

Example Request & Response

$ curl https://api.intercom.io/conversations/<id>/tags/<tag_id> \
-X DELETE \
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept:application/json' -d

{
  "admin_id": "123"
}

HTTP/1.1 200 OK
{
  "type": "tag",
  "id": "2084335",
  "name": "Independent"
}

Example Errors

HTTP/1.1 404 NOT FOUND
{
  "type": "error.list",
  "request_id": "9a3d0816-9707-4598-977e-c009ba630148",
  "errors": [
    {
      "code": "not_found",
      "message": "Contact Not Found"
    }
  ]
}

HTTP/1.1 404 NOT FOUND
{
  "type": "error.list",
  "request_id": "5f6b2623-f844-4914-8b8d-ac01acc62a76",
  "errors": [
    {
      "code": "not_found",
      "message": "Resource Not Found"
    }
  ]
}

You can untag a single conversation.

Request Path Parameter

Parameter	Type	Required	Description
id	String	Yes	The unique identifier for the conversation which is given by Intercom
id	String	Yes	The unique identifier for the tag which is given by Intercom

Request Body Parameter

Parameter	Type	Required	Description
admin_id	String	Yes	The unique identifier for the admin who is removing the tag.

Response

This will return a Tag model for the tag that was removed from the conversation.