"Does not match" error when using a file in messages

[dan-jensen]

Problem

When using a file in messages, this gem causes the Anthropic API to respond with an error: "messages.0.content.1.document.source: Input tag 'file' found using 'type' does not match any of the expected tags: 'base64', 'content', 'text', 'url'". This happens because the API does not support file sources unless the required anthropic-beta header is provided: anthropic-beta: files-api-2025-04-14. This was confirmed by adding the missing header to a gem request via the extra_headers option, which solved the problem.

Proposal

The messages requests should always include the anthropic-beta header, like the the files requests already do.

Example request

message = anthropic.messages.create(
  max_tokens: 1024,
  messages: [
    {
      role: "user",
      content: [
        {
          type: "text",
          text: "Hello Claude"
        },
        {
          type: "document",
          source: {
            type: "file",
            file_id: "file_011CSoYoHF8saWZ6CPh55555"
        }
      ]
    }
  ],
  model: :"claude-sonnet-4-20250514"
)

Example response

{
  "url": "https://api.anthropic.com/v1/messages",
  "status": 400,
  "body": {
    "type": "error",
    "error": {
      "type": "invalid_request_error",
      "message": "messages.0.content.1.document.source: Input tag 'file' found using 'type' does not match any of the expected tags: 'base64', 'content', 'text', 'url'"
    }
  }
}

[ms-jpq]

edit: wait i replied to the wrong message.

---

attempt 2:

hi @dan-jensen, there is actually a separate https://gemdocs.org/gems/anthropic/1.9.0/Anthropic/Resources/Beta.html client.beta.* namespace that is for these purposes!

they should let you specify something like:

betas (Array<String, Symbol, [Anthropic::Models::AnthropicBeta](https://gemdocs.org/gems/anthropic/1.9.0/Anthropic/Models/AnthropicBeta.html)>) —

Header param: Optional header to specify the beta version(s) you want to use.

[dan-jensen]

@ms-jpq no, unfortunately the Beta::Messages methods are missing the required header (anthropic-beta: files-api-2025-04-14). You can see it's in the files beta but not the messages beta. This issue should be re-opened.

[gencergenc]

For a workaround ~until PR, passing request_options -> extra_headers is enough to handle PDFs.

        file = Anthropic::FilePart.new(File.read("tmp/123.pdf"),
                                     filename: "123.pdf",
                                     content_type: "application/pdf")
    	file_metadata = anthropic.beta.files.upload(file: file)
        messages: [ ...
        # {
        #     type: :document,
        #     source: {
        #       type: "file",
        #       file_id: file_metadata.id
        #    }
        #  }
        # ],
      ...
      request_options: { max_retries: 5,
                         extra_headers: { "anthropic-beta" => "files-api-2025-04-14" } }