Contents

Delete an Article

Delete the specified article from your channel.

URL

DELETE https://news-api.apple.com/articles/{articleId}

Path Parameters

NameTypeDescription
articleId Requiredstring

The UUID or the Share URL ID of the article you want to delete. The server returns the article ID and the Share URL when you create an article (see Create an Article) and in Read Article Information and Update an Article responses.

Response Codes

StatusReasonTypeDescription
204No Content

The request was successful but there was no response in the body.

400Bad Request
Content-Type: application/json
Error

  • You didn’t include the article UUID or the Share URL ID field in the request. Key path: *

  • The Apple News team optimized the article, so your article wasn’t deleted. Contact your Apple News technical representative if you need to delete it.

401Unauthorized
Content-Type: application/json
Error

You didn’t include the Authorization header. Key path: N/A

403Forbidden
Content-Type: application/json
Error

You tried to access an article your API key doesn’t have permission to access. Key path: N/A

404Not Found
Content-Type: application/json
Error

  • The endpoint you tried to access doesn’t exist. Key path: N/A

  • The article you tried to access doesn’t exist. Key path: articleId.

Discussion

If the article is viewed on a device, it may take some time for the News app to refresh the cache so the article disappears on that device.

Example

See Also

Articles