API Reference · Secrets

List workspace secrets

List the paths + metadata of every secret stored in the workspace, plus the live list of workloads consuming each (any `pod.secretEnv` reading it from the `<workspace>-secrets` Secret — matched by `path`, or by the sanitized `key` for references created before paths). Values are NEVER returned. `key` is the sanitized Secret data key a `secretEnv` reference must target.

GET/v1/tenants/{name}/secrets

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.

Response

200 — The workspace's secret paths (no values).

secretsarray

curl https://api.live-llm.com/v1/tenants/acme/secrets \
  -H "x-api-key: $LIVELLM_KEY"

Try itGEThttps://api.live-llm.com/v1/tenants/{name}/secrets

API keyYour key stays in your browser (saved locally on this device) and is sent only to the API.

name*

Fill required path param: name.

Example response200

{
  "secrets": [
    {
      "path": "/prod/tg-bot-token",
      "key": "prod_tg_bot_token",
      "createdAt": "2026-07-01T09:12:00Z",
      "createdBy": "user:kamil",
      "updatedAt": "2026-07-20T14:03:00Z",
      "currentVersion": 3,
      "versions": [
        {
          "version": 3,
          "createdAt": "2026-07-20T14:03:00Z",
          "createdBy": "user:kamil",
          "note": "rotated",
          "current": true,
          "rollbackable": false
        },
        {
          "version": 2,
          "createdAt": "2026-07-10T08:00:00Z",
          "createdBy": "user:kamil",
          "note": "",
          "current": false,
          "rollbackable": true
        }
      ],
      "consumers": [
        "web"
      ]
    }
  ]
}