CloudDNS REST API

CloudDNS REST API

API Calls

 

GENERATING ACCESS TOKEN

 

    1. Login to https://clouddns.manageengine.com and click on user profile in the right corner of the  Navbar

    1. Click on view client credentials and copy the client ID and client secret.

    1. Make an API call to https://clouddns.manageengine.com/oauth2/token/ (POST) with the credentials received and set the key grand_type as client_credentials, these must be set in the form data

    1. Access token has 30 minutes of validity

 

 

Headers

Form Data

Example Response

 

Content-Type     application/json

 

 

client_id: ggV0IWqAU3huwyNeakhlrmbjhdbsjsd15Lax9YPzhQ6Uws

 

client_secret: EOPEF3MppjQ4zbZPZ9If K53YJ4qv026ARLlhugiuiuSus9VYVb4sJjtFOyvOgpOmmWmbsYaQupZfc3nioSjLTS2TtmachidshihsidsdVIPoHbHJmpkXKULCwHzt6UnUB

 

grant_type: client_credentials

 

{

    "access_token": "Pn82NLlMc5ONG5AmBdEoB8BtBqljPe",

    "expires_in": 1800,

    "token_type": "Bearer",

    "scope": "read write"

}

 

 

 

DOMAINS

 

GET All:

 

    https://clouddns.manageengine.com/v1/dns/domain

 

Returns a list of all domains in the organisation

 

 

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

[

    {

        "zone_id": 1,

        "zone_name": "test.com.",

        "zone_ttl": 500,

         "zone_type":0,

        "zone_targeting": true,

        "zone_logging": "{}",

        "zone_contact": "mathes.zoho.com",

        "refresh": 43200,

        "retry": 3600,

        "expiry": 1209600,

        "minimum": 180,

        "org": 2,

        "any_query": false,

        "dnssec": true,

        "ns_id": 1,

        "serial": 2022042206,

        "ns": "[\"ns11.zns-53.com.\",\"ns21.zns-53.net.\",\"ns31.zns-53.com.\",\"ns41.zns-53.net.\"]",

        "ds": [

            {

                "record_id": 59,

                "keyTag": 36938,

                "algorithm": 13,

                "digestType": 1,

                "digest": "e9f03d176455d5d16f826b69f9ecb11f59be35e7",

                "domain_id": 30

            },

            {

                "record_id": 60,

                "keyTag": 36938,

                "algorithm": 13,

                "digestType": 2,

                "digest": "7ea640a8668eafd9d89a9b2e9994f5fcfb1dee0668d1e93ba556aa57ac047f96",

                "domain_id": 30

            }

        ]

    },

    {

        "zone_id": 2,

        "zone_name": "test2.com.",

        "zone_ttl": 1000,

          "zone_type":0,

        "zone_targeting": false,

        "zone_logging": "{}",

        "zone_contact": "mathes.zoho.com",

        "refresh": 43200,

        "retry": 3600,

        "expiry": 1209600,

        "minimum": 180,

        "org": 2,

        "any_query": false,

        "dnssec": false,

        "ns_id": 1,

        "serial": 2022040608,

        "ns": "[\"ns11.zns-53.com.\",\"ns21.zns-53.net.\",\"ns31.zns-53.com.\",\"ns41.zns-53.net.\"]"

    },

    {

        "zone_id": 20,

        "zone_name": "hello45.com.",

        "zone_ttl": 3000,

        "zone_targeting": false,

        "zone_logging": "{}",

        "zone_contact": "mathes.zoho.com",

        "refresh": 43200,

        "retry": 3600,

        "expiry": 1209600,

        "minimum": 180,

        "org": 2,

        "any_query": false,

        "dnssec": false,

        "ns_id": 1,

        "serial": 2022040711,

        "ns": "[\"ns11.zns-53.com.\",\"ns21.zns-53.net.\",\"ns31.zns-53.com.\",\"ns41.zns-53.net.\"]"

    },

    {

        "zone_id": 22,

        "zone_name": "zohoaccl.com.",

        "zone_ttl": 300,

         "zone_type":0,

        "zone_targeting": true,

        "zone_logging": "{}",

        "zone_contact": "networkone.zohocorp.com",

        "refresh": 43200,

        "retry": 3600,

        "expiry": 1209600,

        "minimum": 180,

        "org": 2,

        "any_query": false,

        "dnssec": false,

        "ns_id": 1,

        "serial": 2022042206,

        "ns": "[\"ns11.zns-53.com.\",\"ns21.zns-53.net.\",\"ns31.zns-53.com.\",\"ns41.zns-53.net.\"]"

    },

    {

        "zone_id": 23,

        "zone_name": "zohocal.com.",

        "zone_ttl": 300,

          "zone_type":0,

        "zone_targeting": true,

        "zone_logging": "{}",

        "zone_contact": "mathes.zoho.com",

        "refresh": 43200,

        "retry": 3600,

        "expiry": 1209600,

        "minimum": 180,

        "org": 2,

        "any_query": false,

        "dnssec": false,

        "ns_id": 1,

        "serial": 2022041310,

        "ns": "[\"ns11.zns-53.com.\",\"ns21.zns-53.net.\",\"ns31.zns-53.com.\",\"ns41.zns-53.net.\"]"

    }

]

 

 

 

 

POST Create:

 

    https://clouddns.manageengine.com/v1/dns/domain/

 

Creates a domain in the organisation.(Note: set  'zone_type' as  0 for Primary GeoDNS, 1 for Primary AXFR and 2 for Secondary)

 

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

config:
    {
  "zone_name":"localzoho.com.",

        "zone_type": 0,

        "zone_ttl": 600,

        "zone_targeting": true,

        "zone_logging": "{}",

        "zone_contact": "zoho-accl.zohocorp.com",

        "refresh": 4500,

        "retry": 4000,

        "expiry": 1209500,

        "minimum": 500,

        "any_query": false,

        "dnssec": true

 


    }

 

