NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Databox connects to a Nagent workspace with an API key. Once it is connected, agents can call 7 Databox actions, such as "Create Dataset", "Create Data Source" and "Get Dataset Ingestion Status". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Databox, with input parameters and output schema.
DATABOX_CREATE_DATASETTool to create a new dataset in Databox data source. Use when you need to initialize a dataset with a title, data source ID, and primary keys for unique record identification.
Input parameters
Name of the dataset.
Array of field names used to uniquely identify records in the dataset. Each record must have unique values for these fields.
ID of the parent data source. This identifies which data source the dataset belongs to.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DATABOX_CREATE_DATA_SOURCETool to create a new data source in Databox. Use when you need to create a logical container for datasets within a Databox account. Requires accountId, title, and timezone parameters.
Input parameters
A descriptive name for the data source (e.g., 'ERP System', 'Test Data Source').
The timezone for the data source in standard format. Available timezones can be retrieved via GET /v1/timezones. Common values include 'UTC', 'America/New_York', 'Europe/London'.
The unique identifier of the Databox account where the data source will be created.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DATABOX_DELETE_DATASETTool to delete a dataset by ID in Databox. Use when you need to permanently remove a dataset. This operation is irreversible.
Input parameters
The unique identifier of the dataset to delete in UUID format. This operation permanently removes the dataset and is irreversible.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DATABOX_DELETE_DATA_SOURCETool to delete a data source by ID in Databox. Use when you need to permanently remove a data source. This operation is irreversible and will delete all associated datasets.
Input parameters
The unique identifier of the data source to delete. This operation is permanent and irreversible.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DATABOX_GET_DATASET_INGESTION_STATUSTool to check the status of a specific data ingestion for a dataset. Use when you need to verify whether a data ingestion was successful by providing the dataset ID and ingestion ID returned from the initial POST request.
Input parameters
The unique identifier of the dataset (e.g., '06feef1f-460d-49a1-b296-3e6c73511358').
The unique identifier returned from the data ingestion request (e.g., '8f0e9bba-f11b-46ae-8f60-8ff3ea878be9').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DATABOX_LIST_ACCOUNTSTool to retrieve all Databox accounts accessible to the authenticated user. Use to identify account IDs required for subsequent API operations like data source creation.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DATABOX_PUSH_DATA_V1Tool to push data points to a Databox dataset using the v1 API. Use when you need to ingest data records into a specific dataset by providing the dataset ID and an array of records matching the dataset schema.
Input parameters
Collection of data records to ingest. Each record's structure depends on your dataset schema and must include all primary key fields defined during dataset creation.
The unique identifier of the target dataset (UUID format).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 7 Databox actions on Nagent, including "Create Dataset", "Create Data Source" and "Get Dataset Ingestion Status". Create Dataset: Create a new dataset in Databox data source. Each action is listed on this page with its input parameters and its output.
Databox connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Create Dataset takes 3 required inputs: title, primaryKeys and dataSourceId. It returns data, error and successful.