Skip to main content
Datascope logo
  • Category: forms & surveys
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 19
  • Triggers: 0
  • Slug: DATASCOPE
  • Version: 20261101_00

Tools

Slug: DATASCOPE_CHANGE_FORM_ANSWERTool to change a specific answer in a submitted form. Use when you need to modify question values after a form has been submitted.

Input Parameters

string
required
Code of the form response/submission to modify.
string
required
Name or ID of the form containing the answer to change.
string
required
Name of the question whose answer should be changed.
integer
Subform index number (starting from 1) if the question is inside a subform. Leave blank for questions not in subforms.
string
required
New value to set for the specified question.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATASCOPE_CREATE_LISTTool to create a new empty list (metadata type) in DataScope with specified list_type. Use when you need to create a container for list elements like products, locations, or other categorized items.

Input Parameters

object
required
List data object containing all list details.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATASCOPE_CREATE_LIST_ELEMENTTool to create a new list element in a specific metadata list identified by metadata_type. Use when you need to add a new element to a list. For location objects, use the locations API instead.

Input Parameters

object
required
List object containing element details
string
required
Internal code to identify the list (products, and more). For locations objects use locations API

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATASCOPE_CREATE_LOCATIONTool to create a new location in DataScope with geographic coordinates. Use when you need to register a physical location with name and code identifiers.

Input Parameters

object
required
Location data object containing all location details.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATASCOPE_CREATE_TASK_ASSIGNTool to create a task assignment for a specific form, user, and location with a deadline. Use when you need to assign a form to be completed by a specific user at a specific location and time.

Input Parameters

integer
Number of hours allocated to perform the task.
string
Custom code to identify or track the task.
string
required
Date and time of the assigned task in format YYYY-mm-dd HH:MM (e.g., ‘2026-02-20 10:00’).
string
Company tax identifier or code associated with the location.
string
Company name associated with the location.
string
required
Code identifier of the Location where the task should be performed.
integer
required
Internal identifier of the Form. ID in the URL https://www.mydatascope.com/task_forms/[ID]/edit
string
Email address of the Location.
string
Phone number of the Location.
string
required
User Email to whom the task is assigned.
string
GPS latitude coordinate of the location.
string
GPS longitude coordinate of the location.
string
Name of the location. Only needed if you need to create or update the location.
string
Physical address of the Location.
string
Instructions or notes for completing the task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATASCOPE_GET_ALL_LIST_ELEMENTSTool to retrieve all items from a specific metadata list in Datascope. Use when you need to fetch all elements belonging to a particular list type (products, locations, customers, etc.).

Input Parameters

string
required
Internal code to identify the list (e.g., products, locations, etc.). This is required to specify which metadata list to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATASCOPE_GET_ALL_LOCATIONSTool to retrieve all locations configured in the DataScope system. Use when you need to access location data including addresses, coordinates, and company associations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATASCOPE_GET_ANSWERS_V4Tool to retrieve form answers using the v4 API endpoint. Use when you need to fetch form submissions from DataScope with the latest API version. Supports filtering by user, date range, location, and pagination for retrieving large result sets.

Input Parameters

string
End of date range for results in ISO 8601 format (e.g., ‘2024-12-31T23:59:59Z’). Default is today if not provided.
integer
Number of submissions to return. Default is 200. Maximum allowed value is 200.
string
Beginning of date range for results in ISO 8601 format (e.g., ‘2024-01-01T00:00:00Z’). Default is last 7 days if not provided.
integer
Pagination parameter for additional batches. Default is 0. Use this to retrieve subsequent pages of results.
integer
required
The ID of the form to retrieve answers for. This parameter is required.
integer
Filters results to responses from one specific user. If not provided, answers from all users are returned.
integer
Filters to answers from a specific location. If not provided, answers from all locations are returned.
boolean
When true, returns only modified forms or new submissions. Default is false if not provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATASCOPE_GET_ANSWERS_WITH_FULL_METADATATool to retrieve last form answers with full metadata from DataScope (limit 600 results). Returns detailed response structure including answers array with question types, metadata references, and assignment information. Use when you need comprehensive answer data with question-level details and metadata associations.