{

    "zone_id": 13,

    "zone_name": "localzoho.com.",

    "zone_ttl": 300,

      "zone_type":0,

    "zone_targeting": false,

    "zone_logging": "{}",

    "zone_contact": "zoho-accl.zohocorp.com",

     "refresh": 4500,

    "retry": 4000,

    "expiry": 1209500,

    "minimum": 500,

    "org": 2,

    "any_query": false,

    "dnssec": true,

    "ns_id": 1,

    "serial": 2022110308,

    "sec_ns": null,

    "ns": "[\"ns21.zohodns.org.\", \"ns11.zohodns.org.\"]",

    "ds": [

        {

            "record_id": 147,

            "keyTag": 40830,

            "algorithm": 13,

            "digestType": 1,

            "digest": "de9d5503c2ed4af17423687205cf9c11f6b7ddd9",

            "domain_id": 82,

            "disabled": false

        },

        {

            "record_id": 148,

            "keyTag": 40830,

            "algorithm": 13,

            "digestType": 2,

            "digest": "a98e0cf4bed5948b6ce0dbe21569a57186da9ef7e0ce75583726c1ec324df281",

            "domain_id": 82,

            "disabled": false

        }

    ]

 

 

}

 

 

GET Specific:

 

    https://clouddns.manageengine.com/v1/dns/domain/1/

 

Returns the requested domain in the organisation

 

 

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

{

    "zone_id": 1,

    "zone_name": "test.com.",

    "zone_ttl": 500,

      "zone_type":0,

    "zone_targeting": true,

    "zone_logging": "{}",

    "zone_contact": "mathes.zoho.com",

    "refresh": 43200,

    "retry": 3600,

    "expiry": 1209600,

    "minimum": 180,

    "org": 2,

    "any_query": false,

    "dnssec": true,

    "ns_id": 1,

    "serial": 2022042206,

    "ns": "[\"ns11.zns-53.com.\",\"ns21.zns-53.net.\",\"ns31.zns-53.com.\",\"ns41.zns-53.net.\"]",

    "ds": [

        {

            "record_id": 59,

            "keyTag": 36938,

            "algorithm": 13,

            "digestType": 1,

            "digest": "e9f03d176455d5d16f826b69f9ecb11f59be35e7",

            "domain_id": 30

        },

        {

            "record_id": 60,

            "keyTag": 36938,

            "algorithm": 13,

            "digestType": 2,

            "digest": "7ea640a8668eafd9d89a9b2e9994f5fcfb1dee0668d1e93ba556aa57ac047f96",

            "domain_id": 30

        }

    ]

}

 

 

PUT Update:

 

    https://clouddns.manageengine.com/v1/dns/domain/1/

 

Update an existing domain in the organisation

 

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

config:
    {
       "zone_id":1,
        "zone_name": "zohocal.eu.",

         "zone_type":0,
        "zone_ttl": 800,
        "zone_targeting": false,
        "zone_logging": "{}",
        "zone_contact": "zoho-accl.zohocorp.com",
        "refresh": 43200,
        "retry": 3600,
        "expiry": 1209600,
        "minimum": 180,

         "dnssec":true
    }

 

{"message" : "Updated successfully"}

 

 

 

DEL Delete:

 

    https://clouddns.manageengine.com/v1/dns/domain/1/

 

Deletes an existing domain in the organisation

 

 

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

 

{"message" : "deleted successfully"}

 


IMPORT and EXPORT Records as BIND : 

 

GET Export:

 

    https://clouddns.manageengine.com/v1/dns/export_as_bind/{id}/

 

Headers

Example Response

 

Content-Type         application/octet-stream; charset=UTF-8;

Content-Disposition attachment; filename="example.com.txt"

 

authorization      Bearer {{access_token}}

 

 

;SOA

 

$ORIGIN example.com.

 

@   8640   IN     SOA     ns21.com.   a.com.   (

                    2023020665 ;serial

                    43200 ;refresh

                    3600 ;retry

                    1209600 ;expiry

                    180 ;minimum

 

                    )

 

;Root Records

;NS Records

@  86400   IN  NS ns21.com.

@  86400   IN  NS ns11.com.

 

;Other Records

;A Records

test.example.com.  86400   IN  A  3.3.3.3

test.example.com.  86400   IN  A  1.1.1.1

dns.example.com.  86400   IN  A  3.1.1.1

dnsexample.com.  86400   IN  A  4.33.21.1

a.example.com.  86400   IN  A  2.1.1.1

a.example.com.  86400   IN  A  3.1.1.1

 

 

 

 

 

 

POST Import:

 

    https://clouddns.manageengine.com/v1/dns/import_as_bind/{id}/

 

NOTE: Make sure that each DNS record is in a new line

 

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

config:
    
";SOA

 

$ORIGIN example.com.

 

@   8640   IN     SOA     ns21.com.   a.com.   (

                    2023020665 ;serial

                    43200 ;refresh

                    3600 ;retry

                    1209600 ;expiry

                    180 ;minimum

 

                    )

 

;Root Records

;NS Records

@  86400   IN  NS ns21.com.

@  86400   IN  NS ns11.com.

 

;Other Records

;A Records

test.example.com.  86400   IN  A  3.3.3.3

test.example.com.  86400   IN  A  1.1.1.1

dns.example.com.  86400   IN  A  3.1.1.1

dnsexample.com.  86400   IN  A  4.33.21.1

a.example.com.  86400   IN  A  2.1.1.1

a.example.com.  86400   IN  A  3.1.1.1

"
    

 

