[DOCS] Skills guide examples include unnecessary prompt-caching-2024-07-31 beta header

Resolved 💬 2 comments Opened Jan 26, 2026 by coygeek Closed Feb 28, 2026

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://platform.claude.com/docs/en/build-with-claude/skills-guide

Section/Topic

Code examples throughout the Skills guide that include beta headers

Current Documentation

Multiple code examples include the prompt caching beta header:

``python betas=["code-execution-2025-08-25", "skills-2025-10-02", "prompt-caching-2024-07-31"], ``
``typescript betas: ['code-execution-2025-08-25', 'skills-2025-10-02', 'prompt-caching-2024-07-31'], ``
``bash -H "anthropic-beta: code-execution-2025-08-25,skills-2025-10-02,prompt-caching-2024-07-31" \ ``

What's Wrong or Missing?

The prompt-caching-2024-07-31 beta header is no longer needed. The prompt caching documentation explicitly states:

"Prompt caching is now generally available, so you no longer need the beta prefix."

The API release notes confirm:

"The 1-hour cache duration for prompt caching is now generally available. You can now use the extended cache TTL without a beta header."

Including this deprecated beta header in examples may confuse developers who wonder why it's present, or cause them to unnecessarily include it in their own code.

Suggested Improvement

Remove prompt-caching-2024-07-31 from all beta arrays in the Skills guide examples:

Before:

betas=["code-execution-2025-08-25", "skills-2025-10-02", "prompt-caching-2024-07-31"],

After:

betas=["code-execution-2025-08-25", "skills-2025-10-02"],

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://platform.claude.com/docs/en/build-with-claude/skills-guide | 1393, 1407 | Python examples |
| https://platform.claude.com/docs/en/build-with-claude/skills-guide | 1424, 1438 | TypeScript examples |
| https://platform.claude.com/docs/en/build-with-claude/skills-guide | 1455, 1473 | cURL examples |

Total scope: 1 page, 6 code examples affected

Cross-reference: The Prompt Caching FAQ explicitly states the beta prefix is no longer needed.

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