Skip to content

API versioning ​

Current version:

text
/v1

Breaking changes require a new major version such as /v2.

Examples of breaking changes:

  • removing a response field;
  • changing a field type;
  • changing endpoint semantics;
  • removing an accepted enum value.

Non-breaking additions can remain in /v1, including new optional fields, endpoints, webhook events, and optional parameters.

Cedius is an illustrative API documentation portfolio project.