---
title: "Get app details"
method: GET
path: "/apps/{appId}"
tags: ["Apps"]
---

# Get app details

`GET /apps/{appId}`

## Request

- Base URL: `https://app.uselamina.ai/v1`
- URL: `https://app.uselamina.ai/v1/apps/{appId}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Get an app's metadata and parameter definitions.

## Path parameters

- `appId` string, uuid, required

## Response `200`

App details

- object
  - `data` AppDetail, required
    - `appId` string, uuid, required
    - `name` string, required
    - `description` string, nullable
    - `parameters` AppParameter[], required
      - `id` string, required
      - `name` string, required
      - `type` 'text' | 'url' | 'options', required
      - `required` boolean, required
      - `description` string
      - `options` string[]
      - `default` unknown
      - `accept` string[]
      - `multiple` boolean
    - `outputs` object[], required
      - `index` integer, required
      - `label` string, required
      - `type` 'image' | 'video' | 'audio' | 'text', required
    - `frontmatter` AppDiscoveryFrontmatter, required: Author-managed discovery metadata. Arrays are normalized, de-duplicated tags used by UI, REST, and MCP search.
      - `schemaVersion` 1, required
      - `summary` string, required
      - `categories` string[], required
      - `useCases` string[], required
      - `keywords` string[], required
      - `aliases` string[], required
      - `formats` string[], required
      - `platforms` string[], required
      - `audiences` string[], required
      - `excludedIntents` string[], required
    - `capabilities` AppCapabilities, required: Semantic capabilities derived from workflow composition — helps agents understand what this app does and produces.
      - `produces` string[], required: What this app produces (e.g. "photo", "video-clip", "voiceover")
      - `strengths` string[], required: What this app is good at
      - `bestFor` string[], required: Best use cases for this app
      - `limitations` string[], required: Known limitations
      - `outputFormats` string[], required: Output MIME types (e.g. "image/png", "video/mp4")
      - `hasQualityControl` boolean, required: Whether the workflow includes automated quality control
      - `hasHumanApproval` boolean, required: Whether the workflow requires human approval
      - `generationStepCount` integer, required: Number of AI generation steps
      - `nodeTypes` string[], required: Node types used in the workflow

## Other responses

- `401`: Missing or invalid API key
- `404`: App not found
- `500`: Internal server error

---

[API](https://skmtc.dev/uselamina/apis/lamina-v1-api.md) · [All operations](https://skmtc.dev/uselamina/apis/lamina-v1-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uselamina/apis/lamina-v1-api/revisions/73b598526531?raw)