---
title: "Create a saved batch of up to twelve content drafts"
method: POST
path: "/workspace/content/batches"
tags: ["Platform"]
---

# Create a saved batch of up to twelve content drafts

`POST /workspace/content/batches`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/workspace/content/batches`
- Auth: API key in header `Authorization`

Requires Idempotency-Key equal to requestId. Uses generation credits; no publishing. Identical requests recover the original admission receipt. Read the job for current per-item outcomes.

## Request body

- object
  - `requestId` string, uuid, required
  - `profileId` string, uuid, required
  - `language` 'en' | 'fr', required
  - `options` object, required
    - `carousels` integer, required
    - `videos` integer, required
    - `memes` integer, required
    - `videoMode` 'footage' | 'ugc', required
    - `ugcFormat` 'before_after' | 'talking_head', required
    - `imageSources` string[], required
    - `imageUrls` string[], required

## Response `200`

Successful response

- object
  - `runId` string, uuid, required
  - `triggerRunId` string, nullable, required
  - `requestId` string, uuid, required
  - `attempt` integer, required
  - `status` 'queued' | 'processing' | 'complete' | 'failed' | 'canceled', required
  - `stage` 'queued' | 'writing' | 'images' | 'videos' | 'done' | 'failed', required
  - `completed` integer, required
  - `failed` integer, required
  - `count` integer, required
  - `done` boolean, required
  - `failedRun` boolean, required
  - `canceled` boolean, required
  - `error` string, nullable, required
  - `items` object[], required
    - `index` integer, required
    - `draftId` string, nullable, required
    - `status` 'pending' | 'ready' | 'error', required
    - `projectId` string, uuid, nullable, required
    - `error` string, nullable, required
  - `createdAt` string, date-time, required
  - `completedAt` string, date-time, nullable, required
  - `quote` object, required
    - `count` integer, required
    - `actorSetupCredits` number, required
    - `animationCredits` number, required
    - `orchestrationCredits` number, required
    - `voiceCredits` number, required
    - `writing` number, required
    - `imageCredits` number, required
    - `videoCredits` number, required
    - `ugcImages` number, required
    - `estimatedCredits` number, required
    - `generatedImages` integer, required
    - `ugcCount` integer, required
  - `mutationReceipt` object, required
    - `id` string, uuid, required
    - `key` string, uuid, required
    - `operation` 'content.batches.create', required
    - `status` 'completed', required
    - `replayed` boolean, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `500`: Internal server error

---

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