Run Economic Intelligence
Runs the engine toward what the owner wants, in their own words, such as “get more repeat buyers for my taurine supplement”. The recommendation comes back right away with status queued and only the owner’s input filled in; the engine moves it to pending while it works and then to ready, with the title and brief written, or to failed. Watch it in the list. Requests stack and are answered in turn, up to three generating at once.
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
A unique key that makes this request safe to retry. See Idempotent requests.
255"d9105228-4a08-46b1-8b91-42fed586d383"
Pins the request to a dated API version.
"2026-09-11"
Body
Response
recommendation queued
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
"scale_winning_ads"
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"
How the card runs. whop_ai means prompt is sent to Whop AI, which carries out every step.
whop_ai "whop_ai"
Expected change in that ledger line over the evaluation window, in USD, negative when the action reduces it, or null
The ledger line the action is expected to move, or null when the card carries no expectation
"ad_spend_charge"
Economic intelligence ID, prefixed reca_
"reca_xxxxxxxxxxxxxx"
The engine that generated the card, e.g. whop-ai-v5
"whop-ai-v5"
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
"more sales from ads"
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
"Capped 9 of 14 days."
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 "ready"
When a newer card replaced this one, as an ISO 8601 timestamp, or null
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"

