models:read; mutations
require models:run and applicable workspace permission.
Create a chat prompt
Compile a selected version
version or label. Missing required template inputs
fail explicitly. Variables are strings. Message placeholders supply arrays of
system/user/assistant messages; they are not arbitrary raw objects.
Promote with a label
getPrompt(name, { label: "production" }).
This label mutation assigns the supplied labels; inspect the result rather than
assuming an append-only operation.
Link model observations
An SDKobservability.prompt selection takes name, exactly one version or
label, and the required variables/placeholders. CLI/local MCP use
DREAMTUNE_PROMPT_NAME, one of DREAMTUNE_PROMPT_VERSION or
DREAMTUNE_PROMPT_LABEL, and optional JSON DREAMTUNE_PROMPT_INPUTS.
The resolved exact version is linked to the generation. Keep selection and
inputs unchanged when replaying an operation.
Template and size rules
- Names are at most 128 characters, with slash-separated alphanumeric, underscore,
period or hyphen segments;
.and..path segments are not accepted. - Chat definitions contain 1–20 messages/placeholders; text definitions use
textand cannot also containmessages. - String variables and message content are at most 8,000 characters. Template inputs serialize to at most 16,000 characters.
- Labels and tags are unique arrays of at most 20 entries; label strings accept letters, digits, underscores, periods and hyphens, up to 64 characters.