Skip to main content
POST
/
api
/
prompts
/
{promptId}
/
versions
Create a prompt version checkpoint
curl --request POST \
  --url https://your-instance.example.com/api/prompts/{promptId}/versions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "Pre-launch checkpoint",
  "displayVersion": "v1.4",
  "title": "Pre-launch",
  "description": "Snapshot before rolling out to production.",
  "source": "manual_save"
}
'
{
  "message": "Version saved",
  "skipped": false,
  "version": 5,
  "versionId": "65f9b1c2e8a1d4e001a0b1c4"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
promptId
string
required

Body

application/json
​
prompt
string

Optional override; defaults to current prompt body when omitted

​
label
string
​
displayVersion
string | null
​
title
string | null
​
description
string | null
​
source
enum<string>
Available options:
manual_save,
ai_apply,
checkpoint

Response

Version saved (or no-op when unchanged)

​
message
string
​
skipped
boolean
​
version
integer
​
versionId
string
​
versionSnapshot
object
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>..."
}