Skip to main content
POST
/
v1
/
content
/
batch
Batch Create Content
curl --request POST \
  --url https://app.uselamina.ai/v1/content/batch \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "items": [
    {
      "brief": "Lifestyle photo of sneakers in urban park, golden-hour lighting",
      "platform": "instagram",
      "modality": "image"
    },
    {
      "brief": "Product flat-lay of full colorway lineup, minimalist styling",
      "platform": "instagram",
      "modality": "image"
    },
    {
      "brief": "15-second video of sneaker unboxing with ASMR-style close-ups",
      "platform": "tiktok",
      "modality": "video"
    }
  ],
  "brandProfileId": null,
  "campaignId": null
}
'
{
  "data": {
    "batchId": "batch-001",
    "total": 3,
    "queued": 2,
    "failed": 1,
    "items": [
      {
        "index": 0,
        "status": "queued",
        "runId": "exec-001",
        "workflowId": "80d4d454-8844-489f-b903-2ad65a414482",
        "workflowName": "AI Product Photography"
      },
      {
        "index": 1,
        "status": "queued",
        "runId": "exec-002",
        "workflowId": "80d4d454-8844-489f-b903-2ad65a414482",
        "workflowName": "AI Product Photography"
      },
      {
        "index": 2,
        "status": "failed",
        "error": "No video-capable app found for this workspace"
      }
    ]
  }
}
Create multiple pieces of content in a single request. Each item follows the same logic as the create-content endpoint — brief resolution, app selection, and execution — but all items run in parallel. Brand context is resolved once and shared across the batch. Returns an array of results, one per item. Each successful item includes a run ID you can track via the wait or get-run endpoints. Failed items include the error reason. Maximum 10 items per batch.

Authorizations

​
x-api-key
string
header
required

Workspace API key. Prefix: lma_. Example: lma_abc123...

Body

application/json
​
items
object[]
required

Array of content creation requests (1-10 items).

Required array length: 1 - 10 elements
​
brandProfileId
string<uuid> | null

Default brand profile for all items (individual items can override).

​
campaignId
string<uuid> | null

Default campaign for all items (individual items can override).

Response

Batch creation started. Poll individual run IDs for results.

​
data
object

Result of a batch content creation request.