{"message" : "BIND imported successfully.

"}

 

AXFR :

 

GET All:

 

    https://clouddns.manageengine.com/v1/dns/domain/{domain_id}/axfr_config/

 

Headers

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

[

     {

        "id": 16,

        "zone_name": "sec.com.",

        "primary_servers": "14.5.4.5"

    },

    {

        "id": 19,

        "zone_name": "sec.com.",

        "primary_servers": "14.1.4.5,9.44.3.2"

    }

]

 

 

 

 

POST Create:

 

   https://clouddns.manageengine.com/v1/dns/domain/{domain_id}/axfr_config/

 

 

Configuring AXFR with TSIG for a secondary zone:

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

config:
    {

"zone_name":"sec.com.",

"tsig_keyname": "test",

"primary_servers":"41.5.4.5,11.2.2.2"  

}

 

 

 

{

        "id": 1,

        "tsig_keyname": "test",

        "zone_name": "sec.com.",

"zone_id":12,

        "primary_servers": "41.5.4.5,11.2.2.2"

    }

 

 

 

Configuring AXFR without TSIG for a secondary zone:

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

config:
    {

"zone_name":"sec.com.",

"primary_servers":"41.5.4.5,11.2.2.2"  

}

 

 

 

{

        "id": 1,

        "zone_name": "sec.com.",

"zone_id":12,

        "primary_servers": "41.5.4.5,11.2.2.2"

    }

 

 

 

GET Specific:

 

   https://clouddns.manageengine.com/v1/dns/domain/{domain_id}/axfr_config/{id}/

 

Headers

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

     {

        "id": 16,

        "zone_name": "sec.com.",

        "primary_servers": "14.5.4.5"

    }

 

 

 

 

 

 

 

PUT Update: 

 

   https://clouddns.manageengine.com/v1/dns/domain/{domain_id}/axfr_config/{id}/

 

 

Configuring AXFR with TSIG for a secondary zone:

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

config:
    {

"id": 1,

"zone_name":"sec.com.",

"tsig_keyname": "test",

"primary_servers":"4.5.4.5,11.2.2.2"  

}

 

 

 

{

        "id": 1,

        "tsig_keyname": "test",

        "zone_name": "sec.com.",

"zone_id":12,

 

        "primary_servers": "4.5.4.5,11.2.2.2"

    }

 

 

 

Configuring AXFR without TSIG for a secondary zone:

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

config:
    {

"id": 1,

"zone_name":"sec.com.",

"primary_servers":"41.5.4.5,1.2.2.2"  

}

 

 

 

{

        "id": 1,

        "zone_name": "sec.com.",

"zone_id":12,

 

        "primary_servers": "41.5.4.5,1.2.2.2"

    }

 

 

DEL Delete:

 

   https://clouddns.manageengine.com/v1/dns/domain/{domain_id}/axfr_config/{id}/

 

 

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

 

{"message" : "deleted successfully"}

 


TSIG

 

GET All:

 

    https://clouddns.manageengine.com/v1/dns/axfr_tsig_all/

 

Headers

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

[

    {

        "tsig_id": 1,

        "key_name": "test",

        "algorithm": "HMAC-SHA256",

        "secret_key": "ZRIvFMibTlb2r4F7QeBz0oOQAn+Jldyq5MW9fvYGvbg=",

        "zone_associated": []

    },

    {

        "tsig_id": 3,

        "key_name": "test_key",

        "algorithm": "HMAC-SHA256",

        "secret_key": "gYdATewY3wy0moBFrAw0jeNjWqdOCiPOQInPB+elkAM=",

        "zone_associated": []

    }

]

 

 

 


POST :

 

    https://clouddns.manageengine.com/v1/dns/axfr_tsig/

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

config:
   {

        "key_name": "test",

        "algorithm": "HMAC-SHA256",

        "secret_key": "ZRIvFMibTlb2r4F7QeBz0oOQAn+Jldyq5MW9fvYGvbg="

       

    }

 

 

{

        "tsig_id": 1,

        "key_name": "test",

        "algorithm": "HMAC-SHA256",

        "secret_key": "ZRIvFMibTlb2r4F7QeBz0oOQAn+Jldyq5MW9fvYGvbg="

 

    }

 

 

 

GET Specific:

 

    https://clouddns.manageengine.com/v1/dns/axfr_tsig/{id}/

 

Headers

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

    {

        "tsig_id": 1,

        "key_name": "test",

        "algorithm": "HMAC-SHA256",

        "secret_key": "ZRIvFMibTlb2r4F7QeBz0oOQAn+Jldyq5MW9fvYGvbg=",

        "zone_associated": []

    }

 

 

 

 

PUT Update: 

 

    https://clouddns.manageengine.com/v1/dns/axfr_tsig/{id}/

 

NOTE: Keyname can't be updated

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

config:
   {

         "tsig_id": 1,

        "key_name": "test",

        "algorithm": "HMAC-SHA256",

        "secret_key": "ZRIvFMibTlb2r4F7QeBz0oOQAn+Jldyq5ML9fvYGvbg="

       

    }

 

 

{

        "key_name": "test",

        "algorithm": "HMAC-SHA256",

        "secret_key": "ZRIvFMibTlb2r4F7QeBz0oOQAn+Jldyq5ML9fvYGvbg="

 

    }

 

 

 

 

DEL Delete:

 

    https://clouddns.manageengine.com/v1/dns/axfr_tsig/{id}/

 

 

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

 

{"message" : "deleted successfully"}

 


A (IPv4)

 

GET All:

 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/A

 

Returns a list of all A records in the specified domain

 

 

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

[

    {

        "a_domain_id": 14,

        "zone_id": 4,

        "domain_name": "t.zohocal.eu.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 1,

        "record_mode": "standard",

        "records": [

            {

                "record_id": 15,

                "ip": "172.21.100.102",

                "weight": 10,

                "active": true,

                "backup": false,

                "monitor_id": null,

                "monitor_status": 1,

                 "disabled":false,

                "domain_id": 14

            }

        ]

    },

    {

        "a_domain_id": 13,

        "zone_id": 4,

        "domain_name": "testing.zohocal.eu.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 1,

        "record_mode": "standard",

        "records": [

            {

                "record_id": 14,

                "ip": "172.21.100.101",

                "weight": 10,

                "active": true,

                "backup": false,

                "monitor_id": null,

                "monitor_status": 1,

                "disabled":false,

                "domain_id": 13

            }

        ]

    }
]

 

POST Create:

 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/A/

 

Creates one or more new A record(s) in a specified domain

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

config: [
     {

        "zone_id": 4,

        "domain_name": "t.zohocal.eu.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 1,

      

        "records": [

            {

                

                "ip": "172.21.100.102"

              

 

              

            }

        ]

    }
]

 

{"message" : "Record created successfully"}

 

GET Specific:

 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/A/6/

 

Returns a specified A record in the specified domain

 

 

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

[

    {

        "a_domain_id": 6,

        "zone_id": 4,

        "domain_name": "testing.zohodns.net.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 1,

        "record_mode": "standard",

        "records": [

            {

                "record_id": 6,

                "ip": "169.38.34.46",

                "weight": 10,

                "active": true,

                "backup": false,

                "monitor_id": null,

                "monitor_status": 1, 

                "disabled":false,

                "domain_id": 6

            }

        ]

    }

]

 

 

PUT Update:

 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/A/6/

 

Update an existing A record in the specified domain

 

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

config: [

    {

        "a_domain_id": 6,

        "zone_id": 4,

        "domain_name": "testing.zohodns.net.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 1,

      

        "records": [

            {

                "record_id": 6,

                "ip": "169.38.34.46",

                "disabled":false,

                "domain_id": 6

            }

        ]

    }

]

 

{"message" : "Record updated successfully"}

 

DEL Delete:

 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/A/6/

 

Deletes an existing A record in the specified domain

 

 

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

 

{"message" : "Record deleted successfully"}

 

 

AAAA (IPv6)

 

GET All:

 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/AAAA

 

Returns a list of all AAAA records in the specified domain

 

 

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

[

    {

        "aaaa_domain_id": 14,

        "zone_id": 4,

        "domain_name": "t.zohocal.eu.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 1,

        "record_mode": "standard",

        "records": [

            {

                "record_id": 15,

                "ip": "2001:db8:3333:4444:5555:6666:7777:7777",

                "weight": 10,

                "active": true,

                "backup": false,

                "monitor_id": null,

                "monitor_status": 1,,

                "disabled":false,

                "domain_id": 14

            }

        ]

    },

    {

        "aaaa_domain_id": 13,

        "zone_id": 4,

        "domain_name": "testing.zohocal.eu.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 1,

        "record_mode": "standard",

        "records": [

            {

                "record_id": 14,

                "ip": "2001:db8:3333:4444:5555:6666:7777:7799",

                "weight": 10,

                "active": true,

                "backup": false,

                "monitor_id": null,

                "monitor_status": 1,

                "disabled":false,

                "domain_id": 13

            }

        ]

    }
]

 

POST Create:

 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/AAAA/

 

Creates one or more new AAAA record(s) in a specified domain

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

config: [

 {

      

        "zone_id": 4,

        "domain_name": "t.zohocal.eu.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 1,

    

        "records": [

            {

               

                "ip": "2001:db8:3333:4444:5555:6666:7777:7777"

 

             

            }

        ]

    }

]

 

 

{"message" : "Record created successfully"}

 

GET Specific:

 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/AAAA/6

 

Returns a specified AAAA record in the specified domain

 

 

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

[

 {

        "aaaa_domain_id": 6,

        "zone_id": 4,

        "domain_name": "t.zohocal.eu.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 1,

        "record_mode": "standard",

        "records": [

            {

                "record_id": 15,

                "ip": "2001:db8:3333:4444:5555:6666:7777:7777",

                "weight": 10,

                "active": true,

                "backup": false,

                "monitor_id": null,

                "monitor_status": 1,

                "domain_id": 14

            }

        ]

    }

]

 

 

PUT Update:

 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/AAAA/6/

 

Update an existing AAAA record in the specified domain

 

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

config: [

 {

        "aaaa_domain_id": 6,

        "zone_id": 4,

        "domain_name": "t.zohocal.eu.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 9,

        

        "records": [

            {

                "record_id": 15,

                "ip": "2001:db8:3333:4444:5555:6666:7777:7777",

                "disabled":false,

             

 

                "domain_id": 14

            }

        ]

    }

]

 

{"message" : "Record updated successfully"}

 

DEL Delete:

 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/AAAA/6/

 

Deletes an existing AAAA record in the specified domain

 

 

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

 

{"message" : "Record deleted successfully"}

 

CNAME

GET All:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/Cname

Returns a list of all CNAME records in the specified domain

 

Headers

Example Response

 

Content-Type     application/json

authorization   Bearer {{access_token}}

 

[

    {

        "cname_domain_id": 14,

        "zone_id": 4,

        "domain_name": "t.zohocal.eu.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 9,

        "record_mode": "standard",

        "records": [

            {

                "record_id": 15,

                "host_fqdn": "www.test.com.",

                "weight": 10,

                "active": true,

                "backup": false,

                "monitor_id": null,

                "monitor_status": 1,

                "disabled":false,

                "domain_id": 14

            }

        ]

    },

    {

        "cname_domain_id": 13,

        "zone_id": 4,

        "domain_name": "testing.zohocal.eu.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 8,

        "record_mode": "standard",

        "records": [

            {

                "record_id": 14,

                  "host_fqdn": "www.test1.com.",

                "weight": 10,

                "active": true,

                "backup": false,

                "disabled":false,

  "monitor_id": null,

                "monitor_status": 1,

                "disabled":false,

                "domain_id": 13

            }

        ]

    }
]

 

POST Create:

   https://clouddns.manageengine.com/v1/dns/domain/4/records/Cname/

Creates one or more new CNAME record(s) in a specified domain

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

config: [
     {

       

        "zone_id": 4,

        "domain_name": "t.zohocal.eu.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 9,

     

        "records": [

            {   

               "host_fqdn": "www.test.com."

 

              

            }

        ]

    }
]

 

{"message" : "Record created successfully"}

GET Specific: 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/Cname/6/

Returns a specified CNAME record in the specified domain

 

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

[

    {

        "cname_domain_id": 6,

        "zone_id": 4,

        "domain_name": "testing.zohodns.net.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 1,

        "record_mode": "standard",

        "records": [

            {

                "record_id": 6,

                "host_fqdn": "www.test.com.",

                "weight": 10,

                "active": true,

                "backup": false,

                "monitor_id": null,

                "monitor_status": 1,

                "disabled":false,

                "domain_id": 6

            }

    ]

    }

]

    

 

 

PUT Update:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/Cname/6/

Update an existing CNAME record in the specified domain

 

Headers

Form Data

Example Response

 

Content-Type   application/json

authorization  Bearer {{access_token}}

 

config: [

    {

        "cname_domain_id": 6,

        "zone_id": 4,

        "domain_name": "testing.zohodns.net.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 1,

      

        "records": [

            {

                "record_id": 6,

               "host_fqdn": "www.test.com.",

                "disabled":false,

  "domain_id": 6

            }

        ]

    }

]

 

{"message" : "Record updated successfully"}

DEL Delete:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/Cname/6/

Deletes an existing CNAME record in the specified domain

 

Headers

Example Response

 

Content-Type                 application/json

authorization Bearer {{access_token}}

 

 

{"message" : "Record deleted successfully"}

 

ANAME

GET All:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/Aname 

Returns a list of all ANAME records in the specified domain

 

Headers

Example Response

 

Content-Type     application/json

authorization   Bearer {{access_token}}

 

[

    {

        "cname_domain_id": 14,

        "zone_id": 4,

        "domain_name": "@.zohocal.eu.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 1,

        "record_mode": "standard",

        "records": [

            {

                "record_id": 15,

                "host_fqdn": "www.test.com.",

                "weight": 10,

                "active": true,

                "backup": false,

                "monitor_id": null,

                "monitor_status": 1,

                "disabled":false,

                "domain_id": 14

            }

        ]

    },

    {

        "cname_domain_id": 13,

        "zone_id": 4,

        "domain_name": "@.zohocal.eu.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 8,

        "record_mode": "standard",

        "records": [

            {

                "record_id": 14,

                 "host_fqdn": "www.test1.com.",

                "weight": 10,

                "active": true,

                "backup": false,

  "monitor_id": null,

                "monitor_status": 1,

                "domain_id": 13

            }

        ]

    }
]

 

POST Create:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/Aname/

Creates one or more new ANAME record(s) in a specified domain

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

config: [
     {

       

        "zone_id": 4,

        "domain_name": "@.zohocal.eu.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 9,

      

        "records": [

            {   

               "host_fqdn": "www.test.com."

            

 

              

            }

        ]

    }
]

 

{"message" : "Record created successfully"}

GET Specific:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/Aname/6/

 Returns a specified ANAME record in the specified domain

 

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

[ {

        "cname_domain_id": 6,

        "zone_id": 4,

        "domain_name": "@.zohodns.net.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 1,

        "record_mode": "standard",

        "records": [

            {

                "record_id": 6,

                "host_fqdn": "www.test.com.",

                "weight": 10,

                "active": true,

                "backup": false,

                "monitor_id": null,

                "monitor_status": 1,

                "disabled":false,

                "domain_id": 6

            }

        ] } ]

 

 

 

PUT Update:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/Aname/6/

 Update an existing CNAME record in the specified domain

 

Headers

Form Data

Example Response

 

Content-Type   application/json

authorization  Bearer {{access_token}}

 

config: [

    {

        "cname_domain_id": 6,

        "zone_id": 4,

        "domain_name": "@.zohodns.net.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 1,

       

        "records": [

            {

                "record_id": 6,

               "host_fqdn": "www.test.com.",,

                "disabled":false,

              

 

                "domain_id": 6

            }

        ]

    }

]

 

{"message" : "Record updated successfully"}

DEL Delete:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/Aname/6/

Deletes an existing ANAME record in the specified domain

 

Headers

Example Response

 

Content-Type                 application/json

authorization Bearer {{access_token}}

 

 

{"message" : "Record deleted successfully"}

 

ALIAS

GET All:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/Alias 

Returns a list of all ALIAS records in the specified domain

 

Headers

Example Response

 

Content-Type     application/json

authorization   Bearer {{access_token}}

 

[

    {

        "alias_domain_id": 14,

        "zone_id": 4,

        "domain_name": "test.zohocal.eu.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 1,

        "record_mode": "standard",

        "records": [

            {

                "record_id": 15,

                "host_fqdn": "www.test.com.",

                "weight": 10,

                "active": true,

                "backup": false,

                "monitor_id": null,

                "monitor_status": 1,

                "disabled":false,

                "domain_id": 14

            }

        ]

    },

    {

        "alias_domain_id": 13,

        "zone_id": 4,

        "domain_name": "testing.zohocal.eu.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 1

        "record_mode": "standard",

        "records": [

            {

                "record_id": 14,

                 "host_fqdn": "www.test1.com.",

                "weight": 10,

                "active": true,

                "backup": false,

  "monitor_id": null,

                "monitor_status": 1,

                "disabled":false,

                "domain_id": 13

            }

        ]

    }
]

 

POST Create:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/Alias/

Creates one or more new ALIAS record(s) in a specified domain

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

config: [
     {

       

        "zone_id": 4,

        "domain_name": "test.zohocal.eu.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 9,

        "record_mode": "standard",

        "records": [

            {   

               "host_fqdn": "www.test.com.",

                "weight": 10,

                "active": true,

                "backup": false,

                "monitor_id": null,

                "monitor_status": 1

              

            }

        ]

    }
]

 

{"message" : "Record created successfully"}

GET Specific:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/Alias/6/

 Returns a specified ALIAS record in the specified domain

 

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

[ {

        "alias_domain_id": 6,

        "zone_id": 4,

        "domain_name": "test.zohodns.net.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 1,

        "record_mode": "standard",

        "records": [

            {

                "record_id": 6,

                "host_fqdn": "www.test.com.",

                "weight": 10,

                "active": true,

                "backup": false,

                "monitor_id": null,

                "monitor_status": 1,

                "disabled":false,

                "domain_id": 6

            }

        ] } ]

 

 

 

PUT Update:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/Alias/6/

Update an existing ALIAS record in the specified domain

 

Headers

Form Data

Example Response

 

Content-Type   application/json

authorization  Bearer{{access_token}}

 

config: [

    {

        "alias_domain_id": 6,

        "zone_id": 4,

        "domain_name": "test.zohodns.net.",

        "domain_ttl": 300,

        "domain_maxhost": 1,

        "domain_closest": true,

        "domain_location_id": 1,

        "record_mode": "standard",

        "records": [

            {

                "record_id": 6,

               "host_fqdn": "www.test.com.",

                "weight": 10,

                "active": true,

                "backup": false,

                "monitor_id": null,

                "monitor_status": 1,

                "disabled":false,

                "domain_id": 6

            }

        ]

    }

]

 

{"message" : "Record updated successfully"} 

DEL Delete:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/Alias/6

 Deletes an existing ALIAS record in the specified domain

 

Headers

Example Response

 

Content-Type                 application/json

authorization Bearer {{access_token}}

 

 

{"message" : "Record deleted successfully"}

 

MX

 GET All:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/MX/

 Returns a list of all MX records in the specified domain

Headers

Example Response

 

Content-Type     application/json

authorization   Bearer {{access_token}}

 

[

   {

      "mx_domain_id":6,

      "zone_id":4,

      "domain_name":"mxtest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "record_id":1,

            "host_fqdn":"testing.zohodns.net.",

            "weight":10,

            "preference":1,

                "disabled":false,

            "domain_id":6

         }

      ]

   },

   {

      "mx_domain_id":13,

      "zone_id":4,

      "domain_name":"@.zohocal.eu.",

      "domain_ttl":300,

      "domain_maxhost":1,

      "domain_location_id":1,

      "records":[

         {

            "record_id":1,

            "host_fqdn":"testing.zohodns.net.",

            "weight":10,

            "preference":1,,

                "disabled":false,

            "domain_id":6

         }

      ]

   }]

 

 

 POST Create:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/MX/

