In Apidog, an organization is used to centrally manage multiple teams and members. With organizations, you can control permissions, assign roles, and ensure efficient collaboration across your company.Creating an Organization#
You can create one or more organizations. To create a new organization:1.
In the main window, click Organizations from the left navigation panel to open the organization management page.
2.
Click the + New Organization button at the bottom left.
π· Visual Reference
3.
Enter the organization name.
π· Visual Reference
4.
Click Create. Your new organization is now set up.
Organization Members and Roles#
You can invite members into your organization and assign them different roles:Org Admin: Has the highest permissions (except the org owner). Can manage organization members, teams, and organization settings.
Org Member: Can join the organization and its teams, and collaborate on projects. Cannot change organization settings.
Inviting Members#
To invite members into the organization:1.
Go to Members under your organization.
π· Visual Reference
2.
Click Invite, enter their emails to send an invitation, or share the invite link.
π· Visual Reference
Custom Project Roles#
π· Custom Roles Examples
Relation Between Organizations and Teams#
Organization: The highest-level management unit, representing a company or large group. It manages multiple teams.
Teams: A sub-unit within an organization, usually a department or smaller group. It manages multiple projects.
Organization vs. Team β Which Should You Choose?#
When using Apidog, a common question is: should you manage everything directly under an Organization, or mainly rely on Teams? The answer really comes down to two things β team size and business scope.If Your Team is Small and Focused#
Say you've got around ten people all working on the same product line. In that case, a single Team is more than enough. A Team can handle projects, APIs, and members in one place β simple and efficient, without the extra overhead of an Organization.If Your Company is Large and Spread Out#
If you've got lots of people and multiple, unrelated business lines, it's best to create an Organization first, then set up separate Teams inside it for each business area. Each Team manages its own projects and members, with clear boundaries and no overlap.Updating Organization Info#
Admins can update the organization's name or details from Settings. All members will see the updated info.π· Visual Reference
Transferring the Organization#
The organization owner can transfer ownership to another member via Organization Settings β Danger Zone β Transfer.π· Visual Reference
Dismissing the Organization#
The organization owner can permanently delete the organization under Organization Settings β Danger Zone β Dismiss Organization.π· Visual Reference
Dismissing an organization is permanent and cannot be undone. All teams and projects within the organization will be deleted.
