This API method deletes an existing zone record. . After deleting one or more records the Commit Zone API method must be called in order to make the change(s) active.

Request

DELETE /record/zone_name/record_id HTTP/1.0
Host: api.gslb.me 
Accept: encoding_type
Authorization: Basic base64_credentials

Where:

  • zone_name is the name of the zone for which you want to modify a record for (ie.: mydomain.com)
  • record_id is the ID of the record you want to modify. Records IDs can be retrieved using the Get Zone Records method
  • 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)

Sample requests:

  • Raw request:
DELETE /record/mydomain.com/572 HTTP/1.0
Host: api.gslb.me
Accept: application/json
Authorization: Basic dGVzdHVzZXJAZ3NsYi5tZTp0ZXN0cGFzc3dvcmQK
  • Using curl:
curl -u testuser@gslb.me:testpassword -X DELETE -H "Accept: application/json" -k https://api.gslb.me/record/mydomain.com/572

Response

  • In case of invalid zone:
HTTP/1.1 404 Not Found
Content-Type: application/json

{"message":"Zone not found","returncode":"2"}
  • In case of invalid record ID:
HTTP/1.1 404 Not Found
Content-Type: application/json

{"message":"Record not found","returncode":"2"}
  • In case of success:
HTTP/1.1 200 OK
Content-Type: application/json

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

{"message":"Internal error, please contact support@gslb.me","returncode":"4"}