arrow-left

All pages
gitbookPowered by GitBook
1 of 2

Loading...

Loading...

DNS

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

For more information about the DNS service, see the DNS documentationarrow-up-right.

Redirects

Manage HTTP redirect rules programmatically using the Redirects API for your zones.

hashtag
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
chevron-right
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.

chevron-right
422

Validation error

application/json
locstring[]Optional
msgstringOptional
typestringOptional
delete
/api/v1/automation/{org_uuid}/dns/zones/{zone_uuid}

hashtag
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.

hashtag
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>.

hashtag
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.

hashtag
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.

hashtag
List all DNS zones

get

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

Responses
chevron-right
200

Successful response

No content

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

hashtag
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.

hashtag
Create Redirect

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.

hashtag
List Zone Redirects

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.

hashtag
Get Redirect

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.

hashtag
Update Redirect

put
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.

hashtag
Delete Redirect

delete
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.

hashtag
List Organization Redirects

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
{
  "status": true,
  "message": "text",
  "operation_id": "text"
}
Body
typestringOptional

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

domainstringOptional

The domain or subdomain for the record.

answerstring[]Optional

Array of target IP addresses or hostnames.

ttlintegerOptional

Time to Live in seconds.

proxybooleanOptional

Indicates whether the record is proxied through the Medianova network.

Responses
chevron-right
200

Successful response

application/json
statusbooleanOptional

Indicates whether the update was successful.

messagestringOptional

Status message regarding the update operation.

chevron-right
422

Validation error

application/json
locstring[]Optional
msgstringOptional
typestringOptional
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
}
Path parameters
org_uuidstringRequired

Unique identifier for the organization.

Body
namestringRequired

The full domain name of the DNS zone to create.

Responses
chevron-right
200

Successful response

application/json
statusbooleanOptional

Indicates whether the DNS zone creation was successful.

idstringOptional

Unique identifier of the created zone.

namestringOptional

Domain name of the zone.

organization_uuidstringOptional

UUID of the organization owning the zone.

activebooleanOptional

Indicates if the zone is currently active.

create_datestring 路 date-timeOptional

Timestamp indicating when the zone was created.

chevron-right
422

Validation error

application/json
locstring[]Optional
msgstringOptional
typestringOptional
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"
}
Body
valuestringRequired

The specific answer value to be removed from the record.

Responses
chevron-right
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.

chevron-right
422

Validation error

application/json
locstring[]Optional
msgstringOptional
typestringOptional
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"
}
Responses
chevron-right
200

Successful response

application/json
statusbooleanOptional

Indicates whether the request was successful.

idstringOptional

Unique identifier for the DNS record.

domainstringOptional

The domain or subdomain for the record.

typestringOptional

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

ttlintegerOptional

Time to Live in seconds.

proxybooleanOptional

Indicates whether the record is proxied through the Medianova network.

chevron-right
422

Validation error

