Update Recommendation
Updates a recommendation status, records feedback, or both. Send sentiment to rate it. Include status: superseded to retire a ready recommendation and request replacements; a rating alone leaves its status unchanged. To run a recommendation yourself, send status: running to start, then status: executed when it is carried out (with result_id naming what it changed, or result_page naming where it worked, so the result links there) or status: incomplete if the run ended without carrying it out. Whop AI reports its own runs the same way. Send status: acknowledged once an executed run’s result has been seen.
Authorizations
An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.
Headers
Pins the request to a dated API version.
"2026-09-29"
Path Parameters
Recommendation ID, prefixed reca_.
Query Parameters
Account ID, prefixed biz_. Defaults to the API key's own account.
Body
What you want the replacement recommendation for, in your own words. Up to 1000 characters. Sent when superseding, it directs the generation that replaces the rejected recommendation.
1000"Focus on returning buyers instead"
With status: executed, the ID of what the run produced or changed, and the recommendation's result_url becomes where to view it: an ad (ad_), ad group (adgrp_) or ad campaign (adcamp_), a website (app_), a product (prod_), a plan (plan_), a checkout link (ch_), a promo code (promo_), or an experience (exp_). Without result_id or result_page, result_url links to the resource the recommendation was about, when it names one. Send only one of result_id, result_page and result_url.
"prod_xxxxxxxxxxxxx"
With status: executed, the page where the run's result can be seen when it is not one resource, such as the checkout links list or the store page. The recommendation's result_url becomes that page on the account's dashboard, or its store page for store_page.
home, products, ads, websites, checkout_links, tracking_links, promo_codes, payments, customers, affiliates, analytics, store_page "promo_codes"
With status: executed, where to view what was produced when it is outside Whop. An http or https URL. Prefer result_id for anything on Whop.
2048"https://atlas.whop.site/"
A signed-in user can rate a recommendation as positive or negative. Can be sent alone or together with status.
positive, negative "positive"
Use running to start a run of a ready recommendation, executed to record that it was carried out, incomplete to record that a running recommendation's run ended without carrying it out, superseded to reject a ready recommendation, or acknowledged to mark an executed run as seen; the recommendation stays executed and records acknowledged_at.
running, executed, incomplete, superseded, acknowledged "superseded"
An optional explanation of the rating or rejection. Negative feedback informs replacement recommendations.
2000" Focus on returning buyers "
Response
recommendation superseded
ID of the account this recommendation is for, prefixed biz_, or null for personal onboarding.
"biz_xxxxxxxxxxxxxx"
When the executed run was first marked as seen, as an ISO 8601 timestamp, or null if it has not been.
"2026-01-01T12:00:00.000Z"
Type of action recommended, or null when no type is assigned. New values may be added; handle unknown types gracefully.
"scale_winning_ads"
The chat that ran the recommendation, shown only to the user who ran it, or null otherwise.
"aich_xxxxxxxxxxxxxx"
When the recommendation was created, as an ISO 8601 timestamp, or null for an unsaved recommendation.
"2026-01-01T12:00:00.000Z"
When the recommendation was carried out, as an ISO 8601 timestamp, or null if it has not been.
"2026-01-01T12:00:00.000Z"
Recommendation ID, prefixed reca_, or create_business for an unsaved setup recommendation. Authenticate and list again before executing an unsaved recommendation.
"reca_xxxxxxxxxxxxxx"
What you requested, in your own words, or null for recommendations generated without your input.
"more sales from ads"
Step-by-step instructions for Whop AI, or null when no instructions are available.
"Create a 20% off promo code for my members."
Evidence and metrics supporting the recommendation, or null when no reasoning was provided.
"Capped 9 of 14 days."
Where to view what the run produced, such as the published website or created product, or null when the result is only in the chat.
"https://atlas.whop.site/"
The user who started the run, prefixed user_, or null if it has not run or was started without a user, such as with an API key.
"user_xxxxxxxxxxxxxx"
When Whop AI's run ended, whether executed or incomplete, as an ISO 8601 timestamp, or null if it has not ended.
"2026-01-01T12:00:00.000Z"
When Whop AI started carrying out the recommendation, as an ISO 8601 timestamp, or null if it has not run.
"2026-01-01T12:00:00.000Z"
How the user rated this recommendation, or null if they have not rated it
positive, negative, null "positive"
queued when awaiting generation; pending while generating; ready when available to run; running while Whop AI carries it out; executed when carried out; incomplete when Whop AI's run ended without carrying it out; superseded when rejected or replaced.
queued, pending, ready, running, executed, incomplete, superseded "executed"
When the recommendation was rejected or replaced, as an ISO 8601 timestamp, or null if neither has occurred.
"2026-01-01T12:00:00.000Z"
Recommended action and its expected benefit, or null until generated.
"Move $180 from 3 dead ad groups into BATCH#3, +1.7x return"
The user's written feedback, or null if they have not provided any.
null
Website URL selected for pixel setup, or null when no website was captured for this recommendation.
"https://example.com/join"

