Claude Platform Docs
Referência da APISuporte e configuração

Versões da API

Ao fazer requisições à API, você deve enviar um cabeçalho de requisição anthropic-version. Por exemplo, anthropic-version: 2026-10-21. Se você estiver usando o SDK de cliente, ele define esse cabeçalho para você.

Para qualquer versão específica da API, a Anthropic preserva:

  • Parâmetros de entrada existentes
  • Parâmetros de saída existentes

No entanto, a Anthropic pode fazer o seguinte:

  • Adicionar entradas opcionais adicionais
  • Adicionar valores adicionais à saída
  • Alterar condições para tipos de erro específicos
  • Adicionar novas variantes a valores de saída do tipo enum (por exemplo, tipos de eventos de streaming)

Em geral, se você estiver usando a API conforme documentado nesta referência, a Anthropic não quebrará seu uso.

Histórico de versões

A Anthropic recomenda usar a versão mais recente da API sempre que possível.

  • 2026-10-21
    • Migrando para a versão da API 2026-10-21 mostra como fazer a atualização.
    • Disponível na Claude API, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), Claude Models on Google Cloud (Google managed) e Microsoft Foundry. No Amazon Bedrock, está disponível para Claude 4.7 e modelos posteriores. Para modelos Claude anteriores no Bedrock, mantenha a versão da API que você usa hoje.
    • Messages API:
      • Uma requisição que coloca um bloco document diretamente em uma mensagem assistant retorna um erro 400.
      • Enviar um bloco text com um array citations não vazio em uma mensagem user, diretamente ou dentro de um bloco search_result, retorna um erro 400.
      • Os parâmetros de requisição temperature, top_p e top_k foram removidos. Uma requisição que envie qualquer um deles retorna um erro 400 em todos os modelos.
    • Admin API:
      • Os grupos RBACPré-visualização disponível com links para a referência da API — pressione Tab até o foco entrar no cartão, Escape para voltar. não retornam mais roles. Use role_ids em vez disso.
      • Os membros de grupos RBACPré-visualização disponível com links para a referência da API — pressione Tab até o foco entrar no cartão, Escape para voltar., e a resposta à remoção de um deles, não retornam mais group_id. Use rbac_group_id em vez disso.
      • As funções RBACPré-visualização disponível com links para a referência da API — pressione Tab até o foco entrar no cartão, Escape para voltar. não retornam mais name. Use display_name em vez disso.
      • As entradas de “rate limit” (limite de taxa) da organizaçãoPré-visualização disponível com links para a referência da API — pressione Tab até o foco entrar no cartão, Escape para voltar. e do workspacePré-visualização disponível com links para a referência da API — pressione Tab até o foco entrar no cartão, Escape para voltar., e a resposta a definir os limites de taxa de um workspacePré-visualização disponível com links para a referência da API — pressione Tab até o foco entrar no cartão, Escape para voltar., não retornam mais group_type. Use group.type em vez disso.
      • As chaves de APIPré-visualização disponível com links para a referência da API — pressione Tab até o foco entrar no cartão, Escape para voltar. não retornam mais workspace_id. Em vez disso, use scope.workspace_id. Ele contém o ID do workspace da chave, incluindo o workspace padrão. Uma chave de todos os workspaces não tem scope.workspace_id.
    • Claude Enterprise Analytics API:
      • Os relatórios por usuário de usoPré-visualização disponível com links para a referência da API — pressione Tab até o foco entrar no cartão, Escape para voltar. e de custoPré-visualização disponível com links para a referência da API — pressione Tab até o foco entrar no cartão, Escape para voltar. não têm mais actor.email. Use actor.email_address em vez disso.
      • A resposta de resumos de atividadePré-visualização disponível com links para a referência da API — pressione Tab até o foco entrar no cartão, Escape para voltar. não tem mais summaries. Use data em vez disso.
  • 2023-06-01
    • Novo formato para “server-sent events” (eventos enviados pelo servidor), ou SSE, de streaming:
      • As conclusões são incrementais. Por exemplo, " Hello", " my", " name", " is", " Claude." em vez de " Hello", " Hello my", " Hello my name", " Hello my name is", " Hello my name is Claude.".
      • Todos os eventos são eventos nomeados, em vez de eventos somente de dados.
      • Removido o evento desnecessário data: [DONE].
    • Removidos os valores legados exception e truncated nas respostas.
  • 2023-01-01: Lançamento inicial.

Esta página foi útil?