Users
User Account Deletion Policy
To maintain system security and efficiency user accounts (including API users for integrations) that meet the following conditions will be automatically deleted: Users who haven’t logged in for a year and have been removed from their last company over six months ago.
Users are created to Maventa based on an email address. Creation happens at the time of the company account opening, or separately over API or user interface. A user can be connected to many companies and a company can have many users.
Created company user can be real person or an api-user that is a technical user only. Same api-user can be added to multiple accounts, but usually for integrators with larger amount of customers it is for security reasons recommended to have own api-user per account. For example email could be formatted as maventauser+companyBID@example_domain.com.
Access to Maventa web user interface requires access to user email for authentication. If the new users will log in to UI make sure they have access to their email address.
You can control the user rights by changing the user role. There are two roles, user and admin user. Compared to admin, users have more limited rights to service, they cannot for example modify company details or settings or add new users to the company.
You can configure user specific setting in Maventa, e.g. notifications which user would like to get.
- user_create_e to create or add a new or existing user to a company
- user_list to list company users
- user_show to show information about a specific user
- user_update_e to update users details. Note that user’s email address cannot be updated through the API
- user_delete to delete a user from a company account. You cannot delete your own user account
- POST/v1/users to create API user (technical user)
- POST/v1/company/users to add a new or existing user to a company (UI user)