Update Recommendation
Retires a ready recommendation the owner no longer wants by setting its status to superseded. It leaves the ready list and stays in the account’s history.
Authorizations
An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.
Headers
Pins the request to a dated API version.
"2026-09-11-1"
Path Parameters
Recommendation ID, prefixed reca_.
Query Parameters
Account ID, prefixed biz_. Defaults to the API key's own account.
Body
The status to move the recommendation to. Only superseded is accepted.
superseded "superseded"
Response
recommendation superseded
The account this recommendation is for, prefixed biz_
"biz_xxxxxxxxxxxxxx"
The playbook action this card recommends, or null for an untyped card; new values may be added, so handle unknown types gracefully
"improve_landing_page"
When the recommendation was created, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
When the card was run, as an ISO 8601 timestamp, or null
"2026-01-01T12:00:00.000Z"
Economic intelligence ID, prefixed reca_
"reca_xxxxxxxxxxxxxx"
What the owner asked for, in their own words, when this recommendation was requested, or null when the engine chose the action on its own
"Grow revenue"
The step-by-step brief Whop AI executes when the card is run, or null
"Create a 20% off promo code for my members."
The signal and number the recommendation rests on, or null
"Revenue fell by 20%."
queued once requested and not yet picked up; pending while the engine is generating; ready when the card is written and the owner can run it; executed once it was run; superseded when a newer card of the same action type replaced it; failed when the engine had nothing to recommend for the request
queued, pending, ready, executed, superseded, failed "superseded"
When a newer card replaced this one, as an ISO 8601 timestamp, or null
"2026-01-01T12:00:00.000Z"
The recommendation as the owner sees it: one command with the payoff, or null until the engine has written the card
"Move $180 from 3 dead ad groups into BATCH#3, +1.7x return"

