Update a version

put https://{hostname}/mtls-edge-truststore/v1/ca-sets/{caSetId}/versions/{versionId}

Update all the certificates for the version, or the allowInsecureSha1 that controls what type of certificates to allow.

Path Params

caSetId

integer

required

Identifies each CA set.

versionId

integer

required

Version identifier on which to perform the desired operation.

Query Params

accountSwitchKey

string

For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Body Params

allowInsecureSha1

boolean

Defaults to false

By default, the version's certificates need a signature algorithm of SHA-256 or better. Enabling this allows certificates with SHA-1 signatures.

certificates

array of objects

required

length ≥ 1

The certificates that are valid, non-expired, root, or intermediate.

certificates*

certificatePem

string

required

length ≥ 0

The certificate in PEM format, as found in a Base64 ASCII encoded file.

comments

string | null

Any additional comments you can provide while creating or updating the CA set version.

Responses

Response body

object

allowInsecureSha1

boolean | null

By default, all certificates in the version need a signature algorithm of SHA-256 or better. Enabling this allows certificates with SHA-1 signatures.

certificates

array of objects

required

length ≥ 0

The certificates that are valid, non-expired, root, or intermediate.

certificates*

object

certificateId

integer

≥ 1

Read-only Uniquely identifies the certificate.

certificatePem

string

required

length ≥ 1

The certificate in PEM format, as found in a Base64 ASCII encoded file.

createdBy

string

length ≥ 1

Read-only The user who created this CA certificate.

createdDate

date-time

Read-only When the CA certificate was created.

endDate

date-time

Read-only The certificate's ISO 8601 formatted expiration date.

fingerprint

string

length ≥ 1

Read-only The fingerprint of the certificate.

issuer

string

length ≥ 1

Read-only The certificate's issuer.

serialNumber

string

length ≥ 1

Read-only The unique serial number of the certificate.

signatureAlgorithm

string

length ≥ 1

Read-only The signature algorithm of the CA certificate.

startDate

date-time

Read-only The start date of the certificate.

subject

string

length ≥ 1

Read-only The certificate's subject field.

comments

string | null

Any additional comments you can provide while creating or updating the CA set version.

createdBy

string | null

Read-only The user who created the CA set version.

createdDate

date-time | null

Read-only When the CA set version was created.

modifiedBy

string | null

Read-only The user who last modified the CA set version.

modifiedDate

date-time | null

Read-only When the CA set version was last modified.

productionStatus

string | null

Read-only The CA set version's status on the production network, either ACTIVE or INACTIVE.

ACTIVE INACTIVE

stagingStatus

string | null

Read-only The CA set version's status on the staging network, either ACTIVE or INACTIVE.

ACTIVE INACTIVE

validationResults

object | null

Read-only Validation results that display any errors, warnings, or notices.

errors

array of objects

required

length ≥ 0

Read-only Any kind of validation errors you need to fix for the request to succeed. For example, creating or updating a CA set version with expired or malformed certificates.

errors*

object

detail

string

length ≥ 1

Read-only Explains the problem with any guidance on how to fix it.

errors

array of objects

length ≥ 1

Read-only The problem type errors.

errors

object

instance

string

length ≥ 1

Read-only Non-navigable URI that identifies each occurrence of the problem.

status

integer

≥ 1

Read-only The HTTP status code.

title

string

length ≥ 1

Read-only Human readable summary of each error case.

type

string

required

length ≥ 1

Read-only Non-navigable URI that identifies each error case.

notices

array of objects

required

length ≥ 0

Read-only Any kind of validation notices only to make you aware. No corrective action required.

notices*

object

detail

string

length ≥ 1

Read-only Explains the problem with any guidance on how to fix it.

errors

array of objects

length ≥ 1

Read-only The problem type errors.

errors

object

instance

string

length ≥ 1

Read-only Non-navigable URI that identifies each occurrence of the problem.

status

integer

≥ 1

Read-only The HTTP status code.

title

string

length ≥ 1

Read-only Human readable summary of each error case.

type

string

required

length ≥ 1

Read-only Non-navigable URI that identifies each error case.

warnings

array of objects

required

length ≥ 0

Read-only Any kind of validation warnings where you can fix the request. For example, creating or updating CA set version with duplicated certificates.

warnings*

object

detail

string

length ≥ 1

Read-only Explains the problem with any guidance on how to fix it.

errors

array of objects

length ≥ 1

Read-only The problem type errors.

errors

object

instance

string

length ≥ 1

Read-only Non-navigable URI that identifies each occurrence of the problem.

status

integer

≥ 1

Read-only The HTTP status code.

title

string

length ≥ 1

Read-only Human readable summary of each error case.

type

string

required

length ≥ 1

Read-only Non-navigable URI that identifies each error case.

versionId

integer | null

≥ 1

Read-only Uniquely identifies the CA set version.

versionLink

string | null

Read-only Hypermedia link to the CA set version.

versionNumber

integer | null

≥ 1

Read-only The CA set's incremental version number.

Headers

object

X-RateLimit-Limit

integer

Indicates how many total requests you are allowed to make in the current time window. You can't make more requests than this value. See Rate Limiting.

X-RateLimit-Remaining

integer

