Sandbox

Test individual tools directly in the browser

Every connected integration has a Sandbox tab where you can select a tool, fill in parameters, and execute it without an agent or SDK. The Sandbox shows the raw response, a generated cURL command, estimated credits, and optional chart previews.

Getting Started

  1. Navigate to an integration’s detail page
  2. Click the Sandbox tab
  3. Select a tool from the searchable dropdown
  4. Fill in parameters
  5. Click Run

The Sandbox is available on any integration that is connected to a server and has enabled tools. If no tools are enabled, go to the Tools tab first to enable them.

Interface

Tool Selector

A searchable dropdown listing all tools on this integration. Enabled tools appear first; disabled tools are shown below a divider. Each entry shows the tool name and description.

Type to filter the list, then click a tool to select it.

Parameters

When you select a tool, its parameters populate automatically from the tool schema:

  • Required parameters are marked with an asterisk and cannot be removed
  • Optional parameters can be removed if not needed
  • Each parameter shows its name, type, and description
  • Enter values based on type: text for strings, JSON for objects and arrays, true/false for booleans

Global tool arguments (Refract, Chart, Demux) are included based on your Interaction Settings. These can be toggled on or off per call.

You can also add custom parameters by entering a name and value in the fields at the bottom.

cURL Command

The Sandbox generates a live cURL command that mirrors your current configuration. It updates as you change parameters. Copy it to reproduce the call outside the browser.

Run Button

Click Run to execute the tool. The button shows the estimated credit cost. If your balance is insufficient, the button is disabled with a tooltip showing the required credits.

Response

The right panel shows the result:

  • Success: Pretty-printed JSON response, including DataGrout metadata and receipt if enabled
  • Error: Structured error display with message, tool name, timestamp, and expandable technical details
  • Chart: If the tool returns chart data (or you enabled the Chart parameter), a chart preview appears above the response with a download button

Use Cases

  • Verify an integration works after connecting it – select a read-only tool and run it
  • Test parameters before writing agent code – experiment with different arguments
  • Debug a failing tool call – reproduce the exact call your agent made
  • Generate cURL commands – copy the command for use in scripts or documentation

Related