Kimara API Docs
Apps

Get app version metadata

Returns the public name, version, description, input schema, and a ready-to-use API snippet for a published app version.

GET
/apps/{appVersionId}

Authorization

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.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://kimara.ai/api/v1/apps/av_abc123"
{
  "publicName": "Sunset Generator",
  "version": 1,
  "description": "Generates beautiful sunset images from text prompts.",
  "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
    }
  ],
  "api_snippet": {
    "method": "POST",
    "url": "https://kimara.ai/api/v1/apps/av_abc123",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    "body": {
      "inputs": {
        "property1": "string",
        "property2": "string"
      }
    }
  }
}

{
  "error": "Missing API key"
}

{
  "error": "Account suspended"
}

{
  "error": {
    "code": "APP_VERSION_NOT_FOUND",
    "message": "App version 'av_abc123' not found"
  }
}