Creates one or more new MX record(s) in a specified domain

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

config: [

   {

      "zone_id":4,

      "domain_name":"mxtest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "host_fqdn":"testing.zohodns.net.",

            "weight":10,

            "preference":1

         }

      ]

   }

]

 

{"message" : "Record created successfully"}

GET Specific: 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/MX/6/

 Returns a specified MX record in the specified domain

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

[

   {

      "mx_domain_id":6,

      "zone_id":4,

      "domain_name":"mxtest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "record_id":1,

            "host_fqdn":"testing.zohodns.net.",

            "weight":10,

            "preference":1,

                "disabled":false,

            "domain_id":6

         }

      ]

   }

]

 

 

 

PUT Update:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/MX/6/

Update an existing MX record in the specified domain

 

Headers

Form Data

Example Response

 

Content-Type   application/json

authorization  Bearer {{access_token}}

 

config: [

   {

      "mx_domain_id":6,

      "zone_id":4,

      "domain_name":"mxtest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "record_id":1,

            "host_fqdn":"testing.zohodns.net.",

            "weight":10,

            "preference":1,,

                "disabled":false,

            "domain_id":6

         }

      ]

   }

]

 

 

{"message" : "Record updated successfully"} 

DEL Delete: 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/MX/6/

Deletes an existing MX record in the specified domain

 

