v50

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-07-068428533.0 MB
CA Certificates

Upsert a CA Certificate

Create or Update CA Certificate using ID.

put/v2/control-planes/{controlPlaneId}/core-entities/ca_certificates/{CACertificateId}

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"
  ]
}