Skip to main content
Server path: /safetyculture-users | Type: Application | PCID required: Yes

Tools

ToolDescription
safetyculture_users_directory_add_users_folders_associationsAssociate users to folders
safetyculture_users_directory_create_folderCreate a folder
safetyculture_users_directory_delete_foldersDelete folders (bulk)
safetyculture_users_directory_get_all_users_by_folderRetrieve users associated to a folder, includes both directly and indirectly (inherited)
safetyculture_users_directory_get_folderRetrieve a folder
safetyculture_users_directory_get_foldersList folders
safetyculture_users_directory_get_folders_by_parentGet folders (by parent)
safetyculture_users_directory_remove_folders_associationRemove association for a specific user to multiple folders
safetyculture_users_directory_search_foldersSearch folders
safetyculture_users_directory_update_folder_propertiesUpdate a folder
safetyculture_users_permissions_service_assign_permission_setAssign user to a permission set
safetyculture_users_permissions_service_get_permission_setGet a permission set
safetyculture_users_permissions_service_list_permission_setsList permission sets
safetyculture_users_the_pub_service_add_new_user_to_groupAdd user to a group
safetyculture_users_the_pub_service_add_userCreate a user
safetyculture_users_the_pub_service_create_groupCreate a group
safetyculture_users_the_pub_service_get_userGet a user
safetyculture_users_the_pub_service_list_groupsList groups
safetyculture_users_the_pub_service_list_users_in_groupList a group’s or an organization’s users
safetyculture_users_the_pub_service_remove_userRemove user from a group
safetyculture_users_the_pub_service_search_usersList users (by email)
safetyculture_users_the_pub_service_update_userUpdate a user

safetyculture_users_directory_add_users_folders_associations

Associate users to folders Parameters:
ParameterTypeRequiredDefaultDescription
assignmentsobjectNoMap of folder ID to users assignments

safetyculture_users_directory_create_folder

Create a folder Parameters:
ParameterTypeRequiredDefaultDescription
domainstringNodomain represents the type/domain/hierarchy for the folder. This is used for getting folders of a certain domain, i.e. getting all template folders or site folders
idstringNoOptional. Folder UUID. If unspecified, backend will generate the ID.
meta_labelstringYesRequired. Must be one of: “location”, “area”, “region”, “state”, or “country”. Note that these meta labels may not match custom site hierarchy labels used by the organization.
namestringYesRequired. Non-empty folder name. Limited to maximum 250 characters.
parent_idstringNoOptional. Parent folder UUID. If unspecified, will be created as a root folder

safetyculture_users_directory_delete_folders

Delete folders (bulk) Parameters:
ParameterTypeRequiredDefaultDescription
folder_idsany[]YesRequired. Folder ids of the folders to be deleted
cascade_upbooleanNoDeleting folders will always cascade down. If a parent is deleted, then all of its children are deleted. When cascade_up is true, if a child is deleted, and it’s parent no longer has any children, then it will be deleted too. This will cascade all the way up the tree.
domainstringNodomain represents the type/domain/hierarchy for the folder. This is used for deleting folders within a specified domain

safetyculture_users_directory_get_all_users_by_folder

Retrieve users associated to a folder, includes both directly and indirectly (inherited) Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesRequired. The folder identifier we want to get all the users for
get_users_of_descendantsbooleanNoOptional. When true, it will return all of the members of a specified folder and its children folders recursively. Default false, will return all of the members of a specified folder and its parent/ancestor folders.

safetyculture_users_directory_get_folder

Retrieve a folder Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesRequired. The folder identifier to retrieve info for
with_ancestorsbooleanNoWhen true, an array of the folders ancestors will also be returned.
with_all_children_countbooleanNoWhen true, the total count of all children underneath the folder will be returned. This is a recursive count and will include children of children

safetyculture_users_directory_get_folders

List folders Parameters:
ParameterTypeRequiredDefaultDescription
page_sizeintegerNoRequired. This determines the max number of folders returned in the response.
page_tokenstringNoOptional. base64 encoded. If this field is present, the list of folders returned will start from the row after this token.
order_by.sort_fieldstringNoThe field to order by - SORT_FIELD_UNSPECIFIED: The sort field is unspecified - SORT_FIELD_NAME: Sort the folder by name - SORT_FIELD_FOLDER_ID: Sort the folders by folder id - SORT_FIELD_USER_ID: Sort the folders by user id - SORT_FIELD_CREATED_AT: Sort the folders by created at - SORT_FIELD_MODIFIED_AT: Sort the folders by modified at
order_by.sort_orderstringNoThe direction to order by - SORT_ORDER_UNSPECIFIED: The sort order is not specified - SORT_ORDER_ASCENDING: The sort order is asc - SORT_ORDER_DESCENDING: The sort order is desc
only_leaf_nodesbooleanNoOptional. When true, GetFolders will only return leaf node folders. leaf nodes are folders that do not have children Defaults to false.
with_ancestorsbooleanNoOptional. When true, folders will be returned with a list of their ancestors as well. Defaults to false
include_deletedbooleanNoWhen true, deleted folders will also be returned
ignore_folders_disabledbooleanNoOptional. When true, folders will still be returned when disabled for the organisation
domainstringNodomain represents the type/domain/hierarchy for the folder. This is used for getting folders of a certain domain, i.e. getting all template folders or site folders

safetyculture_users_directory_get_folders_by_parent

