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
/v1/agent-postsQueues the video; it takes a few minutes. Poll GET /v1/agent-posts/{jobId} until status is scheduled, published, held or failed.
Body
video_urlstringrequiredThe finished video: a med_ id from POST /v1/media or an https URL.
captionstringYour caption (the agent writes one per network otherwise).
titlestringYouTube title.
platformsstring[]Only these networks: instagram, tiktok, youtube, facebook, twitter, threads, linkedin.
account_idsstring[]Only these accounts (acc_ ids).
scheduled_forstringISO 8601, 5 minutes to 90 days ahead. Default: the next free slot.
cover_urlstringCover image (med_ id or https URL). Default: painted from your brand photos.
resource_urlstringThe link for the comment-to-DM funnel (Instagram and Facebook).
keywordstringThe comment keyword for the funnel.
dm_notestringWhat 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
}
}'{
"job": {
"id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
"status": "queued",
"step": "queued",
"scheduledFor": null
}
}Get an Agent Post
/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
jobIdstringrequiredThe 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"{
"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
/v1/agent-postsThe 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"{
"jobs": [
{
"id": "3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9",
"status": "scheduled"
}
],
"targets": [
{
"platform": "instagram",
"accountId": "acc_..."
}
],
"next_slot": "2026-11-19T20:00:00.000Z"
}