---
title: "Queue Marketing Video Render Job"
method: POST
path: "/render/video/jobs"
tags: ["Render"]
---

# Queue Marketing Video Render Job

`POST /render/video/jobs`

## Request

- Base URL: `https://synchronex.ai/api/v1`
- URL: `https://synchronex.ai/api/v1/render/video/jobs`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://synchronex.ai/oauth/authorize`, token URL `https://synchronex.ai/api/oauth/token`, scopes: `read`)

Creates a brand_media row with status queued and runs the Remotion render after the response. Accepts a Synchronex API key or a first-party session.

## Request body

- RenderVideoJobRequest
  - `compositionId` string
  - `brand_id` string, required
  - `brief` string, required
  - `format` 'short_video' | 'square_video' | 'story_video' | 'wide_video'
  - `duration` integer
  - `run_id` string, uuid
  - `template` string
  - `workspace_id` string, uuid, nullable
  - `product_id` string, nullable

## Response `202`

Video render job queued.

- RenderVideoJobQueuedResponse
  - `jobId` string, uuid, required
  - `status` 'queued', required

## Other responses

- `400`: Validation error. The request body or query string is invalid.
- `401`: Unauthorized. Missing, malformed, expired, or revoked bearer token.
- `403`: Forbidden. The token scope or account tier is insufficient.
- `429`: Rate limit exceeded. Retry after the indicated reset time.
- `503`: Failed to create render job.

---

[API](https://skmtc.dev/synchronex/apis/synchronex-api.md) · [All operations](https://skmtc.dev/synchronex/apis/synchronex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/synchronex/apis/synchronex-api/revisions/aa1e0df0a8d5?raw)