Skip to content

Decomposition

API decomposition, or bifurcation, refers to splitting a single API into two or more standalone APIs, each of which constitutes a new API. As such, they must have unique namespaces and start their versions from zero (v0).

Requirement

  • Each child API extracted from a parent API must have a unique namespace.
  • Child APIs must start their version at v0.

Guidance

  • API teams should deprecate parent APIs once they've released all the child APIs.
  • API teams should document the split and how to migrate to the new APIs in the parent API's documentation.

The API you are decomposing will adhere to the version deprecation guidance.