Intercom API (unofficial showcase)
DELETE/internal_articles/{internal_article_id}/tags/{id}

Remove a tag from an internal article

Removes a tag from an internal article. Use internal_article_id and id to identify the article and tag; the authenticated user must have the manage_knowledge_base_content permission and the read_write_articles_scope OAuth scope.

3 parameters
internal_article_idintegerrequired
The unique integer identifier of the internal article to remove the tag from.
idstringrequired
The unique identifier of the tag to remove.
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
200Returns the removed tag, with `applied_at` and `applied_by` set to null.
typestringoptional
value is "tag"
idstringoptional
The id of the tag
namestringoptional
The name of the tag
applied_atintegeroptional
The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket.
applied_byobjectoptional
The admin who applied the tag. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket.
401Returned when the request is not authorized.

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
403Returned when the authenticated user lacks permission to manage knowledge base content.

One documented failure

  • forbidden

    Not authorized to manage knowledge base content

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

2 documented failures

  • internal_article_not_found

    Internal article not found

  • tag_not_found

    Tag not found

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

Error handling

A 401 is returned when the request is not authorized. A 403 is returned when the authenticated user lacks the manage_knowledge_base_content permission. A 404 is returned when the internal article or tag does not exist; the internal_article_id path parameter identifies the article and the id path parameter identifies the tag. The request requires the read_write_articles_scope OAuth scope.