Stop recording an interaction filter to your index.

To learn how to use the endpoints together take a look at our PYLON API step-by-step page.

An HTTP PUT request sent to:

A successful call to this endpoint returns: 204 No Content.


Parameter Description

The id of the recording you want to stop.


Sample request

curl -X PUT \
  -d '{"id": "d1b7d73b47c639ea3cc290595bca888ca4388afe"}' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: username:api_key'


HTTP/1.1 204


Response code Description
Status 204 No Content The recording was successfully stopped.
Status 400 Bad Request You did not supply an id.
Status 404 Not Found No recording with the given id could be found.
Status 409 Conflict

The subscription has already been stopped.

    "error" : "Subscription not running"


  1. All calls to the API must be properly authenticated with a DataSift username and API key.
  2. All calls to the API must be versioned. The current version is v1.5.
  3. Note that the username is the one you use to log in to and to make calls to any of the REST endpoints but the API key is the one that was returned by your call to the  POST /account/identity endpoint. That is, it is an identity-based API key.
  4. Take a look at our Changelog page to review the changes we've made to the DataSift API over time.

Revision history


Up to v1.2 this endpoint required the hash of the CSDL interaction filter you wanted to stop.

From v1.3 it takes the id of the recording you want to stop. The id is supplied in the JSON returned by your call to the /pylon/start endpoint.

Resource information

Rate limit cost: 5

Requires authentication: Yes

Response formats: JSON, JSONP