Version 2.1.1792967583 · latest Download OpenAPI Markdown

Panel certificate

Admin only. Status of the panel's own HTTPS certificate; one click issues a Let's Encrypt certificate for the panel domain, renewed with certificate management.

panel-certCertificatesAuthentication: Admin only2 endpoints

Get panel certificate status

GET/api/v2/panel-cert
Authentication: Admin only

Issue panel certificate

POST/api/v2/panel-cert/issue
Authentication: Admin only

Panel certificate object

FieldTypeRequiredDescription
acmeCertAcme— Automatic issuance state (state, challenge type, renewal and the last failure reason).
certCert— Certificate (responses carry the chain, names, expiry and status but never the private key; export the key via the export endpoint).
cert_idinteger— panel.tls.cert_id; 0 when no panel certificate is configured.
domainstring— Panel domain; empty when not set.
httpsstring— Current state of panel HTTPS. on = the panel certificate is usable and the controller listens for HTTPS; no_domain = no panel domain set (no certificate is requested); no_cert = a domain is set but there is no usable panel certificate; issuing = the certificate is being issued; failed = issuance failed (see acme.last_error; automatic requests retry at intervals); no_listen = the certificate exists but the controller config file has no HTTPS listener (listen_tls); expired = the panel certificate has expired (not_after has passed and renewal has not succeeded).
Values ["on","no_domain","no_cert","issuing","failed","no_listen","expired"]