SSL/TLS

Manage SSL and TLS certificates, Let's Encrypt integrations, and certificate lifecycle operations through the Security API.

Use these endpoints to manage SSL/TLS certificates for your organization. You can upload custom certificates or issue certificates through Let’s Encrypt.

List SSL/TLS Certificates

get

Authorizations

JWTBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organization_uuidanyRequired

Unique identifier of the organization.

Query parameters

ssl_nameany ofOptional

Filters results by SSL name.

stringOptional

or

nullOptional

common_namestringOptional

Filters results 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

Number of items per page.

Default: 24

Responses

200

Returns a paginated list of SSL/TLS certificates.

application/json

422

Validation error.

application/json

get

/api/v1/ssl/{organization_uuid}/

HTTPcURLJavaScriptPython

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": "2026-01-09T06:05:32.876Z",
      "common_name": "text",
      "created_at": "2026-01-09T06:05:32.876Z",
      "type": "custom",
      "challenge_subdomain": "text"
    }
  ],
  "paginate": [
    {
      "current_page": 1,
      "per_page": 1,
      "total": 1,
      "last_page": 1
    }
  ]
}

Create SSL/TLS Certificate

post

Authorizations

JWTBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organization_uuidanyRequired

Unique identifier of the organization.

Body

application/json

Create SSL/TLS certificate.

ssl_namestring · min: 3 · max: 55Required

Certificate name.

ssl_crtstringRequired

Certificate (PEM).

ssl_passany ofRequired

Private key password, if applicable.

stringOptional

or

nullOptional

ssl_keystringRequired

Private key (PEM).

Responses

200

Returns the created SSL/TLS certificate.

application/json

422

Validation error.

application/json

post

/api/v1/ssl/{organization_uuid}/

HTTPcURLJavaScriptPython

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": "2026-01-09T06:05:32.876Z",
      "common_name": "text",
      "created_at": "2026-01-09T06:05:32.876Z",
      "type": "custom",
      "challenge_subdomain": "text"
    }
  ]
}

Update SSL/TLS Certificate

put

Authorizations

JWTBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organization_uuidanyRequired

Unique identifier of the organization.

ssl_uuidanyRequired

Unique identifier of the SSL/TLS certificate.

Body

application/json

Update SSL/TLS certificate.

ssl_nameany ofRequired

Certificate name.

stringOptional

or

nullOptional

ssl_crtstringRequired

Certificate (PEM).

ssl_passany ofRequired

Private key password, if applicable.

stringOptional

or

nullOptional

ssl_keystringRequired

Private key (PEM).

Responses

200

Returns the updated SSL/TLS certificate.

application/json

422

Validation error.

application/json

put

/api/v1/ssl/{organization_uuid}/{ssl_uuid}/

HTTPcURLJavaScriptPython

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": "2026-01-09T06:05:32.876Z",
      "common_name": "text",
      "created_at": "2026-01-09T06:05:32.876Z",
      "type": "custom",
      "challenge_subdomain": "text"
    }
  ]
}

Delete SSL/TLS Certificate

delete

Authorizations

JWTBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organization_uuidanyRequired

Unique identifier of the organization.

ssl_uuidanyRequired

Unique identifier of the SSL/TLS certificate.

Responses

200

Returns a confirmation indicating that the certificate was deleted.

application/json

422

Validation error.

application/json

delete

/api/v1/ssl/{organization_uuid}/{ssl_uuid}/

HTTPcURLJavaScriptPython

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

Let’s Encrypt

Use these endpoints to issue an SSL/TLS certificate through Let’s Encrypt. Complete the DNS verification step before finalizing the certificate.

Initiate Let’s Encrypt DNS Verification

post

Authorizations

JWTBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organization_uuidstringRequired

Unique identifier of the organization.

Body

application/json

Certificate generation request.

domainstringRequired

Domain name to validate.

Responses

200

Returns DNS challenge records required for verification.

application/json

422

Validation error.

application/json

post

/api/v1/ssl/{organization_uuid}/lets-encrypt/initiate-dns-verification/

HTTPcURLJavaScriptPython

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

Finalize Let’s Encrypt Certificate Creation

post

Authorizations

JWTBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organization_uuidstringRequired

Unique identifier of the organization.

Body

application/json

Finalize certificate creation request.

ssl_namestring · min: 3 · max: 55Required

Certificate name.

domainstringRequired

Domain name to issue the certificate for.

cname_targetstring · min: 3 · max: 255Required

CNAME target value returned from DNS verification.

Responses

200

Returns the created certificate identifier.

application/json

422

Validation error.

application/json

post

/api/v1/ssl/{organization_uuid}/lets-encrypt/finalize-ssl-creation/

HTTPcURLJavaScriptPython

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