Deploy a certificate

This starts the deployment of a certificate to the points of presence used by the applications and IdPs that use it. The deployment is asynchronous, and a successful response means the deployment was queued. To track its progress, run the List certificate summaries and check the certificate's deploy_status.

Your tenant needs the DecoupleCertAppFeatureKey setting enabled. Otherwise, the operation responds with a 403 error.

The operation responds with a 400 error if the certificate expires within the pre-check window, which is 15 days by default, or if it has already expired. For a certificate that an application or IdP uses, it also returns a 400 error if the certificate's common name or subject alternative names don't match the hostname of an associated application or IdP, or if the certificate has no private key. The error response doesn't identify the cause.

If no application or IdP uses the certificate, the operation skips the hostname and private key checks and still responds successfully with 200, but nothing deploys and deploy_status stays empty.

Path Params
string
required

A unique identifier for the certificate.

Query Params
string
required

The Akamai contract identifier for your Enterprise Application Access product.

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.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
URL
LoadingLoading…
Response
Choose an example:
application/json
application/problem+json