Update a CertOps agent's downtime alert settings
PATCH/api/v1/workspaces/:id/certops/agents/:agentId/alert-settings
Edits downtimeAlertsEnabled and/or contactGroupId for an already registered agent. Both fields are independently optional: omit a field to leave it unchanged, or send contactGroupId: null to explicitly clear it back to "use the workspace default contact group". At least one field is required. Recorded as a CERTOPS_AGENT_ALERT_SETTINGS_UPDATED audit event.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 422
- 500
Agent alert settings updated
Request body was empty or contactGroupId does not exist in this workspace
Unauthorized
Forbidden
CertOps is disabled or the agent was not found in this workspace
Request rejected because it contained private key material
Internal server error