Core ConceptsOrganizations2 min read
Organizations
Organizations are the top-level container for all your projects and team members.
Creating an Organization
- Click Create Organization from the dashboard
- Enter an organization name
- Choose a unique URL slug (e.g.,
my-company) - Click Create
Managing Members
- Navigate to your organization's Settings > Members
- Click Invite Member
- Enter the user's email address
- Select a role:
- Owner: Full access, can delete organization
- Admin: Can manage projects and members
- Editor: Can create and edit content
- Viewer: Read-only access
- Click Send Invitation
The invitee receives an email. If they already have a Headless account, the link takes them to sign in, and signing in (or opening the organization while already signed in) accepts the invitation. If they are new, the link takes them to a Set up your account page where they create a password; completing it activates the account and accepts the invitation in one step, so they can sign in immediately. Setup links last 7 days. If one expires, the invitee can request a fresh link from Forgot password, or an admin can use Resend on the pending invitation.
Organization Settings
Access organization settings through the sidebar:
- General: Update name, slug, and logo
- Members: Manage team members and invitations
- Billing: View current plan and usage statistics
- Data: Export, import, or delete organization data
Role Permissions
| Action | Viewer | Editor | Admin | Owner |
|---|---|---|---|---|
| View content | ✓ | ✓ | ✓ | ✓ |
| Create entries | ✓ | ✓ | ✓ | |
| Edit entries | ✓ | ✓ | ✓ | |
| Delete entries | ✓ | ✓ | ✓ | |
| Manage content types | ✓ | ✓ | ||
| Manage API keys | ✓ | ✓ | ||
| Manage webhooks | ✓ | ✓ | ||
| Invite members | ✓ | ✓ | ||
| Change member roles | ✓ | ✓ | ||
| Delete project | ✓ | |||
| Delete organization | ✓ |
Removing Access
- Go to Organization Settings > Members
- Find the user to remove
- Click the menu icon (⋮)
- Select Remove from Organization
Audit Logs
Organization owners and admins can view audit logs:
- Click Audit Logs in the organization sidebar
- View a history of all actions taken in the organization
- Filter by action type, date range, or user
- Use audit logs for compliance and security monitoring