Delete XL Bins API

You can delete your XL Bins using the Delete XL Bins API.

Root

https://api.jsonbin.io/v3

Route

Delete a specific Bin

/b/<BIN_ID>

Request Type

DELETE

Request Headers

Below are the list of Accepted Request Headers if you are trying to Delete a JSON record.

Request Header	Value	Required
X-Master-Key	<API_KEY>	Yes

X-Master-Key Required

X-Master-Key is nothing but your Core API Access Key. You will need this Key to access mostly any API end-point on JSONBin. You could find the key on the API Keys page.

Code Samples

cURL
JavaScript (ES6)
Python 3
Ruby

curl -v\
  -H "X-Master-key: <YOUR_API_KEY>" \
  --request DELETE
    https://api.jsonbin.io/v3/xl/b/<BIN_ID>

let req = new XMLHttpRequest();

req.onreadystatechange = () => {
  if (req.readyState == XMLHttpRequest.DONE) {
    console.log(req.responseText);
  }
};

req.open("DELETE", "https://api.jsonbin.io/v3/xl/b/<BIN_ID>", true);
req.setRequestHeader("X-Master-Key", "<YOUR_API_KEY>");
req.send();

import requests
url = 'https://api.jsonbin.io/v3/xl/b/<BIN_ID>'
headers = {
  'X-Master-Key': '<YOUR_API_KEY>'
}

req = requests.delete(url, json=None, headers=headers)
print(req.text)

require 'net/http'
require 'json'

uri = URI("https://api.jsonbin.io/v3/xl/b/<BIN_ID>")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  req = Net::HTTP::Delete.new(uri)
  req['X-Master-Key'] = '<YOUR_API_KEY>'

  http.request(req)
end

puts res.body

Request Response

Success Status Code: 200

{
  "metadata": {
    "id": "<BIN_ID>"
  },
  "message": "Bin deleted successfully"
}

Error Status Code: 400, 401, 403

{
  "message": "<Error Message>"
}

For more information on the error codes & errors you might possibly encounter, refer to the below section.

Error Reference

400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found

Invalid XL Bin Id provided

You'll encounter this error if the XL Bin Id you are trying to access is invalid. Hence, ensure that the Bin Id you are passing is valid.

XL bin not found or it doesn't belong to your account

The XL Bin you are trying to Delete does not exists or does not belong to your account. Make sure you are passing the right XL Bin ID or the right X-Master-Key

Create a Free Account

Create an Account View Pricing

{}jsonbin.io