Versioning

Every version. Every environment. Full control.

Manage the entire API lifecycle from draft to retirement. Stay on top of versions, environments, and breaking changes — all in one place.

api-portal.io/versions
Version Timeline Payment API
v2.0-beta 3 Tage
Draft
v1.1 2 Wochen
Active
v1.0 6 Monate
Active
v0.9 1 Jahr
Deprecated
0
unplanned breaking changes
100%
audit trail
4
environments
SemVer
semantic versioning

// Versioning

What Versioning delivers

Version Lifecycle

Draft → Active → Deprecated → Retired — clear status for every API version with defined transitions.

Environment Management

DEV, TEST, STAGING, PROD — separate deployments per environment with full traceability.

Changelog & History

Complete revision history and automatic changelogs — every change documented and traceable.

// Lifecycle Management

Clear lifecycle for every API version

From draft to retirement — define clear phases for every API version. The portal ensures consumers are notified about changes in time and no version stays in an unclear state.

  • Automatic notification on deprecation
  • Sunset date and migration guidance
  • Semantic versioning (SemVer) as default
v1.0 Released

Initiales Release — stabile API

v1.1 Released

Minor Update — neue Endpunkte

v2.0-beta Beta

Breaking Changes — Testphase

v1.0 Deprecated

Sunset in 90 Tagen — Migration empfohlen

api-portal.io/environments
API DEV TEST STAGING PROD
Payment API v3.1 v3.1 v3.0 v2.9
User Service v2.0 v2.0 v1.9 v1.8
Event Stream v1.2 v1.1 v1.0
Deployed
Pending

// Environment Tracking

Cross-environment deployment tracking

Which version runs where? The API Portal shows you at a glance which API version is deployed in which environment. No more back-and-forth — everything transparent in a single matrix.

  • DEV, TEST, STAGING, PROD at a glance
  • Real-time deployment status
  • Promotion workflows between environments
“Since we started using the API Portal, we haven't shipped a single unplanned breaking change. Version management gives us the control we need — across all environments.”
0 unplanned breaking changes

// More Features

Explore related features.

Ready for controlled API releases?

Get started with the API Portal and stay on top of every version, every environment, and every change.