CA Certificates

Upsert a CA Certificate

Create or Update CA Certificate using ID.

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

Changes

Changed in 4 of the 11 revisions of this API.6112

Oct 9, 2025740b73588ef411See the full diff
- ▲
  the response property tags became nullable for the status 200
  response-property-became-nullable
- ○
  the request property tags became nullable
  request-property-became-nullable
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 4, 2025e07a25288f1f26See the full diff
- ▲
  the response property created_at became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property updated_at became nullable for the status 200
  response-property-became-nullable
- ○
  the request optional property created_at became not read-only
  request-optional-property-became-not-read-only
- ○
  the request optional property updated_at became not read-only
  request-optional-property-became-not-read-only
- ○
  the request property created_at became nullable
  request-property-became-nullable
- ○
  the request property updated_at became nullable
  request-property-became-nullable
- ○
  the response optional property created_at became not read-only for the status 200
  response-optional-property-became-not-read-only
- ○
  the response optional property updated_at became not read-only for the status 200
  response-optional-property-became-not-read-only
This revision also has 10 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Nov 26, 202499e71588eb6135See the full diff
- ▲
  the request property cert became required
  request-property-became-required
- ▲
  the response property cert_digest became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property id became nullable for the status 200
  response-property-became-nullable
- ○
  the request optional property id became not read-only
  request-optional-property-became-not-read-only
- ○
  the request property cert_digest became nullable
  request-property-became-nullable
- ○
  the request property id became nullable
  request-property-became-nullable
- ○
  the response optional property id became not read-only for the status 200
  response-optional-property-became-not-read-only
- ○
  the response property cert became required for the status 200
  response-property-became-required
This revision also has 81 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 11, 20245bd52189d2901See the full diff
- ●
  deleted the path request parameter CACertificateId
  request-parameter-removed
This revision also has 27 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 11 revisions, 1 has no diff computed.