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 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.
Security
BasicAuth
Query
Bodymultipart/form-dataThe certificate's contents.
Example: crt="-----BEGIN CERTIFICATE-----/nMIIDcTCCAlmgAwIBAgIFAU+BNVgwDQYJKoZIhvcNAQEFBQAwUTESMBAGA1UEAwwJc2lza28udGxkMQswCQYDVQQGEwJVUzEPMA0GA1UECgwGY1BhbmVsMQswCQYDVQQIDAJUWDEQMA4GA1UEBwwHSG91c3RvbjAeFw0xNDEwMDYyMjI2MTlaFw0xNTEwMDYyMjI2MTlaMFExEjAQBgNVBAMMCXNpc2tvLnRsZDELMAkGA1UEBhMCVVMxDzANBgNVBAoMBmNQYW5lbDELMAkGA1UECAwCVFgxEDAOBgNVBAcMB0hvdXN0b24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC9zx6zGiHdmWA0dKtoXmJiWXpZ9E3PXx3YHsjFEWW7e5pH0vZ+jVMzDmm5nsJ7RXrAkZO1IvpIpVLvoQfiJOWVvkD+o9fWvoK1tWJS72FSgPju+58mA2ieBuc87A790Pzuv1P3NR3zFLAjUR99zkHR1fpri/daM3PBWO8ET48FWkyU1kOeZaUlF67/+wrEiNgg+t1qhKOCAB61PdNVkLaSGHimksuC+Czk8Kq9nuS0E0TCnDtjjEyJ455FUcaCfczlTb8xkB/F9ORe74yTzD+vlk0tFMG6PLj/ajIwWqwO0qmQ8wX3NRxkWgGz5kVO1wrVJarKQ5EYQ3/mgvit0v6dAgMBAAGjUDBOMB0GA1UdDgQWBBRw+wKBo34+bgexjAa3EMDsgSCd7zAfBgNVHSMEGDAWgBRw+wKBo34+bgexjAa3EMDsgSCd7zAMBgNVHRMEBTADAQH/MA0GCSqGSIb3DQEBBQUAA4IBAQCHRXIs53opzKM2rM8Qe8lcw524WK6hqy2EWrZHp78N7rU7/6DQ/I3hv3WhcDDIO04I2/Xhe88MLBaLoM367Ya+vy7CaLr14aLi/SfQszMA0ALBvMao+Fis0iVwFYq/NLgSXw+fgnpFskt8v8iQZ+4Kaal8U8e9sVgu8m0RgO7rzym1eRiIKpsKd1rh/SD7LbSN7M7TRL3QqF7ltw9sQhAAsQcRaBBF21pdWrqhiGZ+Eioo3hhgwNavH2agqz78ddHwrFpHFwrEeUk1OfpPb76MYIce7xIy/4oQNdg6fOq4l/FrajBv+WkzDVPaKm6r7YmwfLN/YMZBHXSR58oOGP9W/n-----END CERTIFICATE-----"
The certificate's contents.
- Mock server
https://api.docs.cpanel.net/_mock/specifications/cpanel.openapi/SSL/upload_cert
- A server running cPanel.
https://cpanel-server.tld:2083/execute/SSL/upload_cert
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
-u <username>:<password> \
'https://api.docs.cpanel.net/_mock/specifications/cpanel.openapi/SSL/upload_cert?crt=%22-----BEGIN+CERTIFICATE-----%2FnMIIDcTCCAlmgAwIBAgIFAU%2BBNVgwDQYJKoZIhvcNAQEFBQAwUTESMBAGA1UEAwwJc2lza28udGxkMQswCQYDVQQGEwJVUzEPMA0GA1UECgwGY1BhbmVsMQswCQYDVQQIDAJUWDEQMA4GA1UEBwwHSG91c3RvbjAeFw0xNDEwMDYyMjI2MTlaFw0xNTEwMDYyMjI2MTlaMFExEjAQBgNVBAMMCXNpc2tvLnRsZDELMAkGA1UEBhMCVVMxDzANBgNVBAoMBmNQYW5lbDELMAkGA1UECAwCVFgxEDAOBgNVBAcMB0hvdXN0b24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC9zx6zGiHdmWA0dKtoXmJiWXpZ9E3PXx3YHsjFEWW7e5pH0vZ%2BjVMzDmm5nsJ7RXrAkZO1IvpIpVLvoQfiJOWVvkD%2Bo9fWvoK1tWJS72FSgPju%2B58mA2ieBuc87A790Pzuv1P3NR3zFLAjUR99zkHR1fpri%2FdaM3PBWO8ET48FWkyU1kOeZaUlF67%2F%2BwrEiNgg%2Bt1qhKOCAB61PdNVkLaSGHimksuC%2BCzk8Kq9nuS0E0TCnDtjjEyJ455FUcaCfczlTb8xkB%2FF9ORe74yTzD%2Bvlk0tFMG6PLj%2FajIwWqwO0qmQ8wX3NRxkWgGz5kVO1wrVJarKQ5EYQ3%2Fmgvit0v6dAgMBAAGjUDBOMB0GA1UdDgQWBBRw%2BwKBo34%2BbgexjAa3EMDsgSCd7zAfBgNVHSMEGDAWgBRw%2BwKBo34%2BbgexjAa3EMDsgSCd7zAMBgNVHRMEBTADAQH%2FMA0GCSqGSIb3DQEBBQUAA4IBAQCHRXIs53opzKM2rM8Qe8lcw524WK6hqy2EWrZHp78N7rU7%2F6DQ%2FI3hv3WhcDDIO04I2%2FXhe88MLBaLoM367Ya%2Bvy7CaLr14aLi%2FSfQszMA0ALBvMao%2BFis0iVwFYq%2FNLgSXw%2BfgnpFskt8v8iQZ%2B4Kaal8U8e9sVgu8m0RgO7rzym1eRiIKpsKd1rh%2FSD7LbSN7M7TRL3QqF7ltw9sQhAAsQcRaBBF21pdWrqhiGZ%2BEioo3hhgwNavH2agqz78ddHwrFpHFwrEeUk1OfpPb76MYIce7xIy%2F4oQNdg6fOq4l%2FFrajBv%2BWkzDVPaKm6r7YmwfLN%2FYMZBHXSR58oOGP9W%2Fn-----END+CERTIFICATE-----%22&friendly_name=TestCert' \
-H 'Content-Type: multipart/form-data' \
-F crt=string \
-F friendly_name=stringResponse
application/json
{ "apiversion": 3, "func": "upload_cert", "module": "SSL", "result": { "data": [ … ], "errors": null, "messages": null, "metadata": { … }, "status": 1, "warnings": null } }
Request
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.
Security
BasicAuth
Query
Bodymultipart/form-dataThe key's contents.
Example: key="-----BEGIN RSA PRIVATE KEY-----\nMIIEowIBAAKCAQEAyeiHvMuJuVk8ZEY6wMzUS1g0eWaHaIWmIRe+Qrn6SwiRrm1p\npsJCiGPPPQGOSg4FzrMXqE0zsi/Tk3hUO/EEsi7CcZe8cUanjlUeXhiwrb86FCMF\nOb9siRHQvlss7VCg8ZGXXTWZgf5yD3A1xPwdayYwF2Tc7GkNcZGUAI58geuYaq+U\nGiLczRGZep1IQ0b1cZnqDvGMx6AS6hiDqLISjnmXYY2OhG6Uyp+SuinjYzLPJ6eO\nN/7i9qqbcGmt0ssddmhR897+bTEom5SlSuyi03KZ9Rn4ZmNJgOsup9MclSBGxBys\nb6MuuM3N0/tF5QuwmDc8H6h2rNBP9vGV7RTTXQIDAQABAoIBAFS/WVoRRLmbjxG3\nuKl8UA9f8oaSVnu0vUpeoOl5Dmm4Kw2/tvzbxPlii3Xb1VGYGS/tVBy8atp74J6h\nfxm5zHLN1afAPMR/F41ShPCSBHapMUOKf4MBqhjOdYOw2Way1RsQNSxWdxxtJIr+\nWlNYTzDOUpk/KMvCPHZS2IBzTidpcFpDQ3pyDXjOoKJJH0EQWPtvxJNGrFqmU29D\n9WBqQemHnDrzg3s7JzQ5cGpbbCE+QX8IckNkslAkyhm771CtqWdeo+c45e6YfGcx\nKuAy1zGSVzQBuitzYoMUOL5olXLEj8fHzXd/cZP4yCyyabcGz2vi6luxF+28l1OL\nG1axyLECgYEA+bD5B+Y/Dp5hZ/uVR1bbvyraQpwbDesS1zgnJ53KOIl926dnWzIt\nUvM46+c9IF+UJrtzwIB6IvjAQioNFrK36bHgNGzNf9WQ54NN172qveaFLdW34z/i\nGR2ix/efm9OC41QREQ/5IKV07TibCwVazVBWascMPkH7FnguTvTCiosCgYEAzwJ+\nGPlIWjK+sqkK5JMUyuH43qAvgVfkZV906JpNRQH0Mob3bC0nXN95EoTwWXk68ULT\no1GHv9XLbj8e+Ok7kpJQZT5vEZnDN+cy3jdTLCvcjU5Q3ToImOTp9isSAFWRTbtk\nyabLNoIIsTR/ZwwPFTZcRiK2d8k7ZhcRKdfGnrcCgYAPZ06FoTukoDqsGoYkB4S4\n72DVmSHGIwlfg5ROylouULUV9ubWZmsLYfvR+cr4k0zlcsz6RDLEs4nQyx1RmCbm\nYNXPBiNLTpaI4b3MoGPHIVB3+mZEu60sFXr0UR9kkpDRi18eKVkaHXrwI3zVGjh2\n0Az0u2DS+mkOAs4AivLxbwKBgQC0XPqbLc+Bb0dCCREJmLD8GCkrZ6wcaQUB4krN\nQ2vhnVM0Fu5K3Yi3XapynUuA2aSmgtA9MxMw7MkjlHGa9DPIgBz2KZDCaBN0iMeE\nX/XivZCbucmxBxhohsLmjh5QFj3U2Vp2bBIQuvlx1EjQ8uvNUqDRJvuOoNFVIPH+\nYBeZPwKBgA//kXfNtNMHOpch699i3rgTzbRFDmGwsr1otzvJsXw7Pr2bM4WIzUJy\nG2SUSUlQRSZK4+BBKT9S0d7TynJD6X/6R7IBotZbfXs1myYxEsKj89/BQmr47x2h\nHjYVCClNoJlsbd5C2yu1R3PikweWGoVaxE3c+AN5knqjwJ0g21Cf\n-----END RSA PRIVATE KEY-----"
The certificate's contents.
- Mock server
https://api.docs.cpanel.net/_mock/specifications/cpanel.openapi/SSL/upload_key
- A server running cPanel.
https://cpanel-server.tld:2083/execute/SSL/upload_key
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
-u <username>:<password> \
'https://api.docs.cpanel.net/_mock/specifications/cpanel.openapi/SSL/upload_key?key=%22-----BEGIN+RSA+PRIVATE+KEY-----%5CnMIIEowIBAAKCAQEAyeiHvMuJuVk8ZEY6wMzUS1g0eWaHaIWmIRe%2BQrn6SwiRrm1p%5CnpsJCiGPPPQGOSg4FzrMXqE0zsi%2FTk3hUO%2FEEsi7CcZe8cUanjlUeXhiwrb86FCMF%5CnOb9siRHQvlss7VCg8ZGXXTWZgf5yD3A1xPwdayYwF2Tc7GkNcZGUAI58geuYaq%2BU%5CnGiLczRGZep1IQ0b1cZnqDvGMx6AS6hiDqLISjnmXYY2OhG6Uyp%2BSuinjYzLPJ6eO%5CnN%2F7i9qqbcGmt0ssddmhR897%2BbTEom5SlSuyi03KZ9Rn4ZmNJgOsup9MclSBGxBys%5Cnb6MuuM3N0%2FtF5QuwmDc8H6h2rNBP9vGV7RTTXQIDAQABAoIBAFS%2FWVoRRLmbjxG3%5CnuKl8UA9f8oaSVnu0vUpeoOl5Dmm4Kw2%2FtvzbxPlii3Xb1VGYGS%2FtVBy8atp74J6h%5Cnfxm5zHLN1afAPMR%2FF41ShPCSBHapMUOKf4MBqhjOdYOw2Way1RsQNSxWdxxtJIr%2B%5CnWlNYTzDOUpk%2FKMvCPHZS2IBzTidpcFpDQ3pyDXjOoKJJH0EQWPtvxJNGrFqmU29D%5Cn9WBqQemHnDrzg3s7JzQ5cGpbbCE%2BQX8IckNkslAkyhm771CtqWdeo%2Bc45e6YfGcx%5CnKuAy1zGSVzQBuitzYoMUOL5olXLEj8fHzXd%2FcZP4yCyyabcGz2vi6luxF%2B28l1OL%5CnG1axyLECgYEA%2BbD5B%2BY%2FDp5hZ%2FuVR1bbvyraQpwbDesS1zgnJ53KOIl926dnWzIt%5CnUvM46%2Bc9IF%2BUJrtzwIB6IvjAQioNFrK36bHgNGzNf9WQ54NN172qveaFLdW34z%2Fi%5CnGR2ix%2Fefm9OC41QREQ%2F5IKV07TibCwVazVBWascMPkH7FnguTvTCiosCgYEAzwJ%2B%5CnGPlIWjK%2BsqkK5JMUyuH43qAvgVfkZV906JpNRQH0Mob3bC0nXN95EoTwWXk68ULT%5Cno1GHv9XLbj8e%2BOk7kpJQZT5vEZnDN%2Bcy3jdTLCvcjU5Q3ToImOTp9isSAFWRTbtk%5CnyabLNoIIsTR%2FZwwPFTZcRiK2d8k7ZhcRKdfGnrcCgYAPZ06FoTukoDqsGoYkB4S4%5Cn72DVmSHGIwlfg5ROylouULUV9ubWZmsLYfvR%2Bcr4k0zlcsz6RDLEs4nQyx1RmCbm%5CnYNXPBiNLTpaI4b3MoGPHIVB3%2BmZEu60sFXr0UR9kkpDRi18eKVkaHXrwI3zVGjh2%5Cn0Az0u2DS%2BmkOAs4AivLxbwKBgQC0XPqbLc%2BBb0dCCREJmLD8GCkrZ6wcaQUB4krN%5CnQ2vhnVM0Fu5K3Yi3XapynUuA2aSmgtA9MxMw7MkjlHGa9DPIgBz2KZDCaBN0iMeE%5CnX%2FXivZCbucmxBxhohsLmjh5QFj3U2Vp2bBIQuvlx1EjQ8uvNUqDRJvuOoNFVIPH%2B%5CnYBeZPwKBgA%2F%2FkXfNtNMHOpch699i3rgTzbRFDmGwsr1otzvJsXw7Pr2bM4WIzUJy%5CnG2SUSUlQRSZK4%2BBBKT9S0d7TynJD6X%2F6R7IBotZbfXs1myYxEsKj89%2FBQmr47x2h%5CnHjYVCClNoJlsbd5C2yu1R3PikweWGoVaxE3c%2BAN5knqjwJ0g21Cf%5Cn-----END+RSA+PRIVATE+KEY-----%22&friendly_name=TestKey' \
-H 'Content-Type: multipart/form-data' \
-F crt=string \
-F friendly_name=stringResponse
application/json
{ "apiversion": 3, "func": "upload_key", "module": "SSL", "result": { "data": [ … ], "errors": null, "messages": null, "metadata": { … }, "status": 1, "warnings": null } }