Skip to main content

IPA-118: Extensible by Default

Signaling to clients any intentions for future extensibility and designing APIs conservatively reduces the potential of unintended impact.

State

Adopt

Guidance​

  • API specs must not set additionalProperties to false to flag to clients that additional fields may be added
  • Request parameter data constraints should be specific and restrictive to provide freedom for extensions
  • API producers should default to multi-cloud support when implementing features

Further reading​