Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Trigger and poll automation runs.
/api/automations/:id/run{
"inputs": { "query": "hello" },
"wait": 10
}
| Field | Required | Description |
|---|---|---|
inputs | Yes | Dict of input values matching manifest input names |
wait | No | Seconds to wait for result inline (default 10, max 10). Set to 0 to return immediately. |
curl -s -X POST "https://dashboard.floom.dev/api/automations/$ID/run" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"inputs": {"name": "Alice"}, "wait": 10}'
{
"runId": "run_xyz789",
"status": "success",
"result": {
"status": "success",
"outputs": { "greeting": "Hello, Alice!" },
"logs": "..."
}
}
{
"runId": "run_xyz789",
"status": "running"
}
status is pending or running, poll with GET /api/runs/:runId.
/api/runs/:runIdstatus is success, error, or timeout.
curl -s "https://dashboard.floom.dev/api/runs/$RUN_ID" \
-H "Authorization: Bearer $API_KEY"
| Status | Meaning |
|---|---|
success | Run completed, outputs available |
error | Run failed, error field has details |
timeout | Run exceeded time limit |