Organizations: The Foundation of Team Collaboration
Organizations serve as the foundation for team-based collaboration in APIGIT:
- Organizations can own API repositories, similar to individual users
- Teams are created and managed within organization boundaries
- Teams collaborate on organization repositories according to their assigned permissions and visibility settings
A subscription account can host multiple organizations, allowing you to create separate workspaces for different departments, projects, or functional groups within your enterprise.
Key Benefits of Organizations
- Centralized Repository Management: Maintain all related repositories under one organizational roof
- Hierarchical Team Structure: Create specialized teams with appropriate access levels
- Scalable Collaboration: Easily add new members and adjust permissions as projects evolve
- Departmental Separation: Keep distinct business units or projects isolated when necessary
Managing Organizations
Creating and Deleting Organizations
Only the subscription account owner has the authority to create or delete organizations:
- Navigate to the Billing and Plan page
- Switch to the Account Organizations tab
- Use the interface to add new organizations or remove existing ones
The Account Organizations tab provides a comprehensive overview of your organizational structure, including:
- Total number of organizations
- Teams created within each organization
- Repositories owned by each organization
- Activity metrics for organizations
Organization Lifecycle
When creating a new organization:
- An owner team is automatically created
- The account owner becomes the first member of this team
- The organization becomes available for repository creation and team setup
When deleting an organization:
- All repositories within the organization will be deleted
- All teams associated with the organization will be disbanded
- Member associations with the organization will be removed
Note: Organization deletion is permanent and cannot be undone. Make sure to back up any important repositories before deleting an organization.
Next Steps After Creating an Organization
Once an organization is created:
- Set up teams with appropriate members
- Create repositories within the organization
- Configure team permissions for each repository
- Begin collaborating on your API development projects
Last updated on