Update a CertOps agent's downtime alert settings
PATCH/api/v1/workspaces/:id/certops/agents/:agentId/alert-settings
Edits downtimeAlertsEnabled, contactGroupId, and/or contactGroupIds for an already registered agent. Fields are independently optional: omit a field to leave it unchanged. contactGroupIds wins over contactGroupId when both are sent. Send contactGroupIds: [] or contactGroupId: null to clear back to the workspace default. 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