CA Certificates

Upsert a CA Certificate

Changed on

Create or Update CA Certificate using ID.

put/ca_certificates/{CACertificateId}

Request

  • Base URL: http://localhost:8001
  • URL: http://localhost:8001/ca_certificates/{CACertificateId}
  • Auth: API key in header Kong-Admin-Token

Request body

certstring required

PEM-encoded public certificate of the CA.

cert_digeststring nullable

SHA256 hex digest of the public certificate. This field is read-only and it cannot be set by the caller, the value is automatically computed.

created_atinteger nullable

Unix epoch when the resource was created.

idstring nullable

A string representing a UUID (universally unique identifier).

tagsstring[] nullable

An optional set of strings associated with the Certificate for grouping and filtering.

updated_atinteger nullable

Unix epoch when the resource was last updated.

Example request

{
  "cert": "-----BEGIN CERTIFICATE-----\ncertificate-content\n-----END CERTIFICATE-----",
  "cert_digest": "9b8aaf19a276885f6c8a6bc48a30700fdb3a351d8b05374d153bfb7b178e2a9f",
  "created_at": 1706598432,
  "id": "b2f34145-0343-41a4-9602-4c69dec2f260",
  "tags": [
    "trusted",
    "api"
  ]
}

Response

Successfully upserted CA Certificate

certstring required

PEM-encoded public certificate of the CA.

cert_digeststring nullable

SHA256 hex digest of the public certificate. This field is read-only and it cannot be set by the caller, the value is automatically computed.

created_atinteger nullable

Unix epoch when the resource was created.

idstring nullable

A string representing a UUID (universally unique identifier).

tagsstring[] nullable

An optional set of strings associated with the Certificate for grouping and filtering.

updated_atinteger nullable

Unix epoch when the resource was last updated.

Example response

{
  "cert": "-----BEGIN CERTIFICATE-----\ncertificate-content\n-----END CERTIFICATE-----",
  "cert_digest": "9b8aaf19a276885f6c8a6bc48a30700fdb3a351d8b05374d153bfb7b178e2a9f",
  "created_at": 1706598432,
  "id": "b2f34145-0343-41a4-9602-4c69dec2f260",
  "tags": [
    "trusted",
    "api"
  ]
}

Changes

  • 740b73588ef4Revision changes
    • breaking

      the response property became nullable for the status

    • info

      the request property became nullable

  • e07a25288f1fRevision changes
    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • info

      the request optional property became not read-only

    • info

      the request optional property became not read-only

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the response optional property became not read-only for the status

    • info

      the response optional property became not read-only for the status