/safetyculture-actions | Type: Application | PCID required: Yes
Tools
safetyculture_actions_customer_configuration_service_get_action_labels
Get all action labelssafetyculture_actions_scheduling_service_create_new_schedule
Create a new schedule Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
assignment | object | Yes | — | Specifies which users are assigned to complete the work. |
completion_rule | string | No | — | Completion rule for the schedule. Determines how many assigned users must complete the work for an occurrence to be considered complete. Defaults to COMPLETION_RULE_ANY (any single assigned user can complete it) if not specified. |
recurrence | object | Yes | — | The recurrence pattern that defines when and how frequently the scheduled event occurs. |
target | object | No | — | Specifies which sites or assets this schedule applies to. When set, a separate occurrence is created for each target (site or asset) at each recurrence. When not set, the schedule creates occurrences directly for the assigned users. |
title | string | Yes | — | Title of the schedule. |
work_type | object | No | — | The work to be done as part of the schedule. |
safetyculture_actions_service_create_action
Create an action Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
asset_id | string | No | — | ID of the Asset associated with the action |
collaborators | any[] | No | — | The collaborators involved into this action. |
created_at | string | No | — | Date and time this action was created. |
description | string | No | — | Description of the action (maximum 30000 characters). |
due_at | string | No | — | Date/time this action is due |
field_values | any[] | No | — | Array of custom fields and their values to create with the action. |
inspection_id | string | No | — | ID of the inspection the action belongs to If not set, this action is a standalone action and the inspection ID will be null. |
inspection_item_id | string | No | — | ID of the item in the inspection associated with the action |
label_ids | any[] | No | — | IDs of the labels associated with the action. |
priority_id | string | No | — | ID of the action’s priority If not set, this action will be stored with the default priority(none). |
references | any[] | No | — | Array of references attached to this action. |
site_id | string | No | — | ID of the Site associated with the action. |
status_id | string | No | — | ID of the action’s status If not set, this action will be stored with the default status(to do). |
task_id | string | No | — | The unique identifier of the action If not provided, UUID will be generated server side. |
template_id | string | No | — | If a template ID is provided then an inspection ID must be provided. If not set, this action is a standalone action and the template ID will be null. |
template_ids | any[] | No | — | The list of templates to be linked to the action. |
title | string | Yes | — | Required. Title of the action Title is limited to only 255 characters max. |
type | object | No | — | The type to create an action in. |
safetyculture_actions_service_create_action_shared_link
Create an action link Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | Yes | — | Required. The unique identifier for the action |
safetyculture_actions_service_delete_actions
Delete actions (Bulk) Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ids | any[] | No | — | The list of action ids to be deleted |
modified_at | string | No | — | Optional. The UTC time and date the deletion took place. |
safetyculture_actions_service_get_action
Get an Action Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | ID to query data for |
safetyculture_actions_service_get_action_shared_link
Get an action link Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | Yes | — | Required. The unique identifier for the action |
safetyculture_actions_service_get_actions
List actions Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
inspection_id | string | No | — | Optional. The ID of the inspection the action belongs to. Deprecated, inspectionID in filters should be used instead. |
offset | integer | No | — | Optional. Offset from where on the actions will be listed. |
page_size | integer | No | — | Optional. Number of actions to be returned in a single request. Maximum 100. Non-positive values are ignored. The presence of next_page_token in the response indicates that more results might be available. For example: ‘20’. |
page_token | string | No | — | Optional. If present, then retrieve the next batch of results from the preceding call to this method. page_token must be the value of next_page_token from the previous response. The values of other method parameters should be identical to those in the previous call. For example: ‘ODFBMzQ3MDYtNzQxNy00RDZGLThDNjE1MEFDMkM4MTQ3NDQ=’. |
sort_direction | string | No | — | Optional. Direction for sorting. |
sort_field | string | No | — | Optional. Which field to use for sorting. |
task_filters | any[] | No | — | Optional. The array of filters to apply in your request. You can apply multiple filters in a single request. |
without_count | boolean | No | — | Optional. If true, will not return the count of actions. |
safetyculture_actions_service_revoke_action_shared_link
Delete an action link Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | Yes | — | Required. The unique identifier for the action |
safetyculture_actions_service_update_action_labels
Updates the labels associated with an action Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
action_id | string | Yes | — | action_id is the ID of the action to be updated. |
label_ids | any[] | No | — | The list of label IDs to associate with the action. Multiple labels can be added. Note: Sending an empty list for label_ids will remove all labels currently associated with the action. |
modified_at | string | No | — | Date and time this label was modified. |
safetyculture_actions_service_update_asset
Update the asset of an action Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | Yes | — | Required. The UUID of the task being updated. |
asset_id | object | No | — | Optional. The new asset UUID for the task. If this is empty, the asset will be unset. |
modified_at | string | No | — | Optional. The timestamp of when this event occurred. |
safetyculture_actions_service_update_assignees
Update the assignees of an action Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | Yes | — | Required. The unique identifier for the task to be updated. |
assignees | any[] | Yes | — | Required. The assignees to be assigned to the task. |
modified_at | string | No | — | Optional. The UTC time and date the modification took place. |
safetyculture_actions_service_update_description
Update the description of an action Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | Yes | — | Required. The UUID of the task being updated. |
description | string | No | — | Required. The new description for the task. |
modified_at | string | No | — | Optional. The timestamp of when this event occurred. |
safetyculture_actions_service_update_due_at
Update the due date of an action Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | Yes | — | Required. The UUID of the task being updated |
due_at | string | No | — | Optional. Date/time this task is due. If this is empty, “due at” will be unset. |
modified_at | string | No | — | Optional. The timestamp of when this event occurred. |
safetyculture_actions_service_update_priority
Update the priority of an action Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | Yes | — | Required. The UUID of the task being updated. |
modified_at | string | No | — | Optional. The timestamp of when this event occurred. |
priority_id | string | Yes | — | Required. The new priority UUID for the task. |
safetyculture_actions_service_update_site
Update the site of an action Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | Yes | — | Required. The UUID of the task being updated. |
modified_at | string | No | — | Optional. The timestamp of when this event occurred. |
site_id | object | No | — | Optional. The new site UUID for the task. If this is empty, the site will be unset. Use the GetFolders endpoint to get the available sites. |
safetyculture_actions_service_update_status
Update the status of an action Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | Yes | — | Required. The ID of the action or issue you’re updating. |
modified_at | string | No | — | Optional. The UTC time and date the modification took place. |
status_id | string | Yes | — | Required. The ID of the status you’re updating the action or issue to. An issue can be in an “Open” or “Resolved” status, where each status is represented by hardcoded UUID values. Issue statuses: - Open: 547ed646-5e34-4732-bb54-a199d304368a. - Resolved: 450484b1-56cd-4784-9b49-a3cf97d0c0ad. An action can be in a “To do”, “In progress”, “Complete”, or “Can’t do” status, where each status is represented by hardcoded UUID values. Action statuses: - To do: 17e793a1-26a3-4ecd-99ca-f38ecc6eaa2e. - In progress: 20ce0cb1-387a-47d4-8c34-bc6fd3be0e27. - Complete: 7223d809-553e-4714-a038-62dc98f3fbf3. - Can’t do: 06308884-41c2-4ee0-9da7-5676647d3d75. |
safetyculture_actions_service_update_title
Update the title of an action Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | Yes | — | Required. The UUID of the task being updated. |
modified_at | string | No | — | Optional. The timestamp of when this event occurred. |
title | string | No | — | Required. The new title for the task. The title must be between 0 and 255 characters. |
safetyculture_actions_timeline_service_add_comment
Add comment to timeline Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
comment | string | Yes | — | Required. The content of the comment. |
created_at | string | No | — | Optional. Date/time this comment was added. |
event_id | string | No | — | Optional. The unique identifier for the event. This will be auto-generated if omitted. |
task_id | string | Yes | — | Required. The UUID for the task the comment is being added to. |
safetyculture_actions_timeline_service_get_timeline
List timeline events Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | Yes | — | Required. The UUID of the task whose timeline will be retrieved. |

