This guide covers how to manage your organization's team, including inviting members, assigning roles, and configuring permissions.
Organization Overview
What is an Organization?
An organization in Girard is a collaborative workspace where:
- Team members share access to features
- Usage and billing are centralized
- Resources and settings are managed together
Organization Structure
Organization
├── Owner (1)
├── Admins (multiple)
└── Members (multiple)
Roles and Permissions
Role Comparison
| Permission | Owner | Admin | Member |
|---|---|---|---|
| Use all features | ✅ | ✅ | ✅ |
| View usage stats | ✅ | ✅ | ✅ |
| Manage API keys | ✅ | ✅ | ❌ |
| Invite members | ✅ | ✅ | ❌ |
| Remove members | ✅ | ✅ | ❌ |
| Change member roles | ✅ | ✅ | ❌ |
| Manage billing | ✅ | ❌ | ❌ |
| Delete organization | ✅ | ❌ | ❌ |
| Transfer ownership | ✅ | ❌ | ❌ |
Role Descriptions
Owner
- Full control over the organization
- Only one owner per organization
- Manages billing and subscription
- Can delete the organization
- Can transfer ownership
Admin
- Manages team members
- Creates and revokes API keys
- Configures organization settings
- Cannot access billing
- Cannot delete organization
Member
- Uses Girard features
- Views own usage
- Cannot manage team or settings
Managing Team Members
Inviting Members
- Navigate to Settings > Team
- Click Invite Members
- Enter email addresses (one per line)
- Select a role (Admin or Member)
- Click Send Invites
Invite Email: Recipients receive an email with:
- Organization name
- Inviter's name
- Link to accept invitation
- Expiration (7 days)
Accepting Invitations
New members:
- Click the invitation link
- Sign up or sign in to Girard
- Automatically join the organization
- Access organization resources
Existing users:
- Click the invitation link
- Confirm joining the organization
- If in another organization, prompted to switch
Viewing Team Members
See all members at Settings > Team:
| Column | Description |
|---|---|
| Name | Member's display name |
| Email address | |
| Role | Owner, Admin, or Member |
| Joined | Date they joined |
| Status | Active or Pending |
Changing Roles
- Go to Settings > Team
- Find the member
- Click the role dropdown
- Select new role
- Confirm the change
Note: Only owners and admins can change roles.
Removing Members
- Go to Settings > Team
- Find the member to remove
- Click Remove
- Confirm removal
What happens:
- Member loses access immediately
- Their data remains (generations, etc.)
- They receive a notification email
- They can be re-invited later
Pending Invitations
Managing Invitations
View pending invitations at Settings > Team > Pending:
- See all outstanding invites
- Check invitation status
- Resend or cancel invitations
Resending Invitations
If an invitation expires or wasn't received:
- Find the pending invitation
- Click Resend
- New email sent with fresh link
Canceling Invitations
To revoke a pending invitation:
- Find the pending invitation
- Click Cancel
- Link becomes invalid
Transferring Ownership
When to Transfer
- Leaving the organization
- Changing leadership
- Account consolidation
How to Transfer
- Go to Settings > Team
- Click Transfer Ownership
- Select new owner (must be current admin)
- Enter your password to confirm
- Ownership transfers immediately
After Transfer:
- You become an Admin
- New owner has full control
- Billing transfers to new owner
Best Practices
Security
| Practice | Reason |
|---|---|
| Use minimum necessary roles | Principle of least privilege |
| Review members regularly | Remove inactive users |
| Remove departing employees | Prevent unauthorized access |
| Audit admin actions | Track who made changes |
Team Organization
- Assign clear roles - Match role to responsibility
- Limit admin count - 2-3 admins per organization
- Document access - Keep records of who has access
- Regular audits - Review membership quarterly
Onboarding New Members
-
Send welcome message with:
- Quick start resources
- Key features to explore
- Team contacts for help
-
Set up:
- Appropriate role
- Relevant notifications
- Shared resources access
Multi-Organization Support
Belonging to Multiple Organizations
Users can belong to multiple organizations:
- Separate workspaces
- Different billing
- Independent resources
Switching Organizations
- Click organization name in header
- Select different organization
- Context switches to that org
Creating Additional Organizations
- Click organization dropdown
- Select Create Organization
- Enter new organization details
- Invite members as needed
Troubleshooting
Invitation Issues
"Invitation expired"
- Request a new invitation from an admin
- Links expire after 7 days
"Email not received"
- Check spam/junk folder
- Verify email address is correct
- Ask admin to resend
"Already in another organization"
- You can join multiple organizations
- Accept invitation to add it to your account
Access Issues
"Cannot access feature"
- Check your role permissions
- Contact an admin for access
"Cannot see team settings"
- Only admins and owners see team management
- Ask an admin for help
Role Change Issues
"Cannot change to Owner"
- Only current owner can transfer ownership
- Ownership must be transferred, not assigned
"Cannot remove Owner"
- Owner must transfer ownership first
- Then they can leave or be removed
API Access for Teams
Team API Keys
- API keys are organization-scoped
- All team members share usage limits
- Admins can create/revoke keys
Individual vs Team Keys
| Key Type | Scope | Use Case |
|---|---|---|
| Organization Key | Shared by team | Production apps |
| Development Key | Individual dev | Testing, development |
Key Naming Convention
Recommended naming:
[environment]-[purpose]-[owner]
production-api-main
staging-testing-john
development-local-jane
Previous: Prompt Engineering | Next: Billing & Plans