Indicates how many remaining requests you can make in the current time window. See Rate Limiting.

X-RateLimit-Reset

string

Indicates the time of resetting the number of your remaining requests to the full limit indicated by X-RateLimit-Limit. See Rate Limiting.

Response body

object

allowInsecureSha1

boolean | null

By default, all certificates in the version need a signature algorithm of SHA-256 or better. Enabling this allows certificates with SHA-1 signatures.

certificates

array of objects

required

length ≥ 0

The certificates that are valid, non-expired, root, or intermediate.

certificates*

object

certificateId

integer

≥ 1

Read-only Uniquely identifies the certificate.

certificatePem

string

required

length ≥ 1

The certificate in PEM format, as found in a Base64 ASCII encoded file.

createdBy

string

length ≥ 1

Read-only The user who created this CA certificate.

createdDate

date-time

Read-only When the CA certificate was created.

endDate

date-time

Read-only The certificate's ISO 8601 formatted expiration date.

fingerprint

string

length ≥ 1

Read-only The fingerprint of the certificate.

issuer

string

length ≥ 1

Read-only The certificate's issuer.

serialNumber

string

length ≥ 1

Read-only The unique serial number of the certificate.

signatureAlgorithm

string

length ≥ 1

Read-only The signature algorithm of the CA certificate.

startDate

date-time

Read-only The start date of the certificate.

subject

string

length ≥ 1

Read-only The certificate's subject field.

comments

string | null

Any additional comments you can provide while creating or updating the CA set version.

createdBy

string | null

Read-only The user who created the CA set version.

createdDate

date-time | null

Read-only When the CA set version was created.

modifiedBy

string | null

Read-only The user who last modified the CA set version.

modifiedDate

date-time | null

Read-only When the CA set version was last modified.

productionStatus

string | null

Read-only The CA set version's status on the production network, either ACTIVE or INACTIVE.

ACTIVE INACTIVE

stagingStatus

string | null

Read-only The CA set version's status on the staging network, either ACTIVE or INACTIVE.

ACTIVE INACTIVE

validationResults

object | null

Read-only Validation results that display any errors, warnings, or notices.

errors

array of objects

required

length ≥ 0

Read-only Any kind of validation errors you need to fix for the request to succeed. For example, creating or updating a CA set version with expired or malformed certificates.

errors*

object

detail

string

length ≥ 1

Read-only Explains the problem with any guidance on how to fix it.

errors

array of objects

length ≥ 1

Read-only The problem type errors.

errors

object

instance

string

length ≥ 1

Read-only Non-navigable URI that identifies each occurrence of the problem.

status

integer

≥ 1

Read-only The HTTP status code.

title

string

length ≥ 1

Read-only Human readable summary of each error case.

type

string

required

length ≥ 1

Read-only Non-navigable URI that identifies each error case.

notices

array of objects

required

length ≥ 0

Read-only Any kind of validation notices only to make you aware. No corrective action required.

notices*

object

detail

string

length ≥ 1

Read-only Explains the problem with any guidance on how to fix it.

errors

array of objects

length ≥ 1

Read-only The problem type errors.

errors

object

instance

string

length ≥ 1

Read-only Non-navigable URI that identifies each occurrence of the problem.

status

integer

≥ 1

Read-only The HTTP status code.

title

string

length ≥ 1

Read-only Human readable summary of each error case.

type

string

required

length ≥ 1

Read-only Non-navigable URI that identifies each error case.

warnings

array of objects

required

length ≥ 0

Read-only Any kind of validation warnings where you can fix the request. For example, creating or updating CA set version with duplicated certificates.

warnings*

object

detail

string

length ≥ 1

Read-only Explains the problem with any guidance on how to fix it.

errors

array of objects

length ≥ 1

Read-only The problem type errors.

errors

object

instance

string

length ≥ 1

Read-only Non-navigable URI that identifies each occurrence of the problem.

status

integer

≥ 1

Read-only The HTTP status code.

title

string

length ≥ 1

Read-only Human readable summary of each error case.

type

string

required

length ≥ 1

Read-only Non-navigable URI that identifies each error case.

versionId

integer | null

≥ 1

Read-only Uniquely identifies the CA set version.

versionLink

string | null

Read-only Hypermedia link to the CA set version.

versionNumber

integer | null

≥ 1

Read-only The CA set's incremental version number.

`Content-Type` header.

Language

URL


xxxxxxxxxx
1
curl --request PUT \
2
     --url https://hostname/mtls-edge-truststore/v1/ca-sets/caSetId/versions/versionId \
3
     --header 'accept: application/vnd.akamai.mtls-edge-truststore.ca-set-version.v1+json' \
4
     --header 'content-type: application/vnd.akamai.mtls-edge-truststore.ca-set-version.v1+json'

Click Try It! to start a request and see the response here! Or choose an example:

application/vnd.akamai.mtls-edge-truststore.ca-set-version.v1+json

application/problem+json

200Reflects the updated CA set version.

400Bad request due to certificates that don't validate.

401Unauthorized.

403Forbidden.

404Not found.

409Conflict.

415Unsupported media type. Wrong Content-Type header.

422Unprocessable content.

429Too Many Requests.

500Internal server error.

503Service Unavailable.

`Content-Type` header.