Skip to main content

Update a renewal profile

PATCH 
/api/v1/workspaces/:id/certops/profiles/:profileId

Changes renewal configuration for a profile. Requires the workspace admin role (certops.renewal_profile.manage) because the stored profile determines what a host-privileged agent executes at the next renewal.

Only the fields listed in the profile's editableFields may be changed. The fields that decide WHERE a certificate is written and WHAT command writes it (target, deploymentTargets, acme, ca, dns) are immutable after issuance and are rejected with CERTOPS_PROFILE_FIELD_IMMUTABLE; repointing a deployment is a new issuance, not an edit.

Set autoRenewEnabled to false to stop automatic renewal for every certificate linked to this profile. The certificate then expires unless it is renewed manually. Every accepted change writes an audit event in the same transaction as the update.

Request​

Responses​

Updated renewal profile