Create Content

curl --request POST \
  --url https://app.uselamina.ai/v1/content/create \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "brief": "Create an eye-catching Instagram post showcasing our new summer sneaker collection with lifestyle photography",
  "platform": "instagram",
  "modality": "image",
  "brandProfileId": null,
  "campaignId": null
}
'

{
  "data": {
    "runId": "fc32ae7d-6840-4be3-8fb1-539a60e33fc3",
    "workflowId": "80d4d454-8844-489f-b903-2ad65a414482",
    "workflowName": "AI Product Photography",
    "status": "queued"
  }
}

Create

Create Content

One-call creation endpoint. Provide a natural-language brief and Lamina handles everything: resolves brand context, selects the best workflow/app, injects guidance into prompts, and executes.

How it works:

Resolves brand DNA and active guidance for the workspace
If no appId is provided, selects the best-matching app for the brief, platform, and modality
Translates the brief into app-specific inputs using brand context
Starts the execution and returns immediately (async)

After starting: Use GET /v1/runs/{runId} to poll for results, GET /v1/runs/{runId}/stream for SSE streaming, or pass a webhook query parameter on the execution.

Optional overrides:

appId — Force a specific app instead of automatic selection
inputs — Override specific input parameters on the selected app
templateId — Apply a content template for structured guidance (from GET /v1/templates)
brandProfileId / campaignId — Scope brand context to a specific profile or campaign

POST

content

create

Create Content

curl --request POST \
  --url https://app.uselamina.ai/v1/content/create \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "brief": "Create an eye-catching Instagram post showcasing our new summer sneaker collection with lifestyle photography",
  "platform": "instagram",
  "modality": "image",
  "brandProfileId": null,
  "campaignId": null
}
'

{
  "data": {
    "runId": "fc32ae7d-6840-4be3-8fb1-539a60e33fc3",
    "workflowId": "80d4d454-8844-489f-b903-2ad65a414482",
    "workflowName": "AI Product Photography",
    "status": "queued"
  }
}

One-call creation. Describe what you want, and the API handles app selection, input mapping, brand context injection, and execution. Instead of manually choosing an app and mapping inputs, pass a brief describing the content you need. The engine resolves brand context, selects the best-fit app, injects creative guidance, and starts the execution. The operation is asynchronous — use the returned run ID with the wait, stream, or get-run endpoints to retrieve results. Best for agent-driven workflows where you want a single call to go from intent to finished asset.

Authorizations

x-api-key

string

header

required

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

Body

application/json

brief

string

required

Natural-language description of what content to create. This is the primary input.

platform

string | null

Target platform (e.g. instagram, tiktok, facebook). Helps select the right app and optimize guidance.

modality

string | null

Desired content modality (e.g. image, video). Helps select the right app.

brandProfileId

string<uuid> | null

Scope brand context to a specific brand profile.

campaignId

string<uuid> | null

Scope guidance to a specific campaign.

appId

string<uuid> | null

Force a specific app instead of automatic selection. Use GET /v1/apps to find app IDs.

inputs

object

Override specific input parameters on the selected app. Keys are parameter names.

templateId

string | null

Apply a content template for structured guidance. Use GET /v1/templates to find template IDs.

autoQuality

object

Auto-quality guarantee. Score output after completion and retry if below threshold.

Show child attributes

aspectRatio

string | null

Output aspect ratio. Auto-mapped to the matching workflow parameter. Common values: 1:1, 16:9, 9:16, 4:3, 3:4, 4:5, auto.

Example:

"9:16"

metadata

object

Freeform context about the target placement, injected into prompt engineering as structured document context. Useful for passing context from the calling application without manually writing it into the brief.

Example:

{
  "documentTitle": "Summer Collection 2026",
  "fieldName": "heroImage",
  "fieldPurpose": "Main banner image for collection landing page",
  "dimensions": { "width": 1920, "height": 1080 }
}

Response

Content creation started. Poll the run for results.

data

object

Run details including runId, workflowId, and status.

Inputs And Outputs Generate Content Brief