Skip to main content
POST
/
v1
/
content
/
brief
Generate Content Brief
curl --request POST \
  --url https://app.uselamina.ai/v1/content/brief \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "goal": "Increase Instagram engagement for our new sneaker collection",
  "platform": "instagram",
  "modality": "image",
  "count": 3
}
'
{
  "data": {
    "briefs": [
      {
        "brief": "Create a lifestyle photo of sneakers on a skateboarder in an urban park, golden-hour lighting, warm tones, shot from low angle to emphasize the shoes",
        "platform": "instagram",
        "modality": "image",
        "reasoning": "Lifestyle imagery is your top-performing pattern (+3.2x engagement). Low-angle urban shots align with current streetwear trends."
      },
      {
        "brief": "Flat-lay composition of the full sneaker colorway lineup on a concrete surface with coffee and sunglasses props, overhead shot, minimalist styling",
        "platform": "instagram",
        "modality": "image",
        "reasoning": "Product flat-lays with lifestyle props drive strong save-to-like ratios. Concrete texture matches brand's urban identity."
      },
      {
        "brief": "Close-up macro shot of sneaker texture and stitching details, shallow depth of field, studio lighting with warm accent",
        "platform": "instagram",
        "modality": "image",
        "reasoning": "Detail shots generate high comment engagement. Studio lighting with warm accents matches brand's visual identity."
      }
    ]
  }
}
Generate structured content briefs grounded in your brand context, trend signals, and performance data. Each brief includes a creative direction, suggested format, target platform, and recommended app. Use this as a planning step before content creation, or feed briefs directly into the create-content endpoint for fully automated production. Returns up to count briefs (default 3, max 10) per request.

Authorizations

x-api-key
string
header
required

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

Body

application/json
goal
string
required

Goal or objective for the content (e.g. "Increase engagement for our sneaker line").

platform
string | null

Target platform to optimize briefs for.

modality
string | null

Desired content modality (e.g. image, video).

count
integer
default:3

Number of brief variations to generate.

Required range: x <= 10
brandProfileId
string<uuid> | null

Brand profile to incorporate into briefs.

Response

Generated content briefs

data
object

Generated briefs. Structure varies based on the workspace's intelligence model.