Productivity

Datascope

Learn how to use Datascope with Composio

Overview

SLUG: DATASCOPE

Description

DataScope is the ideal tool to get rid of paperwork, save time and collect data efficiently from the field. The platform allows your team to answer personalized mobile forms (even offline), from their phones or tablets.

Authentication Details

generic_api_key
stringRequired

Connecting to Datascope

Create an auth config

Use the dashboard to create an auth config for the Datascope toolkit. This allows you to connect multiple Datascope accounts to Composio for agents to use.

1

Select App

Navigate to Datascope.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Datascope Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4datascope_auth_config_id = "ac_YOUR_DATASCOPE_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000"  # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10    # Replace this with a method to retrieve an API key from the user.
11    # Or supply your own.
12    user_api_key = input("[!] Enter API key")
13
14    connection_request = composio.connected_accounts.initiate(
15        user_id=user_id,
16        auth_config_id=auth_config_id,
17        config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18    )
19
20    # API Key authentication is immediate - no redirect needed
21    print(f"Successfully connected Datascope for user {user_id}")
22    print(f"Connection status: {connection_request.status}")
23    
24    return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, datascope_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Datascope toolkit’s playground

For code examples, see the Tool calling guide and Provider examples.

Tool List

Tool Name: Create Location

Description

Tool to create a new location in DataScope with geographic coordinates. Use when you need to register a physical location with name and code identifiers.

Action Parameters

location
objectRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get All Answers V2

Description

Tool to retrieve last answers from Datascope forms (limit 200 per request). Use when you need to fetch form submissions with optional filtering by form, user, date range, or location. Supports pagination via offset parameter for retrieving additional batches.

Action Parameters

date_modified
boolean
end
string
form_id
integer
limit
integer
location_id
integer
offset
integer
start
string
user_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get All Answers With Metadata

Description

Tool to retrieve all answers with metadata from the DataScope platform. Returns up to 600 form answers with form metadata, user information, timestamps, and GPS coordinates. Use when you need to fetch submission data with filtering options by form, user, date range, or location.

Action Parameters

date_modified
boolean
end
string
form_id
integer
limit
integer
location_id
integer
offset
integer
start
string
user_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get all list elements

Description

Tool 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.).

Action Parameters

metadata_type
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get All Locations

Description

Tool to retrieve all locations configured in the DataScope system. Use when you need to access location data including addresses, coordinates, and company associations.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Last Tickets

Description

Tool to retrieve the last 5 tickets (findings) from the DataScope system. Use when you need to view recent tickets or findings.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get List Element

Description

Tool 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.

Action Parameters

metadata_id
integerRequired
metadata_type
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Ticket Types

Description

Tool to retrieve available ticket types (findings types) from the DataScope system. Use when you need to access the list of ticket type configurations.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Last Generated Files

Description

Tool 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.

Action Parameters

end
string
start
string

Action Response

data
objectRequired
error
string
successful
booleanRequired