Claude Platform Docs
API-ReferenzSupport & Konfiguration

API-Versionen

Bei API-Anfragen musst du einen anthropic-version-Request-Header senden. Zum Beispiel anthropic-version: 2026-10-21. Wenn du das Client-SDK 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 zeigt, wie du upgradest.
    • Verfügbar in der Claude API, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), Claude Models on Google Cloud (Google managed) und 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.
    • 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-GruppenVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. geben kein roles mehr zurück. Verwende stattdessen role_ids.
      • RBAC-GruppenmitgliederVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. und die Antwort auf das Entfernen eines Mitglieds geben kein group_id mehr zurück. Verwende stattdessen rbac_group_id.
      • RBAC-RollenVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. geben kein name mehr zurück. Verwende stattdessen display_name.
      • Einträge für „rate limits“ (Ratenlimits) auf Organisations-Vorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. und Workspace-EbeneVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. sowie die Antwort auf das Festlegen der Ratenlimits eines WorkspaceVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. geben kein group_type mehr zurück. Verwende stattdessen group.type.
      • API-KeysVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. 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 NutzungVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. und KostenVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. enthalten kein actor.email mehr. Verwende stattdessen actor.email_address.
      • Die Antwort der AktivitätszusammenfassungenVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. enthält kein summaries mehr. Verwende stattdessen data.
  • 2023-06-01
    • Neues Format für 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 statt reiner Daten-Events.
      • Unnötiges data: [DONE]-Event entfernt.
    • Veraltete exception- und truncated-Werte in Antworten entfernt.
  • 2023-01-01: Erstveröffentlichung.

War diese Seite hilfreich?