Delete Channel

Delete channel with HTTP DELETE

Request

HTTP Method

DELETE

URL

https://api.thingspeak.com/channels/<channel_id>.<format>

URL Parameters

Name	Description
<channel_id>	(Required) Channel ID for the channel of interest, specified as an integer.
<format>	(Required) Format for the HTTP response, specified as json or xml.

Example: https://api.thingspeak.com/channels/999990.json

Body Parameters

Name	Description	Value Type
api_key	(Required) Specify User API Key, which you can find in your profile. This key is different from the channel API keys.	string

Content-Type

application/x-www-form-urlencoded

Response

Success

HTTP Status Code

200 OK

Body

 JSON Example

DELETE https://api.thingspeak.com/channels/4.json api_key=XXXXXXXXXXXXXXXX

The response is a JSON object of the channel before it was deleted, for example: { "id": 4, "name": "My New Channel", "description": null, "latitude": null, "longitude": null, "created_at": "2014-03-25T13:12:50-04:00", "elevation": null, "last_entry_id": null, "ranking": 15, "username": "iothans", "tags": [] }

 XML Example

DELETE https://api.thingspeak.com/channels/4.xml api_key=XXXXXXXXXXXXXXXX

The response is an XML object of the channel before it was deleted, for example: <?xml version="1.0" encoding="UTF-8"?> <channel> <id type="integer">4</id> <name>My New Channel</name> <description nil="true" /> <latitude type="decimal" nil="true" /> <longitude type="decimal" nil="true" /> <created-at type="dateTime">2014-03-25T20:17:44-04:00</created-at> <elevation nil="true" /> <last-entry-id type="integer" nil="true" /> <ranking type="integer">15</ranking> <username>iothans</username> <tags type="array" /> </channel>

Error

For the full list, see Error Codes.

Examples

Use POSTMAN to Remove Channel

You can use POSTMAN to try out your HTTP requests using the RESTful API for ThingSpeak. This example shows how to clear a channel using POSTMAN.

Here is the format of the HTTP request.

DELETE https://api.thingspeak.com/channels/400834.json
       api_key=XXXXXXXXXXXXXXXX

1. In POSTMAN, select DELETE from the drop-down list of HTTP verbs.

2. In the address bar, enter https://api.thingspeak.com/channels/<channelID>.json, replacing <channelID> with the ID of the channel you want to remove.

3. Under the Body section, choose x-www-form-urlencoded.

4. Enter the parameter api_key and your user API Key, which is found in Account > My Profile.

The response is a JSON object of the channel settings before deletion.