> ## 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. # List Runs > List past runs for the workspace with optional filters. Returns a paginated list of run summaries (without full output details). Use this to find runs to inspect, or to monitor recent activity. For full output details on a specific run, use `GET /v1/runs/{runId}`. Results are ordered by creation time, newest first. List past executions for your workspace, ordered by creation time (newest first). Use this to build execution history views, audit logs, or find a specific run you need to inspect. Supports filtering by status, app ID, and time range. Results are paginated with offset/limit. Default limit is 25, maximum 100. ## OpenAPI ````yaml GET /v1/runs 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/runs: get: tags: - Track summary: List Runs description: | List past runs for the workspace with optional filters. Returns a paginated list of run summaries (without full output details). Use this to find runs to inspect, or to monitor recent activity. For full output details on a specific run, use `GET /v1/runs/{runId}`. Results are ordered by creation time, newest first. operationId: listRuns parameters: - name: status in: query required: false schema: type: string enum: - queued - running - completed - failed - cancelled description: Filter runs by status. Omit to return all statuses. example: completed - name: appId in: query required: false schema: type: string format: uuid description: Filter by app/workflow ID. Only returns runs of this specific app. example: 80d4d454-8844-489f-b903-2ad65a414482 - name: limit in: query required: false schema: type: integer default: 25 maximum: 100 description: Maximum number of runs to return per page. - name: offset in: query required: false schema: type: integer default: 0 description: Number of runs to skip (for pagination). - name: since in: query required: false schema: type: string format: date-time description: Only return runs created after this ISO 8601 timestamp. example: '2026-04-01T00:00:00Z' responses: '200': description: Paginated list of run summaries content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/ExecutionSummary' pagination: $ref: '#/components/schemas/Pagination' example: data: - runId: fc32ae7d-6840-4be3-8fb1-539a60e33fc3 workflowId: 80d4d454-8844-489f-b903-2ad65a414482 status: completed source: api_app errorMessage: null startedAt: '2026-04-15T10:30:01.000Z' completedAt: '2026-04-15T10:32:15.000Z' createdAt: '2026-04-15T10:30:00.000Z' - runId: a1b2c3d4-e5f6-7890-abcd-ef1234567890 workflowId: 483754bf-24c9-48c1-a70e-71d2ff9682fa status: failed source: api_app errorMessage: Image generation timed out startedAt: '2026-04-15T09:15:01.000Z' completedAt: '2026-04-15T09:20:01.000Z' createdAt: '2026-04-15T09:15:00.000Z' pagination: total: 47 limit: 25 offset: 0 '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' components: schemas: ExecutionSummary: type: object description: | Lightweight run summary for list endpoints. Does not include full output details -- use `GET /v1/runs/{runId}` for complete output data. required: - runId - workflowId - status - createdAt properties: runId: type: string format: uuid description: Unique run identifier workflowId: type: string format: uuid description: The app/workflow that was executed status: type: string enum: - queued - running - completed - failed - cancelled description: Current execution status source: type: string description: >- How the execution was triggered (e.g. `api_app`, `canvas`, `app_runner`) errorMessage: type: string nullable: true description: Error message if execution failed. Null on success. startedAt: type: string format: date-time nullable: true description: When processing started. Null if still queued. completedAt: type: string format: date-time nullable: true description: When processing finished. Null if not yet complete. createdAt: type: string format: date-time description: When the execution was created (queued). Pagination: type: object description: Pagination metadata for list endpoints required: - total - limit - offset properties: total: type: integer description: Total number of records matching the query limit: type: integer description: Maximum records per page (as requested) offset: type: integer description: Number of records skipped (as requested) 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...`' ````