Listing Apps
List all apps your API key has access to.
Use the list apps endpoint to discover which published apps your API key can run.
List Available Apps
curl https://kimara.ai/api/v1/apps \
-H "Authorization: Bearer kim_YOUR_API_KEY"The response includes all apps you can call, like your own apps, your studio's apps, and public marketplace apps:
{
"apps": [
{
"id": "app-version-uuid",
"public_name": "My Image Generator",
"description": "Generates images from text prompts",
"version": 3,
"avatar_url": null,
"is_public": false,
"is_restricted": true,
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-02T00:00:00.000Z",
"inputs": [
{ "key": "1:text", "type": "STRING", "title": "Prompt" }
]
}
],
"has_more": false,
"next_cursor": null
}Each entry shows the latest published version per app.
Pagination
Control page size with the limit parameter (1-100, default 20):
curl "https://kimara.ai/api/v1/apps?limit=5" \
-H "Authorization: Bearer kim_YOUR_API_KEY"When has_more is true, pass the next_cursor value to fetch the next page:
curl "https://kimara.ai/api/v1/apps?limit=5&cursor=CURSOR_VALUE" \
-H "Authorization: Bearer kim_YOUR_API_KEY"Using an App ID
Once you have an app's id, use it to get details or run it:
# Get input schema
curl https://kimara.ai/api/v1/apps/APP_VERSION_ID \
-H "Authorization: Bearer kim_YOUR_API_KEY"
# Run the app
curl -X POST https://kimara.ai/api/v1/apps/APP_VERSION_ID \
-H "Authorization: Bearer kim_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"inputs": {"1:text": "a sunset over mountains"}}'