Sign in
Economic Intelligence

Update Recommendation

Updates a recommendation status, records feedback, or both. Send sentiment to rate it. Include status: superseded to retire it and request replacements; a rating alone leaves its status unchanged.

patch/economic_intelligence/{id}

Request body

inputstring

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.

sentiment'positive' | 'negative'

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

status'executed' | 'superseded'

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

user_feedbackstring

An optional explanation of the rating or rejection. Negative feedback informs replacement recommendations.

Example request

{
  "input": "Focus on returning buyers instead",
  "sentiment": "positive",
  "status": "superseded",
  "user_feedback": "Wrong audience"
}

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.

sentiment'positive' | 'negative' | 'null' nullable required

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

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.

user_feedbackstring nullable required

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

Example response

{
  "account_id": "biz_xxxxxxxxxxxxxx",
  "action_type": "scale_winning_ads",
  "created_at": "2026-01-01T12:00:00.000Z",
  "executed_at": "2026-01-01T12:00:00.000Z",
  "expected_tool_calls": [
    {
      "description": "Increase the summer campaign budget",
      "tool_name": "updateAdCampaign"
    }
  ],
  "id": "reca_xxxxxxxxxxxxxx",
  "input": "more sales from ads",
  "prompt": "Create a 20% off promo code for my members.",
  "reasoning": "Capped 9 of 14 days.",
  "sentiment": "positive",
  "status": "ready",
  "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

Changed in 6 of the 74 revisions of this API.2110

  • 7fcefabddb0a1See the full diff
    • ○

      added the new optional request property

      new-optional-request-property

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 140d015b99661See the full diff
    • ○

      added the required property to the response with the status

      response-required-property-added

  • 076176906e3f15See the full diff
    • ●

      removed the request property

      request-property-removed

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      the request property became optional

      request-property-became-optional

    • ○

      added the required property to the response with the status

      response-required-property-added

    • ○

      added the required property to the response with the status

      response-required-property-added

  • ef86d14ef6911See the full diff
    • ○

      added the optional property to the response with the status

      response-optional-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • ff3a7657356321See the full diff
    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ○

      added the required property to the response with the status

      response-required-property-added

  • c19acf2e25481See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 74 revisions, 1 has no diff computed.