Skip to main content
AI Agents run on a schedule to generate content ideas grounded in your knowledge base, then create post drafts — or publish immediately. Configure once and get a steady stream of on-brand content without manual effort.

​
How It Works

1

Agent triggers

Scheduler polls agents due to run. Supports daily, weekly, or manual triggers with a configurable time window and timezone.
2

Knowledge retrieval

Agent queries your knowledge base using vector similarity and graph traversal, then assembles a grounded context prompt.
3

LLM generation

AI generates structured ideas — each with title, hook, angle, target platform, and virality score.

​
Create an Agent

curl -X POST https://app.autoposting.ai/api-proxy/agents \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Weekly LinkedIn Insights",
    "type": "publish",
    "brandSlug": "brand_slug",
    "kbId": "kb_id",
    "frequency": "weekly",
    "weekday": "mon",
    "time": "09:00",
    "timezone": "America/New_York",
    "platforms": ["linkedin"],
    "postsPerRun": 3,
    "autoPublish": false
  }'

​
Configuration Reference

FieldTypeDescription
typepublish | researchpublish creates post drafts; research generates ideas only
frequencymanual | daily | weeklyRun schedule
time / timeEndHH:MMTime window in 24h format
weekdaymon–sunDay of week (weekly agents only)
contentSourcekb | news | bothIdea sourcing — KB, trending news, or both
postsPerRun1–50Ideas or posts to generate per run
autoPublishbooleanPublish immediately vs. create as draft
promptstringCustom instructions (20–1,000 chars)
writingStylestringWriting style guide (up to 4,000 chars)
notifyEmailbooleanEmail notification after each run

​
Tone Presets

concise · playful · professional · thought-leader · casual · storyteller · breaking-news · controversial · product-launch · educational · inspirational · satirical

​
Trigger Manually

Run an agent immediately regardless of its schedule: 
curl -X POST https://app.autoposting.ai/api-proxy/agents/:id/run-now \
  -H "Authorization: Bearer sk_your_api_key"

​
Run Statuses

StatusDescription
pendingQueued, not yet started
runningLLM pipeline executing
succeededAll requested posts or ideas created
partialSome artifacts succeeded, some failed
failedAll artifacts failed
When an organization’s subscription is suspended, all running agents are automatically paused and resume within one minute of billing being restored.

Knowledge Base

Upload documents to ground agents in proprietary knowledge.

Brands

Agents inherit brand timezone and connected accounts.

Posts

Agent-created drafts enter the standard post publishing pipeline.

API Reference

Full endpoint reference for agent management and run history.