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
| Parameter | Notes |
|---|---|
slug | The prompt's workspace-unique slug. |
label | The 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
| Field | Type | Notes |
|---|---|---|
slug | string | The prompt's slug. |
folder | string | Sidebar grouping. |
model | string | Model hint saved on the prompt. |
temperature | number | Suggested generation temperature. |
version | string | The requested version label. |
source | string | The full prompt body at this version. |
systemSource | string | System-role content at this version. |
userSource | string | User-role content at this version. |
Errors
| Status | Meaning |
|---|---|
404 | The prompt slug, or the version label within it, does not exist. |