Templates

Find ready-to-deploy configurations from the App Gallery.

List the app gallery's templates as ready-made apps.create configurations (image, ports, env, hardware); pass a template's config to apps.create with a name, edited as needed. notes says what a template needs filled in first.

get

Any API key can call this.

Authorizations

AuthorizationstringRequired

An API key from Account settings, e.g. kn_...

Query parameters

searchstring · min: 1 · max: 100Optional

Case-insensitive substring of the name or image

categorystring · enumOptional

Only templates of this category

Possible values:

Responses

200

OK

application/json

400

The request body, query or headers are invalid (invalid_request, invalid_idempotency_key, ...)

application/json

401

The API key is missing, malformed, unknown, revoked or expired

application/json

403

The key lacks a required permission (insufficient_scope), is limited to other projects or to projects while the call acts on the organization (key_project_restricted), the caller's role on the resource is too low (forbidden), or the account is frozen

application/json

404

No such resource, or the caller cannot see it

application/json

429

Too many requests; see the X-RateLimit-* headers and Retry-After

application/json

500

Something failed on our side; the request id is in the body

application/json

502

A service we depend on (the runtime, GitHub) did not answer; retry shortly

application/json

503

The feature is not enabled on this server (github_not_configured), or a service we depend on is down; retry later

application/json

504

A service we depend on did not answer in time; retry shortly

application/json

get/templates

GET /v1/templates HTTP/1.1
Host: api.kinesis.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "templates": [
    {
      "id": "text",
      "name": "text",
      "category": "llm_general",
      "image": null,
      "paidTierOnly": true,
      "notes": null,
      "config": {
        "image": "text",
        "registryAuth": {
          "username": "text",
          "password": "text"
        },
        "ports": [
          {
            "port": 1,
            "protocol": "tcp"
          }
        ],
        "env": [
          {
            "key": "text",
            "value": null,
            "secret": true
          }
        ],
        "command": [
          "text"
        ],
        "entrypoint": [
          "text"
        ],
        "startupCommand": {
          "args": [
            "text"
          ],
          "user": "text",
          "timeoutSec": 1,
          "startPeriodSec": 1
        },
        "healthcheck": {
          "test": [
            "text"
          ],
          "intervalSec": 1
        },
        "restartPolicy": {
          "mode": "disabled",
          "startTimeoutSec": 1,
          "maxRetriesPerNode": 1,
          "maxErrorTolerance": 1,
          "numTasks": 1
        },
        "instances": {
          "min": 1,
          "max": 1
        },
        "stateful": true,
        "hardware": {
          "gpuCount": 1,
          "gpuModels": [
            "text"
          ],
          "gpuManufacturer": "amd",
          "gpuVramBytes": 1,
          "ramBytes": 1,
          "storageBytes": 1,
          "shmemBytes": 1
        },
        "placement": {
          "regions": [
            "us-west"
          ],
          "providers": [
            {
              "csp": "aws",
              "regions": [
                {
                  "region": "text",
                  "zones": [
                    "text"
                  ]
                }
              ]
            }
          ],
          "allowedIps": [
            "text"
          ]
        },
        "grids": {
          "ids": [
            "text"
          ],
          "priorities": {
            "ANY_ADDITIONAL_PROPERTY": 1
          }
        },
        "volumes": [
          {
            "name": "text",
            "target": "text",
            "declaredSizeBytes": 1
          }
        ]
      }
    }
  ],
  "galleryUrl": "text"
}