Organizations & Teams

Organizations provide multi-tenant isolation in FireBackup. All resources (projects, backups, schedules, storage destinations) belong to an organization, enabling team collaboration with role-based access control.

Understanding Organizations

Organization Scope

Everything in FireBackup is scoped to an organization:

• Projects - Firebase projects belong to one organization
• Backups - Backups are stored per organization
• Schedules - Backup schedules are organization-specific
• Storage - Storage destinations are configured per organization
• Members - Users are invited to specific organizations

Multi-Organization Support

Users can belong to multiple organizations:

• Personal organization - Created automatically for each user
• Team organizations - Shared organizations for teams
• Enterprise organizations - Large-scale deployments

Switch between organizations using the organization selector in the header.

Creating an Organization

Default Organization

When you sign up, FireBackup creates a personal organization with your name.

Creating Additional Organizations

1. Click the organization selector in the header
2. Click Create Organization
3. Enter organization details:

Field	Description
Name	Organization display name
Slug	URL-friendly identifier

4. Click Create

You become the Owner of the new organization.

Organization Settings

Accessing Settings

1. Go to Settings in the sidebar
2. Click Organization tab

General Settings

Setting	Description
Name	Organization display name
Slug	URL identifier
Time Zone	Default time zone for schedules
Logo	Organization logo (shown in header)

Updating Organization

1. Navigate to Organization settings
2. Modify desired fields
3. Click Save Changes

Team Members

Viewing Members

The Members section shows all organization members:

Column	Description
User	Name and email
Role	Permission level
Status	Active or Pending
Joined	When they joined
Last Active	Most recent activity

Member Roles

Role	Permissions
Owner	Full access, billing, can delete organization
Admin	Manage members, settings, all resources
Member	Create and manage backups, schedules, projects
Viewer	Read-only access to all resources

Permission Matrix

Action	Owner	Admin	Member	Viewer
View backups	Yes	Yes	Yes	Yes
Create backups	Yes	Yes	Yes	No
Delete backups	Yes	Yes	Yes	No
Manage schedules	Yes	Yes	Yes	No
Connect projects	Yes	Yes	Yes	No
Manage storage	Yes	Yes	No	No
Invite members	Yes	Yes	No	No
Manage roles	Yes	Yes	No	No
Organization settings	Yes	Yes	No	No
Billing	Yes	No	No	No
Delete organization	Yes	No	No	No

Inviting Members

1. Navigate to Organization settings > Members
2. Click Invite Member
3. Enter details:

Field	Description
Email	Invitee's email address
Role	Permission level to assign

4. Click Send Invitation

The invitee receives an email with a link to accept the invitation.

Pending Invitations

View and manage pending invitations:

Column	Description
Email	Invited email
Role	Assigned role
Sent	When invitation was sent
Expires	Invitation expiration

Actions:

• Resend - Send invitation email again
• Cancel - Revoke the invitation

Managing Member Roles

To change a member's role:

1. Find the member in the list
2. Click the role dropdown
3. Select new role
4. Confirm change

Role Changes

Changing from Admin to Member removes their ability to invite others and manage settings.

Removing Members

To remove a member from the organization:

1. Find the member in the list
2. Click Remove
3. Confirm removal

Access Revocation

Removed members immediately lose access to all organization resources.

Accepting Invitations

When invited to an organization:

1. Check your email for the invitation
2. Click Accept Invitation
3. Sign in or create an account
4. You're added to the organization with the assigned role

Invitation Expiration

Invitations expire after 7 days. If expired:

1. Contact the organization administrator
2. Request a new invitation

Organization Billing

Viewing Subscription

Owners can view billing information:

1. Go to Settings > Organization
2. Click Billing tab

Shows:

• Current plan
• Usage metrics
• Billing history
• Payment methods

Upgrading Plans

1. Navigate to Billing settings
2. Click Upgrade Plan
3. Select desired plan
4. Complete payment

Managing Payment Methods

Add, update, or remove payment methods:

1. Navigate to Billing settings
2. Click Payment Methods
3. Add or update payment details

Transferring Ownership

To transfer organization ownership:

