Skip to main content
The Apps API is in beta. Its endpoints and responses may change.
These endpoints generate social content that promotes an app. Base44 reads the app, asks you a few questions about how you want to promote it, turns your answers into a content strategy, and writes a set of posts and images for each platform you approve.

​
Prerequisites

  • A personal access token. See Authentication to get one.
  • An app you can edit, and workspace credit quota for the endpoints that charge.

​
App ID

Endpoints that act on a specific app include the app’s ID in the URL path as app_id. To get your app ID:
  1. Go to app.base44.com.
  2. Open your app in the app editor.
  3. Copy the app ID from the editor URL, "https://app.base44.com/apps/<app_id>/editor".

​
Content plans

A content plan is a set of suggested posts for the app, one platform at a time, each with its own text and a recommended time to post it. Generate content plan drafts one. A plan on its own is a draft, and generating one doesn’t publish anything. Refining the strategy or generating a new plan replaces the old one.

​
Generate a content plan

The endpoints run in order, and most of them refuse to run when the app has not reached the stage they need.
  1. Start social content flow analyzes the app and returns 2 or 3 questions.
  2. Submit answers turns your answers into a content strategy.
  3. Refine content strategy rewrites that strategy from your feedback, as many times as you need.
  4. Generate content plan writes the posts for every platform you approved.
  5. Refine a post and Update post content change a single post, and Generate a post image makes its image.
Get social content state returns where the app is at any point. An app that never started the flow reports a stage of idle, not an error. Reset social content flow clears everything so you can start over.
Refining the strategy discards the app’s existing content plan, including every post and every generated image. Refine before you generate a plan, not after.

​
Generation timing

Generate content plan runs the whole generation inline, one language model call per platform plus the first platform’s images, so it can take several minutes with 3 platforms. Use a long client timeout. Only the first platform’s images are generated inline. Poll Get social content state after the call returns to pick up the remaining image_url values as they finish.

​
Credits

Generating a content plan typically costs ~10 credits. Refining a post and generating an image cost ~1 credit each. Reading state, updating a post’s text, starting the flow, and working on the strategy cost nothing. An endpoint that charges refuses to run when the workspace is out of quota, and a reset does not refund credits already spent.

​
Rate limits

The social content endpoints (the flow that generates a plan) share a limit of 15 requests per minute per app.

​
Endpoints