historics/delete

Delete one specified Historics query. If the query is currently running, stop it.

An HTTP DELETE request sent to:

https://api.datasift.com/v1.3/historics/delete

A successful call to this endpoint returns: 204 No Content. No JSON object is returned to you.

Parameters

Parameter Description
id
required

The id of a Historics query.

Example values: 2490313575797478a5c3

Examples

  1. If you provide a Historics id:

curl -X DELETE https://api.datasift.com/v1.3/historics/delete?id=6cc90a14f570c4acdd22 
    -H 'Authorization:username:apikey'

If you try to delete a Historic that does not exist, you receive an HTTP 404 with a JSON message that looks like this:

{"error":"No historics found with the ID 25ee467e0df7c7f61380 "}

Notes

  1. Be sure to read our introduction to the Historics API to get started with these endpoints.
  2. All calls to the API must be properly authenticated with a DataSift username and API key.
  3. All calls to the API must be versioned. The current version is v1.3.

Resource information

Rate limit cost: 25

Requires authentication: Yes

Response formats: JSON, JSONP