PromptVault Docs
API Reference

Get a version

GET /api/v1/prompts/{slug}/versions/{label} - read one specific prompt version by its label, regardless of which version is live.

Reads one specific version of a prompt by its label, regardless of which version is currently live or staged. Useful for pinning to an exact version or auditing historical prompt content.

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

Path parameters

ParameterNotes
slugThe prompt's workspace-unique slug.
labelThe version label to fetch, e.g. v21.

Request

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

Response

{
  "slug": "support-triage",
  "folder": "support",
  "model": "gpt-4o",
  "temperature": 0.2,
  "version": "v21",
  "source": "You are a support triage assistant...",
  "systemSource": "You are a support triage assistant...",
  "userSource": "Classify the ticket: {{ticket}}"
}

Fields

FieldTypeNotes
slugstringThe prompt's slug.
folderstringSidebar grouping.
modelstringModel hint saved on the prompt.
temperaturenumberSuggested generation temperature.
versionstringThe requested version label.
sourcestringThe full prompt body at this version.
systemSourcestringSystem-role content at this version.
userSourcestringUser-role content at this version.

Errors

StatusMeaning
404The prompt slug, or the version label within it, does not exist.

On this page