create_prompt
Register a new prompt template with a unique name and version. Prevents duplicates by returning a 409 conflict. Enables AI agents to auto-register templates for evaluations and experiments.
Instructions
Register one new prompt template (Pro+ only). name + version + template are required; variables / labels / description are optional. An existing (name, version) pair returns 409 (UNIQUE constraint). Used when an AI agent auto-registers templates for dogfood evals / experiments.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Prompt name (series identifier, [A-Za-z0-9][A-Za-z0-9_-]{0,63}). E.g. 'customer_support' | |
| labels | No | Array of labels (up to 8, each [A-Za-z0-9][A-Za-z0-9_-]{0,31}). E.g. ['production', 'staging']. | |
| version | Yes | Version identifier ([A-Za-z0-9][A-Za-z0-9._-]{0,63}). E.g. 'v1' / '1.0.2' / '2026-06-03' | |
| template | Yes | Prompt body (non-empty, up to 50000 chars). {{var}} placeholders are filled from variables. | |
| variables | No | Default values for {{var}} placeholders in the template (plain object, 4096 bytes max after JSON serialization). Optional. | |
| description | No | Description (up to 500 chars). Optional. |