Headers

Example Response

 

Content-Type                 application/json

authorization Bearer {{access_token}}

 

 

{"message" : "Record deleted successfully"}

  

NS

GET All:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/NS/

Returns a list of all NS records in the specified domain

Headers

Example Response

 

Content-Type     application/json

authorization   Bearer {{access_token}}

 

[

   {

      "ns_domain_id":6,

      "zone_id":4,

      "domain_name":"nstest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "record_id":1,

            "host_fqdn":"testing.zohodns.net.",

                "disabled":false,

 

            "domain_id":6

         }

      ]

   },

   {

      "ns_domain_id":13,

      "zone_id":4,

      "domain_name":"ns2.zohocal.eu.",

      "domain_ttl":300,

      "domain_maxhost":1,

      "domain_closest":true,

      "domain_location_id":8,

      "record_mode":"standard",

      "records":[

         {

            "record_id":1,

            "host_fqdn":"testing.zohodns.net.",

                "disabled":false,

            "domain_id":6

         }

      ]

   }

]

 

POST Create:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/NS/

Creates one or more new NS record(s) in a specified domain

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

config: [

   {

      "zone_id":4,

      "domain_name":"nstest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

         "host_fqdn":"testing.zohodns.net.",

         }

      ]

   }

]

 

{"message" : "Record created successfully"}

