Prompt Templates - Mesh API

Prompt templates let you save reusable system prompts with {{variable}} placeholders. Pass the template name in a chat request to apply it.

Create a template

Python
Node.js
Go

from meshapi import MeshAPI
from meshapi import CreateTemplateParams

client = MeshAPI(base_url="https://api.meshapi.ai", token="rsk_...")

tmpl = client.templates.create(
    CreateTemplateParams(
        name="my-assistant",
        description="A friendly pirate assistant",
        system="You are a {{role}}. Always reply in exactly one sentence.",
        variables=["role"],
    )
)
print(tmpl.id)
print(tmpl.name)

const tmpl = await client.templates.create({
  name: "my-assistant",
  description: "A friendly pirate assistant",
  system: "You are a {{role}}. Always reply in exactly one sentence.",
  variables: ["role"],
});
console.log(tmpl.id);
console.log(tmpl.name);

desc := "A friendly pirate assistant"
system := "You are a {{role}}. Always reply in exactly one sentence."

tmpl, err := client.Templates.Create(ctx, meshapi.CreateTemplateParams{
    Name:        "my-assistant",
    Description: &desc,
    System:      &system,
})
if err != nil {
    log.Fatal(err)
}
fmt.Println(tmpl.ID, tmpl.Name)

List templates

Python
Node.js
Go

templates = client.templates.list()
for t in templates:
    print(t.id, t.name)

const templates = await client.templates.list();
templates.forEach(t => console.log(t.id, t.name));

all, err := client.Templates.List(ctx)
for _, t := range all {
    fmt.Println(t.ID, t.Name)
}

Get a template

Python
Node.js
Go

got = client.templates.get(tmpl.id)
print(got.name)

const got = await client.templates.get(tmpl.id);
console.log(got.name);

got, err := client.Templates.Get(ctx, tmpl.ID)
fmt.Println(got.Name)

Update a template

Python
Node.js
Go

from meshapi import UpdateTemplateParams

updated = client.templates.update(
    tmpl.id,
    UpdateTemplateParams(description="Updated description"),
)
print(updated.description)

const updated = await client.templates.update(tmpl.id, {
  description: "Updated description",
});
console.log(updated.description);

newDesc := "Updated description"
updated, err := client.Templates.Update(ctx, tmpl.ID, meshapi.UpdateTemplateParams{
    Description: &newDesc,
})
fmt.Println(*updated.Description)

Delete a template

Python
Node.js
Go

client.templates.delete(tmpl.id)

await client.templates.delete(tmpl.id);

err := client.Templates.Delete(ctx, tmpl.ID)

Use a template in a chat request

Pass the template name and variable values in the chat request. See Chat Completions — Using a prompt template for the full example.

Python
Node.js
Go

from meshapi import ChatCompletionParams, ChatMessage

resp = client.chat.completions.create(
    ChatCompletionParams(
        model="openai/gpt-4o-mini",
        messages=[ChatMessage(role="user", content="Introduce yourself.")],
        template=tmpl.name,
        variables={"role": "friendly pirate"},
        max_tokens=80,
    )
)
print(resp.choices[0].message.content)

const resp = await client.chat.completions.create({
  model: "openai/gpt-4o-mini",
  messages: [{ role: "user", content: "Introduce yourself." }],
  template: tmpl.name,
  variables: { role: "friendly pirate" },
  max_tokens: 80,
});

maxTokens := 80
resp, err := client.Chat.Completions.Create(ctx, meshapi.ChatCompletionParams{
    Template:  &tmpl.Name,
    Messages:  []meshapi.ChatMessage{{Role: "user", Content: "Introduce yourself."}},
    Variables: map[string]string{"role": "friendly pirate"},
    MaxTokens: &maxTokens,
})