List versions

GET /api/v1/prompts/{slug}/versions - retrieve the full append-only version history of a prompt.

Returns the full version history for a prompt - every saved snapshot, newest first, each with its commit-style message and author.

GET /api/v1/prompts/{slug}/versions

Path parameters

Parameter	Notes
`slug`	The prompt's workspace-unique slug.

Request

curl https://app.promptvlt.com/api/v1/prompts/support-triage/versions \
  -H "Authorization: Bearer pv_live_xxxxxxxxxxxxxxxxxxxx"

Response

{
  "versions": [
    {
      "label": "v22",
      "message": "Tighten the classification rubric",
      "author": "Maya Chen",
      "source": "You are a support triage assistant...",
      "systemSource": "You are a support triage assistant...",
      "userSource": "Classify the ticket: {{ticket}}",
      "createdAt": "2026-05-30T14:12:09.000Z"
    }
  ]
}

Fields

Field	Type	Notes
`versions[].label`	string	Auto-incremented version label (e.g. `v22`).
`versions[].message`	string	Commit-style note describing the change.
`versions[].author`	string	Name of the member who saved the version (`""` if unavailable).
`versions[].source`	string	The full prompt body at this version.
`versions[].systemSource`	string	System-role content at this version.
`versions[].userSource`	string	User-role content at this version.
`versions[].createdAt`	string	ISO 8601 timestamp of when the version was saved.

Errors

Status	Meaning
`404`	No prompt with this slug exists in the workspace.