Get App Details
curl --request GET \
--url https://app.uselamina.ai/v1/apps/{appId} \
--header 'x-api-key: <api-key>'import requests
url = "https://app.uselamina.ai/v1/apps/{appId}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://app.uselamina.ai/v1/apps/{appId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.uselamina.ai/v1/apps/{appId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.uselamina.ai/v1/apps/{appId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.uselamina.ai/v1/apps/{appId}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.uselamina.ai/v1/apps/{appId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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": true,
"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": true,
"options": [
"Ghibli",
"Simpsons",
"Disney / Pixar",
"Cyberpunk"
]
},
{
"id": "5c237908-e6ed-4d4b-bd1d-6253bf60a8a5",
"name": "Aspect Ratio",
"type": "options",
"required": true,
"options": [
"1:1",
"4:3",
"3:4",
"16:9",
"9:16"
],
"default": "1:1"
}
]
}
}{
"error": "Invalid API key"
}{
"error": "App not found"
}"Too many requests from this IP, please try again in a minute"Discover
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
optionsarray (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
curl --request GET \
--url https://app.uselamina.ai/v1/apps/{appId} \
--header 'x-api-key: <api-key>'import requests
url = "https://app.uselamina.ai/v1/apps/{appId}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://app.uselamina.ai/v1/apps/{appId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.uselamina.ai/v1/apps/{appId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.uselamina.ai/v1/apps/{appId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.uselamina.ai/v1/apps/{appId}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.uselamina.ai/v1/apps/{appId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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": true,
"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": true,
"options": [
"Ghibli",
"Simpsons",
"Disney / Pixar",
"Cyberpunk"
]
},
{
"id": "5c237908-e6ed-4d4b-bd1d-6253bf60a8a5",
"name": "Aspect Ratio",
"type": "options",
"required": true,
"options": [
"1:1",
"4:3",
"3:4",
"16:9",
"9:16"
],
"default": "1:1"
}
]
}
}{
"error": "Invalid API key"
}{
"error": "App not found"
}"Too many requests from this IP, please try again in a minute"Inspect an app’s input schema before running it. The
parameters array is the source of truth for:
- which parameters have a
default(safe to omit) and which must be supplied - which values are valid for
optionstype parameters - which fields expect public URLs
- which parameter
key(orname) values to use as keys in theinputsobject — preferkey, the stable snake_case identifier
POST /v1/apps/{appId}/runs — never guess parameter names or option values.Authorizations
Workspace API key. Prefix: lma_. Example: lma_abc123...
Path Parameters
The app ID (UUID) from the List Apps response
Response
App details with full parameter definitions
Full app details including input parameters
Show child attributes
Show child attributes