---
title: Versioni dell'API
url: https://platform.claude.com/docs/it/api/versioning
description: "Quando effettui richieste API, devi inviare un header di richiesta `anthropic-version`. Ad esempio, `anthropic-version: 2026-10-21`. Se stai utilizzando l'[SDK client](https://platform.claude.com/docs/it/cli-sdks-libraries/overview), imposta questo header per te."
---

Per qualsiasi versione dell’API, Anthropic preserva:

* I parametri di input esistenti
* I parametri di output esistenti

Tuttavia, Anthropic può fare quanto segue:

* Aggiungere ulteriori input opzionali
* Aggiungere ulteriori valori all’output
* Modificare le condizioni per specifici tipi di errore
* Aggiungere nuove varianti ai valori di output di tipo enum (ad esempio, i tipi di eventi di streaming)

In generale, se stai utilizzando l’API come documentato in questo riferimento, Anthropic non comprometterà il tuo utilizzo.

## Cronologia delle versioni

Anthropic consiglia di utilizzare la versione più recente dell’API ogni volta che è possibile.

* `2026-10-21`

  * [Migrazione alla versione API 2026-10-21](https://platform.claude.com/docs/it/api/migration-2026-10-21) mostra come effettuare l’aggiornamento.

  * Disponibile sulla Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/it/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/it/build-with-claude/claude-models-on-google-cloud/anthropic-managed), [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/it/build-with-claude/claude-models-on-google-cloud/google-managed) e [Microsoft Foundry](https://platform.claude.com/docs/it/build-with-claude/claude-in-microsoft-foundry). Su Amazon Bedrock, è disponibile per Claude 4.7 e i modelli successivi. Per i modelli Claude precedenti su Bedrock, [mantieni la versione API che usi oggi](https://platform.claude.com/docs/it/api/migration-2026-10-21#availability).

  * Messages API:

    * Una richiesta che inserisce un blocco `document` direttamente in un messaggio `assistant` restituisce un errore 400.
    * L’invio di un blocco `text` con un array `citations` non vuoto in un messaggio `user`, direttamente o all’interno di un blocco `search_result`, restituisce un errore 400.
    * I parametri di richiesta `temperature`, `top_p` e `top_k` sono stati rimossi. Una richiesta che invia uno qualsiasi di essi restituisce un errore 400 su ogni modello.

  * Admin API:

    * I [gruppi RBAC](https://platform.claude.com/docs/it/api/beta/organization/rbac_groups/list) non restituiscono più `roles`. Usa invece `role_ids`.
    * I [membri dei gruppi RBAC](https://platform.claude.com/docs/it/api/beta/organization/rbac_groups/members/list), e la risposta alla rimozione di uno di essi, non restituiscono più `group_id`. Usa invece `rbac_group_id`.
    * I [ruoli RBAC](https://platform.claude.com/docs/it/api/beta/organization/rbac_roles/list) non restituiscono più `name`. Usa invece `display_name`.
    * Le voci dei “rate limit” (limiti di velocità) dell’[organizzazione](https://platform.claude.com/docs/it/api/organization/rate_limits/list) e del [workspace](https://platform.claude.com/docs/it/api/organization/workspaces/rate_limits/list), e la risposta all’[impostazione dei limiti di velocità di un workspace](https://platform.claude.com/docs/it/api/organization/workspaces/rate_limits/update), non restituiscono più `group_type`. Usa invece `group.type`.
    * Le [chiavi API](https://platform.claude.com/docs/it/api/organization/api_keys/list) non restituiscono più `workspace_id`. Usa invece `scope.workspace_id`. Contiene l’ID del workspace della chiave, incluso il workspace predefinito. Una chiave valida per tutti i workspace non ha `scope.workspace_id`.

  * Claude Enterprise Analytics API:

    * I report per utente di [utilizzo](https://platform.claude.com/docs/it/api/beta/organization/analytics/user_usage_report/list) e di [costo](https://platform.claude.com/docs/it/api/beta/organization/analytics/user_cost_report/list) non contengono più `actor.email`. Usa invece `actor.email_address`.
    * La risposta dei [riepiloghi delle attività](https://platform.claude.com/docs/it/api/beta/organization/analytics/summaries/list) non contiene più `summaries`. Usa invece `data`.

* `2023-06-01`

  * Nuovo formato per i “server-sent events” (eventi inviati dal server), o SSE, in [streaming](https://platform.claude.com/docs/it/build-with-claude/streaming):

    * I completamenti sono incrementali. Ad esempio, `" Hello"`, `" my"`, `" name"`, `" is"`, `" Claude." `invece di `" Hello"`, `" Hello my"`, `" Hello my name"`, `" Hello my name is"`, `" Hello my name is Claude."`.
    * Tutti gli eventi sono [eventi con nome](https://developer.mozilla.org/en-US/Web/API/Server-sent%5Fevents/Using%5Fserver-sent%5Fevents#named%5Fevents), anziché [eventi di soli dati](https://developer.mozilla.org/en-US/Web/API/Server-sent%5Fevents/Using%5Fserver-sent%5Fevents#data-only%5Fmessages).
    * Rimosso l’evento `data: [DONE]` non necessario.

  * Rimossi i valori legacy `exception` e `truncated` nelle risposte.

* `2023-01-01`: Rilascio iniziale.
