Anthropic APIBehavior changemedium

Anthropic makes Bearer auth primary, demotes x-api-key to legacy

Detected
Sep 3, 2026
Confidence
82%

What changed

Anthropic has updated the authentication header documentation to promote Authorization: Bearer <token> as the primary authentication method, demoting x-api-key to a 'legacy fallback' that is still supported. The required/optional status of these headers has been inverted compared to the previous documentation.

What to do

Begin migrating from x-api-key to Authorization: Bearer <api-key> header for future-proofing, though x-api-key remains supported for now. SDK users are unaffected as the SDK handles header management automatically.

Affected

header: x-api-keyheader: Authorization

Source: docs.anthropic.com (Anthropic's own page, checked by Breakwatch)

Is your code affected?

Search your repositories for the Anthropic SDK and the names above:

npm: @anthropic-ai/sdkpip: anthropicruby: anthropicgo: github.com/anthropics/anthropic-sdk-gojava: com.anthropic:anthropic-javarust: anthropic

Or let Breakwatch do it: connect a repo and see which files call Anthropic, then get the next change as an alert pointing at those files. Check a repo free

Get Anthropic API changes by email

Once a week: the breaking changes and upcoming deadlines for Anthropic, each linked to the vendor's own page. Free, no account. One-click unsubscribe.

More Anthropic API changes

Every Anthropic API change →