[DOCS] Cross-Reference Contradiction: Bedrock Invoke vs. Converse API Support

Documentation Type

Unclear/confusing documentation

Documentation Location

• https://code.claude.com/docs/en/amazon-bedrock - https://platform.claude.com/docs/en/build-with-claude/pdf-support

Section/Topic

The "Troubleshooting" section of the Claude Code Bedrock documentation and the "Amazon Bedrock PDF Support" section of the Platform documentation.

Current Documentation

From Claude Code Docs (code.claude.com):

"Claude Code uses the Bedrock Invoke API and does not support the Converse API."

From Platform Docs (platform.claude.com):

"PDF support is available on Amazon Bedrock through both the Converse API and InvokeModel API. ... Important considerations for Converse API users: ... processes each page as both text and image... requires citations to be enabled."

What's Wrong or Missing?

The documentation contains a direct contradiction regarding the support of the AWS Bedrock Converse API.

The Claude Code documentation suggests a platform-wide or tool-wide lack of support for the Converse API ("...does not support the Converse API"). However, the Platform documentation provides specific implementation details and requirements for using the Converse API with Claude models on Bedrock.

This creates confusion for developers trying to determine if they can use the more modern Converse API for their integrations or if they must use the legacy Invoke API.

Suggested Improvement

The documentation should clarify the distinction between the internal requirements of the Claude Code CLI tool and the general capabilities of Claude models hosted on Bedrock.

Suggested text for code.claude.com/docs/en/amazon-bedrock:

"The Claude Code CLI utility is currently implemented using the Bedrock Invoke API and does not utilize the Converse API for its internal agent loop. However, the Claude 3 and 4 model families on Bedrock generally support both the Invoke and Converse APIs for use in your own applications and SDK integrations."

Impact

High - Prevents users from using a feature

Additional Context

• Severity: Major (Conflicting technical requirements for AWS integration).
• Related Documentation: AWS Bedrock Converse API Documentation.
• Reasoning: It appears the limitation is specific to the binary/CLI tool logic of Claude Code, but the wording in the current docs is broad enough to imply the models themselves or the provider integration lacks the feature.