Core concepts
User vs workspace, personal vs team, prompts vs versions vs fragments, and what the free tier actually gives you.
PromptAssay has three identity layers that sit on top of each other independently. Keeping them straight is the single biggest thing that makes the app feel simple vs confusing.
User
Your PromptAssay account. One per person. Owns your email, password, MFA factors, OAuth connections, data-export rights, and profile preferences. You always have exactly one.
Workspace (org)
A container for prompts, folders, tags, fragments, BYOK keys, API keys, billing, and membership. Every user has at least a personal workspace (auto-created on signup) and can create team workspaces up to their plan's limit (0 on Free, 1 on Solo, 5 on Team, unlimited on Enterprise).
| Workspace type | Members | Deletable |
|---|---|---|
| Personal | Exactly one forever (you). Invitations explicitly rejected. | Only via account deletion. |
| Team | Up to the tier's maximum member count. Owner + admins + members. | Yes — owner-only, 30-day soft-delete grace period. |
Prompt, version, fragment
- Prompt
- Mutable record holding your current working copy, metadata (title, description, type, target model, intent), and pointers to the latest version and folder.
- Version
- Immutable snapshot of a prompt's content. Created automatically on every save with a change source tag. You can diff any two, restore any prior, or branch a new working copy from one.
- Fragment
- Reusable snippet of prompt text with optional variable slots. Embed one in a prompt with
${fragment:id}and it gets resolved at playground / API time. Handy for shared preambles, output-format directives, or policy blocks.
Tier
Per-workspace billing plan. Free / Solo / Team / Enterprise. Controls monthly LLM call quota, max team members, API access, and SAML SSO availability. New workspaces default to the free tier until someone completes a Stripe checkout for that workspace. See Plans and limits for the full matrix.