Get App Details

Returns app metadata and the full list of input parameters the app accepts. Use this to understand what inputs you need to provide when running the app.

Each parameter has a type that determines what value to send:

• text: A free-form string (prompts, descriptions, product names)
• options: Pick one label from the options array (e.g. "Caucasian", "Male", "Studio")
• url: A publicly accessible URL pointing to an image or video

Use the parameter name as the key when providing inputs to the Run App endpoint.

GET /v1/apps/{appId}

Get app details and parameters

cURL

curl --request GET \
  --url https://app.uselamina.ai/v1/apps/{appId} \
  --header 'x-api-key: <api-key>'

200

{
  "data": {
    "appId": "3f68debe-df0a-4fc9-bdd3-9d45a4160587",
    "name": "Cartoonify!",
    "description": "Just upload your photo and convert it into an Cartoon of your favorite style!",
    "parameters": [
      {
        "id": "4a45d4c6-808e-45e8-9f7c-6a06953583fb",
        "name": "Upload",
        "type": "url",
        "required": false,
        "accept": [
          "image"
        ],
        "default": "https://media.getmason.io/api/assetlib/55e99714-d15d-43fe-9e9b-ead418b7ba67.png"
      },
      {
        "id": "1977e11b-d91b-4f65-802c-b37b597fa8d9",
        "name": "Style",
        "type": "options",
        "required": false,
        "options": [
          "Ghibli",
          "Simpsons",
          "Disney / Pixar",
          "Cyberpunk"
        ]
      },
      {
        "id": "5c237908-e6ed-4d4b-bd1d-6253bf60a8a5",
        "name": "Aspect Ratio",
        "type": "options",
        "required": false,
        "options": [
          "1:1",
          "4:3",
          "3:4",
          "16:9",
          "9:16"
        ],
        "default": "1:1"
      }
    ]
  }
}

Returns app metadata and the parameter definitions needed to build a request payload.

The parameters array is the source of truth for:

• which inputs are required
• which values are valid for options
• which fields expect public URLs
• which parameter names must be used in the inputs object

Authorizations

x-api-key · string · header · required

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

Path Parameters

appId · string<uuid> · required

The app ID (UUID) from the List Apps response

Response

200

application/json

App details with full parameter definitions

data · object

Full app details including input parameters

Show child attributes