Apps
Run a published app version
Queues an execution of the app version with the provided inputs.
Returns a run_id that can be polled via GET /runs/{id}.
Input keys use the nodeId:widgetName format returned by the
GET metadata endpoint. For IMAGE, VIDEO, or AUDIO inputs, pass an
asset_id obtained from POST /assets.
AuthorizationBearer <token>
Pass your API key as a Bearer token: Authorization: Bearer kim_<prefix>_<secret>
In: header
Path Parameters
appVersionId*string
The published app version ID.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://kimara.ai/api/v1/apps/av_abc123" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "5:text": "a photo of a sunset over the ocean", "12:seed": 42 } }'{
"run_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "queued",
"created_at": "2026-04-06T12:00:00.000Z",
"poll_url": "/api/v1/runs/550e8400-e29b-41d4-a716-446655440000"
}{
"error": {
"code": "INVALID_REQUEST",
"message": "Invalid JSON body"
}
}{
"error": "Missing API key"
}{
"error": "Account suspended"
}{
"error": {
"code": "APP_VERSION_NOT_FOUND",
"message": "App version 'av_abc123' not found"
}
}{
"error": {
"code": "APP_DELETED",
"message": "App version 'av_abc123' has been deleted"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded. Try again in 30 seconds.",
"retry_after": 30
}
}{
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "comfy-proxy is unreachable"
}
}