---
title: "Changes to Create or replace an action policy"
method: PUT
path: "/api/alerting/v2/action_policies/{id}"
---

# Changes to Create or replace an action policy

`PUT /api/alerting/v2/action_policies/{id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 106 revisions.

- **2026-08-26** `741b22a9a4e1` — 1 breaking, 1 warning
- **2026-08-17** `e9badbb5da99` — 1 info

## Changes

- **2026-08-26** `741b22a9a4e1` — 1 breaking, 1 warning
  - for the `path` request parameter `id`, the minLength was increased from `0` to `1`
  - for the `path` request parameter `id`, the maxLength was set to `150`
- **2026-08-17** `e9badbb5da99` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/elastic/apis/kibana-apis/docs/api/alerting/v2/action_policies/:id/put.md) · [API](https://skmtc.dev/elastic/apis/kibana-apis.md) · [Page](https://skmtc.dev/elastic/apis/kibana-apis/changes/api/alerting/v2/action_policies/:id/put)