Autonomous growth agents
An autonomous growth agent is an AI helper you set up once. From then on, it keeps drafting and lining up new posts for you on a schedule you choose — and it learns from the posts that performed best so each batch gets a little better.
You stay in control. Every post the agent makes can wait for your review before it ever goes live.
Who it's for
- Busy creators who want a steady stream of posts without writing every one by hand.
- Small teams that want to keep their accounts active even on weeks no one has time.
- Anyone who has a clear topic or voice in mind and wants help turning it into a regular posting habit.
What you can do
- Set up a helper once and let it draft fresh posts for you on a repeating schedule.
- Let it learn from your best-performing posts so new drafts match what your audience already likes.
- Add an image, a full branded design, or a short vertical video to each post automatically.
- Choose how hands-off you want to be — review every post yourself, or let approved posts go out on their own.
- Turn one idea into a whole stretch of scheduled posts in a single step with the campaign helpers.
- Start from a ready-made recipe instead of building a helper from scratch.
Getting started
Open your agents
Go to the AI agents screen. This is where you create helpers and see what they've drafted.
See AI agents for a full walkthrough.
Describe the helper
Give it a name, a topic or voice to stick to, the accounts it should post for, and how often it should run.
Pick your comfort level
Decide whether every post waits for your approval, or whether approved posts can publish on their own. You can change this any time.
Review and approve
When the agent runs, its drafts show up for you to read, tweak, and approve. Nothing your audience sees goes out without passing your rules first.
TIP
Start with the most cautious setting, where every post waits for your approval. Once you trust the drafts, you can let the agent do more on its own.
For developers
All endpoints below are mounted under the API prefix (/api/v1) and require ai.agents on an active subscription, except for read-only list/get routes.
AI Agents
An AI Agent (ai_agents collection) is a persistent, scheduled worker. You define its identity and cadence; it produces post drafts on a cron schedule in its own timezone.
| Endpoint | Method | Purpose |
|---|---|---|
/ai-agents | GET | List your agents |
/ai-agents | POST | Create an agent |
/ai-agents/:id | GET / PATCH / DELETE | Read, update, delete |
/ai-agents/:id/run | POST | Trigger a run now (manual) |
/ai-agents/:id/runs | GET | Run history (agent_runs) |
Each agent carries a name, role, persona, system_prompt, schedule_cron, timezone, target accounts, posts_per_run (1–10), daily_limit (1–50), and an optional brand_id. When brand_id is set the agent's voice and media are locked to that brand; otherwise it falls back to the workspace default brand kit. The bound brand's voice and persona are injected into the system prompt on every run.
Closed-Loop Learning
Before generating, each run pulls the agent owner's first-party analytics and feeds them back into the prompt:
- Best-Format Oracle (
getFormatRecommendation) — your best-performing style, an optional caption-length hint, and your highest-engagement network. - Top posts (
getTopPosts, 3 most recent winners) — captions to emulate, not copy.
It also passes the last 5 posts so the agent avoids repeating themes. Analytics are optional: if none exist, the agent still runs without feedback.
Approval Autopilot
autonomy_level decides what happens to each generated post:
| Level | Behavior | Post state |
|---|---|---|
| 0 | Draft only — held for you to approve + schedule | status: 0, pending_review |
| 1 | Auto-scheduled but held for approval | status: 1, pending_review |
| 2 | Auto-publish within guardrails | status: 1, approved |
When AI disclosure is enabled for the workspace, the disclosure label is appended automatically.
Per-agent media
An agent can attach generated media to each draft:
generate_image— an AI image (prompt derived from the caption, with auto alt-text).generate_design— a full brand-locked design; the hero image is attached and an editable design document is saved.generate_video— the Autonomous Reel Agent: caption → branded 9:16.mp4(image + persona narration viavoice+ burned captions) attached to the draft.
Campaign Director
POST /ai/campaign-director turns one brief into a cohesive, scheduled run of N captions in a single LLM pass. Body: topic, accountIds, optional durationDays, postsPerWeek, autonomyLevel, withImage, language. Posts are spread across the period and created at the chosen autonomy level. Cost: 10 credits. Output is capped at 6 posts with images, 20 without.
Campaign Co-Pilot
POST /ai/campaign-co-pilot extends the Director: per slot it composes a brand-locked design + image + caption, ties every post to a PostCampaigns batch in pending_review, and returns the campaign id. Review the batch with GET /ai/campaign-co-pilot/:campaignId. Body adds brandId and preset (square / portrait / story). Capped at 6 composed posts; ~5 credits per composed post.
Agent Recipe Catalog
The catalog is install-only — no selling or payment.
| Endpoint | Method | Purpose |
|---|---|---|
/catalog/agent-recipes | GET | Browse published recipes |
/catalog/agent-recipes/publish | POST | Publish one of your agents as a recipe |
/catalog/agent-recipes/:id/install | POST | Install a recipe |
Publishing packages an agent's persona, prompt, cadence, and media flags (no live state). Installing clones it into a new inactive agent bound to your brandId and accountIds, then increments the recipe's install count. You review and activate it from the agents page.