1. Navigate to Organization settings
2. Click Transfer Ownership
3. Select the new owner (must be Admin)
4. Confirm transfer

Ownership Transfer

After transfer, you become an Admin. Only the new Owner can transfer ownership again.

Deleting an Organization

Prerequisites

Before deleting:

• Must be the Owner
• All backups should be downloaded or deleted
• All members should be notified

Deletion Options

Soft Delete

Marks organization as deleted but retains data:

1. Go to Organization settings
2. Click Delete Organization
3. Choose Soft Delete
4. Type organization name to confirm

Data can be recovered within 30 days.

Force Delete

Permanently removes organization and all data:

1. Go to Organization settings
2. Click Delete Organization
3. Choose Force Delete
4. Type organization name to confirm

Permanent Deletion

Force delete permanently removes:

• All projects
• All backups
• All schedules
• All storage destinations
• All member associations

This action cannot be undone.

Service Accounts

Organizations can use service accounts for programmatic access:

Creating Service Account

1. Go to Settings > Organization
2. Navigate to Service Accounts section
3. Click Create Service Account
4. Configure:

Field	Description
Name	Service account identifier
Description	Purpose of this account
Permissions	API scopes

5. Click Create
6. Download the API key (shown once)

Service Account Permissions

Permission	Description
backups:read	List and view backups
backups:write	Create and delete backups
schedules:read	View schedules
schedules:write	Create and modify schedules
projects:read	View connected projects
projects:write	Connect and manage projects

Using Service Accounts

Use the API key in requests:

curl -X GET https://api.firebackup.io/api/v1/backups \
  -H "Authorization: Bearer SERVICE_ACCOUNT_KEY" \
  -H "X-Organization-Id: org-123"

Rotating Service Account Keys

1. Navigate to the service account
2. Click Rotate Key
3. Download new key
4. Update your applications
5. Old key is invalidated immediately

Deleting Service Accounts

1. Navigate to the service account
2. Click Delete
3. Confirm deletion

Immediate Effect

Deleting a service account immediately invalidates its key. Ensure no critical systems depend on it.

Audit Logging

Organizations automatically log important actions:

Logged Events

Category	Events
Members	Invite, join, role change, remove
Projects	Connect, disconnect, settings change
Backups	Create, restore, delete
Schedules	Create, modify, delete, toggle
Settings	Organization updates, billing changes

Viewing Audit Logs

1. Go to Settings > Organization
2. Click Audit Log tab
3. Filter and search logs

Column	Description
Timestamp	When event occurred
User	Who performed action
Action	What was done
Resource	Affected resource
Details	Additional information

Exporting Audit Logs

Export logs for compliance:

1. Click Export
2. Select date range
3. Choose format (CSV, JSON)
4. Download file

Best Practices

Organization Structure

Scenario	Recommendation
Single developer	Use personal organization
Small team	One shared organization
Multiple projects	One organization per project or client
Enterprise	Organization per department or team

Security Recommendations

1. Use least privilege - Assign minimum required role
2. Regular audits - Review members and permissions quarterly
3. Service accounts - Use for automation, not personal access
4. Rotate keys - Rotate service account keys periodically
5. Monitor audit logs - Watch for unusual activity

Team Onboarding

When adding new team members:

1. Create invitation with appropriate role
2. Share relevant documentation
3. Conduct initial walkthrough
4. Review after first week

Team Offboarding

When removing team members:

1. Review their created resources
2. Transfer ownership if needed
3. Remove from organization
4. Rotate any shared credentials

Troubleshooting

"Invitation Expired" Error

Solution:

1. Contact organization admin
2. Request new invitation

"Permission Denied" Error

Possible causes:

1. Insufficient role
2. Resource belongs to different organization

Solution:

1. Check your role in the organization
2. Verify you're in the correct organization
3. Contact admin for role upgrade

"Cannot Delete Organization"

Possible causes:

1. Not the owner
2. Active resources exist

Solution:

1. Transfer ownership to yourself first
2. Delete or migrate resources before deletion

Next Steps

• Connect your first project
• Configure storage destinations
• API Authentication
• Security & Compliance