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

/

v1

/

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.

Response

Content creation started. Poll the run for results.

data

object

Run details including runId, workflowId, and status.

Inputs And Outputs Generate Content Brief