Error by downloading the PPT

[spravia]

Bug Report – Quickstart documentation error
https://platform.claude.com/docs/en/agents-and-tools/agent-skills/quickstart

While following the quickstart guide to download a generated PPTX file, the provided code for extracting the file_id does not work:

❌ From the docs – this NEVER matches

if block.type == "tool_use" and block.name == "code_execution":
for result_block in block.content:
if hasattr(result_block, "file_id"):
file_id = result_block.file_id
break

The actual response from client.beta.messages.create() never returns a block with type == "tool_use" when using Skills. The real block types returned are:

text
server_tool_use
bash_code_execution
bash_code_execution_tool_result
text_editor_code_execution_tool_result

✅ This actually works

if block.type == "bash_code_execution_tool_result":
content = getattr(block, "content", None)
if isinstance(content, list):
for item in content:
if hasattr(item, "file_id") and item.file_id:
file_id = item.file_id
break
elif hasattr(content, "file_id") and content.file_id:
file_id = content.file_id

This caused significant confusion and wasted API credits while debugging :'( . The quickstart example appears to have been written for an older API version or was never tested against the actual response structure. Please update the documentation accordingly.

[cj-ant]

Thanks for the detailed report. You were right: the quickstart's download step at the time checked for block.type == "tool_use" with block.name == "code_execution", and the API never returns that shape for server-side tools. The extraction always came back empty.

The quickstart was rewritten in May 2026 and the current page uses the correct block types: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/quickstart

I re-verified today by running the Skills request from the quickstart (pptx skill plus code execution) and inspecting the response. The content blocks returned were text, server_tool_use, text_editor_code_execution_tool_result, and bash_code_execution_tool_result. No tool_use block appears, exactly as you observed. The extraction now published in the docs found the file ID and downloaded a valid .pptx:

file_id = None
for block in response.content:
    if block.type == "code_execution_tool_result":
        if block.content.type == "code_execution_result":
            for output in block.content.content:
                file_id = output.file_id
    elif block.type == "bash_code_execution_tool_result":
        if block.content.type == "bash_code_execution_result":
            for output in block.content.content:
                file_id = output.file_id

It checks both result types because the skill may run its work through either the Python or the bash code execution tool. One more change since you filed this: the quickstart now uses the code_execution_20260521 tool version, which is generally available and needs no code execution beta header (only skills-2025-10-02).

Sorry about the wasted credits debugging this. Closing since the docs are fixed, but reopen if the current page still gives you trouble.