Update Certificate

Overview

Updates an existing certificate. The certificate name cannot be changed. Certificate is automatically deployed to all specified environments after update.

Endpoint

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

Authentication

Requires a Personal API Access Token.

Authorization: Bearer YOUR_TOKEN

Request

Headers

Header Value Required
Authorization Bearer {token} Yes
Content-Type multipart/form-data Yes

Path Parameters

Parameter Type Required Description
projectName string Yes Project name
certificateName string Yes Certificate name (cannot be changed)

Form Data

Same as Create Certificate. See Create Certificate for field descriptions.

Query Parameters

Parameter Type Required Description
updateReferencedJwks boolean No Whether to update referenced JWKs (default: false)
updateScope string No Scope for updating JWKs: SAME_PROJECT or ALL_PROJECTS (required if updateReferencedJwks is true)

Notes

  • Certificate name in path must match existing certificate
  • All form fields are required
  • Old certificate is deleted and new one is created
  • Certificate is automatically deployed after update
  • If updateReferencedJwks=true, JWKs created from this certificate will be updated
  • updateScope determines which JWKs to update: SAME_PROJECT or ALL_PROJECTS

Response

Same as Create Certificate. See Create Certificate for response format.

cURL Example

Example 1: Update Certificate

curl -X PUT \
  "https://demo.apinizer.com/apiops/projects/MyProject/certificates/my-certificate/" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "alias=updated-cert-alias" \
  -F "certificateDescription=Updated SSL certificate" \
  -F "environmentList=production,staging" \
  -F "pemEncodedFile=@updated-certificate.pem"

Example 2: Update Certificate with JWK Updates

curl -X PUT \
  "https://demo.apinizer.com/apiops/projects/MyProject/certificates/my-certificate/?updateReferencedJwks=true&updateScope=SAME_PROJECT" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "alias=updated-cert-alias" \
  -F "certificateDescription=Updated SSL certificate" \
  -F "environmentList=production,staging" \
  -F "pemEncodedFile=@updated-certificate.pem"

Notes and Warnings

  • Certificate Name:
    • Cannot be changed (specified in path)
    • Must match existing certificate
  • Replacement:
    • Old certificate is deleted and new one is created
    • This ensures clean update across all environments
  • All Fields Required:
    • All form fields must be provided
    • Same requirements as create
  • Referenced JWKs:
    • If updateReferencedJwks=true, JWKs created from this certificate will be updated
    • updateScope determines which JWKs to update: SAME_PROJECT or ALL_PROJECTS
    • This ensures JWKs stay in sync with certificate updates