---
title: Versiones de la API
url: https://platform.claude.com/docs/es/api/versioning
description: "Al realizar solicitudes a la API, debes enviar un encabezado de solicitud `anthropic-version`. Por ejemplo, `anthropic-version: 2026-10-21`. Si estás usando el [SDK de cliente](https://platform.claude.com/docs/es/cli-sdks-libraries/overview), este establece este encabezado por ti."
---

Para cualquier versión dada de la API, Anthropic preserva:

* Los parámetros de entrada existentes
* Los parámetros de salida existentes

Sin embargo, Anthropic puede hacer lo siguiente:

* Agregar entradas opcionales adicionales
* Agregar valores adicionales a la salida
* Cambiar las condiciones para tipos de error específicos
* Agregar nuevas variantes a valores de salida de tipo enum (por ejemplo, tipos de eventos de streaming)

En general, si estás usando la API tal como se documenta en esta referencia, Anthropic no romperá tu uso.

## Historial de versiones

Anthropic recomienda usar la versión más reciente de la API siempre que sea posible.

* `2026-10-21`

  * [Migración a la versión de la API 2026-10-21](https://platform.claude.com/docs/es/api/migration-2026-10-21) muestra cómo actualizar.

  * Disponible en la Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/es/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/es/build-with-claude/claude-models-on-google-cloud/anthropic-managed), [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/es/build-with-claude/claude-models-on-google-cloud/google-managed) y [Microsoft Foundry](https://platform.claude.com/docs/es/build-with-claude/claude-in-microsoft-foundry). En Amazon Bedrock, está disponible para Claude 4.7 y modelos posteriores. Para modelos de Claude anteriores en Bedrock, [mantén la versión de la API que usas hoy](https://platform.claude.com/docs/es/api/migration-2026-10-21#availability).

  * Messages API:

    * Una solicitud que coloca un bloque `document` directamente en un mensaje `assistant` devuelve un error 400.
    * Enviar un bloque `text` con un arreglo `citations` no vacío en un mensaje `user`, directamente o dentro de un bloque `search_result`, devuelve un error 400.
    * Se eliminan los parámetros de solicitud `temperature`, `top_p` y `top_k`. Una solicitud que envíe cualquiera de ellos devuelve un error 400 en todos los modelos.

  * Admin API:

    * Los [grupos RBAC](https://platform.claude.com/docs/es/api/beta/organization/rbac_groups/list) ya no devuelven `roles`. Usa `role_ids` en su lugar.
    * Los [miembros de grupos RBAC](https://platform.claude.com/docs/es/api/beta/organization/rbac_groups/members/list), y la respuesta al eliminar uno, ya no devuelven `group_id`. Usa `rbac_group_id` en su lugar.
    * Los [roles RBAC](https://platform.claude.com/docs/es/api/beta/organization/rbac_roles/list) ya no devuelven `name`. Usa `display_name` en su lugar.
    * Las entradas de límite de velocidad de la [organización](https://platform.claude.com/docs/es/api/organization/rate_limits/list) y del [espacio de trabajo](https://platform.claude.com/docs/es/api/organization/workspaces/rate_limits/list), y la respuesta a [establecer los límites de velocidad de un espacio de trabajo](https://platform.claude.com/docs/es/api/organization/workspaces/rate_limits/update), ya no devuelven `group_type`. Usa `group.type` en su lugar.
    * Las [claves de API](https://platform.claude.com/docs/es/api/organization/api_keys/list) ya no devuelven `workspace_id`. Usa `scope.workspace_id` en su lugar. Contiene el ID del espacio de trabajo de la clave, incluido el espacio de trabajo predeterminado. Una clave de todos los espacios de trabajo no tiene `scope.workspace_id`.

  * Claude Enterprise Analytics API:

    * Los informes por usuario de [uso](https://platform.claude.com/docs/es/api/beta/organization/analytics/user_usage_report/list) y [costo](https://platform.claude.com/docs/es/api/beta/organization/analytics/user_cost_report/list) ya no tienen `actor.email`. Usa `actor.email_address` en su lugar.
    * La respuesta de [resúmenes de actividad](https://platform.claude.com/docs/es/api/beta/organization/analytics/summaries/list) ya no tiene `summaries`. Usa `data` en su lugar.

* `2023-06-01`

  * Nuevo formato para los “server-sent events” (eventos enviados por el servidor), o SSE, de [streaming](https://platform.claude.com/docs/es/build-with-claude/streaming):

    * Las completaciones son incrementales. Por ejemplo, `" Hello"`, `" my"`, `" name"`, `" is"`, `" Claude." `en lugar de `" Hello"`, `" Hello my"`, `" Hello my name"`, `" Hello my name is"`, `" Hello my name is Claude."`.
    * Todos los eventos son [eventos con nombre](https://developer.mozilla.org/en-US/Web/API/Server-sent%5Fevents/Using%5Fserver-sent%5Fevents#named%5Fevents), en lugar de [eventos solo de datos](https://developer.mozilla.org/en-US/Web/API/Server-sent%5Fevents/Using%5Fserver-sent%5Fevents#data-only%5Fmessages).
    * Se eliminó el evento innecesario `data: [DONE]`.

  * Se eliminaron los valores heredados `exception` y `truncated` en las respuestas.

* `2023-01-01`: Lanzamiento inicial.