You can Update Private & Public bins using the Update API.

Request Type
Request Headers
Header Value Required
Content-Type application/json Yes
X-Master-Key <YOUR_API_KEY> No
X-Bin-Versioning <true / false> No

Content-Type needs to be set to application/json. The request will result in an error in-case of a missing Content-Type header.


X-Master-Key needs to be passed in-order to Update a Private bin. In-order to get the key, you need to sign-up and navigate to API Keys page.

Note: One can update a Public record without passing an X-Master-Key.


You can control the Bin versioning using this header. By default, the versioning is turned off for all the Private bins. If you want to enable the versioning, you need to pass the above header with a value of true.

Note: Bin versioning is enabled for all the Public bins by default. Only the owner of the bin can turn off the Version control by passing the X-Master-Key along with X-Bin-Versioning set to false

Basic Code Samples
curl -v\
  -H "Content-Type: application/json" \
  -H "X-Master-key: <YOUR_API_KEY>" \
  --request PUT \
  --data '{"sample": "Hello World"}' \<BIN_ID>
let req = new XMLHttpRequest();

req.onreadystatechange = () => {
  if (req.readyState == XMLHttpRequest.DONE) {
};"PUT", "<BIN_ID>", true);
req.setRequestHeader("Content-Type", "application/json");
req.setRequestHeader("X-Master-Key", "<YOUR_API_KEY>");
req.send('{"sample": "Hello World"}');
import requests
url = '<BIN_ID>'
headers = {
  'Content-Type': 'application/json',
  'X-Master-Key': '<YOUR_API_KEY>'
data = {"sample": "Hello World"}

req = requests.put(url, json=data, headers=headers)
require 'net/http'
require 'json'

uri = URI("<BIN_ID>")
res = Net::HTTP.start(, uri.port, use_ssl: true) do |http|
  req =
  req['Content-Type'] = 'application/json'
  req['X-Master-Key'] = '<YOUR_API_KEY>'

  req.body = {"sample": "Hello World"}.to_json

puts res.body
Request Response
  "record": {
    "sample": "Hello World"
  "metadata": {
    "parentId": "<BIN_ID>",
    "private": true
400, 401, 403, 404
  "message": "<ERROR_MESSAGE>"
Status Code Error Message
400 Bad Request
You need to pass Content-Type set to application/json
400 Bad Request
Invalid Bin Id provided
400 Bad Request
Bin cannot be blank
404 Not Found
Bin not found
401 Unauthorized
You need to pass X-Master-Key in the header to update a private bin
401 Unauthorized
Invalid X-Master-Key provided or the bin does not belong to your account
403 Forbidden
Free users cannot update a record over 500kb. Upgrade to Pro plan to update records upto 1mb
403 Forbidden
Requests exhausted. Buy additional requests at
403 Forbidden
Versioning is not available for the Free users. Upgrade to Pro plan to avail this feature
400 Bad Request
Schema Doc Validation Mismatch: key:val