DNS

If you want more information about DNS service you can visit https://clients.medianova.com/products/dns

List all DNS zones

get

Retrieves a paginated list of DNS zones associated with the organization.

Responses

200

Successful response

No content

get

/api/v1/automation/{org_uuid}/dns/zones

HTTPcURLJavaScriptPython

GET /api/v1/automation/{org_uuid}/dns/zones HTTP/1.1
Host: 
Accept: */*

200

Successful response

No content

Create a new DNS zone

post

Creates a new DNS zone for the specified organization in the Medianova Control Panel.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

org_uuidstringRequired

Unique identifier for the organization.

Body

application/json

namestringRequired

The full domain name of the DNS zone to create.

Responses

200

Successful response

application/json

422

Validation error

application/json

post

/api/v1/automation/{org_uuid}/dns/zones

HTTPcURLJavaScriptPython

POST /api/v1/automation/{org_uuid}/dns/zones HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "name": "text"
}

{
  "status": true,
  "data": {
    "id": "text",
    "name": "text",
    "organization_uuid": "text",
    "active": true,
    "create_date": "2026-01-17T16:12:57.281Z"
  }
}

Delete a DNS zone

delete

Permanently removes the specified DNS zone and all associated records from the Medianova Control Panel.

Path parameters

org_uuidstringRequired

Unique identifier for the organization.

zone_uuidstringRequired

Unique identifier for the DNS zone to be deleted.

Responses

200

Successful response

application/json

422

Validation error

application/json

delete

/api/v1/automation/{org_uuid}/dns/zones/{zone_uuid}

HTTPcURLJavaScriptPython

DELETE /api/v1/automation/{org_uuid}/dns/zones/{zone_uuid} HTTP/1.1
Host: cloud.medianova.com
Accept: */*

{
  "status": true,
  "message": "text",
  "operation_id": "text"
}

List all DNS records

get

Retrieves a list of all DNS records configured for a specific zone.

Path parameters

org_uuidstringRequired

Unique identifier for the organization.

zone_uuidstringRequired

Unique identifier for the DNS zone.

Responses

200

Successful response

application/json

422

Validation error

application/json

get

/api/v1/automation/{org_uuid}/dns/zones/{zone_uuid}/records

HTTPcURLJavaScriptPython

GET /api/v1/automation/{org_uuid}/dns/zones/{zone_uuid}/records HTTP/1.1
Host: cloud.medianova.com
Accept: */*

{
  "status": true,
  "data": [
    {
      "id": "text",
      "domain": "text",
      "type": "text",
      "ttl": 1,
      "proxy": true
    }
  ]
}

Create a new DNS record

post

Adds one or more DNS records to a specific zone in the Medianova Control Panel.

Path parameters

org_uuidstringRequired

Unique identifier for the organization.

zone_uuidstringRequired

Unique identifier for the DNS zone.

Bodyobject[]

application/json

typestringRequired

The DNS record type (e.g., A, CNAME, TXT).

domainstringRequired

The domain or subdomain for the DNS record.

ttlintegerRequired

Time to Live in seconds.

proxybooleanOptional

Indicates whether the record is proxied through the Medianova network.

Default: false

Responses

200

Successful response

application/json

422

Validation error

application/json

post

/api/v1/automation/{org_uuid}/dns/zones/{zone_uuid}/records

HTTPcURLJavaScriptPython

POST /api/v1/automation/{org_uuid}/dns/zones/{zone_uuid}/records HTTP/1.1
Host: cloud.medianova.com
Content-Type: application/json
Accept: */*
Content-Length: 87

[
  {
    "type": "text",
    "domain": "text",
    "answers": [
      {
        "answer": [
          "text"
        ]
      }
    ],
    "ttl": 1,
    "proxy": false
  }
]

{
  "status": true,
  "message": "text"
}

Update a DNS record

put

Updates an existing DNS record within a specific zone in the Medianova Control Panel.

Path parameters

org_uuidstringRequired

Unique identifier for the organization.

zone_uuidstringRequired

Unique identifier for the DNS zone.

record_uuidstringRequired

Unique identifier for the DNS record to update.

Body

application/json

typestringOptional

DNS record type (e.g., A, CNAME, TXT).

domainstringOptional

The domain or subdomain for the record.

ttlintegerOptional

Time to Live in seconds.

proxybooleanOptional

Indicates whether the record is proxied through the Medianova network.

Responses

200

Successful response

application/json

422

Validation error

application/json

put

/api/v1/automation/{org_uuid}/dns/zones/{zone_uuid}/records/{record_uuid}

HTTPcURLJavaScriptPython

PUT /api/v1/automation/{org_uuid}/dns/zones/{zone_uuid}/records/{record_uuid} HTTP/1.1
Host: cloud.medianova.com
Content-Type: application/json
Accept: */*
Content-Length: 84

{
  "type": "text",
  "domain": "text",
  "answers": [
    {
      "answer": [
        "text"
      ]
    }
  ],
  "ttl": 1,
  "proxy": true
}

{
  "status": true,
  "message": "text"
}

Delete a DNS record value

delete

Deletes a specific answer value from an existing DNS record in the Medianova Control Panel.

Path parameters

org_uuidstringRequired

Unique identifier for the organization.

zone_uuidstringRequired

Unique identifier for the DNS zone.

record_uuidstringRequired

Unique identifier for the DNS record.

Body

application/json

valuestringRequired

The specific answer value to be removed from the record.

Responses

200

Successful response

application/json

422

Validation error

application/json

delete

/api/v1/automation/{org_uuid}/dns/zones/{zone_uuid}/records/{record_uuid}

HTTPcURLJavaScriptPython

DELETE /api/v1/automation/{org_uuid}/dns/zones/{zone_uuid}/records/{record_uuid} HTTP/1.1
Host: cloud.medianova.com
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "value": "text"
}

{
  "status": true,
  "message": "text",
  "operation_id": "text"
}