Group Assignments
Assigns a user to a specified group. The user gains all access controls (scopes) specified for this group.
Groups assigned to employee users must share the same vendor identifier.
The iam.assignment_create_own scope allows a customer to assign a user to a specified group only if the user is assigned to the same company.
Your Emporix tenant name.
Note: The tenant name should always be written in lowercase.
^[a-z][a-z0-9]+$Unique identifier of a group, generated when the group is created.
User unique identifier generated when the user is created. Might be customer ID or Management Dashboard user ID.
Assignment type, possible values: CUSTOMER, EMPLOYEE
EMPLOYEEExample: CUSTOMERPossible values: The request was successful. The user has been added to the group.
Request was syntactically incorrect.
Given request is unauthorized - the authorization token is invalid or has expired. It usually means that tenant from the token does not match tenant from path.
Scope validation failed, details will be provided in response message
Given resources cannot be found.
Removes all users from a specified group.
Your Emporix tenant name.
Note: The tenant name should always be written in lowercase.
^[a-z][a-z0-9]+$Unique identifier of a group, generated when the group is created.
The request was successful. All users have been deleted from the group.
No content
Given request is unauthorized - the authorization token is invalid or has expired. It usually means that tenant from the token does not match tenant from path.
Scope validation failed, details will be provided in response message
No content
Creates user's assignment to a specified group. The user gains all access controls (scopes) specified for this group. In case the assignment already exists, nothing happens as the type of assignment cannot be changed.
Groups assigned to employee users must share the same vendor identifier
Your Emporix tenant name.
Note: The tenant name should always be written in lowercase.
^[a-z][a-z0-9]+$Unique identifier of a group, generated when the group is created.
User type that may be one of: 'CUSTOMER', 'EMPLOYEE'
User unique identifier, generated when the user is created.
The request was successful. The user has been added to the group.
The request was successful. The user assignment already exists and has not been changed.
No content
Request was syntactically incorrect.
Given request is unauthorized - the authorization token is invalid or has expired. It usually means that tenant from the token does not match tenant from path.
Scope validation failed, details will be provided in response message
Given resources cannot be found.
Removes a specified user from a specified group.
The iam.assignment_delete_own scope allows a customer to remove user from a specified group only if the user is assigned to the same company.
Your Emporix tenant name.
Note: The tenant name should always be written in lowercase.
^[a-z][a-z0-9]+$Unique identifier of a group, generated when the group is created.
User unique identifier, generated when the user is created.
The request was successful. The user has been removed from the group.
No content
Given request is unauthorized - the authorization token is invalid or has expired. It usually means that tenant from the token does not match tenant from path.
Scope validation failed, details will be provided in response message
No content
Removes a specified user from all groups.
Your Emporix tenant name.
Note: The tenant name should always be written in lowercase.
^[a-z][a-z0-9]+$User unique identifier, generated when the user is created.
The request was successful. The user has been removed from all groups.
No content
Given request is unauthorized - the authorization token is invalid or has expired. It usually means that tenant from the token does not match tenant from path.
Permission denied due to insufficient rights. This may happen when request does not contain sufficient scopes for given query values.
No content
Last updated
Was this helpful?