DNS

Manage DNS zones and DNS records programmatically using the DNS API.

For more information about the DNS service, see the DNS documentation.

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

GET /api/v1/automation/{org_uuid}/dns/zones HTTP/1.1
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

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

org_uuidstringRequired

Unique identifier for the organization.

Body

namestringRequired

The full domain name of the DNS zone to create.

Responses

200

Successful response

application/json

statusbooleanOptional

Indicates whether the DNS zone creation was successful.

422

Validation error

application/json

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

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-01T00:00:00.000Z"
  }
}

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

statusbooleanOptional

Indicates whether the deletion was successful.

messagestringOptional

Confirmation message regarding the deletion process.

operation_idstringOptional

Unique identifier for the operation log.

422

Validation error

application/json

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

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

statusbooleanOptional

Indicates whether the request was successful.

422

Validation error

application/json

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

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 · DnsRecordCreate[]

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

statusbooleanOptional

Indicates whether the record creation was successful.

messagestringOptional

Status message describing the operation result.

422

Validation error

application/json

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

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

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

statusbooleanOptional

Indicates whether the update was successful.

messagestringOptional

Status message regarding the update operation.

422

Validation error

application/json

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

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

valuestringRequired

The specific answer value to be removed from the record.

Responses

200

Successful response

application/json

statusbooleanOptional

Indicates whether the deletion was successful.

messagestringOptional

Status message regarding the deletion result.

operation_idstringOptional

Unique identifier for the operation log.

422

Validation error

application/json

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

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"
}