Accounts
Read and rename connected social accounts.
Connecting and disconnecting accounts are not part of the API. Connecting requires an OAuth browser flow, and disconnecting revokes the grant at YouTube or TikTok — a destructive action outside BotLobby that would need a browser re-authorization to undo. Both live in the web app at botlobby.ai.
Introduction
Generate short-form video from a script and publish it to connected
Account
Account
Accounts
Accounts
API Keys
API Keys
Contents
Contents
Create content
Creates a content item and generates its script. This spends credits,
Create a persona
`text_ai` and `audio_ai` are credential ids. Which models you may use
Delete content
Soft delete. The row stops appearing in every read path and any running
Delete a persona
**Permanent.** Unlike content, which is soft-deleted, a persona is
Generate a voiceover
Generates the narration for a content item. Asynchronous — poll
Render a video
Renders the final video from a content item that already has audio.
Generation
Generation
Get an account
Get an account
Get content
Returns a **richer shape than the list endpoint**: it adds `textover`,
Get credit balance
Your current balance. Spend against `total_credits` — it is the sum of
Get current plan
Your active subscription, trial state and usage summary. Per-plan limit
Get a persona
Get a persona
Poll generation status
The current state of a content item's generation.
Validate a key
Confirms a key is live and reports its owner and scopes. Any valid key
List connected accounts
The social accounts you have connected. Use the `id` values here to
List content versions
Snapshots kept each time a content item's script, audio or video was
List content
Your content items, newest first.
List personas
Your personas, with the pricing-relevant flags the picker uses.
List stock backgrounds
The pre-supplied background clips you can render against. Passing one
Personas
Personas
Generate and optionally publish in one call
Runs the whole pipeline for a content item: audio, then video, then —
Publish to social accounts
Dispatches the rendered video to the selected connected accounts.
Publishing
Publishing
schemas
11 items
Rename an account
Only the display name is editable.
Update content
Editing resets `status` to `NEW`, discarding any rendered output. If a
Update a persona
Every field is optional; send only what changes. The same plan limits