Skip to main content
ZStack
Monitoring & Collection/Auto Remediation

UpdateRemediationPolicy

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

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

Operation ID

UpdateRemediationPolicy

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

application/json

Path Parameters

  • policyId
    StringRequired

    UUID of the policy to update

Body Fields

  • name
    StringRequired

    Updated display name

    Example: High CPU Auto-Restart v2

  • enabled
    BooleanRequired

    Whether the policy should be enabled

    Example: true

  • agentSelector
    LinkedHashMapRequired

    Label selector to match target agents

    Example: (nested object)

  • conditionOp
    StringRequired

    Updated condition combinator

    Example: AND

  • conditions
    ListRequired

    Conditions for this resource

    Example: (nested array)

    • metricName
      String

      Name of the metric to evaluate as a condition

      Example: cpu_usage_percent

    • operator
      String

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

      Example: >

    • threshold
      Long

      Threshold value for the condition

      Example: 90

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • id
    String

    Unique identifier of the remediation policy

    Example: policy-001-abc

  • name
    String

    Display name of the remediation policy

    Example: High CPU Auto-Restart

  • enabled
    Boolean

    Whether this policy is currently active

    Example: true

  • agentSelector
    LinkedHashMap

    Label selector to match target agents

    Example: (nested object)

  • conditionOp
    String

    Logical operator combining multiple conditions (AND, OR)

    Example: AND

  • conditions
    List

    Conditions for this resource

    Example: (nested array)

    • metricName
      String

      Name of the metric to evaluate as a condition

      Example: cpu_usage_percent

    • operator
      String

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

      Example: >

    • threshold
      Long

      Threshold value for the condition

      Example: 90

  • action
    String

    Remediation action to execute when conditions are met

    Example: restart_service

  • actionParams
    LinkedHashMap

    Parameters passed to the remediation action

    Example: (nested object)

  • cooldownSec
    Integer

    Cooldown period in seconds before this policy can trigger again

    Example: 300

  • verifyAfterSec
    Integer

    Delay in seconds after action execution before verifying success

    Example: 60

  • maxRetries
    Integer

    Maximum number of retry attempts on failure

    Example: 3

  • createdAt
    String

    Created at

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