Get folders (by parent) Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesOptional. The identifier of the parent folder. When no parent folder ID is given all top level root folders will be returned
include_members_countbooleanNoOptional. Whether to return the directly associated members count with the folders. Defaults to false.
limitintegerNoThe number of results to be returned.
page_tokenstringNoOptional. base64 encoded. If this field is present, the list of folders returned will start from the row after this token.
include_inherited_members_countbooleanNoOptional. Whether to include the number of inherited members for each folder
domainstringNodomain represents the type/domain/hierarchy for the folder. This is used for getting folders of a certain domain, i.e. getting all template folders or site folders
only_assigned_foldersbooleanNoWhen true, GetFoldersByParent will only return folders that are assigned to the user making the request. Defaults to false
with_deleted_foldersbooleanNoOptional. When true, deleted and non-deleted folders will be returned.

safetyculture_users_directory_remove_folders_association

Remove association for a specific user to multiple folders Parameters:
ParameterTypeRequiredDefaultDescription
user_idstringYesRequired. The user identifier we want to remove folders from
folder_idsany[]YesRequired. List of folder IDs to remove association to given user

safetyculture_users_directory_search_folders

Search folders Parameters:
ParameterTypeRequiredDefaultDescription
domainstringNodomain represents the type/domain/hierarchy for the folder. This is used for getting folders of a certain domain, i.e. getting all template folders or site folders
filtersany[]NoOptional. Filters to apply when getting folders. Used for only returning folders that match the filter setting. i.e. only returning meta_label ‘location’. Maximum of 1000 filters allowed.
ignore_folders_disabledbooleanNoOptional. When true, folders will still be returned when disabled for the organisation
include_deleted_foldersbooleanNoWhether to return both deleted and non-deleted folders. Defaults to false
include_folders_countbooleanNoWhether to return the total number of folders discovered in the query. Defaults to false
include_members_countbooleanNoWhether to return the directly associated members count with the folders. Defaults to false.
limitintegerNoThe number of results to be returned. maximum 1500, default 500
only_assigned_foldersbooleanNoWhen true, SearchFolders will only return folders that are assigned to the user making the request. Defaults to false
only_leaf_nodesbooleanNoWhen true, SearchFolders will only search location folders. Defaults to false.
order_byobjectNoThe order in which folders are sorted.
page_tokenstringNoThe offset used for pagination. The starting number for the next query
querystringNoOptional. The search value to query folders with when provided. When not provided, either all of the organisations folders or users folders will be returned in a paginated way

safetyculture_users_directory_update_folder_properties

Update a folder Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesRequired. The folder identifier of the folder to be updated.
domainstringNodomain represents the type/domain/hierarchy for the folder. This is used for changing the properties of a specific domain folder
nameobjectNoOptional. Non-empty folder name. Limited to maximum 250 characters.

safetyculture_users_permissions_service_assign_permission_set

Assign user to a permission set Parameters:
ParameterTypeRequiredDefaultDescription
idstringNoOptional. The ID of the permission set.
namestringNoOptional. The name of the permission set to assign. De-prioritised in favour of id.
user_idsany[]NoThe IDs of the users to assign.

safetyculture_users_permissions_service_get_permission_set

Get a permission set Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID of the permission set.
include_usersbooleanNoWhether to include users in the response. Only includes a preview of 10 users, not the entire list

safetyculture_users_permissions_service_list_permission_sets

List permission sets Parameters:
ParameterTypeRequiredDefaultDescription
filtersany[]No(Optional). The filters to apply.
include_usersbooleanNoWhether to include users in the response.
limitintegerNoThe maximum number of permission sets to return.
offsetintegerNoThe offset of the first permission set to return.
searchstringNoSearch input to filter down the permission sets.
sortobjectNoThe sorting to apply.

safetyculture_users_the_pub_service_add_new_user_to_group

Add user to a group Parameters:
ParameterTypeRequiredDefaultDescription
group_idstringYesThe ID of the group to add the user to.
user_idstringYesThe ID of the user to add to the group.

safetyculture_users_the_pub_service_add_user

Create a user Parameters:
ParameterTypeRequiredDefaultDescription
emailstringYesThe email address of the user.
firstnamestringYesThe first name of the user.
lastnamestringYesThe last name of the user.
messagestringNoMessage passed to the newly created user.
passwordstringYesThe password of the user.
seat_typestringNoThe billing seat type of the added user, free or full.

safetyculture_users_the_pub_service_create_group

Create a group Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesThe name of the group to be created.

safetyculture_users_the_pub_service_get_user

Get a user Parameters:
ParameterTypeRequiredDefaultDescription
user_idstringYesThe id of the user to be retrieved.

safetyculture_users_the_pub_service_list_groups

List groups

safetyculture_users_the_pub_service_list_users_in_group

List a group’s or an organization’s users Parameters:
ParameterTypeRequiredDefaultDescription
group_idstringYesThe ID of the group or organization to list users for.
limitintegerNoThe maximum number of users to return. optional
offsetintegerNoThe offset to start listing users from. optional
statusany[]NoThe status to filter users by. optional - active: Active user. - inactive: Inactive user.

safetyculture_users_the_pub_service_remove_user

Remove user from a group Parameters:
ParameterTypeRequiredDefaultDescription
group_idstringYesThe ID of the group or organization to remove the user from.
user_idstringYesThe ID of the user to remove.
replacement_userstringNoThe ID of the user to reassign data to when removing the user from an organization.

safetyculture_users_the_pub_service_search_users

List users (by email) Parameters:
ParameterTypeRequiredDefaultDescription
emailany[]YesEmails to filter by. Required.

safetyculture_users_the_pub_service_update_user

Update a user Parameters:
ParameterTypeRequiredDefaultDescription
user_idstringYesThe id of the user to be updated.
firstnamestringNoThe first name of the user. Optional
lastnamestringNoThe last name of the user. Optional
new_emailstringNoThe email address of the user. Optional
seat_typestringNoThe billing seat type of the added user, free or full. Optional
statusstringNoThe status of the user. Optional