Submit answers

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

Submits your answers to the questions from Start social content flow and returns a content strategy to review.

Key each answer by the question id. Send social_url to match the writing voice of your own social profile. Answers replace any previously submitted for the app, and generating a new strategy discards the previous one. This endpoint fails with a 409 while a content plan is generating.

Accept the strategy by calling Generate content plan, or change it first with Refine content strategy.

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/submit-answers

Path parameters

app_idstring required

ID of the app.

ID of the app.

Request body

answersobject required

Your answers, keyed by the id of each question returned by Start social content flow. Send at most 10. Answers longer than 2000 characters are truncated, and a key containing $ or . or longer than 200 characters is dropped.

social_urlstring nullable

HTTPS URL of your social profile, used to match the writing voice of the generated content. Omit it to skip voice matching.

Example request

{
  "answers": {
    "goal": "Get the first 100 users",
    "target_audience": "Freelance designers"
  },
  "social_url": "https://x.com/yourhandle"
}

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