certmanager

GET /certificates/_routes

Get the certmanager route manifest

Returns the service name and the list of certmanager routes with their method, path and required permissions.

Status Codes:
  • 200 OK – service name and routes manifest

POST /certificates/create

Issue a certificate

Issues a certificate for the requested DNS names through certbot; IP SANs are rejected.

Request JSON Object:
  • dns_names[] (string)

  • ip_addresses[] (string)

Status Codes:
Response JSON Object:
  • certificate_pem (string)

  • private_key_pem (string)

GET /certificates/dashboard

Get the certificate dashboard

Collects certificates from this node and configured remote nodes, applies search and filters, and returns a summary with one page of results.

Query Parameters:
  • page (integer) – page number, 1-based (default 1)

  • page_size (integer) – page size, 1 to 100 (default 10)

  • search (string) – search text

  • status (string) – status filter: valid, expiring or expired

  • type (string) – certificate type filter

  • service (string) – service name filter

  • algorithm (string) – key algorithm filter

Status Codes:
Response JSON Object:
  • certificates[].algo_bits (string) – “2048-bit”, “256-bit”, etc

  • certificates[].algorithm (string) – “RSA-2048”, “ECDSA-256”, “RSA-4096”

  • certificates[].cns[] (string)

  • certificates[].days_left (integer)

  • certificates[].expiration (string) – ISO format date

  • certificates[].fingerprint (string) – SHA256 fingerprint

  • certificates[].issuer_ca (string)

  • certificates[].name (string)

  • certificates[].services[] (string)

  • certificates[].status (string) – “valid”, “expiring”, “expired”

  • certificates[].type (string) – “AGENT”, “MGMT”, “STORAGE”, “DB”, “LB”

  • current_page (integer)

  • page_size (integer)

  • summary.auto_renewal_count (integer)

  • summary.expired_count (integer)

  • summary.expiring_count (integer)

  • summary.expiring_days_remaining (integer)

  • summary.total_compute (integer)

  • summary.total_mgmt (integer)

  • summary.total_nodes (integer)

  • summary.valid_count (integer)

  • summary.valid_days_remaining (integer)

  • total_count (integer)

GET /certificates/external-leaf

Get external edge certificate status

Reports whether an operator-managed edge certificate is installed, with its subject, expiry and days remaining when readable.

Status Codes:
POST /certificates/external-leaf

Install an external edge certificate

Validates an uploaded cert and key (optional chain), swaps the Envoy edge chain and key, writes the operator-managed marker and schedules an Envoy restart.

Status Codes:
  • 200 OK – installed certificate details and restart status

  • 400 Bad Request – missing or unreadable files, invalid cert, key mismatch, expired or not yet valid

  • 500 Internal Server Error – backup directory, chain or key write failed

GET /certificates/get/{domain}

Get a certificate

Returns certificate file info and parsed details for a domain.

Parameters:
  • domain (string) – Certificate domain

Status Codes:
Response JSON Object:
  • algo_bits (string) – “2048-bit”, “256-bit”, etc

  • algorithm (string) – “RSA-2048”, “ECDSA-256”, “RSA-4096”

  • cert_path (string)

  • certificate_pem (string)

  • chain_path (string)

  • cns[] (string)

  • days_left (integer)

  • domain (string)

  • expiration (string) – ISO format date

  • fingerprint (string) – SHA256 fingerprint

  • fullchain_path (string)

  • issued_at (string)

  • issuer_ca (string)

  • key_path (string)

  • live_path (string)

  • name (string)

  • private_key_pem (string)

  • services[] (string)

  • status (string) – “valid”, “expiring”, “expired”

  • type (string) – “AGENT”, “MGMT”, “STORAGE”, “DB”, “LB”

GET /certificates/list

List certificates

Lists all system certificates on this node for its node type.

Status Codes:
POST /certificates/renew/{domain}

Renew a certificate

Renews the certificate for a domain through certbot, optionally forcing renewal.

Parameters:
  • domain (string) – Certificate domain

Query Parameters:
  • force (boolean) – force renewal when true

Status Codes:
Response JSON Object:
  • certificate_pem (string)

  • private_key_pem (string)

GET /certificates/root-ca

Download the root CA certificate

Returns the cluster root CA certificate as a downloadable PEM file.

Status Codes:
POST /certificates/rotate/certificateauthorities

Rotate the certificate authorities

Validates an uploaded CA cert and key (.crt and .key, max 10MB each), rotates the CAs and verifies the rotation; management server only.

Status Codes: