light-mode-image
Learn
API ReferenceCertificates

Create a DTS root CA certificate

Roles

admindts-provider

Analytics Events

ECOSYSTEM_DTS_CA_CERTIFICATE_CREATE_STARTECOSYSTEM_DTS_CA_CERTIFICATE_CREATE_SUCCESSECOSYSTEM_DTS_CA_CERTIFICATE_CREATE_FAIL
POST/v1/ecosystems/certificates/ca

Creates a DTS root CA certificate which is used to sign DTS signer certificates.

  • A maximum of three DTS root CA certificates can be created per tenant.

Analytic events

  • ECOSYSTEM_DTS_CA_CERTIFICATE_CREATE_START
  • ECOSYSTEM_DTS_CA_CERTIFICATE_CREATE_SUCCESS
  • ECOSYSTEM_DTS_CA_CERTIFICATE_CREATE_FAIL

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.vii.au01.mattr.global/v1/ecosystems/certificates/ca" \  -H "Content-Type: application/json" \  -d '{    "organisationName": "Example Inc."  }'
{
  "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
}
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}

How would you rate this page?

Retrieve ecosystem policy GET

Retrieves an ecosystem policy by providing the ecosystem ID. This endpoint is intended for public consumption, and as such does not require authentication. ### **Analytic events** * ECOSYSTEM_POLICY_RETRIEVE_LATEST_START * ECOSYSTEM_POLICY_RETRIEVE_LATEST_SUCCESS * ECOSYSTEM_POLICY_RETRIEVE_LATEST_FAIL

Retrieve all DTS root CA certificates GET

Retrieves all DTS root CA certificates. ### **Analytic events** * ECOSYSTEM_DTS_CA_CERTIFICATE_RETRIEVE_LIST_START * ECOSYSTEM_DTS_CA_CERTIFICATE_RETRIEVE_LIST_SUCCESS * ECOSYSTEM_DTS_CA_CERTIFICATE_RETRIEVE_LIST_FAIL