Organizations
Organizations are a way of grouping customers (developer accounts with access to ApiOmat).
An organization has an account and after login to the dashboard with that account, the organization can manage its customers and add customers that aren't in an organization yet.
There's always one default organization with the name "Default". When a customer is created by the SuperAdmin, they are added to that default organization. When a customer is created by an organization, they are added to that organization directly.
When the SuperAdmin or the organization assigns contracts to the organization, then the organization account and all customers within the organization need to accept the contract to be able to access ApiOmat. Read more about contracts here.
Create
Only the SuperAdmin can create organizations. This can be done in the organization management page of the dashboard:
This can also be done via request to the REST endpoint /organizations. See https://apiomat.yourcompany.com/apidocs/#!/organizations.
Manage
Add / remove customers
The SuperAdmin and the organization itself can add customers to the organization. But it can only add customers that are in the default organization.
In the dashboard a customer can be selected from the customer list and then getting edited. Only customers that are in the logged in organization or in the default organization are listed.
A customer always has to be in an organization, so if they are removed from the logged in one, they will be moved to the default organization.
Customers can also be added and removed with requests to the REST endpoint /organizations/{organizationName}/members. See https://apiomat.yourcompany.com/apidocs/#!/organizations/addMember and https://apiomat.yourcompany.com/apidocs/#!/organizations/removeMember for details.
Roles
Just like customers who created a backend (application) or module can grant read/write/etc access to other customers, organizations can manage access rights to all applications and modules that belong to customers that are members of the logged in organization.
To learn more about roles, see Application Roles and Module Roles.