guided-workflow

Finalize Social Video Campaigns

Finalize reviewed social video drafts, then generate deferred non-video social posts.

post/api/guided-workflow/social-campaigns/generate-videos

Request

  • Base URL: https://api.usepomo.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.usepomo.ai/api/guided-workflow/social-campaigns/generate-videos
  • Auth: HTTP bearer

Request body

deferred_platform_configsobject[] nullable

Deferred non-video platform configs to generate after video finalize

provided_media_assetsobject[] nullable

User-provided media assets to use for deferred social creative

num_postsinteger nullable

Number of posts per deferred platform

reference_imagesstring[] nullable

Reference image data URLs

creative_referencesobject nullable
campaign_templateobject nullable

Zero or one template selected by id

use_brand_styleboolean nullable

Apply brand style constraints

video_durationinteger nullable

Fallback video duration for social video finalize

video_qualitystring nullable

Default video quality for social videos

ugc_style_enabledboolean nullable

Whether to steer generated social videos and seed images toward creator-led UGC style

use_fast_modelboolean nullable

Whether to use the Gemini fast video model (lite + 1080p) for finalized social videos

batch_campaign_idstring nullable

Optional batch campaign id

campaign_opportunity_idstring uuid nullable

Trusted competitor campaign opportunity UUID returned by the draft job

execution_settings_job_idstring nullable

Accepted campaign-ideas job whose deferred fields this finalize must honor

execution_settings_draft_identitystring nullable

Builder draft identity bound to the accepted execution-settings receipt

user_promptstring nullable

Original user prompt/product description

product_offering_idstring uuid nullable

Product offering ID

product_descriptionstring nullable

Deprecated: use user_prompt

Response

Successful Response

job_idstring required

Unique job identifier

statusstring required

Initial job status (typically 'running')

stream_urlstring required

SSE endpoint for real-time progress

poll_urlstring required

HTTP endpoint for polling status

Example response

{
  "job_id": "987fcdeb-51a2-43f7-9876-543210987654",
  "poll_url": "/api/chat/agentic/jobs/987fcdeb-51a2-43f7-9876-543210987654",
  "status": "running",
  "stream_url": "/api/chat/agentic/jobs/987fcdeb-51a2-43f7-9876-543210987654/stream"
}

Changes

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