Skip to content
HotKVDocs

Ask the HotKV docs

Answers come only from these docs and can be wrong; check the linked pages before you rely on them.

TOOL.CACHE.FLUSH

Last updated 
TOOL.CACHE.FLUSH namespace
Group
Keyed caches
Complexity
O(N) where N is the number of entries
Arity
2 (exactly, counting the command name)
Flags
write
Keys
first 1, last 1, step 1
HotKV Cloud
Performance and Scale
On-Premise
requires the tool-cache license feature

The tool cache memoizes the results of deterministic tool or function calls an agent makes, keyed by a deterministic string built from the call (for example the tool name and its arguments). TOOL.CACHE.FLUSH empties a namespace. The namespace keeps its settings, so you can store new entries straight away. To remove the namespace itself, use TOOL.CACHE.DROP.

Return value

Section titled “Return value”
Case RESP2 RESP3
Always Integer: the number of entries removed (0 for an unknown namespace) Same

Errors:

  • ERR wrong number of arguments for 'tool.cache.flush' command if the argument count is wrong.
  • NOLICENSE tool-cache requires a HotKV license. Contact sales@hotkv.com if your license does not include the tool-cache feature.

Examples

Section titled “Examples”
127.0.0.1:6379> TOOL.CACHE.FLUSH sqltool
(integer) 2
127.0.0.1:6379> TOOL.CACHE.FLUSH sqltool
(integer) 0

Compatibility

Section titled “Compatibility”

HotKV-only command. Redis and Valkey have no equivalent.

See also

Section titled “See also”

TOOL.CACHE.CREATE, TOOL.CACHE.SET, TOOL.CACHE.GET, TOOL.CACHE.DEL, TOOL.CACHE.STATS, TOOL.CACHE.DROP, TOOL.CACHE.LIST, AI features guide