Caddy PKI API

The PKI API from Caddy — 2 operation(s) for pki.

OpenAPI Specification

caddy-pki-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Caddy Admin Adapt PKI API
  version: '1.0'
  description: Minimal OpenAPI 3.1 description of the Caddy web server admin API. By default the admin endpoint is bound to localhost:2019 and is used to inspect and dynamically modify the running configuration without restarts.
  x-generated-from: https://caddyserver.com/docs/api
  x-generated-by: claude-crawl-2026-05-08
servers:
- url: http://localhost:2019
  description: Default admin endpoint
tags:
- name: PKI
paths:
  /pki/ca/{id}:
    parameters:
    - $ref: '#/components/parameters/IdParam'
    get:
      tags:
      - PKI
      summary: Returns PKI CA information
      operationId: getPkiCa
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Config'
  /pki/ca/{id}/certificates:
    parameters:
    - $ref: '#/components/parameters/IdParam'
    get:
      tags:
      - PKI
      summary: Returns the CA certificate chain
      operationId: getPkiCaCertificates
      responses:
        '200':
          description: OK
          content:
            application/x-pem-file:
              schema:
                type: string
components:
  schemas:
    Config:
      type: object
      additionalProperties: true
  parameters:
    IdParam:
      name: id
      in: path
      required: true
      schema:
        type: string