How should parameterMacro and modelPropertyMacro be used?

[edusummit]

Hi, I’m trying to understand the exact purpose of parameterMacro and modelPropertyMacro.

• What is the correct value I should return if I don’t want to override anything (e.g., should I return parameter.default, parameter.value, or the object itself)?
• Are these macros meant only for simple global overrides, or can they be used in a more contextual way (like per-operation or per-path)?

Any short example of recommended usage would be very helpful. Thanks!

[saky-semicolon]

The parameterMacro and modelPropertyMacro functions are mainly for simple default/ example overrides, not for deep context-aware logic.

• If you don’t want to override anything, just return the original value (e.g., parameter.default for parameters, or the property object for models).
• These macros are global, so you can’t scope them to a single path/operation/property. The function runs for every parameter/property.
• A common pattern is:

'parameterMacro': function (operation, parameter) {
  if (parameter.name === 'year') {
    return 2025
  }
  return parameter.default // fallback to original
}