---
title: "Deprecation: #109107 - CacheAction key \"href\""
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:deprecation-109107-1772108218"
source: "Changelog/14.3/Deprecation-109107-CacheActionHrefKey.rst"
typo3-version: "14.3"
typo3-major: 14
type: "deprecation"
issue: 109107
forge: "https://forge.typo3.org/issues/109107"
tags: ["Backend", "PHP-API", "ext:backend", "NotScanned"]
rendered: "2026-09-23T15:30:34+00:00"
---

# Deprecation: #109107 - CacheAction key "href" {#deprecation-109107-1772108218}

See [forge#109107](https://forge.typo3.org/issues/109107)

## Description {#description}

The `CacheAction` array key `href` used in cache action definitions
provided by the
`\TYPO3\CMS\Backend\Backend\Event\ModifyClearCacheActionsEvent` has been
deprecated in favor of `endpoint`. The new key name better reflects the purpose of
this field, which is used as an AJAX endpoint URL. The value must be a
`string`.

## Impact {#impact}

Cache action arrays that contain an `href` rather than an `endpoint` key
will trigger a PHP `E_USER_DEPRECATED` notice.
`\TYPO3\CMS\Backend\Backend\ToolbarItems\ClearCacheToolbarItem` will automatically
migrate `href` to `endpoint` at runtime to maintain backward compatibility.

Support for the `href` key will be removed in TYPO3 v15.0.

## Affected installations {#affected-installations}

Any installation that has extensions which register custom cache actions with
`\TYPO3\CMS\Backend\Backend\Event\ModifyClearCacheActionsEvent` and
provide an action URL in the `href` array key.

## Migration {#migration}

Replace the `href` key with `endpoint` in any cache action array
returned from a `\TYPO3\CMS\Backend\Backend\Event\ModifyClearCacheActionsEvent` listener.

```diff
$event->addCacheAction([
    'id' => 'my_custom_cache',
-   'href' => $uriBuilder->buildUriFromRoute('ajax_my_cache_clear'),
+   'endpoint' => (string)$uriBuilder->buildUriFromRoute('ajax_my_cache_clear'),
    'iconIdentifier' => 'actions-system-cache-clear',
    'title' => 'Clear my cache',
    'description' => 'Optional description',
    'severity' => 'notice',
]);
```