Content

Queue rendered content production

Queues a rendered batch in any Content Studio format and returns before generation finishes. Poll /content/jobs/{jobId}; job status moves queued → generating → ready_for_review | completed | partially_failed (or canceled). Pieces carry signed output URLs once status is ready. Each piece uses one render from the plan's monthly render budget (GET /usage); a job needing more renders than remain is refused with 402.

post/content/jobs

Request

  • Base URL: https://app.getprolifik.com/api/v1
  • URL: https://app.getprolifik.com/api/v1/content/jobs
  • Auth: HTTP bearer

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

brandIdstring uuid required
contentSourceIdstring uuid

A ready content source to write from. Omit to write from the brand context alone.

format'carousel' | 'kinetic-type' | 'scene-swap' | 'b-roll' | 'caption-card' | 'talking-head' required

carousel = Image Carousel, kinetic-type = Text Story, scene-swap = Meme Reaction, b-roll = Clip Montage, caption-card = Caption Meme, talking-head = Video Hook & Demo (requires demoVideoKey).

demoVideoKeystring

talking-head only, and required there. Key of the product recording that plays after the hook: a video from GET /content/media (the user's media library) or a key from POST /content/uploads. Must be an mp4, mov or webm of at most 100 MB and 60 seconds.

hookVideoKeystring

talking-head only, optional, at most 15 seconds. Your own hook clip: a video key from GET /content/media (e.g. an AI Studio talking head) or an upload key from POST /content/uploads. Omit it and each piece gets a library hook clip.

countinteger
deliveryMode'download' | 'schedule'

Intent only; pieces are published explicitly through /content/pieces/{pieceId}/publish either way.

includeLogoboolean
mentionBrandboolean

Response

Content job accepted

object required

Changes

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