update_prompt
Update an existing prompt with new fields, archive the old version, and publish to activate changes. Supports both single and multi-message formats.
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 |