Intercom API (unofficial showcase)
DELETE/tags/{tag_id}

Delete a tag

Deletes a tag from the workspace. Use the tag_id path parameter to identify the tag to delete; a tag with dependent objects cannot be deleted.

2 parameters
tag_idstringrequired
The unique identifier of the tag to delete.
Intercom-Versionstringoptional
The Intercom API version to use. Defaults to 2.17 when omitted.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

4 status codes
200Confirms that the tag was deleted.
400Returned when the tag has dependent objects and cannot be deleted.

One documented failure

  • tag_has_dependent_objects

    Unable to delete Tag with dependent objects. Segments: Seg 1.

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
401Returned when the request is unauthorized.

One documented failure

  • unauthorized

    Access Token Invalid

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
404Returned when the tag does not exist.

One documented failure

  • not_found

    Resource Not Found

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects

Error handling

A 400 is returned when the tag has dependent objects and cannot be deleted. A 401 is returned when the request is unauthorized, and a 404 is returned when the tag_id path parameter does not identify an existing tag. The Intercom-Version header selects the API version and defaults to 2.17 when omitted.