update_prompt
Update an existing prompt with new values and create an archived version. Only changed fields are applied, and publishing activates the new version.
Instructions
Update an existing prompt and create a new archived version. Only provided fields change, and publish_prompt is what makes the new version active. For multi-message chat prompts pass messages (preferred) or a JSON-encoded array as string.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt_id | Yes | Prompt ID or slug to update | |
| name | No | New display name for the prompt | |
| collection_id | No | Move to a different collection | |
| string | No | Legacy prompt template string. Use plain text for single-message prompts, or a JSON-encoded messages array string for multi-message chat prompts. | |
| messages | No | Structured chat template alias for updates. Serialized to the legacy string format before the prompt is updated. | |
| parameters | No | New default values for template variables | |
| model | No | New model identifier | |
| virtual_key | No | New virtual key slug | |
| version_description | No | Description for this version | |
| template_metadata | No | New metadata | |
| functions | No | New function definitions | |
| tools | No | New tool definitions | |
| tool_choice | No | New tool choice strategy | |
| dry_run | No | When true, validate without updating |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | Whether the tool call succeeded and returned structured data | |
| data | No | Structured success payload when ok is true | |
| error | No | Structured error payload when ok is false |