v1

latestOpenAPI 3.1.0MIT2026-07-1799111346.8 KB

Refresh directory cache

Refreshes one or more directories in the VFS cache, optionally recursively.

post/vfs/refresh

Query parameters

fsstring

Optional VFS identifier whose directory cache should be refreshed.

recursiveboolean

Set to true to refresh entire directory trees.

paramsobject

Additional arbitrary parameters allowed.

_groupstring

Assign the request to a custom stats group.

_asyncboolean

Run the command asynchronously. Returns a job id immediately.

Headers

Prefer'respond-async'

Set to "respond-async" with _async=true to receive HTTP 202 instead of 200.

Request body

fsstring

Optional VFS identifier whose directory cache should be refreshed.

recursiveboolean

Set to true to refresh entire directory trees.

_groupstring

Assign the request to a custom stats group.

_asyncboolean

Run the command asynchronously. Returns a job id immediately.

Response

Acknowledgement of directories refreshed in the VFS cache.

resultobject required

Map of refreshed directories to status messages.