API Reference · Templates

Save a resource template

Persists a reusable blueprint (the type-specific spec of a workload). Credentials are stripped server-side — a top-level `password`, and the `password` inside a `credentials` object, are dropped before storage.

POST/v1/tenants/{name}/templates

Authorization

x-api-keystringrequired
Your per-workspace API key, e.g. llc_AbC123…. Also accepted as Authorization: Bearer <key>. Mint keys on your workspace's API keys page — each key belongs to one workspace.

Path parameters

namestringrequired
Workspace (tenant) name.

Body

namestringrequired
e.g. web app
descriptionstringoptional
kindenumrequired
One of: vm-ubuntu · vm-ubuntu-desktop · vm-windows · pod · browser · controller · storage.
configobjectrequired
The workload-type spec blueprint (max 64KB serialized).

Response

201The created template.

idstring
e.g. tpl_3f9a1c2d4e5f
namestring
descriptionstring
kindenum
One of: vm-ubuntu · vm-ubuntu-desktop · vm-windows · pod · browser · controller · storage.
configobject
The workload-type spec blueprint (credentials stripped).
createdAtstring · date-time
curl -X POST https://api.live-llm.com/v1/tenants/acme/templates \
  -H "x-api-key: $LIVELLM_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "scraper browser",
    "description": "Chromium with the agent pre-wired",
    "kind": "browser",
    "config": {
      "browser": {
        "aiAgent": {
          "enabled": true,
          "provider": "zai-coding-plan",
          "model": "glm-5.2"
        }
      }
    }
  }'
Try itPOSThttps://api.live-llm.com/v1/tenants/{name}/templates
Fill required path param: name.
Example response201
{
  "id": "tpl_3fa1",
  "name": "scraper browser",
  "description": "Chromium with the agent pre-wired",
  "kind": "browser",
  "config": {
    "browser": {
      "aiAgent": {
        "enabled": true,
        "provider": "zai-coding-plan",
        "model": "glm-5.2"
      }
    }
  },
  "createdAt": "2026-07-11T08:30:00Z"
}