Update one or more catalog rate modifier rules in parallel. Each item targets an existing rule by id. The
match.type branch (FLOOR / FLOOR_SIZE / ZONE / ORIENTATION) is immutable — repeat it and adjust the
matching branch payload. Optionally change name, adjustment (PERCENTAGE delta or FLAT cash), enabled, or the
effective window. Each update is reported per-rule; partial failures do not abort the rest.
| Parameter |
Type |
Required |
Description |
rateModifiers |
UpdateRateModifierInput[] |
Yes |
Array of rate modifier rules to update - UpdateRateModifierInput |
| Field |
Type |
Required |
Description |
id |
string |
Yes |
The ID of the rate modifier rule to update |
name |
string |
No |
New human-readable name (max 150 characters) |
match |
MatchCriteria |
No |
New match criteria (operator + values). Its type must match the existing rule attribute — the subclass is immutable post-create. - MatchCriteria |
adjustment |
RateAdjustment |
No |
New adjustment. Its type must match the existing rule kind (percentage / flat is immutable post-create). - RateAdjustment |
enabled |
boolean |
No |
Whether the rule is enabled |
effectiveFrom |
string | null |
No |
ISO-8601 start of the effective window. Pass null to clear it. |
effectiveTo |
string | null |
No |
ISO-8601 end of the effective window. Pass null to clear it. |
| Field |
Type |
Required |
Description |
type |
Type |
Yes |
Discriminator selecting the adjustment arm. PERCENTAGE → set percentage; FLAT → set flat. - Type |
percentage |
PercentageAdjustment |
No |
PercentageAdjustment |
flat |
FlatAdjustment |
No |
FlatAdjustment |
| Field |
Type |
Required |
Description |
operator |
OrderedMatchOperator |
Yes |
OrderedMatchOperator |
floors |
number[] |
Yes |
Floor numbers the rule matches against. Scalar operators require exactly one value; IN/NIN require at least one. |
| Field |
Type |
Required |
Description |
operator |
OrderedMatchOperator |
Yes |
OrderedMatchOperator |
floorSizes |
number[] |
Yes |
Floor sizes (in square metres) the rule matches against. Must be non-negative. |
| Field |
Type |
Required |
Description |
operator |
IdentityMatchOperator |
Yes |
IdentityMatchOperator |
zoneIds |
string[] |
Yes |
Zone IDs the rule matches against. All zones must belong to the rule’s building. |
| Field |
Type |
Required |
Description |
operator |
IdentityMatchOperator |
Yes |
IdentityMatchOperator |
orientationIds |
string[] |
Yes |
Orientation IDs the rule matches against. All orientations must belong to the rule’s building. |
| Field |
Type |
Required |
Description |
delta |
number |
Yes |
Multiplicative delta, e.g. 0.1 = +10%. Range -9.9999..9.9999. |
| Field |
Type |
Required |
Description |
amount |
unknown |
Yes |
Signed money object (minor units + ISO 4217 currency). |
| Value |
Description |
FLOOR |
Rule matches against unit floors |
FLOOR_SIZE |
Rule matches against unit floor sizes (in square metres) |
ZONE |
Rule matches against unit zones |
ORIENTATION |
Rule matches against unit orientations |
| Value |
Description |
PERCENTAGE |
Percentage delta applied to the base rate |
FLAT |
Fixed cash amount added to/subtracted from the base rate |
| Value |
Description |
EQ |
Equal to |
NEQ |
Not equal to |
GT |
Greater than |
GTE |
Greater than or equal to |
LT |
Less than |
LTE |
Less than or equal to |
IN |
In the set of values |
NIN |
Not in the set of values |
| Value |
Description |
EQ |
Equal to |
NEQ |
Not equal to |
IN |
In the set of values |
NIN |
Not in the set of values |
| Field |
Type |
Description |
content |
ContentItem[] |
Array of content items returned by the tool - ContentItem |
isError |
boolean |
Whether the tool execution resulted in an error |
| Field |
Type |
Description |
type |
'text' |
Content type (currently only ‘text’ is supported) |
text |
string |
The text content to display |