Intercom API (unofficial showcase)
DELETE/news/news_items/{news_item_id}

Delete a news item

Deletes a single news item. Use news_item_id to identify the item to remove. The response confirms whether the item was deleted and identifies the deleted object.

2 parameters
news_item_idintegerrequired
The unique integer identifier of the news item to delete.
Intercom-Versionstringoptional
The Intercom API version to use. Defaults to 2.17 when omitted; supported values include the versions listed in the schema.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

3 status codes
200Returns a deletion object containing the supplied item identifier, the `news-item` object type, and a boolean indicating whether deletion succeeded.
idstringoptional
The unique identifier for the news item which you provided in the URL.
objectstringoptional
The type of object which was deleted - news-item.
Allowed:news-item
deletedbooleanoptional
Whether the news item 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 the requested news item 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 resource is not available for deletion. A 401 is returned when the request is unauthorized; send valid API credentials. A 404 is returned when no news item exists with the specified news_item_id path parameter.