---
title: "Delete event processing policy chain"
method: DELETE
path: "/v1/event-processing-policy/chains/{chain-id}"
tags: ["Event Processing Policy"]
---

# Delete event processing policy chain

`DELETE /v1/event-processing-policy/chains/{chain-id}`

Delete a chain together with all its rules. Calls to the deleted chain are removed from rules
in every other chain; each chain that lost a call gets a new version, reported in
`updatedChains`. Use `GET /v1/event-processing-policy/chains/{chain-id}/callers` beforehand to
see which rules are affected. The main chain (ID 0) cannot be deleted.

## Path parameters

- `chain-id` integer, required

## Response `200`

Chain deleted successfully

- object
  - `updatedChains` object[] — Chains whose rules lost a call to the deleted chain, with their new versions
    - `chainId` integer — Chain ID (0 = main chain)
    - `version` integer — New chain version

## Other responses

- `400` — Chain ID is not a number
- `401` — Unauthorized
- `403` — User does not have the global EPP right (required to delete chains)
- `404` — Chain not found
- `405` — Main chain cannot be deleted
- `500` — Database failure

## Changes

- **2026-09-08** `4fd66f32833f` — 1 info
  - endpoint added
- **2026-09-08** `c2492179ed18` — 1 breaking
  - api path removed without deprecation
- **2026-09-07** `3aeada4e28f8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/event-processing-policy/chains/:chain-id/delete.md)

---

[API](https://skmtc.dev/netxms/apis/netxms-api.md) · [All operations](https://skmtc.dev/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/netxms/apis/netxms-api/revisions/6eac6acac8bf?raw)