Reference

POST /partner/v1/decisions/{id}/refresh

Re-run the decisioning model for an application. Costly, so sub-limited to 1 req/s. Use only when new information materially changes the case.

2 min read

POSTHTTP method
OAuthAuth
partnerRing

Endpoint

MethodPOST
Path/partner/v1/decisions/{id}/refresh
Ringpartner (OAuth)
AuthOAuth

Request

Path parameter id. An optional body carrying updated inputs. Requires decisions:write. Send an Idempotency-Key.

Response

A response indicating a refresh was queued; the new outcome arrives via the decision webhook or a subsequent read. Refresh re-runs the model, which is expensive — do it only when materially new information (updated financials, a corrected figure) would change the result, not speculatively.

Errors & notes

Sub-limited to 1 req/s — re-running the model is costly. A 409 if a refresh is already in flight; a 403 without decisions:write. Idempotency applies.

Frequently asked questions

When should I refresh a decision?

Only when genuinely new information would change the outcome — updated accounts, a corrected amount. Refreshing speculatively wastes the 1 req/s sub-limit and the model run for no benefit.

Why is refresh limited to 1 req/s?

Each refresh re-runs the decisioning model, which is the most expensive operation on the ring. The tight sub-limit keeps that cost bounded.

Funding for UK limited companies

Credicorp lends to your company, not to you personally — short-term working capital with no personal guarantee. See what your business could access.