# SSL Certificate Management

SSL Certificates / SSL Certificate Management

## Delete SSL certificate

 - [GET /SSL/delete_cert](https://api.docs.cpanel.net/specifications/cpanel.openapi/ssl-certificate-management/delete_cert.md): This function deletes an SSL certificate.

Note:

* When you call this function, you must include the id or the friendly_name
parameter.
* This function only deletes certificates from SSL storage. To end SSL
coverage for a domain, use the UAPI SSL::delete_ssl function instead.

Important:

When you disable the Calendars and Contacts, Receive Mail, Web Disk, Webmail,
and Web Server roles,
the system disables this function.

## Delete certificate signing request

 - [GET /SSL/delete_csr](https://api.docs.cpanel.net/specifications/cpanel.openapi/ssl-certificate-management/delete_csr.md): This function deletes a certificate signing request (CSR).

Note:

* When you call this function, you must include the id or the friendly_name
parameter.
* To delete a private key, use the UAPI SSL::delete_key function instead.

Important:

When you disable the Calendars and Contacts, Receive Mail, Web Disk, Webmail,
and Web Server roles,
the system disables this function.

## Delete private key

 - [GET /SSL/delete_key](https://api.docs.cpanel.net/specifications/cpanel.openapi/ssl-certificate-management/delete_key.md): This function deletes a private key.

Note:

* When you call this function, you must include the id or the friendly_name
parameter.
* To delete a certificate signing request (CSR), use the UAPI SSL::delete_csr
function instead.

Important:

When you disable the Calendars and Contacts, Receive Mail, Web Disk, Webmail,
and Web Server roles,
the system disables this function.

## Create self-signed SSL certificate

 - [GET /SSL/generate_cert](https://api.docs.cpanel.net/specifications/cpanel.openapi/ssl-certificate-management/generate_cert.md): This function generates a self-signed SSL certificate.

Important:

When you disable the Calendars and Contacts, Receive Mail, Web Disk, Webmail,
and Web Server roles,
the system disables this function.

## Create certificate signing request

 - [GET /SSL/generate_csr](https://api.docs.cpanel.net/specifications/cpanel.openapi/ssl-certificate-management/generate_csr.md): This function generates a certificate signing request (CSR).

Note:

This function requires a valid key in the account's ssl directory.
You can generate a key with UAPI's SSL::generate_key function.

Important:

When you disable the Calendars and Contacts, Receive Mail, Web Disk, Webmail,
and WebServer roles,
the system disables this function.

## Create private key

 - [GET /SSL/generate_key](https://api.docs.cpanel.net/specifications/cpanel.openapi/ssl-certificate-management/ssl-generate_key.md): This function generates a private key.

Important:

* You cannot call both the keytype and keysize parameters in a single call.
* When you disable the Calendars and Contacts, Receive Mail, Web Disk, Webmail, and
Web Server roles,
the system disables this function.

## Install SSL certificate

 - [GET /SSL/install_ssl](https://api.docs.cpanel.net/specifications/cpanel.openapi/ssl-certificate-management/install_ssl.md): This function installs an SSL certificate.

Note:

Due to their inherent complexities, SSL-related functions often present problems for third-party developers. For the additional steps required to successfully call this function, read our Call UAPI's SSL::install_ssl Function in Custom Code documentation.

Important:

When you disable the Calendars and Contacts, Receive Mail, Web Disk, Webmail, and Web Server roles, the system disables this function.

## Update SSL certificate's friendly name

 - [GET /SSL/set_cert_friendly_name](https://api.docs.cpanel.net/specifications/cpanel.openapi/ssl-certificate-management/set_cert_friendly_name.md): This function changes a certificate's friendly name.

Important:

When you disable the Calendars and Contacts, Receive Mail, Web Disk, Webmail, and Web Server roles, the system disables this function.

## Update certificate signing request's friendly name

 - [GET /SSL/set_csr_friendly_name](https://api.docs.cpanel.net/specifications/cpanel.openapi/ssl-certificate-management/set_csr_friendly_name.md): This function changes a certificate signing request's (CSR) friendly name.

Important:

* You must call either the friendly_name or id parameter.
* When you disable the Calendars and Contacts, Receive Mail, Web Disk, Webmail, and Web Server roles, the system disables this function.

## Update private key's friendly name

 - [GET /SSL/set_key_friendly_name](https://api.docs.cpanel.net/specifications/cpanel.openapi/ssl-certificate-management/set_key_friendly_name.md): This function changes a key's friendly name.

Important:

* You must call either the friendly_name or id parameter.
* When you disable the Calendars and Contacts, Receive Mail, Web Disk, Webmail, and Web Server roles, the system disables this function.

## Update SSL website for dedicated IP address

 - [GET /SSL/set_primary_ssl](https://api.docs.cpanel.net/specifications/cpanel.openapi/ssl-certificate-management/set_primary_ssl.md): This function sets a new primary SSL website for a dedicated IP address.

Important:

When you disable the Calendars and Contacts, Receive Mail, Web Disk, Webmail, and Web Server roles, the system disables this function.

## Export SSL certificate

 - [GET /SSL/show_cert](https://api.docs.cpanel.net/specifications/cpanel.openapi/ssl-certificate-management/show_cert.md): This function retrieves a certificate.

Note:

When you call this parameter, you must include either the id or
the friendly_name parameter.

Important:

When you disable the Calendars and Contacts, Receive Mail, Web Disk,
Webmail, and Web Server roles,
the system disables this function.

## Export certificate signing request

 - [GET /SSL/show_csr](https://api.docs.cpanel.net/specifications/cpanel.openapi/ssl-certificate-management/show_csr.md): This function retrieves a certificate signing request (CSR).

Important:

When you disable the Calendars and Contacts, Receive Mail, Web Disk, Webmail,
and Web Server roles,
the system disables this function.

Note:

When you call this function, you must include either the id
or the friendly_name parameter.

## Export private key

 - [GET /SSL/show_key](https://api.docs.cpanel.net/specifications/cpanel.openapi/ssl-certificate-management/show_key.md): This function retrieves a private key.

Important:

When you disable the Calendars and Contacts, Receive Mail, Web Disk, Webmail, and Web Server roles, the system disables this function.

## Import SSL certificate

 - [POST /SSL/upload_cert](https://api.docs.cpanel.net/specifications/cpanel.openapi/ssl-certificate-management/upload_cert.md): This function uploads a certificate.

Important:

* Due to the limited field length of HTTP GET method calls, you must use the HTTP
POST method. For this reason, you cannot use a cPanel or Webmail session URL to
call this function.
* When you disable the Calendar and Contacts, Receive Mail, Web Disk, Webmail, and
Web Server roles,
the system disables this function.

## Import private key

 - [POST /SSL/upload_key](https://api.docs.cpanel.net/specifications/cpanel.openapi/ssl-certificate-management/upload_key.md): This function uploads a private key.

Note:

Due to the limited field length of HTTP GET method calls, you must use
the HTTP POST method. For this reason, you cannot use a cPanel or Webmail
session URL to call this function.

Important:

When you disable the Calendars and Contacts, Receive Mail, Web Disk, Webmail,
and Web Server roles,
the system disables this function.