NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Dromo connects to a Nagent workspace with an API key. Once it is connected, agents can call 8 Dromo actions, such as "Create Headless Import", "Create Import Schema" and "Get Import Schema". 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 Dromo, with input parameters and output schema.
DROMO_CREATE_HEADLESS_IMPORTTool to create a headless import in Dromo. Returns a signed upload URL for file uploads. Use this before uploading files to obtain the temporary upload URL.
Input parameters
UUID of the saved schema defining data structure and validation rules
JSON string containing array of objects to import directly instead of uploading a file
Name of the file being imported (e.g., 'data.csv'). Required for file imports.
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
DROMO_CREATE_IMPORT_SCHEMATool to create a new import schema in Dromo. Define fields, validation rules, and settings for data imports. Use this when setting up a new data import workflow or template.
Input parameters
Name of the import schema for identification and display
Webhook configuration for various import events.
Array of field definitions that define the structure and validation for imported data. Must contain at least one field.
Configuration settings for the import schema behavior and appearance
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
DROMO_DELETE_IMPORT_SCHEMATool to delete an import schema in Dromo. Use when you need to remove a schema definition that is no longer needed. This action is irreversible.
Input parameters
UUID of the import schema to delete
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
DROMO_GET_IMPORT_SCHEMATool to retrieve an import schema by ID from Dromo. Returns the complete schema definition including fields, validation rules, settings, and webhook configurations. Use this to inspect schema structure, validate field requirements, or retrieve configuration details before creating imports.
Input parameters
Unique identifier of the import schema to retrieve
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
DROMO_LIST_IMPORT_SCHEMASTool to retrieve all import schemas configured for your Dromo organization. Use this to discover available schemas, their field definitions, validation rules, and settings before creating imports.
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
DROMO_LIST_UPLOADSRetrieves a paginated list of all file uploads stored by Dromo for your organization. Returns upload metadata including status, row counts, errors, user information, and file details. Use this to monitor import progress, track upload history, or retrieve upload IDs for further processing.
Input parameters
Ending index for pagination (exclusive). Must be greater than start. Defaults to 10000. Maximum value is 10000.
Starting index for pagination (inclusive). Defaults to 0.
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
DROMO_UPDATE_IMPORT_SCHEMATool to update an existing import schema in Dromo. Modifies the schema definition including fields, validation rules, and settings. Use when you need to change field configurations, add/remove validators, or update import settings for an existing schema.
Input parameters
UUID of the import schema to update
Display name for the import schema
Webhook configuration for various import events.
List of field configurations defining the schema structure
Configuration settings for the import schema
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
DROMO_UPLOAD_FILE_TO_HEADLESS_IMPORTUpload a file to Dromo's headless import system using a presigned S3 URL. This action performs the actual file upload step in Dromo's headless import workflow: 1. First, create a headless import via POST to /headless/imports/ to get an upload URL 2. Then, use this action to upload the file to that URL 3. Dromo automatically processes the file once the upload completes The upload URL is valid for 30 minutes. This action performs an HTTP PUT request with the file content to the provided presigned S3 URL.
Input parameters
Raw file content as bytes. For CSV files, encode the CSV text as UTF-8 bytes. For binary files, provide the raw binary data.
Presigned S3 URL obtained from creating a headless import. This URL is valid for 30 minutes and grants temporary permission to upload the file via HTTP PUT. Obtain this URL by creating a headless import with the Dromo API.
MIME type of the file being uploaded. Common values: 'text/csv' for CSV files, 'application/vnd.ms-excel' for Excel files, 'text/plain' for text files.
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 8 Dromo actions on Nagent, including "Create Headless Import", "Create Import Schema" and "Get Import Schema". Create Headless Import: Create a headless import in Dromo. Each action is listed on this page with its input parameters and its output.
Dromo 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 Headless Import takes 1 required input: schema_id. It also takes 2 optional inputs: initial_data and original_filename. It returns data, error and successful.