Assign Role Users ​
Endpoint ​
POST /unified/user-directory/users/assign_role
Integrations supported
- CrowdStrike
- JumpCloud
- TeamViewer
Query parameters ​
Refer Specifying query parameters in Truto APIs
The ID of the integrated account to use for the request.
62f44730-dd91-461e-bd6a-aedd9e0ad79d
The format of the response.
unified
will return the response with unified mappings applied.raw
will return the raw response from the remote API.normalized
will apply the unified mappings and return the data in a normalized format.
Defaults to unified
.
unified
raw
normalized
unified
Excludes the remote_data
attribute from the response.
Array of fields to exclude from the response.
truto_exclude_fields[]=id&truto_exclude_fields[]=name
Query parameters to pass to the underlying API without any transformations. Refer this guide to see how to structure the query parameters.
remote_query[foo]=bar
Request Body ​
Refer Writing data using Unified APIsThe roles of the user
Required in
- Slack Enterprise
The unique identifier for a role
The name of the role
The role of the user in the group. This is available when the user can have different roles in different groups or teams in an application.
The role of the user in the organization. This is available when the user can have different roles in different organizations in an application.
The role of the user in the workspace. This is available when the user can have different roles in different workspaces in an application.
The unique identifier for a group.
Required in
- Slack Enterprise
The unique identifier for a user
Required in
- Slack Enterprise
Any additional data that should be passed as part of the request body. This data is not transformed by Truto and is passed as is to the remote API.
Response Body ​
The unique identifier for a user
Supported in
- JumpCloud
The external identifier for a user. This is set when the SCIM API is being used.
The identifiers of the user.
The first name of the user
The last name of the user
The title of the user
The name of the user
The username of the user
The emails of the user
The email address
The type of email address
Whether the email address is primary
The phones of the user
The phone number
The extension of the phone number
The type of phone number
The status of the user. If no clear mapping is available, then the raw value is returned.
active
inactive
deleted
invited
Whether the user's email has been verified
Whether the user has 2FA enabled
The roles of the user
The unique identifier for a role
The name of the role
The role of the user in the group. This is available when the user can have different roles in different groups or teams in an application.
The role of the user in the organization. This is available when the user can have different roles in different organizations in an application.
The role of the user in the workspace. This is available when the user can have different roles in different workspaces in an application.
The organizations of the user
The unique identifier for an organization
The name of the organization
The type of user
The licenses of the user or the products the user has access to
The unique identifier for a license
The name of the license
The unique identifier of the organization to which the license belongs
The date and time the user was last active for the license
The groups of the user
The unique identifier for a group
The name of the group
The unique identifier of the organization to which the group belongs
The workspaces of the user
The unique identifier for a workspace
The name of the workspaces
The avatar of the user
The timezone of the user
The languages preferred by the user
The bio of the user. Usually a short description set by the user about them.
The date and time the user was created
The date and time the user was last updated
The date and time the user was last active
The date and time the user was last logged in
The date and time the user's status was last changed
The date and time the user was activated
The URLs of the user
The URL
The type of URL
Raw data returned from the remote API call.