Delete a Recordset


  • Delete a recordset


  • Delete

API Operation Object

  • Recordset

Synchronous / Asynchronous

  • Synchronous


HTTP Request Method


HTTP Request Path


HTTP Request Header


Content-Type: application/json
Accept: application/json
X-Auth-Token: <token_id>

HTTP Request Body

  • none

Request Parameter

name style format description required/optional default value action for invalid parameter response code for invalid parameter
token_id header authentication token string authentication token required - Terminate 401
zone_id path uuid ID for the zone required - Terminate 400,404
recordset_id path uuid ID for the recordset required - Terminate 400,403,404


HTTP Response Header


HTTP/1.1 <response_code>       (ex. 200)
  • <response_code>: see "Response Code" section

Response Code

response code status condition message
204 No Content normal end  
400 Bad Request invalid value E2042 Zone id is required.
403 Forbidden forbidden E2062 Default NS recordset can't delete.
  Forbidden forbidden E2063 Default SOA recordset can't modify.
404 Not Found not exists E2007 Specified zone is not found.
  Not Found not exists E2008 Specified recordset is not found.
401 Unauthorized authentication failure E2001 Invalid token.
500 Internal Server Error internal server error E9001 Internal Server Error. Request failed.

Response Body

  • none

Response Parameter

  • none

Sample Request and Response

Sample API Request

Request URL

DELETE /v2/zones/fbe8562b-66a5-4071-b4c2-250487d15a81/recordsets/2514d0c1-d41e-4fd0-b736-acf3fbd1e03a

Request Header

Content-Type: application/json
Accept: application/json
X-Auth-Token: e8c788fbaeb14964ae19759eb1df4ff1

Request Body

  • none

Sample API Response

Response Header

HTTP/1.1 204
Date: Mon, 24 Oct 2016 06:32:17 GMT
Connection: keep-alive
Set-Cookie: TS0183560f=01cce65ce1a9b4bad9a75c63c2ba25247b78708a009952cb20bc4248f5da08399d51c5528f; Path=/

Response Body

  • none

Sample Error Response


HTTP/1.1 404
Date: Mon, 24 Oct 2016 06:32:30 GMT
Content-Type: application/json
Content-Length: 94
Connection: keep-alive
Set-Cookie: TS0183560f=01cce65ce18b6ed4db4bb2cc92d7bdcf47206c5fd2454b51e86f27c10dd11b0aee5500e33c; Path=/

{"error":{"code":404,"title":"Not Found","message":"E2008 Specified recordset is not found."}}