This API method commits pending changing for an existing zone. Whenever one record (RRset) is added, modified or deleted the change is saved but not active until this “Commit Zone” method is called.


POST /commit/zone/zone_name HTTP/1.0
Accept: encoding_type
Content-Length: 0
Authorization: Basic base64_credentials


  • zone_name is the name of the zone you want to commit
  • base64_credentials is username:password in base64-encoded format (HTTP Basic Authentication)
  • encoding_type is either application/xml or application/json (if the “Accept” header is omitted, response will be JSON-encoded)

Note: The “Content-Length: 0” header is mandatory.

Sample requests:

  • Raw request:
POST /commit/zone/ HTTP/1.0
Accept: application/json
Content-Length: 0
Authorization: Basic dGVzdHVzZXJAZ3NsYi5tZTp0ZXN0cGFzc3dvcmQK
  • Using curl:
curl -u -X POST -H "Accept: application/json" -H "Content-Length: 0" -k


  • In case of success:
HTTP/1.1 200 OK
Content-Type: application/json

  • If the zone is not valid
HTTP/1.1 404 Not Found
Content-Type: application/json

{"message":"Zone not found","returncode":"2"}
  • In case of internal error:
HTTP/1.1 500 Server Error
Content-Type: application/json

{"message":"Internal error, please contact","returncode":"4"}