application/json
locstring[]Optional
msgstringOptional
typestringOptional
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: */*
200

Successful response

No content

Bodyobject[]
typestringRequired

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

domainstringRequired

The domain or subdomain for the DNS record.

answerstring[]Optional

Array of target IP addresses or hostnames.

ttlintegerRequired

Time to Live in seconds.

proxybooleanOptional

Indicates whether the record is proxied through the Medianova network.

Default: false
Responses
chevron-right
200

Successful response

application/json
statusbooleanOptional

Indicates whether the record creation was successful.

messagestringOptional

Status message describing the operation result.

chevron-right
422

Validation error

application/json
locstring[]Optional
msgstringOptional
typestringOptional
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
  }
]
DELETE /api/v1/automation/{org_uuid}/dns/zones/{zone_uuid} HTTP/1.1
Host: cloud.medianova.com
Accept: */*
GET /api/v1/automation/{org_uuid}/dns/zones HTTP/1.1
Accept: */*
Path parameters
org_uuidstringRequired

Organization UUID

zone_idstringRequired

The UUID of the zone

Body

Schema for creating a new redirect

source_urlstringRequired

Source URL without schema (e.g., example.com/path)

target_urlstringRequired

Target URL (schema optional, defaults to https)

redirect_typestring 路 enumOptional

Redirect type enumeration

Possible values:
path_forwarding_modestring 路 enumOptional

Path forwarding mode enumeration

Possible values:
query_forwardingbooleanOptional

Forward query parameters

Default: false
enable_httpsbooleanOptional

Enable HTTPS for the redirect

Default: false
enforce_httpsbooleanOptional

Force HTTPS (requires enable_https to be true)

Default: false
tagsstring[]Optional

Tags for categorization

Responses
chevron-right
200

Successful Response

application/json

Wrapper model for RedirectResponse with status field

statusbooleanRequiredDefault: true
idstringRequired

Unique identifier for the redirect

configuration_idstringOptional

configuration ID

domainstringRequired

Source domain

pathstringRequired

Source path

source_urlstringRequired

Full source URL (domain + path)

target_urlstringRequired

Target URL

redirect_typestring 路 enumRequired

Redirect type enumeration

Possible values:
path_forwarding_modestring 路 enumRequired

Path forwarding mode enumeration

Possible values:
query_forwardingbooleanRequired

Query forwarding enabled

https_enabledbooleanRequired

HTTPS enabled

https_forcedbooleanRequired

HTTPS enforced

ssl_certificate_idany ofOptional

SSL certificate reference ID

stringOptional
or
nullOptional
tagsany ofOptional

Tags

string[]Optional
or
nullOptional
create_datestring 路 date-timeRequired

Creation timestamp

update_dateany ofOptional

Last update timestamp

string 路 date-timeOptional
or
nullOptional
chevron-right
409

Conflict - DNS record conflicts found

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

{
  "source_url": "text",
  "target_url": "text",
  "redirect_type": "permanent",
  "path_forwarding_mode": "all",
  "query_forwarding": false,
  "enable_https": false,
  "enforce_https": false,
  "tags": [
    "text"
  ]
}
Path parameters
org_uuidstringRequired

Organization UUID

zone_idstringRequired

The UUID of the zone

Responses
chevron-right
200

Successful Response

application/json

Response for listing redirects

statusbooleanRequiredDefault: true
idstringRequired

Unique identifier for the redirect

configuration_idstringOptional

configuration ID

domainstringRequired

Source domain

pathstringRequired

Source path

source_urlstringRequired

Full source URL (domain + path)

target_urlstringRequired

Target URL

redirect_typestring 路 enumRequired

Redirect type enumeration

Possible values:
path_forwarding_modestring 路 enumRequired

Path forwarding mode enumeration

Possible values:
query_forwardingbooleanRequired

Query forwarding enabled

https_enabledbooleanRequired

HTTPS enabled

https_forcedbooleanRequired

HTTPS enforced

ssl_certificate_idany ofOptional

SSL certificate reference ID

stringOptional
or
nullOptional
tagsany ofOptional

Tags

string[]Optional
or
nullOptional
create_datestring 路 date-timeRequired

Creation timestamp

update_dateany ofOptional

Last update timestamp

string 路 date-timeOptional
or
nullOptional
get
/api/v1/automation/{org_uuid}/redirects/zones/{zone_id}
GET /api/v1/automation/{org_uuid}/redirects/zones/{zone_id} HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

Successful Response

Path parameters
org_uuidstringRequired

Organization UUID

redirect_idstringRequired

The UUID of the redirect

Responses
chevron-right
200

Successful Response

application/json

Wrapper model for RedirectResponse with status field

statusbooleanRequiredDefault: true
idstringRequired

Unique identifier for the redirect

configuration_idstringOptional

configuration ID

domainstringRequired

Source domain

pathstringRequired

Source path

source_urlstringRequired

Full source URL (domain + path)

target_urlstringRequired

Target URL

redirect_typestring 路 enumRequired

Redirect type enumeration

Possible values:
path_forwarding_modestring 路 enumRequired

Path forwarding mode enumeration

Possible values:
query_forwardingbooleanRequired

Query forwarding enabled

https_enabledbooleanRequired

HTTPS enabled

https_forcedbooleanRequired

HTTPS enforced

ssl_certificate_idany ofOptional

SSL certificate reference ID

stringOptional
or
nullOptional
tagsany ofOptional

Tags

string[]Optional
or
nullOptional
create_datestring 路 date-timeRequired

Creation timestamp

update_dateany ofOptional

Last update timestamp

string 路 date-timeOptional
or
nullOptional
chevron-right
404

Redirect not found

application/json
get
/api/v1/automation/{org_uuid}/redirects/{redirect_id}
GET /api/v1/automation/{org_uuid}/redirects/{redirect_id} HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Path parameters
org_uuidstringRequired

Organization UUID

redirect_idstringRequired

The UUID of the redirect

Body

Schema for updating an existing redirect

target_urlstringOptional

Target URL

redirect_typestring 路 enumOptional

Redirect type enumeration

Possible values:
path_forwarding_modestring 路 enumOptional

Path forwarding mode enumeration

Possible values:
query_forwardingbooleanOptional

Query forwarding enabled

enable_httpsbooleanOptional

Enable HTTPS

enforce_httpsbooleanOptional

Force HTTPS (requires enable_https to be true)

tagsstring[]Optional

Tags for categorization

Responses
chevron-right
200

Successful Response

application/json

Wrapper model for RedirectResponse with status field

statusbooleanRequiredDefault: true
idstringRequired

Unique identifier for the redirect

configuration_idstringOptional

configuration ID

domainstringRequired

Source domain

pathstringRequired

Source path

source_urlstringRequired

Full source URL (domain + path)

target_urlstringRequired

Target URL

redirect_typestring 路 enumRequired

Redirect type enumeration

Possible values:
path_forwarding_modestring 路 enumRequired

Path forwarding mode enumeration

Possible values:
query_forwardingbooleanRequired

Query forwarding enabled

https_enabledbooleanRequired

HTTPS enabled

https_forcedbooleanRequired

HTTPS enforced

ssl_certificate_idany ofOptional

SSL certificate reference ID

stringOptional
or
nullOptional
tagsany ofOptional

Tags

string[]Optional
or
nullOptional
create_datestring 路 date-timeRequired

Creation timestamp

update_dateany ofOptional

Last update timestamp

string 路 date-timeOptional
or
nullOptional
chevron-right
409

Conflict - DNS record conflicts found

application/json
put
/api/v1/automation/{org_uuid}/redirects/{redirect_id}
PUT /api/v1/automation/{org_uuid}/redirects/{redirect_id} HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 159

{
  "target_url": "text",
  "redirect_type": "permanent",
  "path_forwarding_mode": "all",
  "query_forwarding": true,
  "enable_https": true,
  "enforce_https": true,
  "tags": [
    "text"
  ]
}
Path parameters
org_uuidstringRequired

Organization UUID

redirect_idstringRequired

The UUID of the redirect

Responses
chevron-right
200

Successful Response

application/json
statusbooleanOptional
messagestringOptional
chevron-right
404

Redirect not found

application/json
delete
/api/v1/automation/{org_uuid}/redirects/{redirect_id}
DELETE /api/v1/automation/{org_uuid}/redirects/{redirect_id} HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Path parameters
org_uuidstringRequired

Organization UUID

Query parameters
skipintegerOptional

Number of records to skip for pagination

Default: 0
limitintegerOptional

Maximum number of records to return

Default: 100
Responses
chevron-right
200

Successful Response

application/json

Response for listing redirects

statusbooleanRequiredDefault: true
idstringRequired

Unique identifier for the redirect

configuration_idstringOptional

configuration ID

domainstringRequired

Source domain

pathstringRequired

Source path

source_urlstringRequired

Full source URL (domain + path)

target_urlstringRequired

Target URL

redirect_typestring 路 enumRequired

Redirect type enumeration

Possible values:
path_forwarding_modestring 路 enumRequired

Path forwarding mode enumeration

Possible values:
query_forwardingbooleanRequired

Query forwarding enabled

https_enabledbooleanRequired

HTTPS enabled

https_forcedbooleanRequired

HTTPS enforced

ssl_certificate_idany ofOptional

SSL certificate reference ID

stringOptional
or
nullOptional
tagsany ofOptional

Tags

string[]Optional
or
nullOptional
create_datestring 路 date-timeRequired

Creation timestamp

update_dateany ofOptional

Last update timestamp

string 路 date-timeOptional
or
nullOptional
get
/api/v1/automation/{org_uuid}/redirects
GET /api/v1/automation/{org_uuid}/redirects HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

Successful Response

{
  "status": true,
  "data": {
    "id": "text",
    "configuration_id": "text",
    "domain": "text",
    "path": "text",
    "source_url": "text",
    "target_url": "text",
    "redirect_type": "permanent",
    "path_forwarding_mode": "all",
    "query_forwarding": true,
    "https_enabled": true,
    "https_forced": true,
    "ssl_certificate_id": "text",
    "tags": [
      "text"
    ],
    "create_date": "2026-05-15T20:13:05.224Z",
    "update_date": "2026-05-15T20:13:05.224Z"
  }
}
{
  "status": true,
  "data": [
    {
      "id": "text",
      "configuration_id": "text",
      "domain": "text",
      "path": "text",
      "source_url": "text",
      "target_url": "text",
      "redirect_type": "permanent",
      "path_forwarding_mode": "all",
      "query_forwarding": true,
      "https_enabled": true,
      "https_forced": true,
      "ssl_certificate_id": "text",
      "tags": [
        "text"
      ],
      "create_date": "2026-05-15T20:13:05.224Z",
      "update_date": "2026-05-15T20:13:05.224Z"
    }
  ]
}
{
  "status": true,
  "data": {
    "id": "text",
    "configuration_id": "text",
    "domain": "text",
    "path": "text",
    "source_url": "text",
    "target_url": "text",
    "redirect_type": "permanent",
    "path_forwarding_mode": "all",
    "query_forwarding": true,
    "https_enabled": true,
    "https_forced": true,
    "ssl_certificate_id": "text",
    "tags": [
      "text"
    ],
    "create_date": "2026-05-15T20:13:05.224Z",
    "update_date": "2026-05-15T20:13:05.224Z"
  }
}
{
  "status": true,
  "data": {
    "id": "text",
    "configuration_id": "text",
    "domain": "text",
    "path": "text",
    "source_url": "text",
    "target_url": "text",
    "redirect_type": "permanent",
    "path_forwarding_mode": "all",
    "query_forwarding": true,
    "https_enabled": true,
    "https_forced": true,
    "ssl_certificate_id": "text",
    "tags": [
      "text"
    ],
    "create_date": "2026-05-15T20:13:05.224Z",
    "update_date": "2026-05-15T20:13:05.224Z"
  }
}
{
  "status": true,
  "message": "text"
}
{
  "status": true,
  "data": [
    {
      "id": "text",
      "configuration_id": "text",
      "domain": "text",
      "path": "text",
      "source_url": "text",
      "target_url": "text",
      "redirect_type": "permanent",
      "path_forwarding_mode": "all",
      "query_forwarding": true,
      "https_enabled": true,
      "https_forced": true,
      "ssl_certificate_id": "text",
      "tags": [
        "text"
      ],
      "create_date": "2026-05-15T20:13:05.224Z",
      "update_date": "2026-05-15T20:13:05.224Z"
    }
  ]
}
{
  "status": true,
  "message": "text"
}
{
  "status": true,
  "data": {
    "id": "text",
    "name": "text",
    "organization_uuid": "text",
    "active": true,
    "create_date": "2026-05-15T20:13:05.224Z"
  }
}
{
  "status": true,
  "message": "text",
  "operation_id": "text"
}
{
  "status": true,
  "data": [
    {
      "id": "text",
      "domain": "text",
      "type": "text",
      "ttl": 1,
      "proxy": true
    }
  ]
}
{
  "status": true,
  "message": "text"
}