Input Parameters

string
Set the end date range. Default is today if not provided. Use ISO 8601 format or date format.
string
Set the start date range. Default is last 7 days if not provided. Use ISO 8601 format or date format.
integer
If set, only get values of one form. When not provided, answers from all forms are returned.
string
If set, get values of only one user. This is a string identifier for the user.
integer
Set to get answers of only one location. When not provided, answers from all locations are returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATASCOPE_GET_FORM_SCHEMATool to retrieve the schema definition for a specific form by its form ID. Use when you need to understand the structure of a form including all questions, field types, and configurations.

Input Parameters

string
required
Unique identifier of the form to retrieve the schema for. Can be found in Configure > Configure App section.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATASCOPE_GET_FORMS_LISTTool to retrieve all available forms/tasks from the DataScope system. Use when you need to get a list of forms that can be assigned or filled out.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATASCOPE_GET_LAST_TICKETSTool to retrieve the last 5 tickets (findings) from the DataScope system. Use when you need to view recent tickets or findings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATASCOPE_GET_LIST_ELEMENTTool to retrieve a specific element from a metadata list by type and ID. Use when you need to fetch detailed information about a specific list element such as locations, products, or other metadata objects.

Input Parameters

integer
required
Internal identifier of the element of the list
string
required
Internal code to identify the list (e.g., ‘products’, ‘locations’, etc.)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATASCOPE_GET_TICKET_TYPESTool to retrieve available ticket types (findings types) from the DataScope system. Use when you need to access the list of ticket type configurations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATASCOPE_LIST_LAST_GENERATED_FILESTool to retrieve all generated files (PDFs, Excel) from a specific date range. Use when you need to access recently generated files within the last 90 days. Date format is MM/DD/YYYY.

Input Parameters

string
Conclusion of the date range for file retrieval. Format: DD/MM/YYYY (e.g., ‘19/12/2019’ for December 19, 2019). Defaults to today if not provided. Maximum date range is 90 days.
string
Beginning of the date range for file retrieval. Format: DD/MM/YYYY (e.g., ‘10/12/2019’ for December 10, 2019). Defaults to last 7 days if not provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATASCOPE_LIST_NOTIFICATIONSTool to retrieve all notifications (PDF and Excel files) from a date range. Use when you need to access notification details including type, URL, form information, and timestamps.

Input Parameters

string
Set the end date range. Format should match the API requirements. Defaults to today if not provided.
string
Set the start date range. Format should match the API requirements. Defaults to last 7 days if not provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATASCOPE_UPDATE_BULK_LIST_ELEMENTSBulk update objects in a DataScope metadata list using the experimental endpoint; the locations metadata type is not supported. This destructive replacement operation may soft-delete objects omitted from the incoming list.

Input Parameters

string
required
Name of the list to be created or updated.
array
required
Array of objects to be created or updated. WARNING: All existing objects for this metadata_type will be soft-deleted and replaced with these objects. Objects with existing codes will be updated; new codes will create new objects.
string
required
Internal code to identify the list to update. WARNING: Cannot be ‘locations’. This identifies which metadata list to bulk update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATASCOPE_UPDATE_LIST_ELEMENTTool to update an existing list element by ID with new name, description, code, or attributes. Use when you need to modify properties of a specific metadata object in DataScope.

Input Parameters

integer
required
The ID of the list element to update
object
required
List object containing updated element details

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DATASCOPE_UPDATE_LOCATIONTool to update an existing location in DataScope by ID. Use when you need to modify location details such as name, address, coordinates, or company information.

Input Parameters

integer
required
The ID of the location to update.
object
required
Location data object containing updated location details.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not