Web Service Endpoint

Delete an Article

Delete the specified article from your channel.

URL

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

Path Parameters

articleId
string
(Required)

UUID of the article you want to delete. The article ID is returned when you create an article (see Create an Article) and in Read Article Information and Update an Article responses.

Response Codes

204 No Content
No Content

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

400 Bad Request
Bad Request

The Article UUID field was not supplied in the request. Key path: *

401 Unauthorized
Unauthorized

The Authorization header was not supplied. Key path: N/A

403 Forbidden
Forbidden

You tried to access an article your API key does not have permission to access. Key path: N/A

404 Not Found
Not Found
  • The endpoint you tried to access does not exist. Key path: N/A

  • The article you tried to access does not exist. Key path: articleId

Discussion

For devices on which the article has already been viewed, it may take some time for the cache to be refreshed and for the article to disappear.

Example

DELETE /articles/a3caeb08-b9db-4002-b379-cde305d74be7 HTTP/1.1Host: news-api.apple.comAccept: application/jsonAuthorization: HHMAC; key="1e3gfc5e-e9f8-4232-a6be-17bf40edad09"; signature="irqw07DCRQLtx/40Z2VhNc7sl3nB1PKII374R7AHjUQ="; date="2015-02-28T00:03:31Z"
HTTP/1.1 204 No ContentDate: Sat, 28 Feb 2015 00:51:41 GMT

See Also

Articles

Create an Article

Publish an article to your channel.

Read Article Information

Retrieve information about an article, such as the revision number and maturity rating.

Search Articles in a Channel

See a list of all articles in a channel that match the specified search criteria.

Search Articles in a Section

See a list of all articles in a section that match the specified search criteria.

Update an Article

Update an existing article in your channel.

object Create Article Metadata Fields

See the optional metadata fields for the create article request.

object ArticleLinksRequest

See the required field for the create article request.

object Update Article Metadata Fields

See the metadata fields for the update article request.

object Article

See the fields returned by the article endpoints.

object ArticleResponse

See which objects make up the create article, read article, and update article responses.

object ArticleLinksResponse

See the links returned by the article endpoints.

object SearchResponse

See the fields returned by the search article endpoints.

object Meta

See the object that wraps the throttling information that's returned for the create article and read article endpoints.

object Throttling

See the object that wraps the throttling information that's returned for the create article and update article endpoints.