GET Specific:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/NS/6/

 Returns a specified NS record in the specified domain

  

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

[

   {

      "ns_domain_id":6,

      "zone_id":4,

      "domain_name":"nstest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "record_id":1,

            "host_fqdn":"testing.zohodns.net.",,

                "disabled":false,

            "domain_id":6

         }

      ]

   }

]

 

 

 

PUT Update:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/NS/6/

Update an existing NS record in the specified domain

 

Headers

Form Data

Example Response

 

Content-Type   application/json

authorization  Bearer {{access_token}}

 

config: [

   {

      "ns_domain_id":6,

      "zone_id":4,

      "domain_name":"nstest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "record_id":1,

            "host_fqdn":"testing.zohodns.net.",

                "disabled":false,

            "domain_id":6

         }

   }

]

 

 

{"message" : "Record updated successfully"}

DEL Delete:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/NS/6/

Deletes an existing NS record in the specified domain

 

Headers

Example Response

 

Content-Type                 application/json

authorization Bearer {{access_token}}

 

 

{"message" : "Record deleted successfully"}

 

       

DS

GET All:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/DS/

Returns a list of all DS records in the specified domain

Headers

Example Response

 

Content-Type     application/json

authorization   Bearer {{access_token}}

 

[

   {

      "ds_domain_id":6,

      "zone_id":4,

      "domain_name":"dstest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "record_id":1,

            "keyTag": 22,

               "algorithm": 2,

               "digestType": 1,

               "digest": "WESDEERRRRRSTYUJH",

                "disabled":false,

            "domain_id":6

         }

      ]

   },

   {

      "ds_domain_id":13,

      "zone_id":4,

      "domain_name":"ds2.zohocal.eu.",

      "domain_ttl":300,

      "domain_maxhost":1,

     

      "domain_location_id":1,

     

      "records":[

         {

               "record_id":1,

               "keyTag": 22,

               "algorithm": 2,

               "digestType": 1,

               "digest": "WESDEERRRRR3455QAAA",

                "disabled":false,

            "domain_id":6

         }

      ]

   }

]

 

POST Create:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/DS

Creates one or more new DS record(s) in a specified domain

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

config: [

   {

      "zone_id":4,

      "domain_name":"dstest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

              "keyTag": 22,

               "algorithm": 2,

               "digestType": 1,

               "digest": "WESDEERRRRR3455QAAA",

         }

      ]

   }

]

 

{"message" : "Record created successfully"}

GET Specific:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/DS/6/

 Returns a specified DS record in the specified domain

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

[

   {

      "ds_domain_id":6,

      "zone_id":4,

      "domain_name":"dstest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "record_id":1,

           "keyTag": 22,

               "algorithm": 2,

               "digestType": 1,

               "digest": "WESDEERRRRR3455QAAA",,

                "disabled":false,

            "domain_id":6

         }

      ]

   }

]

 

 

 

PUT Update:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/DS/6

Update an existing DS record in the specified domain

 

Headers

Form Data

Example Response

 

Content-Type   application/json

authorization  Bearer {{access_token}}

 

