Skip to main content
API Explorer|API Explorer
Monitoring & Collection/Auto Remediation
PUTMonitoringSince 1.0SynchronousAuth Required

UpdateRemediationPolicy

Update an existing remediation policy's conditions, action, or cooldown settings

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Path Parameters

Request Inputs

Path Parameters

  • policyIdStringRequired

    UUID of the policy to update

Body Fields

  • nameStringRequired

    Updated display name

    Example: High CPU Auto-Restart v2

  • enabledBooleanRequired

    Whether the policy should be enabled

    Example: true

  • agentSelectorLinkedHashMapRequired

    Label selector to match target agents

    Example: (nested object)

  • conditionOpStringRequired

    Updated condition combinator

    Example: AND

  • conditionsListRequired

    Conditions for this resource

    Example: (nested array)

    • metricNameString

      Name of the metric to evaluate as a condition

      Example: cpu_usage_percent

    • operatorString

      Comparison operator (e.g. >, =, <=, ==)

      Example: >

    • thresholdLong

      Threshold value for the condition

      Example: 90

Responses

200 OK

On success, this API returns the following response structure.

  • idString

    Unique identifier of the remediation policy

    Example: policy-001-abc

  • nameString

    Display name of the remediation policy

    Example: High CPU Auto-Restart

  • enabledBoolean

    Whether this policy is currently active

    Example: true

  • agentSelectorLinkedHashMap

    Label selector to match target agents

    Example: (nested object)

  • conditionOpString

    Logical operator combining multiple conditions (AND, OR)

    Example: AND

  • conditionsList

    Conditions for this resource

    Example: (nested array)

    • metricNameString

      Name of the metric to evaluate as a condition

      Example: cpu_usage_percent

    • operatorString

      Comparison operator (e.g. >, =, <=, ==)

      Example: >

    • thresholdLong

      Threshold value for the condition

      Example: 90

  • actionString

    Remediation action to execute when conditions are met

    Example: restart_service

  • actionParamsLinkedHashMap

    Parameters passed to the remediation action

    Example: (nested object)

  • cooldownSecInteger

    Cooldown period in seconds before this policy can trigger again

    Example: 300

  • verifyAfterSecInteger

    Delay in seconds after action execution before verifying success

    Example: 60

  • maxRetriesInteger

    Maximum number of retry attempts on failure

    Example: 3

  • createdAtString

    Created at

    Example: 2026-01-15T08:00:00Z

Endpoint

PUT/api/v1/monitoring/remediation-policies/{policyId}

/api/v1/monitoring/remediation-policies/{policyId}

Operation ID

UpdateRemediationPolicy

Permalink

Request Example

curl -X PUT '{host}/api/v1/monitoring/remediation-policies/{policyId}' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"name":"High CPU Auto-Restart v2","enabled":true,"agentSelector":"(nested object)","conditionOp":"AND","conditions":"(nested array)","action":"restart_service","actionParams":"(nested object)","cooldownSec":600,"verifyAfterSec":60,"maxRetries":5}'

Response Example

200
{
  "id": "policy-001-abc",
  "name": "High CPU Auto-Restart",
  "enabled": true,
  "agentSelector": null,
  "conditionOp": "AND",
  "conditions": [
    {}
  ],
  "action": "restart_service",
  "actionParams": null
}

Change History

This API has no change history records yet.

View all change history