---
title: Cache Reserve
---

[Skip to content](#%5Ftop) 

[API Reference](https://developers.cloudflare.com/api/typescript)

[Cache](https://developers.cloudflare.com/api/typescript/resources/cache)

Copy Markdown

Open in **Claude**

Open in **ChatGPT**

Open in **Cursor**

---

**Copy Markdown**

**View as Markdown**

# Cache Reserve

##### [Get Cache Reserve setting](https://developers.cloudflare.com/api/typescript/resources/cache/subresources/cache%5Freserve/methods/get)

client.cache.cacheReserve.get(CacheReserveGetParams { zone\_id } params, RequestOptionsoptions?): [CacheReserveGetResponse](https://developers.cloudflare.com/api/typescript/resources/cache#%28resource%29%20cache.cache%5Freserve%20%3E%20%28model%29%20cache%5Freserve%5Fget%5Fresponse%20%3E%20%28schema%29) { id, editable, value, modified\_on } 

GET/zones/{zone\_id}/cache/cache\_reserve

##### [Change Cache Reserve setting](https://developers.cloudflare.com/api/typescript/resources/cache/subresources/cache%5Freserve/methods/edit)

client.cache.cacheReserve.edit(CacheReserveEditParams { zone\_id, value } params, RequestOptionsoptions?): [CacheReserveEditResponse](https://developers.cloudflare.com/api/typescript/resources/cache#%28resource%29%20cache.cache%5Freserve%20%3E%20%28model%29%20cache%5Freserve%5Fedit%5Fresponse%20%3E%20%28schema%29) { id, editable, value, modified\_on } 

PATCH/zones/{zone\_id}/cache/cache\_reserve

##### [Get Cache Reserve Clear](https://developers.cloudflare.com/api/typescript/resources/cache/subresources/cache%5Freserve/methods/status)

client.cache.cacheReserve.status(CacheReserveStatusParams { zone\_id } params, RequestOptionsoptions?): [CacheReserveStatusResponse](https://developers.cloudflare.com/api/typescript/resources/cache#%28resource%29%20cache.cache%5Freserve%20%3E%20%28model%29%20cache%5Freserve%5Fstatus%5Fresponse%20%3E%20%28schema%29) { id, start\_ts, state, 2 more } 

GET/zones/{zone\_id}/cache/cache\_reserve\_clear

##### [Start Cache Reserve Clear](https://developers.cloudflare.com/api/typescript/resources/cache/subresources/cache%5Freserve/methods/clear)

client.cache.cacheReserve.clear(CacheReserveClearParams { zone\_id, body } params, RequestOptionsoptions?): [CacheReserveClearResponse](https://developers.cloudflare.com/api/typescript/resources/cache#%28resource%29%20cache.cache%5Freserve%20%3E%20%28model%29%20cache%5Freserve%5Fclear%5Fresponse%20%3E%20%28schema%29) { id, start\_ts, state, 2 more } 

POST/zones/{zone\_id}/cache/cache\_reserve\_clear

##### ModelsExpand Collapse 

CacheReserve \= "cache\_reserve"

The identifier of the caching setting.

CacheReserveClear \= "cache\_reserve\_clear"

ID of the zone setting.

State \= "In-progress" | "Completed"

The current state of the Cache Reserve Clear operation.

One of the following:

"In-progress"

"Completed"

CacheReserveGetResponse { id, editable, value, modified\_on } 

id: [CacheReserve](https://developers.cloudflare.com/api/typescript/resources/cache#%28resource%29%20cache.cache%5Freserve%20%3E%20%28model%29%20cache%5Freserve%20%3E%20%28schema%29) { } 

The identifier of the caching setting.

editable: boolean

Whether the setting is editable.

value: "on" | "off"

Value of the Cache Reserve zone setting.

One of the following:

"on"

"off"

modified\_on?: string | null

Last time this setting was modified.

formatdate-time

CacheReserveEditResponse { id, editable, value, modified\_on } 

id: [CacheReserve](https://developers.cloudflare.com/api/typescript/resources/cache#%28resource%29%20cache.cache%5Freserve%20%3E%20%28model%29%20cache%5Freserve%20%3E%20%28schema%29) { } 

The identifier of the caching setting.

editable: boolean

Whether the setting is editable.

value: "on" | "off"

Value of the Cache Reserve zone setting.

One of the following:

"on"

"off"

modified\_on?: string | null

Last time this setting was modified.

formatdate-time

CacheReserveStatusResponse { id, start\_ts, state, 2 more } 

You can use Cache Reserve Clear to clear your Cache Reserve, but you must first disable Cache Reserve. In most cases, this will be accomplished within 24 hours. You cannot re-enable Cache Reserve while this process is ongoing. Keep in mind that you cannot undo or cancel this operation.

id: [CacheReserveClear](https://developers.cloudflare.com/api/typescript/resources/cache#%28resource%29%20cache.cache%5Freserve%20%3E%20%28model%29%20cache%5Freserve%5Fclear%20%3E%20%28schema%29) { } 

ID of the zone setting.

start\_ts: string

The time that the latest Cache Reserve Clear operation started.

formatdate-time

state: [State](https://developers.cloudflare.com/api/typescript/resources/cache#%28resource%29%20cache.cache%5Freserve%20%3E%20%28model%29%20state%20%3E%20%28schema%29)

The current state of the Cache Reserve Clear operation.

end\_ts?: string

The time that the latest Cache Reserve Clear operation completed.

formatdate-time

modified\_on?: string | null

Last time this setting was modified.

formatdate-time

CacheReserveClearResponse { id, start\_ts, state, 2 more } 

You can use Cache Reserve Clear to clear your Cache Reserve, but you must first disable Cache Reserve. In most cases, this will be accomplished within 24 hours. You cannot re-enable Cache Reserve while this process is ongoing. Keep in mind that you cannot undo or cancel this operation.

id: [CacheReserveClear](https://developers.cloudflare.com/api/typescript/resources/cache#%28resource%29%20cache.cache%5Freserve%20%3E%20%28model%29%20cache%5Freserve%5Fclear%20%3E%20%28schema%29) { } 

ID of the zone setting.

start\_ts: string

The time that the latest Cache Reserve Clear operation started.

formatdate-time

state: [State](https://developers.cloudflare.com/api/typescript/resources/cache#%28resource%29%20cache.cache%5Freserve%20%3E%20%28model%29%20state%20%3E%20%28schema%29)

The current state of the Cache Reserve Clear operation.

end\_ts?: string

The time that the latest Cache Reserve Clear operation completed.

formatdate-time

modified\_on?: string | null

Last time this setting was modified.

formatdate-time