Update a DTS root CA certificate

PUT/v1/ecosystems/certificates/ca/{dtsCaCertificateId}

Updates a DTS root CA certificate.

Roles

admindts-provider

Analytics Events

ECOSYSTEM_DTS_CA_CERTIFICATE_UPDATE_STARTECOSYSTEM_DTS_CA_CERTIFICATE_UPDATE_SUCCESSECOSYSTEM_DTS_CA_CERTIFICATE_UPDATE_FAIL

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

dtsCaCertificateId*string

Unique identifier of the DTS root CA certificate.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X PUT "https://example.com/v1/ecosystems/certificates/ca/b0aae560-10e7-4247-8e96-7cdd3578a1e2" \  -H "Content-Type: application/json" \  -d '{    "active": true  }'

{  "id": "782f1885-c7c2-4459-8426-b6d7c111b0b1",  "active": true,  "certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDXTCCAkWgAwIBAgIJAL5...\n-----END CERTIFICATE-----",  "certificateFingerprint": "f6cad6e579d70b3973efa60624af731a580d1a11a7579e70f2f10f059dc86172",  "certificateData": {    "commonName": "example.com",    "country": "US",    "organisationName": "Example Inc.",    "notAfter": "2024-10-22T00:00:00Z",    "notBefore": "2023-10-22T00:00:00Z"  },  "isManaged": true,  "useIntermediateCa": true}

Update a DTS root CA certificate

PUT/v1/ecosystems/certificates/ca/{dtsCaCertificateId}

Updates a DTS root CA certificate.

Roles

admindts-provider

Analytics Events

ECOSYSTEM_DTS_CA_CERTIFICATE_UPDATE_STARTECOSYSTEM_DTS_CA_CERTIFICATE_UPDATE_SUCCESSECOSYSTEM_DTS_CA_CERTIFICATE_UPDATE_FAIL

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

dtsCaCertificateId*string

Unique identifier of the DTS root CA certificate.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

active*boolean

Indicates whether the DTS root CA certificate is active. Activating a certificate does not affect your ability to create or sign subordinate (intermediate CA or signer) certificates: you can build a complete certificate chain while the root CA is inactive. Instead, active certificates are included in the selection process MATTR VII uses when choosing the certificate chain to sign a trusted list (VICAL or RICAL), where MATTR VII prefers the most recently created active certificate at each level of the chain. Only one DTS root CA certificate can be active at a time.

useIntermediateCa?boolean

When true, this DTS root CA certificate uses the 3-tier certificate model, requiring and using DTS intermediate CA certificates as part of its chain of trust for signing operations. When false, the 2-tier model is used and the DTS root CA signs signer certificates directly. Changing this value requires deleting all subordinate certificates. This field can only be set for unmanaged (external) DTS root CA certificates. For an explanation of the 2-tier and 3-tier models, refer to the DTS certificates overview.

Response Body

`application/json`

curl -X PUT "https://example.com/v1/ecosystems/certificates/ca/b0aae560-10e7-4247-8e96-7cdd3578a1e2" \  -H "Content-Type: application/json" \  -d '{    "active": true  }'

{  "id": "782f1885-c7c2-4459-8426-b6d7c111b0b1",  "active": true,  "certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDXTCCAkWgAwIBAgIJAL5...\n-----END CERTIFICATE-----",  "certificateFingerprint": "f6cad6e579d70b3973efa60624af731a580d1a11a7579e70f2f10f059dc86172",  "certificateData": {    "commonName": "example.com",    "country": "US",    "organisationName": "Example Inc.",    "notAfter": "2024-10-22T00:00:00Z",    "notBefore": "2023-10-22T00:00:00Z"  },  "isManaged": true,  "useIntermediateCa": true}

How would you rate this page?

Update a DTS root CA certificate

Roles

Analytics Events

200application/json

400application/json

404application/json

Update a DTS root CA certificate

Roles

Analytics Events

200application/json

400application/json

404application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`