AI Agents

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

Agent triggers

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

Knowledge retrieval

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

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
  }'

const res = await fetch("https://app.autoposting.ai/api-proxy/agents", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk_your_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    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,
  }),
});
const { data } = await res.json();

Configuration Reference

Field	Type	Description
`type`	`publish` \| `research`	`publish` creates post drafts; `research` generates ideas only
`frequency`	`manual` \| `daily` \| `weekly`	Run schedule
`time` / `timeEnd`	`HH:MM`	Time window in 24h format
`weekday`	`mon`–`sun`	Day of week (weekly agents only)
`contentSource`	`kb` \| `news` \| `both`	Idea sourcing — KB, trending news, or both
`postsPerRun`	1–50	Ideas or posts to generate per run
`autoPublish`	boolean	Publish immediately vs. create as draft
`prompt`	string	Custom instructions (20–1,000 chars)
`writingStyle`	string	Writing style guide (up to 4,000 chars)
`notifyEmail`	boolean	Email 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

Status	Description
`pending`	Queued, not yet started
`running`	LLM pipeline executing
`succeeded`	All requested posts or ideas created
`partial`	Some artifacts succeeded, some failed
`failed`	All 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.

Getting Started

Core Concepts

How It Works

Create an Agent

Configuration Reference

Tone Presets

Trigger Manually

Run Statuses

Knowledge Base

Brands

Posts

API Reference

​How It Works

​Create an Agent

​Configuration Reference

​Tone Presets

​Trigger Manually

​Run Statuses

Knowledge Base

Brands

Posts

API Reference

How It Works

Create an Agent

Configuration Reference

Tone Presets

Trigger Manually

Run Statuses