# Automate10x — Agentic Publishing API

> Give us text (or a URL to research), a list of destinations, and optional
> media. We return a job you can poll, and we publish everywhere.

Base URL: https://automate10x.com
Auth: Authorization: Bearer sk_...   (never trim trailing '=')
Errors: one envelope { "error": { type, code, message, field?, docs, requestId } }
Docs (full): https://automate10x.com/llms-full.txt
OpenAPI: https://automate10x.com/openapi.json
Human docs: https://automate10x.com/docs/api

## Start here (agents call these first)
- GET  /api/v2/users/me          verify the key; returns plan, credits, scopes.
- GET  /api/v2/capabilities      per-platform char limits, media rules, required
                                 fields, AND your connected accounts + channel ids.

## The publish envelope (one call, many destinations)
POST /api/v2/posts
{
  "text": "default text for every target",
  "media": ["https://cdn.example.com/launch.png"],
  "targets": [
    { "accountId": "acc_x" },
    { "accountId": "acc_linkedin", "options": { "pageId": "pg_9" } },
    { "accountId": "acc_tiktok", "media": ["https://.../v.mp4"],
      "options": { "privacyLevel": "PUBLIC_TO_EVERYONE", "title": "Launch" } }
  ],
  "schedule": { "mode": "now" }            // or {"mode":"at","time":"<ISO>"}
}
-> { jobId, status, targets[], poll: "/api/v2/posts/<jobId>" }

Add ?dryRun=true to validate every target against /capabilities and queue nothing.
Send header  Idempotency-Key: <uuid>  to make retries safe (replayed for 24h).

## Poll
GET /api/v2/posts/<jobId>
-> status: queued|running|completed|partially_failed|failed; per-target url/error.

## Research feedstock
POST /api/v2/sources { brandId, type, url|query|content }  (type: article, youtube,
     tiktok, pdf, audio, perplexity, text — "article" for any web URL; text resolves
     immediately) -> resolved content for generation.

## Lists (cursor pagination is opt-in via ?limit / ?cursor)
- GET /api/v2/accounts          connected accounts (+ ids).
- GET /api/v2/scheduled-posts   filters: status, platform, jobId, from, to.
- GET /api/v2/published-posts    live posts with permalinks.

## If you support MCP, prefer the MCP server (tools auto-poll to a settled result).