API Reference
List prompts
GET /api/v1/prompts - list every prompt in the workspace with its folder, model, and live/staging version labels.
Returns every prompt in the workspace authenticated by the API key, along with each prompt's current live and staging version labels.
GET /api/v1/promptsRequest
curl https://app.promptvlt.com/api/v1/prompts \
-H "Authorization: Bearer pv_live_xxxxxxxxxxxxxxxxxxxx"Response
{
"prompts": [
{
"slug": "support-triage",
"folder": "support",
"model": "gpt-4o",
"liveVersion": "v22",
"stagingVersion": "v23"
},
{
"slug": "onboarding-email",
"folder": "lifecycle",
"model": "claude-opus-4-8",
"liveVersion": "v5",
"stagingVersion": null
}
],
"planStatus": "active"
}Fields
| Field | Type | Notes |
|---|---|---|
prompts[].slug | string | Workspace-unique identifier. |
prompts[].folder | string | Sidebar grouping. |
prompts[].model | string | Human-facing model hint saved on the prompt. |
prompts[].liveVersion | string | Label of the live version (e.g. v22). |
prompts[].stagingVersion | string | null | Label of the staging version, or null when no staging version is set. |
planStatus | string | Workspace billing state. Also returned in the x-promptvault-plan-status header. |