/safetyculture-users | Type: Application | PCID required: Yes
Tools
safetyculture_users_directory_add_users_folders_associations
Associate users to folders Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
assignments | object | No | — | Map of folder ID to users assignments |
safetyculture_users_directory_create_folder
Create a folder Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
domain | string | No | — | domain 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 |
id | string | No | — | Optional. Folder UUID. If unspecified, backend will generate the ID. |
meta_label | string | Yes | — | Required. 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. |
name | string | Yes | — | Required. Non-empty folder name. Limited to maximum 250 characters. |
parent_id | string | No | — | Optional. Parent folder UUID. If unspecified, will be created as a root folder |
safetyculture_users_directory_delete_folders
Delete folders (bulk) Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
folder_ids | any[] | Yes | — | Required. Folder ids of the folders to be deleted |
cascade_up | boolean | No | — | Deleting 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. |
domain | string | No | — | domain 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | Required. The folder identifier we want to get all the users for |
get_users_of_descendants | boolean | No | — | Optional. 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | Required. The folder identifier to retrieve info for |
with_ancestors | boolean | No | — | When true, an array of the folders ancestors will also be returned. |
with_all_children_count | boolean | No | — | When 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page_size | integer | No | — | Required. This determines the max number of folders returned in the response. |
page_token | string | No | — | Optional. base64 encoded. If this field is present, the list of folders returned will start from the row after this token. |
order_by.sort_field | string | No | — | The 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_order | string | No | — | The 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_nodes | boolean | No | — | Optional. When true, GetFolders will only return leaf node folders. leaf nodes are folders that do not have children Defaults to false. |
with_ancestors | boolean | No | — | Optional. When true, folders will be returned with a list of their ancestors as well. Defaults to false |
include_deleted | boolean | No | — | When true, deleted folders will also be returned |
ignore_folders_disabled | boolean | No | — | Optional. When true, folders will still be returned when disabled for the organisation |
domain | string | No | — | domain 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | Optional. The identifier of the parent folder. When no parent folder ID is given all top level root folders will be returned |
include_members_count | boolean | No | — | Optional. Whether to return the directly associated members count with the folders. Defaults to false. |
limit | integer | No | — | The number of results to be returned. |
page_token | string | No | — | Optional. base64 encoded. If this field is present, the list of folders returned will start from the row after this token. |
include_inherited_members_count | boolean | No | — | Optional. Whether to include the number of inherited members for each folder |
domain | string | No | — | domain 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_folders | boolean | No | — | When true, GetFoldersByParent will only return folders that are assigned to the user making the request. Defaults to false |
with_deleted_folders | boolean | No | — | Optional. 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
user_id | string | Yes | — | Required. The user identifier we want to remove folders from |
folder_ids | any[] | Yes | — | Required. List of folder IDs to remove association to given user |
safetyculture_users_directory_search_folders
Search folders Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
domain | string | No | — | domain 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 |
filters | any[] | No | — | Optional. 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_disabled | boolean | No | — | Optional. When true, folders will still be returned when disabled for the organisation |
include_deleted_folders | boolean | No | — | Whether to return both deleted and non-deleted folders. Defaults to false |
include_folders_count | boolean | No | — | Whether to return the total number of folders discovered in the query. Defaults to false |
include_members_count | boolean | No | — | Whether to return the directly associated members count with the folders. Defaults to false. |
limit | integer | No | — | The number of results to be returned. maximum 1500, default 500 |
only_assigned_folders | boolean | No | — | When true, SearchFolders will only return folders that are assigned to the user making the request. Defaults to false |
only_leaf_nodes | boolean | No | — | When true, SearchFolders will only search location folders. Defaults to false. |
order_by | object | No | — | The order in which folders are sorted. |
page_token | string | No | — | The offset used for pagination. The starting number for the next query |
query | string | No | — | Optional. 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | Required. The folder identifier of the folder to be updated. |
domain | string | No | — | domain represents the type/domain/hierarchy for the folder. This is used for changing the properties of a specific domain folder |
name | object | No | — | Optional. Non-empty folder name. Limited to maximum 250 characters. |
safetyculture_users_permissions_service_assign_permission_set
Assign user to a permission set Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | No | — | Optional. The ID of the permission set. |
name | string | No | — | Optional. The name of the permission set to assign. De-prioritised in favour of id. |
user_ids | any[] | No | — | The IDs of the users to assign. |
safetyculture_users_permissions_service_get_permission_set
Get a permission set Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | The ID of the permission set. |
include_users | boolean | No | — | Whether 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filters | any[] | No | — | (Optional). The filters to apply. |
include_users | boolean | No | — | Whether to include users in the response. |
limit | integer | No | — | The maximum number of permission sets to return. |
offset | integer | No | — | The offset of the first permission set to return. |
search | string | No | — | Search input to filter down the permission sets. |
sort | object | No | — | The sorting to apply. |
safetyculture_users_the_pub_service_add_new_user_to_group
Add user to a group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
group_id | string | Yes | — | The ID of the group to add the user to. |
user_id | string | Yes | — | The ID of the user to add to the group. |
safetyculture_users_the_pub_service_add_user
Create a user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
email | string | Yes | — | The email address of the user. |
firstname | string | Yes | — | The first name of the user. |
lastname | string | Yes | — | The last name of the user. |
message | string | No | — | Message passed to the newly created user. |
password | string | Yes | — | The password of the user. |
seat_type | string | No | — | The billing seat type of the added user, free or full. |
safetyculture_users_the_pub_service_create_group
Create a group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | Yes | — | The name of the group to be created. |
safetyculture_users_the_pub_service_get_user
Get a user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
user_id | string | Yes | — | The id of the user to be retrieved. |
safetyculture_users_the_pub_service_list_groups
List groupssafetyculture_users_the_pub_service_list_users_in_group
List a group’s or an organization’s users Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
group_id | string | Yes | — | The ID of the group or organization to list users for. |
limit | integer | No | — | The maximum number of users to return. optional |
offset | integer | No | — | The offset to start listing users from. optional |
status | any[] | No | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
group_id | string | Yes | — | The ID of the group or organization to remove the user from. |
user_id | string | Yes | — | The ID of the user to remove. |
replacement_user | string | No | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
email | any[] | Yes | — | Emails to filter by. Required. |
safetyculture_users_the_pub_service_update_user
Update a user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
user_id | string | Yes | — | The id of the user to be updated. |
firstname | string | No | — | The first name of the user. Optional |
lastname | string | No | — | The last name of the user. Optional |
new_email | string | No | — | The email address of the user. Optional |
seat_type | string | No | — | The billing seat type of the added user, free or full. Optional |
status | string | No | — | The status of the user. Optional |

