Sign in
Event Processing Policy

Replace chain rules

Replace the rules of a chain (including the main chain, ID 0) with the supplied ordered list. Other chains are not affected. If version is present in the request body it must match the current chain version, otherwise the request is rejected with status 409 and the body contains the current currentVersion. If version is omitted the chain is replaced unconditionally.

Each rule may be supplied either in the form produced by this API (object IDs, event codes, and called chain IDs as plain integers) or as a configuration export record (object/event references as objects carrying name and GUID, called chains as GUIDs); the latter form is resolved on import and any references that cannot be resolved are dropped, with details returned in the optional warnings field.

put/v1/event-processing-policy/chains/{chain-id}/rules

Path parameters

chain-idinteger required

Chain ID (0 = main chain)

Request body

versioninteger

Expected current chain version. If present, the update is applied only if it matches the server-side version, otherwise the request is rejected with status 409. If omitted, the chain is replaced unconditionally.

Response

Chain rules updated successfully

chainIdinteger

ID of the updated chain (0 = main chain)

versioninteger

New chain version

ruleCountinteger

Number of rules now in the chain

warningsstring

Human-readable text describing any issues encountered while applying the rules (e.g. references to objects or chains that no longer exist). Present only if there were warnings.

Changes