config: [

   {

      "ds_domain_id":6,

      "zone_id":4,

      "domain_name":"dstest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "record_id":1,

             "keyTag": 22,

               "algorithm": 2,

               "digestType": 1,

               "digest": "WESDEERRRRR3455QAAA",

                "disabled":false,

            "domain_id":6

         }

      ]

   }

]

 

 

{"message" : "Record updated successfully"}

DEL Delete:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/DS/6/

Deletes an existing DS record in the specified domain

 

Headers

Example Response

 

Content-Type                 application/json

authorization Bearer {{access_token}}

 

 

{"message" : "Record deleted successfully"}

 


SPF/TXT  

GET All:

https://clouddns.manageengine.com/v1/dns/domain/4/records/SPF_TXT

Returns a list of all SPF/TXT records in the specified domain

Headers

Example Response

 

Content-Type     application/json

authorization   Bearer {{access_token}}

 

[

   {

      "spf_txt_domain_id":6,

      "zone_id":4,

      "domain_name":"spftest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "record_type": "SPF",

       "records":[

         {

            "record_id":1,

             "value": "[\"necwcltpwxbz-noelget3jush-vop2xxvapot3eyq_0\"]",

                "disabled":false,

              "domain_id":6

         }

      ]

   },

   {

      "spf_txt_domain_id":13,

      "zone_id":4,

      "domain_name":"txt.zohocal.eu.",

      "domain_ttl":300,

      "domain_maxhost":1,

      "domain_location_id":1,

     "record_type": "TXT",

       "records":[

         {

            "record_id":1,

               "value": "[\"v=spf1include:transmail.netinclude:zoho.com~all\",\"c-68e3oc4trm8w7piplscg7vgojmtkjrnrabr4king8\"]",

                "disabled":false,

              "domain_id":13,

         }

      ]

   }

]

 

POST Create:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/SPF_TXT/

Creates one or more new SPF/TXT record(s) in a specified domain

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

config: [

   {

      "zone_id":4,

      "domain_name":"spftest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "record_type": "SPF",

       "records":[

         {

             "value": "[\"necwcltpwxbz-noelget3jush-vop2xxvapot3eyq_0\"]",

            

         }

      ]

   }

]

 

{"message" : "Record created successfully"}

GET Specific: 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/SPF_TXT/6/

 Returns a specified SPF/TXT record in the specified domain

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

[

   {

      "spf_txt_domain_id":6,

      "zone_id":4,

      "domain_name":"spftest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

     "record_type": "SPF",

       "records":[

         {

            "record_id":1,

             "value": "[\"necwcltpwxbz-noelget3jush-vop2xxvapot3eyq_0\"]",,

                "disabled":false,

              "domain_id":6

         }

      ]

 

   }

]

 

 

 

PUT Update:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/SPF_TXT/6/

Update an existing SPF/TXT record in the specified domain

 

Headers

Form Data

Example Response

 

Content-Type   application/json

authorization  Bearer {{access_token}}

 

config: [

   {

      "spf_txt_domain_id":6,

      "zone_id":4,

      "domain_name":"spftest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

   "record_type": "SPF",

       "records":[

         {

            "record_id":1,

             "value": "[\"necwcltpwxbz-noelget3jush-vop2xxvapot3eyq_0\"]",

                "disabled":false,

              "domain_id":6

         }

      ]

   }

]

 

 

{"message" : "Record updated successfully"}

DEL Delete:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/SPF_TXT/6

Deletes an existing SPF/TXT record in the specified domain

Headers

Example Response

Content-Type                 application/json

authorization Bearer {{access_token}}

 

 

{"message" : "Record deleted successfully"}

 

SRV

GET All:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/SRV

Returns a list of all SRV records in the specified domain

Headers

Example Response

 

Content-Type     application/json

authorization   Bearer {{access_token}}

 

[

   {

      "srv_domain_id":6,

      "zone_id":4,

      "domain_name":"srvtest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "record_id":1,

              "port": 443,

             "srv_weight": 10,

             "priority": 1,

             "target": "www.sample.com.",

                "disabled":false,

 

            "domain_id":6

         }

      ]

   },

   {

      "srv_domain_id":13,

      "zone_id":4,

      "domain_name":"srv2.zohocal.eu.",

      "domain_ttl":300,

      "domain_maxhost":1,

     

      "domain_location_id":1,

     

      "records":[

         {

               "record_id":1,

               "port": 443,

             "srv_weight": 10,

             "priority": 1,

             "target": "www.eg.com.",

                "disabled":false,

 

            "domain_id":6

         }

      ]

   }

]

 

POST Create:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/SRV/

Creates one or more new SRV record(s) in a specified domain

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

config: [

   {

      "zone_id":4,

      "domain_name":"srvtest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "port": 443,

             "srv_weight": 10,

             "priority": 1,

             "target": "www.sample.com."

 

         }

      ]

   }

]

 

{"message" : "Record created successfully"}

GET Specific:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/SRV/6

 Returns a specified SRV record in the specified domain

  

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

[

   {

      "srv_domain_id":6,

      "zone_id":4,

      "domain_name":"srvtest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "record_id":1,

           "port": 443,

             "srv_weight": 10,

             "priority": 1,

             "target": "www.sample.com.",,

                "disabled":false,

            "domain_id":6

         }

      ]

   }

]

 

 

  

PUT Update:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/SRV/6/

Update an existing SRV record in the specified domain

 

Headers

Form Data

Example Response

 

Content-Type   application/json

authorization  Bearer {{access_token}}

 

config: [

   {

      "srv_domain_id":6,

      "zone_id":4,

      "domain_name":"srvtest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "record_id":1,

            "port": 443,

             "srv_weight": 10,

             "priority": 1,

             "target": "www.sample.com.",

 

                "disabled":false,

             "domain_id":6

         }

      ]

   }

]

 

 

{"message" : "Record updated successfully"}

 DEL Delete:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/SRV/6

Deletes an existing SRV record in the specified domain  

Headers

Example Response

 

Content-Type                 application/json

authorization Bearer {{access_token}}

 

 

{"message" : "Record deleted successfully"}

 

CAA 

GET All:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/CAA/

Returns a list of all CAA records in the specified domain

Headers

Example Response

 

Content-Type     application/json

