Skip to main content
PATCH
/
api
/
prompts
/
{promptId}
/
versions
/
{versionId}
Update prompt version metadata
curl --request PATCH \
  --url https://your-instance.example.com/api/prompts/{promptId}/versions/{versionId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.tetherai.ca/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
promptId
string
required
​
versionId
string
required

Body

application/json
​
displayVersion
string | null

Human label shown in the version dropdown (e.g. v1.4); pass null to clear.

​
title
string | null

Short label shown on the version timeline entry; pass null to clear.

​
description
string | null

Longer description shown on the version timeline entry; pass null to clear.

Response

Prompt version updated successfully

Returned by PATCH /api/prompts/{promptId}/versions/{versionId}.

​
message
string
required
​
version
object
required
Example:
{
  "_id": "65f9b1c2e8a1d4e001a0b1c3",
  "version": 4,
  "label": "Friendlier tone",
  "displayVersion": "v1.3",
  "title": "Tone update",
  "description": "Softened the opening line.",
  "source": "manual_save",
  "createdAt": "2026-04-22T10:14:00.000Z",
  "matchesCurrentPrompt": true,
  "preview": "<prompt><role>Leasing assistant</role>..."
}