Sign in
Economic Intelligence

Update Recommendation

Approves or rejects a recommendation and requests replacements.

patch/economic_intelligence/{id}

Request body

reasonstring

Why the recommendation was rejected. Used as feedback when replenishing recommendations.

status'executed' | 'superseded' required

Use executed to record approval, or superseded to reject the recommendation.

Example request

{
  "reason": "Wrong audience",
  "status": "superseded"
}

Response

recommendation superseded

account_idstring nullable required

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

action_typestring nullable required

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

ai_chat_idstring nullable required

The chat to resume after its initial message is accepted, or null before a chat is ready.

created_atstring nullable required

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

executed_atstring nullable required

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

idstring required

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

inputstring nullable required

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

promptstring nullable required

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

reasoningstring nullable required

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

status'queued' | 'pending' | 'ready' | 'executed' | 'superseded' required

queued when awaiting generation; pending while generating; ready when available for approval; executed when approved; superseded when rejected or replaced.

superseded_atstring nullable required

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

target_urlstring nullable

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

titlestring nullable required

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

Example response

{
  "account_id": "biz_xxxxxxxxxxxxxx",
  "action_type": "cut_losing_ad_spend",
  "created_at": "2026-01-01T12:00:00.000Z",
  "executed_at": "2026-01-01T12:00:00.000Z",
  "id": "reca_xxxxxxxxxxxxxx",
  "input": "Grow revenue",
  "prompt": "Create a 20% off promo code for my members.",
  "reasoning": "Revenue fell by 20%.",
  "status": "superseded",
  "superseded_at": "2026-01-01T12:00:00.000Z",
  "target_url": "https://example.com/join",
  "title": "Move $180 from 3 dead ad groups into BATCH#3, +1.7x return"
}

Changes