Detach a conversation

Example Request & Response

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

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"
    }
  ]
}
HTTP/1.1 404 BAD REQUEST
{
  "type": "error.list",
  "request_id": "5f6b2623-f844-4914-8b8d-ac01acc62a76",
  "errors": [
    {
      "code": "parameter_not_found",
      "message": "admin_id is a required parameter"
    }
  ]
}

You can untag a single conversation.

Request Path Parameter

ParameterTypeRequiredDescription
idStringYesThe unique identifier for the conversation which is given by Intercom

Request Body Parameter

ParameterTypeRequiredDescription
admin_idStringYesThe unique identifier for the admin (which is given by intercom) performing the untag action.

Response

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