Every Sentry account belongs to at least one organization. An organization owns all of your projects, teams, members, integrations, and billing. From the source model:
# src/sentry/models/organization.py
class Organization(ReplicatedCellModel):
"""
An organization represents a group of individuals which maintain ownership of projects.
"""
name = models.CharField(max_length=64)
slug = SentryOrgSlugField(unique=True)
status = BoundedPositiveIntegerField(
choices=OrganizationStatus.as_choices(),
default=OrganizationStatus.ACTIVE.value,
)
date_added = models.DateTimeField(default=timezone.now)
default_role = models.CharField(max_length=32, default=str(roles.get_default().id))
Organization slug
Each organization has a unique slug that appears in Sentry URLs and in API paths:
https://sentry.io/organizations/<org_slug>/
/api/0/organizations/<org_slug>/projects/
Members and roles
Users join an organization through OrganizationMember. Each member is assigned a role that determines their permissions across the entire organization.
# src/sentry/models/organizationmember.py
class OrganizationMember(ReplicatedCellModel):
organization = FlexibleForeignKey("sentry.Organization")
user_id = HybridCloudForeignKey("sentry.User", ...)
role = models.CharField(max_length=32, default=str(roles.get_default().id))
| Role | Description |
|---|
| Member | Can view and interact with issues in projects they have access to. |
| Admin | Can manage team membership and project settings. |
| Manager | Can manage members, teams, and most organization settings. |
| Owner | Full access including billing, SSO configuration, and organization deletion. |
Teams
Teams group members and control which projects they can access. A user gains access to a project by being a member of a team that is assigned to that project.
# src/sentry/models/team.py
class Team(ReplicatedCellModel):
"""
A team represents a group of individuals which maintain ownership of projects.
"""
organization = FlexibleForeignKey("sentry.Organization")
slug = SentrySlugField()
name = models.CharField(max_length=64)
Organization flags
Several organization-wide behaviors are controlled by boolean flags on the Organization model:
# src/sentry/models/organization.py
class flags(TypedClassBitField):
allow_joinleave: bool # Members can join/leave teams without approval
enhanced_privacy: bool # Limit PII in notifications and source code display
disable_shared_issues: bool # Disable public sharing of issue details
early_adopter: bool # Access features before public release
require_2fa: bool # Enforce 2FA for all members
disable_member_project_creation: bool # Prevent members from creating projects
disable_member_invite: bool # Prevent members from inviting others
Organization settings
| Section | What you can configure |
|---|
| General | Organization name, slug, and default member role |
| Members | Invite members, manage roles, enforce 2FA |
| Teams | Create teams, add members, assign projects |
| Security & Privacy | SSO (SAML, Google Workspace), enhanced privacy, IP allow lists |
| Integrations | GitHub, GitLab, Slack, PagerDuty, and many more |
| Data retention | Event retention period (plan-dependent) |
| Auth tokens | Organization-level API tokens for CI/CD pipelines |
Multi-organization support
A single Sentry user can be a member of multiple organizations. Switching organizations is done through the organization selector in the top-left corner of the UI.
In self-hosted installations with SENTRY_SINGLE_ORGANIZATION = True, organization switching is hidden and all users belong to a single organization. Set this to False in sentry.conf.py to enable multi-organization mode.
Inviting members
Open Members settings
Go to Organization Settings → Members.
Click Invite Members
Enter one or more email addresses and select the role to assign.
Send the invitation
The invitee receives an email with a link that is valid for 30 days. Once they accept, they are added as an OrganizationMember.
If disable_member_invite is enabled on the organization, only managers and owners can send invitations.
