Skip to main content

Enable or disable alert policy

POST 
/api/v1/orgs/{orgId}/alert-policies/{alertPolicyId}:{action}

Execute an enable or disable action on the alert policy. Policies are created disabled and must be enabled before they evaluate attached data streams. Enabling publishes the policy's current definition for evaluation; disabling withdraws it (attached data streams stop being evaluated for this policy, but existing fired alert events are left untouched).

Parameters

  • alertPolicyId (UUID, required): Alert policy identifier.
  • action (enum, required, path segment after :): Lifecycle action. Valid values: enable, disable.

Responses

  • 204 No Content: Alert policy status updated successfully.
  • 404 Not Found: Alert policy not found in this org.
  • 400 Bad Request: action is not one of enable/disable.

Request​

Responses​

No Content