cache_read
Reads a key from a cache connector (Redis or the built-in in-memory backend).
Missing keys yield null.
Synopsis
{
"name": "cache_read",
"input": {
"connector": "redis",
"key": "rate:42",
"output": "data.cached"
}
}
Description
cache_read is a connector function. It names a connector for its credentials and endpoint. Orion validates its input when the workflow is saved, and the call runs through the connector’s circuit breaker.
Retry safety: read. See Retry safety for what the answer costs.
Fields
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
connector | string | yes | — | Name of the cache connector |
key | string | yes | — | Cache key to read |
output | string | JSONLogic | no | "data" | Dotted path where the value is written |
Examples
{ "name": "cache_read", "input": { "connector": "redis", "key": "rate:42", "output": "data.cached" } }
Related
- Connectors: why credentials and endpoints live on a connector.
- Connect a database or API: creating the connector this function names.
- Task functions: the whole catalogue, and each function’s retry safety.
- Connector types: the connector fields, retries and circuit breakers behind the call.
Last verified 14 September 2026