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: AuthorizationSource: 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:
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