SSL/TLS | Knowledge Base

Knowledge Base

medianova.com Support Log in

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

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

422

Validation Error

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-05-30T04:57:43.592Z",
      "common_name": "text",
      "created_at": "2025-05-30T04:57:43.592Z",
      "type": "custom",
      "challenge_subdomain": "text"
    }
  ],
  "paginate": [
    {
      "current_page": 1,
      "per_page": 1,
      "total": 1,
      "last_page": 1
    }
  ]
}

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

Responseany

422

Validation Error

application/json

delete

DELETE /api/v1/ssl/{organization_uuid}/{ssl_uuid}/ HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

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

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.

typeany ofOptionalDefault: custom

string · enumOptional

SSL Type

Possible values:

nullOptional

challenge_subdomainany ofOptional

Challenge Subdomain

stringOptional

nullOptional

Responses

200

Successful Response

application/json

422

Validation Error

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: 116

{
  "ssl_name": "text",
  "ssl_crt": "text",
  "ssl_pass": "text",
  "ssl_key": "text",
  "type": "custom",
  "challenge_subdomain": "text"
}

{
  "status": true,
  "data": [
    {
      "uuid": "text",
      "organization_uuid": "text",
      "ssl_name": "text",
      "expire_date": "2025-05-30T04:57:43.592Z",
      "common_name": "text",
      "created_at": "2025-05-30T04:57:43.592Z",
      "type": "custom",
      "challenge_subdomain": "text"
    }
  ]
}

Update SSL

put

Authorizations

Path parameters

orgnization_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

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

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

422

Validation Error

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-05-30T04:57:43.592Z",
      "common_name": "text",
      "created_at": "2025-05-30T04:57:43.592Z",
      "type": "custom",
      "challenge_subdomain": "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

wildcardbooleanOptional

Is Wildcard Certificate

Default: false

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

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: 34

{
  "domain": "text",
  "wildcard": false
}

No content

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

wildcardbooleanOptional

Is Wildcard Certificate

Default: false

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

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: 74

{
  "ssl_name": "text",
  "domain": "text",
  "cname_target": "text",
  "wildcard": false
}

No content