Runs
Get run status and outputs
Poll a run by ID to check its status. When status is completed, the
outputs array contains download URLs for generated files.
Output URLs are time-limited SAS URLs. Re-poll the run to get fresh URLs if they expire.
AuthorizationBearer <token>
Pass your API key as a Bearer token: Authorization: Bearer kim_<prefix>_<secret>
In: header
Path Parameters
id*string
The run ID returned when a run was created.
Format
uuidResponse Body
application/json
application/json
application/json
curl -X GET "https://kimara.ai/api/v1/runs/550e8400-e29b-41d4-a716-446655440000"{
"run_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "completed",
"created_at": "2026-04-06T12:00:00.000Z",
"started_at": "2026-04-06T12:00:05.000Z",
"completed_at": "2026-04-06T12:00:30.000Z",
"error_message": "Node 5 failed: out of memory",
"outputs": [
{
"filename": "ComfyUI_00001_.png",
"url": "https://storage.example.com/outputs/ComfyUI_00001_.png?sv=2024-05-04&se=...",
"content_type": "image/png",
"size_bytes": 1048576
}
]
}{
"error": "Missing API key"
}{
"error": {
"code": "APP_VERSION_NOT_FOUND",
"message": "App version 'av_abc123' not found"
}
}