Request 2 caches its request content (not the response) changedbuild-with-claude/prompt-caching
Recorded here
Lines+72added
Lines−6removed
From line
2
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits34to this page, all time
## Availability ### API support #### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) #### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) ### Data handling
The whole hunk
from line 2, old and new numbered
/
from line 2
22title: Prompt caching
33url: https://platform.claude.com/docs/en/build-with-claude/prompt-caching
44description: Cache prompt prefixes with `cache_control` to cut costs and latency, using automatic caching or explicit breakpoints with 5-minute or 1-hour TTLs.
5featureMetadata:
6 zdr:
7 eligibility: eligible
8 note: Excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements). Your prompts and Claude's outputs are not stored. KV cache representations and cryptographic hashes are held in memory for the cache TTL and promptly deleted after expiry.
9 supportedModels:
10 - claude-fable-5-1
11 - claude-mythos-5-1
12 - claude-fable-5
13 - claude-mythos-5
14 - claude-mythos-preview
15 - claude-opus-5-5
16 - claude-opus-5
17 - claude-sonnet-5-5
18 - claude-sonnet-5
19 - claude-haiku-5-5
20 - claude-haiku-4-5-20251001
21 - claude-opus-4-8
22 - claude-opus-4-7
23 - claude-opus-4-6
24 - claude-sonnet-4-6
25 - claude-opus-4-5-20251101
26 - claude-sonnet-4-5-20250929
27 supportedPlatforms:
28 Claude API: ga
29 Claude Platform on AWS: ga
30 Claude Models on Google Cloud (Anthropic managed): ga
31 Amazon Bedrock: ga
32 Amazon Bedrock (InvokeModel): ga
33 Claude Models on Google Cloud (Google managed): ga
34 Microsoft Foundry: ga
535---
636
7Prompt caching optimizes your API usage by allowing resuming from specific prefixes in your prompts. This significantly reduces processing time and costs for repetitive tasks or prompts with consistent elements.
37**API support**: Usage differs by product.
838
9<Note>
10 To learn how zero data retention (ZDR) applies to this feature, see [API and data retention](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention).
11</Note>
39* **Messages API**: Opt in with `cache_control`, at the top level or on blocks.
40* **Managed Agents**: Always on. Cache entries use a 5-minute lifetime by default, and cache reads and writes show up in the session’s usage.
1241
42Prompt caching optimizes your API usage by allowing resuming from specific prefixes in your prompts. This significantly reduces processing time and costs for repetitive tasks or prompts with consistent elements.
43
1344There are two ways to enable prompt caching:
1445
1546* **[Automatic caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#automatic-caching):** Add a single `cache_control` field at the top level of your request. The system automatically applies the cache breakpoint to the last cacheable block and moves it forward as conversations grow. Best for multi-turn conversations where the growing message history should be cached automatically.
from line 3193
31623193
31633194KV (key-value) cache representations and cryptographic hashes of cached content are held in memory only and are not stored at rest. Cached entries have a minimum lifetime of 5 minutes (standard) or 1 hour (extended), after which they are promptly, though not immediately, deleted. Cache entries are isolated between organizations and, on the Claude API, Claude Platform on AWS, and Microsoft Foundry, between workspaces within an organization.
31643195
3165For ZDR eligibility across all features, see [API and data retention](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention).
3166
31673196***
31683197
31693198## FAQ
from line 3355
33263355 ```
33273356 </Accordion>
33283357</AccordionGroup>
3358
3359## Availability
3360
3361Prompt caching is available or in beta, depending on the API, and eligible for zero data retention and HIPAA readiness.
3362
3363### API support
3364
3365#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
3366
3367* Availability: Available
3368* Usage: Opt in with `cache_control`, at the top level or on blocks.
3369
3370| Status | Cloud platforms | Models |
3371| --------- | ----------------------- | ----------------------------------------------------------------- |
3372| Available | All supported platforms | [All models](https://platform.claude.com/docs/en/models/overview) |
3373
3374#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
3375
3376* Availability: Always on
3377* Usage: Cache entries use a 5-minute lifetime by default, and cache reads and writes show up in the session’s usage.
3378
3379| Status | Cloud platforms | Models |
3380| ------ | ----------------------- | ----------------------------------------------------------------- |
3381| Beta | All supported platforms | [All models](https://platform.claude.com/docs/en/models/overview) |
3382
3383### Data handling
3384
3385[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
3386
3387| Item | Zero data retention | HIPAA |
3388| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
3389| Status | Eligible (excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)) | Eligible |
3390| Details | Your prompts and Claude’s outputs are not stored. KV cache representations and cryptographic hashes are held in memory for the cache TTL and promptly deleted after expiry. [Learn more](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#data-retention) | — |
3391
3392Applicable endpoints:
3393
3394* `/v1/messages`
33293395
No line in this hunk matches that.