retrostashQuery

fun HttpRequestBuilder.retrostashQuery(scopeName: String, template: String, bindings: Map<String, String> = emptyMap(), bodyBytes: ByteArray? = null, maxAgeMs: Long = 0, tags: List<String> = emptyList()): HttpRequestBuilder

Marks this request as a Retrostash query. On hit, the plugin returns the cached payload via RetrostashCachedPayloadKey. On miss, the response is persisted (if maxAgeMs> 0) on a 2xx status code.

Parameters

scopeName

Logical namespace (typically the API interface name).

template

Cache template (e.g. "feed/{id}").

bindings

Placeholder values from the call site (path / query parameters).

bodyBytes

Optional request body for placeholder fallback resolution.

maxAgeMs

TTL for the cached entry. 0 disables persistence (lookup-only).

tags

Tag templates to persist with the entry. Resolved from bindings / bodyBytes.