---
title: "Versionierung & Preview"
description: "Wie die Bodo API versioniert: /v1 im Pfad, eine Datumsversion im Header, ein Preview-Kanal je Request. Was als Bruch gilt, wie lange eine abgelöste Version läuft und wie eine Abkündigung aussieht."
lang: de
url: https://developers.bodo-app.com/guides/versioning/
apiVersion: 2026-11-01
---

# Versionierung & Preview

Wie die Bodo API versioniert: /v1 im Pfad, eine Datumsversion im Header, ein Preview-Kanal je Request. Was als Bruch gilt, wie lange eine abgelöste Version läuft und wie eine Abkündigung aussieht.

- **/v1**: Die Klammer im Pfad. `v2` gibt es nur bei einem Paradigmenbruch.
- **Bodo-Version: 2026-11-01**: Datumsversion im Header. Ohne Header gilt der Pin des Schlüssels, jede Antwort nennt die angewandte Version.
- **Bodo-Preview: true**: Ein beweglicher Kanal für neue Operationen. Brüche sind dort erlaubt und stehen im Changelog. Keine Produktionsgrundlage, nicht pinnbar.

## Lebenslauf der Versionen

Gezeichnet aus der Versions-Registry der API. Eine abgelöste Version läuft ab Erscheinen ihrer Nachfolgerin noch 12 Monate, Brownouts liegen in den letzten 6 Wochen davor.

**Lebenslauf der API-Versionen**

- `2026-11-01`: erscheint 01.11.2026 · läuft, keine Nachfolgerin; Supportende erst 12 Monate nach Erscheinen einer Nachfolgerin

[openapi.2026-11-01.json herunterladen](/openapi/openapi.2026-11-01.json)

## Welche Version gilt für meinen Aufruf?

| Reihenfolge | Quelle | Beispiel |
| --- | --- | --- |
| 1 | Header im Request | Bodo-Version: 2026-11-01 |
| 2 | Pin des Schlüssels (beim Anlegen die aktuelle Stable) | versionPin: 2026-11-01 |
| – | Org-Default gibt es nicht | bewusst, damit kein versteckter Zustand entsteht |

## Bruch nur mit neuer Version

- Feld oder Operation entfernt oder umbenannt
- Typwechsel eines Felds
- neues Pflichtfeld im Request, engere Validierung
- geänderter Default, entfernter Enum-Wert
- geänderter `code`, geänderte Semantik

## Kein Bruch: sofort live, im Changelog

- neues optionales Feld im Request
- neues Feld in der Antwort
- neuer Enum-Wert in der Antwort (`x-extensible-enum`)
- neue Operation
- neuer `code` für eine neue Bedingung

## Tolerant Reader

Unbekannte Felder und Enum-Werte ignorieren, nie darauf scheitern.

Bruchversionen: höchstens 2 pro Jahr · Supportfenster: 12 Monate

[So sieht eine Abkündigung aus](/guides/migrate-2027-05-01/)