Templates

Create a new template

Creates a new template with the provided details. The template includes a slug, mode, content, and additional configuration options.

post/v1/templates

Request

Request body

slugstring required
mode'text' | 'openai' required
metadataPromptMetadata

Versioned key/value text, separate from model parameters and prompt variables. Keys are preserved exactly, must not be blank, and are limited to 256 characters. The reserved key proto is not allowed. Values must be strings. Numbers, booleans, null, arrays, and objects are rejected. The serialized object must be no larger than 64 KiB. Returned by prompt retrieval endpoints, including public-key retrieval; do not store secrets here. Omitted metadata defaults to an empty object on creation and is preserved on PATCH.

extraobject
testValuesobject
isDraftboolean
notesstring

Example request

{
  "metadata": {
    "owner": "support",
    "release_channel": "production",
    "locale": "en"
  }
}

Response

Successful response

idstring
namestring
slugstring
mode'text' | 'openai'
createdAtstring date-time
groupstring
projectIdstring

Example response

{
  "versions": [
    {
      "metadata": {
        "owner": "support",
        "release_channel": "production",
        "locale": "en"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.