cache

Expire cache entries

Changed on

Drops cached directory entries, and optionally cached file data, for the cache backend.

post/cache/expire

Request

Headers

Prefer'respond-async'

Set to respond-async to run the call in the background. Rclone returns a 202 with a job ID right away, and job/status reports progress. This has the same effect as the _async param in rclone's docs, but _async alone returns a 200 instead of a 202.

Request body

_configobject

Config overrides for this call only.

_filterobject

Filter overrides for this call only.

_groupstring

Stats group for this call.

remotestring required

Remote path to expire from the cache, e.g. remote:path/to/dir.

withDataboolean

Set this to drop cached chunk data along with directory entries. Rclone only checks whether the key is present, so any value turns it on, including false.

Response

Confirmation that the path was cleared.

statusstring required

Always ok.

messagestring required

Describes what was cleared.

Changes