Retire a managed certificate
POST/api/v1/workspaces/:id/certops/certificates/:certId/retire
Soft-retires a managed certificate by moving public lifecycle status to revoked or decommissioned. The managed certificate, linked token, and instance history are preserved; request bodies containing private key material are rejected before feature gating.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 422
- 500
Managed certificate retired
Invalid retire request
Unauthorized
Authenticated user lacks the workspace manager/admin role required for CertOps writes
CertOps is disabled or the certificate was not found in this workspace
Request rejected because it contained private key material
Internal server error