authorization   Bearer {{access_token}}

 

[

   {

      "caa_domain_id":6,

      "zone_id":4,

      "domain_name":"caatest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "record_id":1,

            "flag": 1,

              "tag": "issue",

              "value": "www.sample.com.",

                "disabled":false,

 

            "domain_id":6

         }

      ]

   },

   {

      "caa_domain_id":13,

      "zone_id":4,

      "domain_name":"caa2.zohocal.eu.",

      "domain_ttl":300,

      "domain_maxhost":1,

     

      "domain_location_id":1,

     

      "records":[

         {

               "record_id":1,

             "flag": 0,

              "tag": "issue",

              "value": "www.eg.com.",

                "disabled":false,

 

 

            "domain_id":6

         }

      ]

   }

]

 

POST Create: 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/CAA

Creates one or more new CAA record(s) in a specified domain

 

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

config: [

   {

      "zone_id":4,

      "domain_name":"caatest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "flag": 1,

              "tag": "issue",

              "value": "www.sample.com.",

 

 

         }

      ]

   }

]

 

{"message" : "Record created successfully"}

 

GET Specific:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/CAA/6/

 Returns a specified CAA record in the specified domain

  

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

[

   {

      "caa_domain_id":6,

      "zone_id":4,

      "domain_name":"caatest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "record_id":1,

           "flag": 1,

              "tag": "issue",

              "value": "www.sample.com.",,

                "disabled":false,

            "domain_id":6

         }

      ]

   }

]

 

 

 

PUT Update: 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/SRV/6

Update an existing SRV record in the specified domain

 

Headers

Form Data

Example Response

 

Content-Type   application/json

authorization  Bearer {{access_token}}

 

config: [

   {

      "caa_domain_id":6,

      "zone_id":4,

      "domain_name":"caatest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "record_id":1,

              "flag": 1,

              "tag": "issue",

              "value": "www.sample.com.",

                "disabled":false,

             "domain_id":6

         }

      ]

   }

]

 

 

{"message" : "Record updated successfully"}

 

 DEL Delete: 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/CAA/6/

Deletes an existing CAA record in the specified domain

Headers

Example Response

 

Content-Type                 application/json

authorization Bearer {{access_token}}

 

 

{"message" : "Record deleted successfully"}

 

 

CAA

GET All: 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/PTR

Returns a list of all PTR records in the specified domain

Headers

Example Response

 

Content-Type     application/json

authorization   Bearer {{access_token}}

 

[

   {

      "ptr_domain_id":6,

      "zone_id":4,

      "domain_name":"ptrtest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

         "record_id":1,

              "name": "www.sample.com.",

                "disabled":false,

             "domain_id":6

 

         }

      ]

   },

   {

      "ptr_domain_id":13,

      "zone_id":4,

      "domain_name":"ptr2.zohocal.eu.",

      "domain_ttl":300,

      "domain_maxhost":1,

     

      "domain_location_id":1,

     

      "records":[

         {

              "record_id":1,

              "name": "www.eg.com.",

                "disabled":false,

             "domain_id":13

         }

      ]

   }

]

 

POST Create:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/PTR/

Creates one or more new PTR record(s) in a specified domain

Headers

Form Data

Example Response

 

Content-Type     application/json

authorization Bearer {{access_token}}

 

 

config: [

   {

      "zone_id":4,

      "domain_name":"ptrtest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

      

        "name":"www.sample.com.",

    

   }

      ]

   }

]

 

{"message" : "Record created successfully"}

GET Specific:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/PTR/6

 Returns a specified PTR record in the specified domain

  

Headers

Example Response

 

Content-Type                     application/json

authorization Bearer {{access_token}}

 

[

   {

      "ptr_domain_id":6,

      "zone_id":4,

      "domain_name":"ptrtest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

          "record_id":1,

              "name": "www.sample.com.",,

                "disabled":false,

             "domain_id":6

 

         }

      ]

   }

]

 

 

 

PUT Update: 

    https://clouddns.manageengine.com/v1/dns/domain/4/records/PTR/6/

Update an existing PTR record in the specified domain

 

Headers

Form Data

Example Response

 

Content-Type   application/json

authorization  Bearer {{access_token}}

 

config: [

   {

      "ptr_domain_id":6,

      "zone_id":4,

      "domain_name":"ptrtest.zohocal.eu.",

      "domain_ttl":300,

      "domain_location_id":1,

      "records":[

         {

            "record_id":1,

              "name": "www.sample.com.",

                "disabled":false,

             "domain_id":6

         }

      ]

   }

]

 

 

{"message" : "Record updated successfully"}

DEL Delete:

    https://clouddns.manageengine.com/v1/dns/domain/4/records/PTR/6/

Deletes an existing PTR record in the specified domain

 

Headers

Example Response

 

Content-Type                 application/json

authorization Bearer {{access_token}}

 

 

{"message" : "Record deleted successfully"}

 

 

                  New to ADSelfService Plus?

                    • Related Articles

                    • ManageEngine CloudDNS REST API- Documentation

                      API Calls Generating Access Token Login to https://clouddns.manageengine.com and click on user profile in the right corner of the Navbar Click on view client credentials and copy the client ID and client secret. Make an API call to ...
                    • ManageEngine CloudDNS REST API - Documentation

                      API Calls Generating Access Token Login to https://clouddns.manageengine.com and click on user profile in the right corner of the Navbar Click on view client credentials and copy the client ID and client secret. Make an API call to ...
                    • Migrating From Other Providers to ManageEngine CloudDNS

                      Cloudflare Generating Auth-Code: Login into your Cloudflare account and on dashboard click on user icon and select 'My Profile'. Navigate to 'API Tokens' and click on 'View' button of 'Global API Key'. Enter your password and complete the ...
                    • Creating Filters in ManageEngine CloudDNS

                      Filters in ManageEngine CloudDNS Filters in CloudDNS are essential tools for optimizing and securing network traffic, ensuring users get the best possible experience, and providing businesses with the ability to enforce their operational policies ...
                    • ManageEngine CloudDNS Dashboard

                      ManageEngine CloudDNS Dashboard The CloudDNS dashboard serves as an effective visualization tool that presents the most important DNS analytics data.   To access the Dashboard: Select the Dashboard menu from the main menu bar along the left window ...