Create Root Certificate Authorities

Create Root Certificate Authorities

Creates a root certificate authority using the provided certificate pem and private key pem. It will be marked as inactive initially.

This is used during Step 1 of the Certificate Authority rotation procedure. See Rotating CAs and Leaf Certificates for more details.

Request
URI
POST
https://{api_host}/api/v0/certificate_authorities
COPY
Request Body

OK

{
    "cert_pem": "string",
    "private_key_pem": "string"
}
string
cert_pem
Optional

cert_pem

string
private_key_pem
Optional

private_key_pem

Responses
200

OK

Returns RegeneratedCertificateAuthoritiesRotationStatus of type(s) application/json
{
    "guid": "string",
    "issuer": "string",
    "created_on": "string",
    "expires_on": "string",
    "active": false,
    "cert_pem": "string",
    "certificates": {
        "regenerated": [
            {
                "location": "string",
                "product_guid": "string",
                "property_reference": "string",
                "variable_path": "string",
                "reason": "string"
            }
        ],
        "excluded": [
            {
                "location": "string",
                "product_guid": "string",
                "property_reference": "string",
                "variable_path": "string",
                "reason": "string"
            }
        ],
        "regenerate_failed": [
            {
                "location": "string",
                "product_guid": "string",
                "property_reference": "string",
                "variable_path": "string",
                "reason": "string"
            }
        ]
    }
}
string
guid
Optional

guid

string
issuer
Optional

issuer

string
created_on
Optional

created_on

string
expires_on
Optional

expires_on

boolean
active
Optional

active

string
cert_pem
Optional

cert_pem

object
certificates
Optional

certificates


422

Unprocessable Entity

Returns SafetyViolations of type(s) application/json
"SafetyViolations Object"
string
error
Optional

error

array of safety_violations
safety_violations
Optional

safety_violations


Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/api/v0/certificate_authorities