---
title: "Refine content strategy"
method: POST
path: "/api/apps/{app_id}/virality/refine-strategy"
---

# Refine content strategy

`POST /api/apps/{app_id}/virality/refine-strategy`

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Rewrites the current content strategy according to your feedback and returns the new version. Call it as many times as you need before generating a content plan.

Submit answers first. This endpoint fails with a 409 unless the app already has a strategy, and while a content plan is generating.

<Warning>Refining the strategy discards the app's existing content plan, including every post and every generated image. Refine before you call [Generate content plan](/api-reference/generate-content-plan), not after.</Warning>

This endpoint calls a language model, so expect it to take a few seconds. It shares a limit of 15 requests per minute with the other social content endpoints.

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time. Send only the fields documented here. Other request fields are not supported and their behavior can change.</Warning>

## Path parameters

- `app_id` string, required — ID of the app.

## Request body

- RefineStrategyPayload
  - `feedback` string, required — What to change about the current strategy, in your own words. Can't be empty.

## Response `200`

Successful Response

- StrategyResponse — The app's social content strategy after the change.
  - `strategy_text` string — The content strategy, written as prose for you to review. Refine it with [Refine content strategy](/api-reference/refine-content-strategy), or accept it and call [Generate content plan](/api-reference/generate-content-plan).

## Other responses

- `400` — The `feedback` field is empty.
- `401` — Missing or invalid credentials.
- `403` — You don't have editor access to this app, or you used a workspace API key.
- `404` — App not found, the app has no social content state yet, or the social content feature is not enabled for your account.
- `409` — The app has no strategy to refine yet, or a content plan is currently generating.
- `422` — Validation Error
- `429` — Rate limit exceeded (15 requests per minute).
- `500` — Refining the strategy failed. Retry the request.

## Changes

- **2026-08-25** `8dfd9c46c0b9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/idealspot/apis/base44-app-management-api/changes/api/apps/:app_id/virality/refine-strategy/post.md)

---

[API](https://skmtc.dev/idealspot/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/idealspot/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idealspot/base44-app-management-api/revisions/394136a6cdd4/schema)