Get Brand Context

curl --request GET \
  --url https://app.uselamina.ai/v1/intelligence/brand-context \
  --header 'x-api-key: <api-key>'

{
  "data": {
    "brandDna": {
      "voiceAttributes": [
        "bold",
        "confident",
        "playful"
      ],
      "visualIdentity": [
        "minimalist",
        "high-contrast",
        "warm tones"
      ],
      "contentPillars": [
        "product innovation",
        "sustainability",
        "community"
      ],
      "audienceSignals": [
        "Gen Z",
        "urban professionals",
        "eco-conscious"
      ],
      "guardrails": [
        "no political content",
        "avoid controversial topics"
      ],
      "toneSpectrum": {
        "primary": "energetic",
        "secondary": "witty",
        "avoid": [
          "corporate",
          "formal"
        ]
      },
      "performanceProfile": {
        "topPatterns": [
          "lifestyle imagery",
          "user-generated content style"
        ],
        "weakPatterns": [
          "stock photo aesthetic",
          "text-heavy posts"
        ],
        "avgEngagementTier": "high"
      }
    },
    "guidance": {
      "promptDirectives": [
        "Lead with bold colors and dynamic composition",
        "Include human subjects when possible"
      ],
      "negativePrompts": [
        "no text overlays",
        "avoid cluttered backgrounds"
      ],
      "recommendedMoves": [
        "Test carousel format",
        "Add behind-the-scenes content"
      ],
      "testIdeas": [
        "A/B test warm vs cool color palettes",
        "Try vertical video format"
      ],
      "winningPatterns": [
        "lifestyle imagery",
        "product-in-context shots"
      ],
      "weakPatterns": [
        "plain product shots on white background"
      ],
      "supportingMetrics": [
        "lifestyle posts avg 3.2x engagement",
        "video posts outperform static by 40%"
      ],
      "creativeStructure": null
    },
    "topPatterns": {
      "topItems": [
        {
          "id": "item-001",
          "title": "Summer Campaign Hero",
          "modality": "image",
          "platform": "instagram",
          "performanceScore": 92.5,
          "winningPatterns": [
            "lifestyle imagery",
            "warm tones",
            "human subjects"
          ]
        }
      ],
      "topPatterns": [
        {
          "pattern": "lifestyle imagery",
          "occurrences": 15,
          "avgPerformance": 88.3
        },
        {
          "pattern": "warm tones",
          "occurrences": 12,
          "avgPerformance": 85.7
        }
      ],
      "weakPatterns": [
        {
          "pattern": "stock photo aesthetic",
          "occurrences": 4,
          "avgPerformance": 32.1
        }
      ]
    }
  }
}

Intelligence

Get Brand Context

Retrieve the complete brand context package for your workspace: brand DNA, workflow guidance, and top-performing content patterns. This is the primary intelligence endpoint — use it to inform content creation decisions.

The response combines three data sources resolved in parallel:

brandDna — Voice attributes, visual identity, content pillars, audience signals, guardrails, tone spectrum, and performance profile extracted from the workspace’s brand profile.
guidance — Prompt directives, negative prompts, recommended creative moves, test ideas, winning/weak patterns, supporting metrics, and creative structure. Resolved from the active workflow guidance package, optionally scoped by campaign, workflow, platform, or objective.
topPatterns — The highest-performing content items and aggregated pattern analysis (winning patterns vs weak patterns with occurrence counts and average performance scores).

All parameters are optional. Omit them to get the workspace default context. Provide brandProfileId to scope to a specific brand profile, campaignId or workflowId to narrow guidance, and platform/objective/modality to get platform-specific recommendations.

GET

intelligence

brand-context

Get Brand Context

curl --request GET \
  --url https://app.uselamina.ai/v1/intelligence/brand-context \
  --header 'x-api-key: <api-key>'

{
  "data": {
    "brandDna": {
      "voiceAttributes": [
        "bold",
        "confident",
        "playful"
      ],
      "visualIdentity": [
        "minimalist",
        "high-contrast",
        "warm tones"
      ],
      "contentPillars": [
        "product innovation",
        "sustainability",
        "community"
      ],
      "audienceSignals": [
        "Gen Z",
        "urban professionals",
        "eco-conscious"
      ],
      "guardrails": [
        "no political content",
        "avoid controversial topics"
      ],
      "toneSpectrum": {
        "primary": "energetic",
        "secondary": "witty",
        "avoid": [
          "corporate",
          "formal"
        ]
      },
      "performanceProfile": {
        "topPatterns": [
          "lifestyle imagery",
          "user-generated content style"
        ],
        "weakPatterns": [
          "stock photo aesthetic",
          "text-heavy posts"
        ],
        "avgEngagementTier": "high"
      }
    },
    "guidance": {
      "promptDirectives": [
        "Lead with bold colors and dynamic composition",
        "Include human subjects when possible"
      ],
      "negativePrompts": [
        "no text overlays",
        "avoid cluttered backgrounds"
      ],
      "recommendedMoves": [
        "Test carousel format",
        "Add behind-the-scenes content"
      ],
      "testIdeas": [
        "A/B test warm vs cool color palettes",
        "Try vertical video format"
      ],
      "winningPatterns": [
        "lifestyle imagery",
        "product-in-context shots"
      ],
      "weakPatterns": [
        "plain product shots on white background"
      ],
      "supportingMetrics": [
        "lifestyle posts avg 3.2x engagement",
        "video posts outperform static by 40%"
      ],
      "creativeStructure": null
    },
    "topPatterns": {
      "topItems": [
        {
          "id": "item-001",
          "title": "Summer Campaign Hero",
          "modality": "image",
          "platform": "instagram",
          "performanceScore": 92.5,
          "winningPatterns": [
            "lifestyle imagery",
            "warm tones",
            "human subjects"
          ]
        }
      ],
      "topPatterns": [
        {
          "pattern": "lifestyle imagery",
          "occurrences": 15,
          "avgPerformance": 88.3
        },
        {
          "pattern": "warm tones",
          "occurrences": 12,
          "avgPerformance": 85.7
        }
      ],
      "weakPatterns": [
        {
          "pattern": "stock photo aesthetic",
          "occurrences": 4,
          "avgPerformance": 32.1
        }
      ]
    }
  }
}

Retrieve the intelligence layer’s understanding of your brand: voice attributes, visual identity, content pillars, audience signals, guardrails, and performance patterns. The Creative Engine uses this context automatically when you call POST /v1/content/create. Use this endpoint when you want to inspect what the engine knows, feed brand data into your own pipelines, or build brand-aware agent prompts.

Authorizations

x-api-key

string

header

required

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

Query Parameters

brandProfileId

string<uuid>

Scope to a specific brand profile. Omit for the workspace default.

campaignId

string<uuid>

Narrow guidance to a specific campaign.

workflowId

string<uuid>

Narrow guidance to a specific workflow/app.

platform

string

Target platform (e.g. instagram, tiktok, facebook, linkedin).

objective

string

Content objective (e.g. engagement, awareness, conversion).

modality

enum<string>

Content modality to optimize guidance for.

Available options:

image,

video,

text,

audio,

mixed

topK

integer

default:10

Number of top-performing items to include in the topPatterns section.

Response

Brand context package with DNA, guidance, and top patterns

data

object

Complete brand context package combining DNA, guidance, and top patterns.

Show child attributes

List Assets Predict Content Performance