SSL/TLS

List SSL

get
Authorizations
Path parameters
organization_uuidanyRequired

The unique identifier of the organization.

Query parameters
ssl_nameany ofOptional

The name or description of the SSL certificate. This parameter contains the name or description of the SSL certificate used by the server or service.

stringOptional
or
nullOptional
common_namestringOptional

Filter by common name

sort_fieldall ofOptional

Field to sort by

Default: created_at
string · enumOptionalPossible values:
sortall ofOptional

Sort order

Default: desc
string · enumOptionalPossible values:
pageintegerOptional

Page number

Default: 1
per_pageintegerOptional

Items per page

Default: 24
Responses
200
Successful Response
application/json
get
GET /api/v1/ssl/{organization_uuid}/ HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "status": true,
  "data": [
    {
      "uuid": "text",
      "organization_uuid": "text",
      "ssl_name": "text",
      "expire_date": "2025-08-04T12:14:50.290Z",
      "common_name": "text",
      "created_at": "2025-08-04T12:14:50.290Z",
      "type": "custom",
      "challenge_subdomain": "text"
    }
  ],
  "paginate": [
    {
      "current_page": 1,
      "per_page": 1,
      "total": 1,
      "last_page": 1
    }
  ]
}

Create SSL

post
Authorizations
Path parameters
organization_uuidanyRequired

The unique identifier of the organization.

Body

SSL Create

ssl_namestring · min: 3 · max: 55Required

The name or description of the SSL certificate. This parameter contains the name or description of the SSL certificate used by the server or service.

ssl_crtstringRequired

A string containing the certificate file of the SSL certificate. This parameter represents the content of the server's SSL certificate.

ssl_passany ofRequired

A string containing the password for the SSL certificate's private key. This parameter contains the password for the private key of the SSL certificate.

stringOptional
or
nullOptional
ssl_keystringRequired

A string containing the private key file for the SSL certificate. This parameter represents the private key used for the SSL certificate.

Responses
200
Successful Response
application/json
post
POST /api/v1/ssl/{organization_uuid}/ HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 71

{
  "ssl_name": "text",
  "ssl_crt": "text",
  "ssl_pass": "text",
  "ssl_key": "text"
}
{
  "status": true,
  "data": [
    {
      "uuid": "text",
      "organization_uuid": "text",
      "ssl_name": "text",
      "expire_date": "2025-08-04T12:14:50.290Z",
      "common_name": "text",
      "created_at": "2025-08-04T12:14:50.290Z",
      "type": "custom",
      "challenge_subdomain": "text"
    }
  ]
}

Update SSL

put
Authorizations
Path parameters
organization_uuidanyRequired

The unique identifier of the organization.

ssl_uuidanyRequired

The created SSL in panel unit ID value.

Body

SSL Update

ssl_nameany ofRequired

The name or description of the SSL certificate. This parameter contains the name or description of the SSL certificate used by the server or service.

stringOptional
or
nullOptional
ssl_crtstringRequired

A string containing the certificate file of the SSL certificate. This parameter represents the content of the server's SSL certificate.

ssl_passany ofRequired

A string containing the password for the SSL certificate's private key. This parameter contains the password for the private key of the SSL certificate.

stringOptional
or
nullOptional
ssl_keystringRequired

A string containing the private key file for the SSL certificate. This parameter represents the private key used for the SSL certificate.

Responses
200
Successful Response
application/json
put
PUT /api/v1/ssl/{organization_uuid}/{ssl_uuid}/ HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 71

{
  "ssl_name": "text",
  "ssl_crt": "text",
  "ssl_pass": "text",
  "ssl_key": "text"
}
{
  "status": true,
  "data": [
    {
      "uuid": "text",
      "organization_uuid": "text",
      "ssl_name": "text",
      "expire_date": "2025-08-04T12:14:50.290Z",
      "common_name": "text",
      "created_at": "2025-08-04T12:14:50.290Z",
      "type": "custom",
      "challenge_subdomain": "text"
    }
  ]
}

Delete SSL

delete
Authorizations
Path parameters
organization_uuidanyRequired

The unique identifier of the organization.

ssl_uuidanyRequired

The created SSL in panel unit ID value.

Responses
200
Successful Response
application/json
delete
DELETE /api/v1/ssl/{organization_uuid}/{ssl_uuid}/ HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "status": true,
  "message": "text"
}

Lets Encrypt DNS Challenge

post
Authorizations
Path parameters
organization_uuidstringRequired

The unique identifier of the organization.

Body

Certificate Generation Request

domainstringRequired

Associated Domain Name

Responses
200
Successful Response
application/json
post
POST /api/v1/ssl/{organization_uuid}/lets-encrypt/initiate-dns-verification/ HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "domain": "text"
}
{
  "status": true,
  "data": {
    "cname_host": "text",
    "cname_target": "text"
  },
  "operation_id": "text"
}

Lets Encrypt Create CERT

post
Authorizations
Path parameters
organization_uuidstringRequired

The unique identifier of the organization.

Body

CompleteCertRequest

ssl_namestring · min: 3 · max: 55Required

The name or description of the SSL certificate. This parameter contains the name or description of the SSL certificate used by the server or service.

domainstringRequired

Associated Domain Name

cname_targetstring · min: 3 · max: 255Required

CNAME Record Target

Responses
200
Successful Response
application/json
post
POST /api/v1/ssl/{organization_uuid}/lets-encrypt/finalize-ssl-creation/ HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 57

{
  "ssl_name": "text",
  "domain": "text",
  "cname_target": "text"
}
{
  "status": true,
  "data": {
    "message": "text",
    "uuid": "text"
  },
  "operation_id": "text"
}

Last updated

Was this helpful?