Organizations

Organizations are the foundational workspace model in LLMx Prompt Studio. They provide isolated environments where teams can collaboratively develop, test, and deploy AI prompts.

What is an Organization?

An organization (also called a workspace) is a container that holds all your prompts, folders, deployments, and team members. Every piece of content you create belongs to exactly one organization.

Think of organizations like separate projects or teams:

• Personal workspace: Your private sandbox for experimenting with prompts
• Team workspace: A shared environment where multiple people collaborate
• Client workspace: Isolated projects for different clients or departments

Key Concepts

Workspace Isolation

All data within an organization is completely isolated from other organizations:

• Prompts and folders are private to the organization
• Team members only see content from organizations they belong to
• API keys are scoped to individual organizations
• LLM provider configurations are organization-specific

This isolation ensures security and prevents accidental cross-contamination between projects.

Team Collaboration

Organizations enable real-time collaboration:

• Multiple team members can work on prompts simultaneously
• Changes are synced across all members instantly
• Version history tracks who made what changes
• Deployments can be managed by authorized team members

Role-Based Access Control

Every organization member has a role that determines their permissions:

See Members & Roles for detailed permission information.

Common Use Cases

Solo Developer

As an individual developer, you get a personal workspace automatically when you sign up. Use it to:

• Prototype new prompts
• Experiment with different LLM providers
• Test prompts before moving to production

Team Environment

Create a shared organization for your team to:

• Collaborate on prompt libraries
• Maintain consistent prompt standards
• Share LLM provider credentials securely
• Control who can deploy to production

Consultants & Agencies

Manage multiple clients by creating separate organizations:

• Keep client data completely isolated
• Invite client stakeholders as Viewers
• Maintain separate billing and provider configurations
• Transfer ownership when projects complete

Quick Start

1. First login: A personal workspace is automatically created for you
2. Create a team workspace: Click “New Organization” in the account menu
3. Invite teammates: Go to Settings > Members and send invitations
4. Start collaborating: Create prompts, folders, and deployments together

Next Steps

• Getting Started - Create and switch between workspaces
• Members & Roles - Understand the permission system
• Invitations - Learn how to invite team members
• API Keys - Set up external integrations
• Settings - Configure your organization

For Developers

Data Architecture

All resources in LLMx Prompt Studio are scoped to an organization. The data structure follows a hierarchical pattern:

organizations/
└── {org_id}/
    ├── name, slug, settings...
    ├── members/          # Team members
    ├── invitations/      # Pending invites
    ├── prompts/          # All prompts
    ├── folders/          # Folder hierarchy
    ├── deployments/      # Deployed prompts
    ├── api_keys/         # External access keys
    └── secrets/          # LLM provider credentials

Organization Context

When a user switches organizations, a global context is set that automatically scopes all subsequent operations:

// Frontend: Setting organization context
BaseFirestoreService.setOrgContext(orgId);
 
// All service calls now automatically use this org
await promptService.list(); // Returns prompts for current org
await folderService.create({...}); // Creates in current org

Multi-Tenancy

Users can belong to multiple organizations simultaneously:

• Each organization has its own member list
• A user can have different roles in different organizations
• Switching organizations changes the entire application context
• Organization selection persists across browser sessions