retrostashMutate

fun HttpRequestBuilder.retrostashMutate(scopeName: String, invalidateTemplates: List<String> = emptyList(), bindings: Map<String, String> = emptyMap(), bodyBytes: ByteArray? = null, invalidateTags: List<String> = emptyList()): HttpRequestBuilder

Marks this request as a Retrostash mutation. On a 2xx response, RetrostashPlugin resolves each entry in invalidateTemplates against bindings / bodyBytes and removes matching cache entries.

Parameters

scopeName

Logical namespace; should match the scopeName used by paired query calls.

invalidateTemplates

Cache templates to clear. Use the placeholder form (e.g. "users/{id}") — the plugin substitutes from bindings before invalidating.

bindings

Placeholder values from the call site.

bodyBytes

Optional request body for placeholder fallback resolution.

invalidateTags

Tag templates to resolve and clear on a 2xx response (parallel to invalidateTemplates but matched against per-entry tag sets).