ap post

Use ap post for one-off posts and operational fixes. For week-long or month-long plans, prefer calendar.json plus ap calendar sync --dry-run.

Create a post

ap post [content] [options]

ap post is an alias for ap post create.

Create options

Option	Description
--connection <ids>	Target connection(s) — comma-separated IDs or platform names (twitter,linkedin)
--all	Post to all connections in the project
--media <path>	Attach an image or video
--media-id <id>	Attach an existing Agenda Panda media item by ID or filename
--media-url <url>	Attach an existing hosted media URL
--schedule <iso>	Schedule for later; accepts UTC or an offset and normalizes it
--now	Publish immediately (default)
--project <id>	Override the active project
--json	Output JSON result

Examples

# Post immediately
ap post "Just shipped v2.0!"

# Post to ALL connected platforms at once
ap post "Hello everywhere!" --all

# Post to specific platforms
ap post "Check this out" --connection twitter,linkedin

# Post with an image
ap post "Check out our new feature" --media screenshot.png

# Reuse generated media from the library
ap post "Launch visual" --media-id abc12345
ap post "Launch visual" --media-url https://agendapanda.com/api/media/abc12345.png

# Schedule for later
ap post "Coming soon" --schedule 2026-03-15T14:00:00Z
ap post "11am Santiago time" --schedule 2026-03-15T11:00:00-03:00

# Pipe content from stdin
echo "Hello world" | ap post --now

Interactive mode

Run ap post create (or just ap post with no flags) to get an interactive wizard:

1. Select connections — pick one, multiple (comma-separated), or “all”
2. Write content — multi-line editor with character limit awareness
3. Choose timing — post now or schedule for later (local timezone)

ap post create

Manage existing posts

ap post list
ap post list --date 2026-04-17
ap post list --from 2026-04-17 --to 2026-04-18
ap post get <id>
ap post update <id> --content "Updated copy" --schedule 2026-05-01T14:00:00Z
ap post update <id> --remove-media
ap post retry <id>
ap post delete <id>

ap post list supports day and range filters so you can inspect upcoming schedules without opening the dashboard.

Multi-platform posting and results

When posting to multiple connections, each post is created in parallel. Results are reported per-connection:

✓ Posted to X (@acmecorp)
  https://x.com/acmecorp/status/1893...
✓ Posted to LinkedIn (Acme Corp)
✓ Posted to Threads (@acmecorp)
  3/3 succeeded.

In JSON mode, multi-post returns { "success": true, "items": [...] }.

Connect on first post

If you have no connections and run ap post, the CLI will offer to connect a platform inline — no need to run a separate ap connections add first.

AI media workflow

For one-off posts, generate or edit media first, then attach it directly:

ap media generate "cinematic product hero shot" --aspect 16:9
ap post "Shipping today" --media-id abc12345

For calendar-based workflows, use the hosted HTTPS URL returned by the media command inside calendar.json.

Notes

• Instagram and TikTok require media.
• ap post can surface brand lint warnings after create or update.
• In automation, prefer explicit --project and --connection flags instead of relying on global defaults.