Refine content 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, 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>

post/api/apps/{app_id}/virality/refine-strategy

Path parameters

app_idstring required

ID of the app.

ID of the app.

Request body

feedbackstring required

What to change about the current strategy, in your own words. Can't be empty.

Example request

{
  "feedback": "Focus on freelancers rather than agencies, and keep the tone less formal."
}

Response

Successful Response

strategy_textstring

The content strategy, written as prose for you to review. Refine it with Refine content strategy, or accept it and call Generate content plan.

Example response

{
  "strategy_text": "Lead with the spreadsheet pain your audience already feels, then show the app solving it in one screen."
}

Changes

Changed in 1 of the 11 revisions of this API.1