DELETE/articles/{article_id}

Delete an article

Deletes an article from the help center. Use the article_id path parameter to identify the article to remove. The response confirms whether the article was deleted.

2 parameters
article_idintegerrequired
The unique integer identifier for the article 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

3 status codes
200Returns a deletion result containing the article ID, the object type `article`, and a boolean indicating whether deletion succeeded.
idstringoptional
The unique identifier for the article which you provided in the URL.
objectstringoptional
The type of object which was deleted. - article
Allowed:article
deletedbooleanoptional
Whether the article was deleted successfully or not.
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 no article exists with the given `article_id`.

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 401 is returned when the request is unauthorized. A 404 is returned when the article_id path parameter does not identify an article.