API resource

Agent Posts

Hand the agent a finished vertical video and it does the rest: transcribes it, writes the copy for every network (Smarty's brand memory steers it), books the next free posting slot, renders a version per network (9:16 for Reels, TikTok and Shorts, 720p for X, 4:5 for LinkedIn) and schedules one post to every connected video account. With a resource_urlit also arms a comment-to-DM funnel on Instagram and Facebook. Anything you send (caption, title, keyword, cover, time) is used instead of the agent's. Any active plan.

Post a finished video

POST/v1/agent-posts

Queues the video; it takes a few minutes. Poll GET /v1/agent-posts/{jobId} until status is scheduled, published, held or failed.

Body

video_urlstringrequired

The finished video: a med_ id from POST /v1/media or an https URL.

captionstring

Your caption (the agent writes one per network otherwise).

titlestring

YouTube title.

platformsstring[]

Only these networks: instagram, tiktok, youtube, facebook, twitter, threads, linkedin.

account_idsstring[]

Only these accounts (acc_ ids).

scheduled_forstring

ISO 8601, 5 minutes to 90 days ahead. Default: the next free slot.

cover_urlstring

Cover image (med_ id or https URL). Default: painted from your brand photos.

resource_urlstring

The link for the comment-to-DM funnel (Instagram and Facebook).

keywordstring

The comment keyword for the funnel.

dm_notestring

What the DM should say about the link.

trial_reeltrue | "manual" | "auto"

Post the Instagram Reel as a Trial Reel.

virality{ mode, threshold }

mode "score" scores it before posting; "gate" holds it (status held) when it scores under threshold (default 70).

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/agent-posts" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "med_b0Wq7Yx2Rk9LzT4nVs1Pc8Hf3Jd6Gm5Ea2Uo7Ki9Nr0",
    "resource_url": "https://example.com/guide",
    "virality": {
      "mode": "score",
      "threshold": 70
    }
  }'
Response 201
{
  "job": {
    "id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
    "status": "queued",
    "step": "queued",
    "scheduledFor": null
  }
}

Get an Agent Post

GET/v1/agent-posts/{jobId}

Status, step, error, the copy per network (caption, youtubeTitle, twitterCaption, linkedinCaption, threadsCaption, dmText), scheduledFor, the cover, per-network renders (formats) and viralityCheck.

Path parameters

jobIdstringrequired

The Agent Post id.

curl "https://creatoros-production-5658.up.railway.app/v1/agent-posts/3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "job": {
    "id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
    "status": "scheduled",
    "keyword": "GUIDE",
    "scheduledFor": "2026-11-19T23:00:00.000Z",
    "viralityCheck": {
      "status": "done",
      "score": 81,
      "verdict": "post"
    }
  }
}

List Agent Posts

GET/v1/agent-posts

The workspace's Agent Posts, newest first, with targets (the accounts it posts to), next_slot and the saved defaults (GET / PUT /v1/agent-posts/defaults). POST /v1/agent-posts/{jobId}/retry runs a failed one again, /release posts a held one anyway, DELETE removes one (a scheduled post is taken off the schedule).

curl "https://creatoros-production-5658.up.railway.app/v1/agent-posts" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "jobs": [
    {
      "id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
      "status": "scheduled"
    }
  ],
  "targets": [
    {
      "platform": "instagram",
      "accountId": "acc_..."
    }
  ],
  "next_slot": "2026-11-19T20:00:00.000Z"
}