---
title: API-Versionen
url: https://platform.claude.com/docs/de/api/versioning
description: "Bei API-Anfragen musst du einen `anthropic-version`-Request-Header senden. Zum Beispiel `anthropic-version: 2026-10-21`. Wenn du das [Client-SDK](https://platform.claude.com/docs/de/cli-sdks-libraries/overview) verwendest, setzt es diesen Header für dich."
---

Für jede gegebene API-Version bewahrt Anthropic:

* Bestehende Eingabeparameter
* Bestehende Ausgabeparameter

Anthropic kann jedoch Folgendes tun:

* Zusätzliche optionale Eingaben hinzufügen
* Zusätzliche Werte zur Ausgabe hinzufügen
* Bedingungen für bestimmte Fehlertypen ändern
* Neue Varianten zu Enum-ähnlichen Ausgabewerten hinzufügen (zum Beispiel Streaming-Event-Typen)

Im Allgemeinen gilt: Wenn du die API so verwendest, wie sie in dieser Referenz dokumentiert ist, wird Anthropic deine Nutzung nicht beeinträchtigen.

## Versionsverlauf

Anthropic empfiehlt, wann immer möglich die neueste API-Version zu verwenden.

* `2026-10-21`

  * [Migration zu API-Version 2026-10-21](https://platform.claude.com/docs/de/api/migration-2026-10-21) zeigt, wie du upgradest.

  * Verfügbar in der Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/de/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/de/build-with-claude/claude-models-on-google-cloud/anthropic-managed), [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/de/build-with-claude/claude-models-on-google-cloud/google-managed) und [Microsoft Foundry](https://platform.claude.com/docs/de/build-with-claude/claude-in-microsoft-foundry). Auf Amazon Bedrock ist sie für Claude 4.7 und neuere Modelle verfügbar. Für frühere Claude-Modelle auf Bedrock [behältst du die API-Version bei, die du heute verwendest](https://platform.claude.com/docs/de/api/migration-2026-10-21#availability).

  * Messages API:

    * Eine Anfrage, die einen `document`-Block direkt in einer `assistant`-Nachricht platziert, gibt einen 400-Fehler zurück.
    * Das Senden eines `text`-Blocks mit einem nicht leeren `citations`-Array in einer `user`-Nachricht, direkt oder innerhalb eines `search_result`-Blocks, gibt einen 400-Fehler zurück.
    * Die Request-Parameter `temperature`, `top_p` und `top_k` wurden entfernt. Eine Anfrage, die einen davon sendet, gibt bei jedem Modell einen 400-Fehler zurück.

  * Admin API:

    * [RBAC-Gruppen](https://platform.claude.com/docs/de/api/beta/organization/rbac_groups/list) geben kein `roles` mehr zurück. Verwende stattdessen `role_ids`.
    * [RBAC-Gruppenmitglieder](https://platform.claude.com/docs/de/api/beta/organization/rbac_groups/members/list) und die Antwort auf das Entfernen eines Mitglieds geben kein `group_id` mehr zurück. Verwende stattdessen `rbac_group_id`.
    * [RBAC-Rollen](https://platform.claude.com/docs/de/api/beta/organization/rbac_roles/list) geben kein `name` mehr zurück. Verwende stattdessen `display_name`.
    * Einträge für „rate limits“ (Ratenlimits) auf [Organisations-](https://platform.claude.com/docs/de/api/organization/rate_limits/list) und [Workspace-Ebene](https://platform.claude.com/docs/de/api/organization/workspaces/rate_limits/list) sowie die Antwort auf [das Festlegen der Ratenlimits eines Workspace](https://platform.claude.com/docs/de/api/organization/workspaces/rate_limits/update) geben kein `group_type` mehr zurück. Verwende stattdessen `group.type`.
    * [API-Keys](https://platform.claude.com/docs/de/api/organization/api_keys/list) geben kein `workspace_id` mehr zurück. Verwende stattdessen `scope.workspace_id`. Es enthält die ID des Workspace des Keys, einschließlich des Standard-Workspace. Ein Key für alle Workspaces hat kein `scope.workspace_id`.

  * Claude Enterprise Analytics API:

    * Die nutzerbezogenen Berichte zu [Nutzung](https://platform.claude.com/docs/de/api/beta/organization/analytics/user_usage_report/list) und [Kosten](https://platform.claude.com/docs/de/api/beta/organization/analytics/user_cost_report/list) enthalten kein `actor.email` mehr. Verwende stattdessen `actor.email_address`.
    * Die Antwort der [Aktivitätszusammenfassungen](https://platform.claude.com/docs/de/api/beta/organization/analytics/summaries/list) enthält kein `summaries` mehr. Verwende stattdessen `data`.

* `2023-06-01`

  * Neues Format für [Streaming](https://platform.claude.com/docs/de/build-with-claude/streaming) von „server-sent events“ (vom Server gesendete Ereignisse), oder SSE:

    * Completions sind inkrementell. Zum Beispiel `" Hello"`, `" my"`, `" name"`, `" is"`, `" Claude." `anstelle von `" Hello"`, `" Hello my"`, `" Hello my name"`, `" Hello my name is"`, `" Hello my name is Claude."`.
    * Alle Events sind [benannte Events](https://developer.mozilla.org/en-US/Web/API/Server-sent%5Fevents/Using%5Fserver-sent%5Fevents#named%5Fevents) statt [reiner Daten-Events](https://developer.mozilla.org/en-US/Web/API/Server-sent%5Fevents/Using%5Fserver-sent%5Fevents#data-only%5Fmessages).
    * Unnötiges `data: [DONE]`-Event entfernt.

  * Veraltete `exception`- und `truncated`-Werte in Antworten entfernt.

* `2023-01-01`: Erstveröffentlichung.
