Prompts

Update prompt version metadata

PATCH
/api/prompts/{promptId}/versions/{versionId}

Updates editable metadata fields (displayVersion, title, description) on a prompt version. Passing an explicit null clears the field; at least one field must be supplied.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

promptId*string
versionId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/api/prompts/string/versions/string" \  -H "Content-Type: application/json" \  -d '{    "displayVersion": "v1.5",    "title": "Tone tweak",    "description": "Softened opening line based on feedback."  }'
{  "message": "Prompt version updated successfully",  "version": {    "_id": "64d2f9c5e8a1d4e001a0b1d8",    "version": 5,    "label": "Pre-launch checkpoint (renamed)",    "displayVersion": "v1.4",    "title": "Pre-launch - final",    "description": "Renamed during launch retro.",    "source": "manual_save",    "createdAt": "2026-04-25T10:14:00.000Z"  }}