> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Submit answers
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
Submits your answers to the questions from [Start social content flow](/api-reference/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](/api-reference/generate-content-plan), or change it first with [Refine content strategy](/api-reference/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.
This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.
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.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json post /api/apps/{app_id}/virality/submit-answers
openapi: 3.1.0
info:
title: Base44 App Management API
version: 1.0.0
servers:
- url: https://app.base44.com
security:
- ApiKeyAuth: []
paths:
/api/apps/{app_id}/virality/submit-answers:
post:
summary: Submit answers
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
Submits your answers to the questions from [Start social content
flow](/api-reference/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](/api-reference/generate-content-plan), or change it first with
[Refine content strategy](/api-reference/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.
This endpoint accepts a personal API key. Workspace API keys are
not authorized for it and are rejected with a 403.
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.
operationId: submit_answers_api_api_apps__app_id__virality_submit_answers_post
parameters:
- name: app_id
in: path
required: true
schema:
type: string
description: ID of the app.
title: App Id
description: ID of the app.
example: 6820f3a4e7b91d003c45a1f2
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SubmitAnswersPayload'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/StrategyResponse'
'400':
description: The request is invalid.
'401':
description: Missing or invalid credentials.
'403':
description: >-
You don't have editor access to this app, or you used a workspace
API key.
'404':
description: >-
App not found, or the social content feature is not enabled for your
account.
'409':
description: A content plan is currently generating for this app.
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
'429':
description: Rate limit exceeded (15 requests per minute).
'500':
description: Generating the strategy failed. Retry the request.
components:
schemas:
SubmitAnswersPayload:
properties:
answers:
additionalProperties:
type: string
type: object
title: Answers
description: >-
Your answers, keyed by the `id` of each question returned by [Start
social content flow](/api-reference/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.
example:
goal: Get the first 100 users
target_audience: Freelance designers
social_url:
anyOf:
- type: string
maxLength: 500
- type: 'null'
title: Social Url
description: >-
HTTPS URL of your social profile, used to match the writing voice of
the generated content. Omit it to skip voice matching.
example: https://x.com/yourhandle
type: object
required:
- answers
title: SubmitAnswersPayload
StrategyResponse:
properties:
strategy_text:
type: string
title: Strategy Text
description: >-
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).
default: ''
example: >-
Lead with the spreadsheet pain your audience already feels, then
show the app solving it in one screen.
type: object
title: StrategyResponse
description: The app's social content strategy after the change.
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: api_key
description: Personal API key.
````