Content

Create content

Compatibility high-level endpoint over the frozen AgentPlan lifecycle. Interactive calls return questions, route choices, or an approval-ready plan without spending generation credits. Set headless=true only with an Idempotency-Key header and positive maxCredits to execute an approval-ready plan.

post/content/create

Request

  • Base URL: https://app.uselamina.ai/v1
  • URL: https://app.uselamina.ai/v1/content/create
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Headers

Idempotency-Keystring

Required when headless=true or terminalMode=auto.

Request body

briefstring required

What content to create

platformstring nullable

Target platform

modality'image' | 'video' | 'audio' nullable

Content modality (image, video, or audio)

brandProfileIdstring uuid nullable
campaignIdstring uuid nullable
appIdstring uuid nullable

Force a specific app

scenarioIdstring nullable

Pin a known creative scenario for deterministic planning.

feedbackstring nullable

Free-text feedback to fold into a revised plan.

preferredPath'auto' | 'atomic' | 'compose' | 'app' nullable

Optional route-family preference; the planner still freezes the route.

maxEstimatedCreditsinteger nullable

Planning constraint; do not return a plan estimated above this amount.

headlessboolean nullable

Unattended mode. The server still freezes a plan first and dispatches only when it is awaiting approval, within maxCredits, and protected by Idempotency-Key. Questions and route choices are returned without dispatch.

maxCreditsinteger

Required hard credit ceiling for headless execution.

allowUnknownCostboolean

Explicitly permit an unknown-cost plan while retaining maxCredits as the hard ceiling.

inputsobject nullable

Override inputs for the selected app

templateIdstring nullable

Apply a content template

aspectRatiostring nullable

Output aspect ratio (e.g. 1:1, 16:9, 9:16, 4:3, 4:5, auto). Auto-mapped to the matching workflow parameter.

metadataobject nullable

Deprecated compatibility metadata. Put planner-known values under inputs; metadata.webhookUrl returns a warning and is not attached to pipeline runs.

webhookUrlstring uri nullable

Deprecated compatibility field. Canonical pipeline runs do not attach this callback; poll GET /content/runs/{runId}. A warning is returned when supplied.

Response

Frozen plan or started pipeline run

dataobject required

Changes

No recorded changes to this operation across all 1 revision of this API.