Skip to content

Administration

Admin-only operations (requires an administrator token)

Upload CA certificate

Request

Upload (add) a Certification Authority (CA) certificate to the system.

This operation is intended to add a CA that is not present among the trusted ones already configured. Requires a token with administrator privileges.

Body is application/json and contains:

  • certificate: the certificate to add (typically base64 / PEM content as a string, per examples)
  • tags (optional): object with any of: chain, trusted, tsa
Security
AuthToken
Bodyapplication/jsonrequired
certificatestringrequired

Certificate content (as string, e.g. base64/PEM as provided by clients)

tagsobject

Optional tags to classify the certificate

curl -i -X POST \
  https://example.com/api/admin/certificates/ \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "certificate": "MIIF...base64...",
    "tags": {
      "trusted": {},
      "chain": {},
      "tsa": {}
    }
  }'

Responses

CA certificate added successfully

Bodyapplication/json
dataobject
<property name>anyadditional property
Response
{ "data": { "hash": "string", "certificate": "string", "tags": {}, "not_before": { … }, "not_after": { … }, "cert_id": "string", "serial_number": "string", "subject": "string", "issuer": "string" } }