Run a sandbox test
POST
/api/testPoll test run status
GET
/api/test-runs/:idstatus is success, error, or timeout.
API Reference
Test
Test artifacts in a sandbox before deploying.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Test artifacts in a sandbox before deploying.
/api/test{
"artifactId": "art_abc123",
"inputs": { "name": "test" },
"automationId": "auto_xyz789",
"wait": 10
}
| Field | Required | Description |
|---|---|---|
artifactId | Yes | ID from POST /api/artifacts |
inputs | Yes | Dict of test input values |
automationId | No | Link to existing automation (ensures secrets are available during test) |
wait | No | Seconds to wait for result inline (default 10, max 10) |
curl -s -X POST "https://dashboard.floom.dev/api/test" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"artifactId": "art_abc123", "inputs": {"name": "test"}}'
{
"testRunId": "tr_xyz789",
"status": "success",
"result": {
"status": "success",
"outputs": { "greeting": "Hello, test!" },
"logs": "Installing dependencies...\nRunning main.py..."
}
}
{
"testRunId": "tr_xyz789",
"status": "pending"
}
/api/test-runs/:idstatus is success, error, or timeout.
curl -s "https://dashboard.floom.dev/api/test-runs/$TEST_RUN_ID" \
-H "Authorization: Bearer $API_KEY"
| Status | Meaning |
|---|---|
success | Test passed, outputs available |
error | Test failed, check error and logs fields |
timeout | Sandbox timed out |