Delete Certificate

Endpoint

DELETE /apiops/projects/{projectName}/certificates/{certificateName}/

Authentication

Requires a Personal API Access Token.

Header

Authorization: Bearer YOUR_TOKEN

Request

Headers

Header	Value	Required
Authorization	Bearer {token}	Yes

Path Parameters

Parameter	Type	Required	Description
projectName	string	Yes	Project name
certificateName	string	Yes	Certificate name

Query Parameters

Parameter	Type	Required	Description
jwkDeleteAction	string	No	Action to take on referenced JWKs: NULLIFY (clear references) or DELETE (delete JWKs completely). Defaults to NULLIFY if not provided.

Request Body

None.

Response

Success Response (200 OK)

{
  "success": true,
  "deploymentResult": {
    "success": true,
    "message": "Undeployment completed successfully",
    "environmentResults": [
      {
        "environmentName": "production",
        "success": true,
        "message": "Undeployed successfully"
      }
    ]
  }
}

Error Response (400 Bad Request)

{
  "error": "bad_request",
  "error_description": "Certificate (name: my-certificate) is not found!"
}

cURL Example

Example 1: Delete Certificate (Default: Clear JWK References)

curl -X DELETE \
  "https://demo.apinizer.com/apiops/projects/MyProject/certificates/my-certificate/" \
  -H "Authorization: Bearer YOUR_TOKEN"

Example 2: Delete Certificate and Clear JWK References

curl -X DELETE \
  "https://demo.apinizer.com/apiops/projects/MyProject/certificates/my-certificate/?jwkDeleteAction=NULLIFY" \
  -H "Authorization: Bearer YOUR_TOKEN"

Example 3: Delete Certificate and Delete Related JWKs

curl -X DELETE \
  "https://demo.apinizer.com/apiops/projects/MyProject/certificates/my-certificate/?jwkDeleteAction=DELETE" \
  -H "Authorization: Bearer YOUR_TOKEN"

Permissions

User must have SECRETS + MANAGE permission in the project. For undeployment operations (when undeploying certificates from environments), user must also have SECRETS + DEPLOY_UNDEPLOY permission.

Notes and Warnings

• Permanent Deletion:

  • Certificate is permanently deleted
  • This action cannot be undone

• Automatic Undeployment:

  • Certificate is automatically undeployed from all environments
  • Undeployment results are returned in the response

• Referenced JWKs:

  • If jwkDeleteAction=NULLIFY or not provided (default), JWK references will be cleared
  • If jwkDeleteAction=DELETE, all JWKs created from this certificate will be permanently deleted
  • Default behavior (NULLIFY) preserves JWKs but removes their reference to the deleted certificate

Related Documentation

• List Certificates - List all certificates
• Create Certificate - Create a new certificate