---
title: "Service: /caches/{name}/elements/{key}/remove [POST]"
source: https://dev.pageseeder.com/api/services/remove-cache-element-POST.html
description: "Removes an entry from a specified cache by key. Returns XML response indicating if removal was successful. Requires administrator permissions. Returns error if cache name doesn't exist."
last_updated: 2026-09-02T11:36:12+10:00
document_type: api_endpoint
operation_id: cache-POST
resource_id: cache
path_template: /caches/{name}/elements/{key}/remove
http_method: POST
api_category: cache
implementation_version: 6.3000
api_since: 5.5000
deprecated_since: null
obsolete_since: null
api_support: experimental
cache_control: N/A
generated_at: 2026-09-02
tokens: ~251
---

# /caches/\{name\}/elements/\{key\}/remove \[POST\]

## Description

Removes an entry from the cache content.

## Parameters

No parameters required.

## Permission

This service requires administrator.

## Response

When the response is successful, the XML response includes the element that was removed as well as the affected cache wrapped in a `<clear-entry>` element.

Example of a successful response:

```xml

<clear-entry>
  <cache name="xml-documents"
guid="MY-PC/192.168.200.210-860d089c-62e9-4f2a-9081-e79a2989c0ef"/>
  <element key="4-1-" removed="true"/>
</clear-entry>
```

If the key does not exist, the response is identical to when the response is successful.

```xml

<clear-entry>
  <cache name="xml-documents"
guid="MY-PC/192.168.200.210-860d089c-62e9-4f2a-9081-e79a2989c0ef"/>
  <element key="5" removed="false"/>
</clear-entry>
```

## Error Handling

If the cache name does not exist, this service returns:

```xml

<clear-entry>
  <no-cache name="brazil"/>
</clear-entry>
```