UAPI accesses the cPanel interface's features. Use this API to access and modify cPanel account data and settings.
Download OpenAPI description
Overview
URL
WebPros International, LLC
License
Languages
Servers
Mock server
https://api.docs.cpanel.net/_mock/specifications/cpanel.openapi/
A server running cPanel.
https://{host}:{port}/execute/
Request
This function deletes a private key.
Note:
- When you call this function, you must include the
idor thefriendly_nameparameter. - To delete a certificate signing request (CSR), use the UAPI
SSL::delete_csrfunction instead.
Important:
When you disable the Calendars and Contacts, Receive Mail, Web Disk, Webmail, and Web Server roles, the system disables this function.
Security
BasicAuth
- Mock server
https://api.docs.cpanel.net/_mock/specifications/cpanel.openapi/SSL/delete_key
- A server running cPanel.
https://cpanel-server.tld:2083/execute/SSL/delete_key
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
'https://api.docs.cpanel.net/_mock/specifications/cpanel.openapi/SSL/delete_key?friendly_name=TestKey&id=example_com_e095f_0ab2f_ebcbe4a571276f48562241411556647f'Response
application/json
{ "apiversion": 3, "func": "delete_key", "module": "SSL", "result": { "data": [ … ], "errors": null, "messages": null, "metadata": { … }, "status": 1, "warnings": null } }
Request
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.
Security
BasicAuth
Query
A comma-separated list of domains for which to generate the certificate.
domains=domains=example1.com,example2.com,example3.com
domains=example.com
The key's ID.
Example: key_id=example_com_cb497_a394d_1397249671_d1272da8f13a1fd837493a5ad1f0a0f3
The certificate's Organization Name.
Example: organizationName=Organization
The two-letter state or locality abbreviation.
Example: stateOrProvinceName=TX
An email address to associate with the certificate.
Default ""
Example: emailAddress=username@example.com
A friendly name for the new certificate.
This parameter defaults to the domain's name for which you generated the certificate.
Example: friendly_name=TestCert
- Mock server
https://api.docs.cpanel.net/_mock/specifications/cpanel.openapi/SSL/generate_cert
- A server running cPanel.
https://cpanel-server.tld:2083/execute/SSL/generate_cert
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
'https://api.docs.cpanel.net/_mock/specifications/cpanel.openapi/SSL/generate_cert?countryName=US&domains=string&key_id=example_com_cb497_a394d_1397249671_d1272da8f13a1fd837493a5ad1f0a0f3&localityName=Houston&organizationName=Organization&stateOrProvinceName=TX&emailAddress=username%40example.com&friendly_name=TestCert&organizationalUnitName=Department'Response
application/json
{ "apiversion": 3, "func": "generate_cert", "module": "SSL", "result": { "data": { … }, "errors": null, "messages": [ … ], "metadata": {}, "status": 1, "warnings": null } }
Request
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.
Security
BasicAuth
Query
A comma-separated list of the domains for which to generate the certificate.
domains=domains=example-1.com,example-1.com,example-2.com
domains=example.com
The key's ID.
Example: key_id=example_com_cb497_a394d_1397249671_d1272da8f13a1fd837493a5ad1f0a0f3
The certificate's organization.
Example: organizationName=Organization
The certificate's state or locality name.
Example: stateOrProvinceName=Texas
An email address to associate with the certificate.
Default ""
Example: emailAddress=username@example.com
A friendly name for the new certificate.
This parameter defaults to the domain name for which you generated the certificate.
Example: friendly_name=TestCert
- Mock server
https://api.docs.cpanel.net/_mock/specifications/cpanel.openapi/SSL/generate_csr
- A server running cPanel.
https://cpanel-server.tld:2083/execute/SSL/generate_csr
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
-u <username>:<password> \
'https://api.docs.cpanel.net/_mock/specifications/cpanel.openapi/SSL/generate_csr?countryName=US&domains=string&key_id=example_com_cb497_a394d_1397249671_d1272da8f13a1fd837493a5ad1f0a0f3&localityName=Houston&organizationName=Organization&stateOrProvinceName=Texas&emailAddress=username%40example.com&friendly_name=TestCert&organizationalUnitName=Department'Response
application/json
{ "apiversion": 3, "func": "generate_csr", "module": "SSL", "result": { "data": { … }, "errors": null, "messages": [ … ], "metadata": {}, "status": 1, "warnings": null } }