Cloning

Schedule different variations across accounts

Spreads DIFFERENT variations of one cloning job across the brand's social accounts at staggered times. Every account gets its own variation and the same variation is never posted to two accounts: a variation that already has a live or published post is refused (409) unless the entry is identical to it, in which case it is reported as alreadyScheduled and nothing is sent again. Surplus variations go out on the next day(s), one per account per day, and an account-day that already has a post from this job (an earlier distribute, a retry after a partial failure) is skipped — an entry landing on one is refused with 409 unless it is that identical post. Originals are handed out before translated variations; languages narrows a server plan to some of them. Send either an explicit plan, or socialAccountIds + startAt (+ spacingMinutes, jitterMinutes, languages) for the server to plan with the same rules the dashboard previews (seeded on the job, UTC days unless timeZone is given); accounts that cannot take any variation (a carousel to YouTube, a locked or disconnected account) are returned under excluded. The whole plan is validated before anything is scheduled — ownership, the job's brand (a plan-locked brand is a 402), rendering, platform compatibility, duplicates, one post per account per day, the time window and the monthly video quota. One distribute per job runs at a time (409 in_progress). Each post uses the variation's own caption and hashtags. A dispatch failure after validation is reported per entry. Requires publish:write and an Idempotency-Key.

post/cloning/jobs/{jobId}/distribute

Request

  • Base URL: https://app.getprolifik.com/api/v1
  • URL: https://app.getprolifik.com/api/v1/cloning/jobs/{jobId}/distribute
  • Auth: HTTP bearer

Path parameters

jobIdstring uuid required

Headers

Idempotency-Keystring required

Unique retry key retained for 24 hours. Replays return the original response with X-Idempotent-Replayed: true; reuse with different request data returns 409.

Request body

socialAccountIdsstring[]

Server-planned mode, in stagger order.

startAtstring date-time

Server-planned mode: when the first account posts.

spacingMinutesinteger
jitterMinutesinteger

Each time moves by up to ± this many minutes, deterministically per job and account.

languagesstring[]

Server-planned mode only: which variations to hand out — "original" for the untranslated ones, or translation language codes. Omitted: originals first, translations only once the originals run out.

timeZonestring

IANA time zone the one-post-per-account-per-day rule (and a server plan's next-day surplus) is counted in, e.g. Europe/Vilnius. Default UTC.

Response

Per-entry results

scheduledinteger required
failedinteger required
accountsinteger required

Distinct accounts with a post from this request.

accountsWithoutVariationstring[]

Server-planned mode: accounts left over because the variations ran out.

Changes

No recorded changes to this operation across all 1 revision of this API.