All pages
Powered 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 documentation.

Redirects

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

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[]
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
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
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
200

Successful response

No content

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

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.

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.

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.

422

Validation error

application/json
post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
org_uuidstringRequired

Organization UUID

zone_idstringRequired

The UUID of the zone

Body
get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
org_uuidstringRequired

Organization UUID

zone_idstringRequired

The UUID of the zone

Responses
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
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
org_uuidstringRequired

Organization UUID

redirect_idstringRequired

The UUID of the redirect

Responses
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
404

Redirect not found

application/json
put
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
org_uuidstringRequired

Organization UUID

redirect_idstringRequired

The UUID of the redirect

Body
delete
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
org_uuidstringRequired

Organization UUID

redirect_idstringRequired

The UUID of the redirect

Responses
200

Successful Response

application/json
statusbooleanOptional
messagestringOptional
404

Redirect not found

application/json
get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
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
{
  "status": true,
  "message": "text"
}
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"
}
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
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
}
Responses
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.

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

List all DNS zones

Delete a DNS zone

Update a DNS record

Create a new DNS zone

Delete a DNS record value

List all DNS records

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

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: */*

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
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
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"
  ]
}
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: */*
Responses
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

Create Redirect

List Zone Redirects

Get Redirect

Update Redirect

Delete Redirect

List Organization Redirects

{
  "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-30T18:06:27.874Z",
    "update_date": "2026-05-30T18:06:27.874Z"
  }
}
{
  "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-30T18:06:27.874Z",
      "update_date": "2026-05-30T18:06:27.874Z"
    }
  ]
}
{
  "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-30T18:06:27.874Z",
    "update_date": "2026-05-30T18:06:27.874Z"
  }
}
{
  "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-30T18:06:27.874Z",
    "update_date": "2026-05-30T18:06:27.874Z"
  }
}
{
  "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-30T18:06:27.874Z",
      "update_date": "2026-05-30T18:06:27.874Z"
    }
  ]
}
{
  "status": true,
  "message": "text"
}
{
  "status": true,
  "data": {
    "id": "text",
    "name": "text",
    "organization_uuid": "text",
    "active": true,
    "create_date": "2026-05-30T18:06:27.874Z"
  }
}
{
  "status": true,
  "message": "text",
  "operation_id": "text"
}
{
  "status": true,
  "data": [
    {
      "id": "text",
      "domain": "text",
      "type": "text",
      "ttl": 1,
      "proxy": true
    }
  ]
}