Create prompt template

POST

https://app.lumenia.net/api/v1/prompt-templates

POST

/api/v1/prompt-templates

$ curl -X POST https://app.lumenia.net/api/v1/prompt-templates \
>      -H "Authorization: Bearer <API_KEY>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "name": "Dental clinic receptionist",
>   "type": "voice",
>   "prompt": "You are the receptionist of {{company}}. Keep answers short and {{tone}}.",
>   "description": "Voice receptionist for dental clinics",
>   "firstMessage": "Thank you for calling {{company}}! How can I help you today?",
>   "variables": [
>     {
>       "key": "company",
>       "description": "The clinic name",
>       "type": "string",
>       "required": true
>     },
>     {
>       "key": "tone",
>       "type": "string",
>       "required": false,
>       "defaultValue": "friendly",
>       "validation": {
>         "enum": [
>           "friendly",
>           "formal"
>         ]
>       }
>     }
>   ],
>   "toolIds": [
>     "b2c3d4e5-6f70-4a1b-8c2d-3e4f5a6b7c8d"
>   ]
> }'

1 {
2   "template": {
3     "id": "a1b2c3d4-5e6f-4a0b-8c1d-2e3f4a5b6c7d",
4     "name": "Dental clinic receptionist",
5     "description": "Voice receptionist for dental clinics",
6     "type": "voice",
7     "createdAt": "2026-07-01T09:00:00.000Z",
8     "updatedAt": "2026-07-01T09:00:00.000Z",
9     "versionsCount": 1,
10     "latestPublishedVersion": null,
11     "pinnedWorkspacesCount": 0
12   },
13   "version": {
14     "id": "d4e5f6a7-8091-4c3d-ae4f-5a6b7c8d9e0f",
15     "templateId": "a1b2c3d4-5e6f-4a0b-8c1d-2e3f4a5b6c7d",
16     "version": 1,
17     "status": "draft",
18     "publishedAt": null,
19     "archivedAt": null,
20     "createdAt": "2026-07-01T09:00:00.000Z",
21     "prompt": "You are the receptionist of {{company}}. Keep answers short and {{tone}}.",
22     "firstMessage": "Thank you for calling {{company}}! How can I help you today?",
23     "variables": [
24       {
25         "key": "company",
26         "description": "The clinic name",
27         "type": "string",
28         "required": true,
29         "defaultValue": null,
30         "validation": null
31       },
32       {
33         "key": "tone",
34         "description": null,
35         "type": "string",
36         "required": false,
37         "defaultValue": "friendly",
38         "validation": {
39           "enum": [
40             "friendly",
41             "formal"
42           ]
43         }
44       }
45     ],
46     "tools": [
47       {
48         "id": "b2c3d4e5-6f70-4a1b-8c2d-3e4f5a6b7c8d",
49         "name": "get_order_status"
50       }
51     ]
52   }
53 }

Create a prompt template and its initial draft version.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

namestringRequired

Human-readable template name. Must be unique among the partner templates.

typeenumRequired

The channel the template is written for. Fixed for the life of the template.

Allowed values:

promptstringRequired

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

descriptionstringOptional

What the template is for.

firstMessagestringOptional

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

variableslist of objectsOptional

Definitions for the placeholders used in the prompt and firstMessage.

toolIdslist of stringsOptional

Partner tools used by this version, by ID. The tools become available when this version is assigned to a workspace.

Response

The created template and its initial draft version.

templateobject

The newly created template.

versionobject

The version 1 draft, in full detail.

Errors

400

Bad Request Error

403

Forbidden Error

409

Conflict Error

500

Internal Server Error