Concepts
A tour of the entities and rules that shape every PromptVault screen and SDK call.
A short tour of the entities and rules that shape every screen and every SDK call.
Workspace
A workspace is the top-level home for a team's prompts, versions, API keys, members, activity, and integrations.
| Property | Notes |
|---|---|
| Name | Display name shown in the sidebar. Editable by owners. |
| Owner | The person who created or owns the workspace. |
| Staging | Optional workflow that lets test keys read a staged version before it goes live. |
A user can belong to multiple workspaces. The dashboard opens the active workspace for the signed-in user.
Members and roles
Every member is either an owner or a member.
| Capability | Owner | Member |
|---|---|---|
| Create/edit/delete prompts and versions | yes | yes |
| Create and revoke API keys | yes | yes |
| Manage integrations | yes | yes |
| Toggle workspace settings | yes | no |
| Invite or remove members | yes | no |
| View pending invitations | yes | no |
Prompt
A prompt is the unit of "the thing the LLM reads." It is identified by a slug that is unique inside its workspace.
| Field | Purpose |
|---|---|
| Slug | URL-safe identifier, such as support-triage or onboarding-email. |
| Folder | Sidebar grouping. |
| Model | Human-facing model hint. |
| Temperature | Suggested generation temperature returned by the SDK. |
| Live version | Version served to pv_live_ keys. |
| Staging version | Optional version served to pv_test_ keys. |
| Draft | Current editor buffer. |
Version
A version is a snapshot of the prompt source.
| Field | Notes |
|---|---|
| Label | Auto-incremented per prompt, such as v1 or v22. |
| Status | live or draft. |
| Source | The prompt body at that point in history. |
| Message | Commit-style note explaining the change. |
| Author | The workspace member who saved it. |
When you save in the editor, you choose a target:
- Draft saves a checkpoint without changing live or staging reads.
- Staging saves a draft and makes it visible to
pv_test_keys. - Live publishes a version to
pv_live_keys.
API keys
API keys authenticate SDK reads.
| Key type | Resolves to |
|---|---|
pv_live_... | The prompt's live version. |
pv_test_... | The prompt's staging version, falling back to live when staging is unset. |
Use pv_test_ keys in CI, preview environments, and staging environments. Use pv_live_ keys in production.
Activity
Activity records meaningful workspace actions such as creating prompts, saving versions, rolling back, connecting integrations, and deleting prompts. Use the Activity feed to answer "what changed?" and "who did it?"
Integrations
A workspace can connect to Langfuse, Helicone, Braintrust, Webhook, PostHog, and GitHub. Integrations receive prompt lifecycle events and let your existing tools handle traces, evals, audit, or external mirrors.
AI Evaluator
The AI Evaluator reviews draft prompts and surfaces issues that need attention. Re-run it after prompt changes to confirm the current draft is ready to ship.