> ## Documentation Index > Fetch the complete documentation index at: https://docs.uselamina.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Recommendations > List open content recommendations for the workspace. Recommendations are generated by the Content Intelligence Engine based on brand context, trend signals, and historical performance data. Each recommendation includes a type (e.g. `trend_opportunity`, `gap_analysis`, `optimization`), priority level, title, summary, and a `data` object with structured details. Use recommendations to surface actionable content ideas for agents or human creators. Combine with `POST /v1/content/create` to act on a recommendation by passing its details as the content brief. Returns actionable content recommendations grounded in your brand context and recent performance data. Recommendations cover what to create next, which formats to prioritize, and how to improve existing content. Use this to drive editorial calendars, feed agent-based content planners, or surface suggestions in creative tools. ## OpenAPI ````yaml GET /v1/intelligence/recommendations openapi: 3.1.0 info: title: Lamina Apps API version: 1.0.0 description: > Professional creative content production for AI agents. Create brand-aligned images, videos, and designs from natural-language briefs using 30+ specialized AI pipelines. Unlike raw model APIs (DALL-E, Flux, Kling), Lamina automatically applies brand guidelines, selects the optimal multi-model pipeline, scores output quality, and delivers permanent CDN-hosted URLs with composability metadata for chaining. ## Authentication All endpoints require an API key passed via one of these headers: - `x-api-key: lma_your_key` (recommended) - `Authorization: Bearer lma_your_key` API keys are workspace-scoped. Create them in **Settings -> API Keys**. ## Quick Start (One-Call Path) `POST /v1/create` with `{ "brief": "product photo of sneakers", "sync": true }` — returns completed output inline with CDN URL. ## Quick Start (Advanced) 1. `GET /v1/apps` -- browse 30+ specialized creative apps 2. `GET /v1/apps/{appId}` -- inspect input parameters 3. `POST /v1/apps/{appId}/runs?webhook=` -- run with your inputs 4. Receive results via webhook, poll `GET /v1/runs/{runId}`, or stream via `GET /v1/runs/{runId}/stream` ## Rate Limits All `/v1/*` endpoints are currently limited to 100 requests per minute per IP. On `429`, read the `RateLimit-*` and `Retry-After` headers before retrying. ## How Inputs Work When running an app, provide inputs as a JSON object keyed by parameter **name** (from the app details response). - **text** parameters: send a string value (e.g. a prompt or description) - **options** parameters: send the **label** of the option (e.g. `"Caucasian"`), not an internal value - **url** parameters: send a publicly accessible URL to an image or video Every parameter is returned with `required: true`. Parameters with a `default` can safely be omitted -- the app will use the default value. ## Endpoint Groups | Group | Purpose | |-------|---------| | **Apps** | Discover and inspect available content creation apps | | **Runs** | Run workflows, track progress, and retrieve results | | **Assets** | Browse generated images, videos, and text from past executions | | **Intelligence** | Brand context, performance prediction, recommendations, and trends | | **Publishing** | Publish content to connected social channels | | **Content** | One-call agent operations: create, score, brief, batch | | **Account** | Credit balance and rate limit visibility | | **Templates** | Content creation templates and strategies | | **Webhooks** | Webhook signature verification | servers: - url: https://app.uselamina.ai description: Production security: - apiKey: [] tags: - name: Create description: Create content from briefs, run specific apps, and use templates - name: Discover description: Find and inspect available apps and their input schemas - name: Track description: Monitor execution progress, retrieve results, and browse generated assets - name: Intelligence description: >- Brand context, performance prediction, content recommendations, and trend signals - name: Distribute description: Publish content to social channels and transfer assets to CDN - name: Score description: Evaluate content quality, brand alignment, and engagement potential - name: Account description: Credit balance, rate limits, and health checks - name: Webhooks description: Webhook signature verification for secure callback handling paths: /v1/intelligence/recommendations: get: tags: - Intelligence summary: Get Recommendations description: > List open content recommendations for the workspace. Recommendations are generated by the Content Intelligence Engine based on brand context, trend signals, and historical performance data. Each recommendation includes a type (e.g. `trend_opportunity`, `gap_analysis`, `optimization`), priority level, title, summary, and a `data` object with structured details. Use recommendations to surface actionable content ideas for agents or human creators. Combine with `POST /v1/content/create` to act on a recommendation by passing its details as the content brief. operationId: getRecommendations parameters: - name: campaignId in: query required: false schema: type: string format: uuid description: Filter recommendations to a specific campaign. - name: workflowId in: query required: false schema: type: string format: uuid description: Filter recommendations to a specific workflow/app. - name: brandProfileId in: query required: false schema: type: string format: uuid description: Filter recommendations to a specific brand profile. - name: platform in: query required: false schema: type: string description: Filter by target platform. example: instagram - name: objective in: query required: false schema: type: string description: Filter by content objective. example: engagement - name: modality in: query required: false schema: type: string description: Filter by content modality. example: image - name: limit in: query required: false schema: type: integer default: 25 maximum: 100 description: Maximum number of recommendations to return. responses: '200': description: List of open content recommendations content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/Recommendation' example: data: - id: rec-001 type: trend_opportunity status: open priority: 1 title: Capitalize on 'quiet luxury' trend for Instagram summary: >- The 'quiet luxury' aesthetic is trending +45% this week. Your brand's minimalist identity is a natural fit. data: trendSignal: quiet luxury trendGrowth: +45% suggestedPlatform: instagram suggestedModality: image createdAt: '2026-04-15T08:00:00.000Z' - id: rec-002 type: gap_analysis status: open priority: 2 title: No video content published in 14 days summary: >- Video content historically drives 2.3x engagement for your brand. Consider creating short-form video. data: daysSinceLastVideo: 14 videoEngagementMultiplier: 2.3 createdAt: '2026-04-14T12:00:00.000Z' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' components: schemas: Recommendation: type: object description: >- An actionable content recommendation generated by the intelligence engine. required: - id - type - status - priority - title - createdAt properties: id: type: string format: uuid description: Unique recommendation identifier type: type: string description: >- Recommendation category (e.g. `trend_opportunity`, `gap_analysis`, `optimization`) status: type: string description: Recommendation status (e.g. `open`, `acted_on`, `dismissed`) priority: type: integer description: Priority level (1 = highest priority) title: type: string description: Short human-readable title summary: type: string nullable: true description: Longer explanation with context and reasoning data: type: object description: Structured recommendation details (varies by type) createdAt: type: string format: date-time description: When the recommendation was generated responses: Unauthorized: description: Missing or invalid API key content: application/json: schema: type: object properties: error: type: string example: error: Invalid API key TooManyRequests: description: >- Rate limit exceeded. All `/v1/*` endpoints are currently limited to 100 requests per minute per IP. headers: RateLimit-Policy: description: Active rate limit policy. schema: type: string example: 100;w=60 RateLimit-Limit: description: Max requests allowed in the current window. schema: type: integer example: 100 RateLimit-Remaining: description: Requests remaining in the current window. schema: type: integer example: 0 RateLimit-Reset: description: Seconds until the current window resets. schema: type: integer example: 60 Retry-After: description: Seconds to wait before retrying. schema: type: integer example: 60 content: text/plain: schema: type: string example: Too many requests from this IP, please try again in a minute securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: 'Workspace API key. Prefix: `lma_`. Example: `lma_abc123...`' ````