Create a template | Mesh API Docs

curl -X POST https://api.meshapi.ai/v1/templates \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "support-reply",
  "description": "Structured support reply template.",
  "system": "You are a helpful support assistant for {{company}}.",
  "messages": [
    {
      "role": "user",
      "content": "Respond with empathy and clear next steps."
    }
  ],
  "model": "openai/gpt-4o-mini",
  "params": {
    "temperature": 0.2,
    "max_tokens": 300
  },
  "variables": [
    "company"
  ]
}'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "support-reply",
  "is_global": false,
  "created_at": "2024-04-01T12:00:00+00:00",
  "updated_at": "2024-04-01T12:00:00+00:00",
  "owner": "user_123",
  "description": "Structured support reply template.",
  "system": "You are a helpful support assistant for {{company}}.",
  "messages": [
    {
      "role": "user",
      "content": "Respond with empathy and clear next steps."
    }
  ],
  "model": "openai/gpt-4o-mini",
  "params": {
    "temperature": 0.2,
    "max_tokens": 300
  },
  "variables": [
    "company"
  ]
}

Creates a template owned by the authenticated owner.

Template names must be unique within an owner namespace. Global templates are read-only from this API.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

namestringRequired>=1 character

descriptionstring or nullOptional

systemstring or nullOptional

messageslist of objects or nullOptional

modelstring or nullOptional

paramsobject or nullOptional

variableslist of strings or nullOptional

Response

Template created successfully.

idstringformat: "uuid"

namestring

is_globalboolean

created_atdatetime

updated_atdatetime

ownerstring or null

descriptionstring or null

systemstring or null

messageslist of objects or null

modelstring or null

paramsobject or null

variableslist of strings or null

Errors

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

422

Unprocessable Entity Error