Skip to main content
Prefix: /v1/developer/observability/prompts. Reading/compiling requires model read access; creation/label changes require model execution access. URL-encode the entire prompt name when constructing its path.

Create a chat prompt

A text prompt instead sets type text and text to a string. A chat definition uses messages. Do not supply incompatible text and chat fields. Creating again creates a version; it is not an idempotent operation. The response identifies name and version. Read that version before promoting a label.

Compile

Use either version or label, never both. Supply required variables and message placeholders explicitly. Missing or malformed inputs fail instead of silently producing an incomplete conversation. Compilation is read-only and does not spend model credits. Definitions can compose supported same-workspace text dependencies. Keep names and versions deliberate; cross-workspace prompt access is not supported. See prompt workflows for linking a compiled prompt to execution.

Promote an exact version

A label selects one version. A request records the resolved exact version so a later label move does not rewrite historical attribution. Review compilation and output before moving a production label.

Input limits

config is a JSON record. Prototype-sensitive names and unsupported fields are rejected. Keep credentials out of templates, variables, tags and commit messages.