Skip to main content
PATCH
Update Recommendation

Autorisations

Authorization
string
header
requis

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.

Scopes

company:basic:read

En-têtes

Api-Version-Date
string

Pins the request to a dated API version.

Exemple:

"2026-11-17"

Paramètres de chemin

id
string
requis

Recommendation ID, prefixed reca_.

Paramètres de requête

account_id
string

Account ID, prefixed biz_. Defaults to the API key's own account.

Corps

application/json
input
string

No longer read: recommendations are written for the business as it changes. Up to 1000 characters.

Maximum string length: 1000
result_id
string

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.

Exemple:

"prod_xxxxxxxxxxxxx"

result_page
enum<string>

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. The recommendation's result_url becomes that page on the account's dashboard.

Options disponibles:
home,
products,
ads,
websites,
checkout_links,
tracking_links,
promo_codes,
payments,
customers,
affiliates,
analytics,
store_page
Exemple:

"promo_codes"

result_url
string

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.

Maximum string length: 2048
Exemple:

"https://atlas.whop.site/"

sentiment
enum<string>

A signed-in user can rate a recommendation as positive or negative. Can be sent alone or together with status.

Options disponibles:
positive,
negative
Exemple:

"positive"

status
enum<string>

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.

Options disponibles:
running,
executed,
incomplete,
superseded,
acknowledged
Exemple:

"superseded"

user_feedback
string

An optional explanation of the rating or rejection.

Maximum string length: 2000
Exemple:

" Focus on returning buyers "

Réponse

recommendation superseded

account_id
string | null
requis

ID of the account this recommendation is for, prefixed biz_, or null for personal onboarding.

Exemple:

"biz_xxxxxxxxxxxxxx"

acknowledged_at
string | null
requis

When the executed run was first marked as seen, as an ISO 8601 timestamp, or null if it has not been.

Exemple:

"2026-01-01T12:00:00.000Z"

action_type
string | null
requis

Type of action recommended, or null when no type is assigned. New values may be added; handle unknown types gracefully.

Exemple:

"add_cancel_offer"

ai_chat_id
string | null
requis

The chat that ran the recommendation, shown only to the user who ran it, or null otherwise.

Exemple:

"aich_xxxxxxxxxxxxxx"

created_at
string | null
requis

When the recommendation was created, as an ISO 8601 timestamp, or null for an unsaved recommendation.

Exemple:

"2026-01-01T12:00:00.000Z"

executed_at
string | null
requis

When the recommendation was carried out, as an ISO 8601 timestamp, or null if it has not been.

Exemple:

"2026-01-01T12:00:00.000Z"

expected_tool_calls
object[] | null
requis
id
string
requis

Recommendation ID, prefixed reca_, or create_business for an unsaved setup recommendation. Authenticate and list again before executing an unsaved recommendation.

Exemple:

"reca_xxxxxxxxxxxxxx"

input
string | null
requis

What you requested, in your own words, or null for recommendations generated without your input.

Exemple:

null

inputs
object[]
requis
prompt
string | null
requis

Step-by-step instructions for Whop AI, or null when no instructions are available.

Exemple:

"Create a 20% off promo code for my members."

reasoning
string | null
requis

Evidence and metrics supporting the recommendation, or null when no reasoning was provided.

Exemple:

"Capped 9 of 14 days."

result_url
string | null
requis

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.

Exemple:

"https://atlas.whop.site/"

run_by_user_id
string | null
requis

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.

Exemple:

"user_xxxxxxxxxxxxxx"

run_ended_at
string | null
requis

When the run ended, whether executed or incomplete, as an ISO 8601 timestamp, or null if it has not ended.

Exemple:

"2026-01-01T12:00:00.000Z"

run_started_at
string | null
requis

When the run started, by Whop AI or the recommendation's API calls, as an ISO 8601 timestamp, or null if it has not run.

Exemple:

"2026-01-01T12:00:00.000Z"

sentiment
enum<string> | null
requis

How the user rated this recommendation, or null if they have not rated it

Options disponibles:
positive,
negative,
null
Exemple:

"positive"

status
enum<string>
requis

queued when awaiting generation; pending while generating or preparing its work; ready when available to run; running while Whop AI or the recommendation's API calls carry it out; executed when carried out; incomplete when the run ended without carrying it out; superseded when rejected or replaced.

Options disponibles:
queued,
pending,
ready,
running,
executed,
incomplete,
superseded
Exemple:

"executed"

superseded_at
string | null
requis

When the recommendation was rejected or replaced, as an ISO 8601 timestamp, or null if neither has occurred.

Exemple:

"2026-01-01T12:00:00.000Z"

title
string | null
requis

Recommended action and its expected benefit, or null until generated.

Exemple:

"Move $180 from 3 dead ad groups into BATCH#3, +1.7x return"

user_feedback
string | null
requis

The user's written feedback, or null if they have not provided any.

Exemple:

null

target_url
string | null

Website URL selected for pixel setup, or null when no website was captured for this recommendation.

Exemple:

"https://example.com/join"