Apps
List accessible apps
Returns all published app versions the authenticated API key holder can call, deduplicated to the latest version per workflow.
Access rules:
- Unrestricted apps (
is_restricted: false): visible to everyone. - Restricted apps: visible only to the author or studio members.
Use owner=me to narrow results to only apps you created.
Results are ordered by updated_at descending.
AuthorizationBearer <token>
Pass your API key as a Bearer token: Authorization: Bearer kim_<prefix>_<secret>
In: header
Query Parameters
owner?string
Filter apps by owner. Currently only me is supported, which
returns apps created by the authenticated user. Omit to return
all accessible apps (including public apps from other users).
Value in
"me"limit?integer
Maximum number of results per page.
Default
20Range
1 <= value <= 100cursor?string
Pagination cursor from a previous response's next_cursor.
Response Body
application/json
application/json
application/json
curl -X GET "https://kimara.ai/api/v1/apps"{
"apps": [
{
"id": "av_abc123",
"public_name": "Sunset Generator",
"description": "Generates beautiful sunset images from text prompts.",
"version": 3,
"avatar_url": null,
"is_public": false,
"is_restricted": true,
"created_at": "2026-04-06T12:00:00.000Z",
"updated_at": "2026-04-06T14:00:00.000Z",
"inputs": [
{
"key": "5:text",
"type": "STRING",
"title": "Prompt",
"placeholder": "a photo of a sunset",
"options": [
"option_a",
"option_b"
],
"description": "Describe the scene you want to generate.",
"min": 0,
"max": 100
}
]
}
],
"has_more": false,
"next_cursor": null
}{
"error": {
"code": "INVALID_REQUEST",
"message": "Invalid JSON body"
}
}{
"error": "Missing API key"
}