Update template version (draft only)

PATCH

https://app.lumenia.net/api/v1/prompt-template-versions/:versionId

PATCH

/api/v1/prompt-template-versions/:versionId

curl -X PATCH https://app.lumenia.net/api/v1/prompt-template-versions/versionId \
     -H "Authorization: Bearer <API_KEY>" \
     -H "Content-Type: application/json" \
     -d '{
  "prompt": "You are the receptionist of {{company}}. Always answer in {{language}}."
}'

{
  "version": {
    "id": "e5f6a7b8-9102-4d4e-bf50-6b7c8d9e0f1a",
    "templateId": "a1b2c3d4-5e6f-4a0b-8c1d-2e3f4a5b6c7d",
    "version": 3,
    "status": "draft",
    "publishedAt": null,
    "archivedAt": null,
    "createdAt": "2026-07-10T09:00:00.000Z",
    "prompt": "You are the receptionist of {{company}}. Always answer in {{language}}.",
    "firstMessage": "Thank you for calling {{company}}!",
    "variables": [
      {
        "key": "company",
        "description": null,
        "type": "string",
        "required": true,
        "defaultValue": null,
        "validation": null
      },
      {
        "key": "language",
        "description": null,
        "type": "string",
        "required": false,
        "defaultValue": "English",
        "validation": null
      }
    ],
    "tools": []
  }
}

Update a draft template version.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <API_KEY>, where API_KEY is your API key.

Path parameters

versionIdstringRequired

Draft version to update.

Request

Fields to change. Every field is optional but you must send at least one; only the fields you send are updated.

promptstringOptional

The system prompt. May contain {{placeholder}} variables — declare each one in variables before the version can be published.

firstMessagestring or nullOptional

The call greeting. Only valid on voice templates; may also contain {{placeholder}} variables.

variableslist of objectsOptional

Definitions for the placeholders used in the prompt and firstMessage. Sending this REPLACES the full set; omit it to leave the variables untouched.

toolIdslist of stringsOptional

Partner tools this version references, by id. Only tools owned by the same partner are accepted. Sending this REPLACES the full set; omit it to leave the tools untouched.

Response

The updated draft version.

versionobject

The updated draft, in full detail.

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

500

Internal Server Error