Run a poll once now
run_poll_nowQueue one run of a poll now, whatever its schedule. It asks every wording, or with share=true the next part of the poll's rotation at its sample_percent, exactly as a scheduled run would. It spends the account's balance, so the request must carry max_cost_usd (estimate_poll's run_now.hold_micro). Follow it with get_live_run, then read get_results once it settles. Refused with 409 if a run is already in progress. (POST /api/v1/polls/{id}/run)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "run_poll_now"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The poll's id, or its public address (slug). | |
| share | No | true: ask the next part of the rotation at the poll's sample_percent, as a scheduled run would (estimate_poll's per_run). false: every wording (run_now). | |
| max_cost_usd | No | The most, in US dollars, you agree this may commit. Required: the call is refused with the amount it needs if this is missing or too low. |