Start a poll
start_pollStart a draft or paused poll on its schedule. Each run spends the account's balance, so the request must carry max_cost_usd, the most it may commit (estimate_poll gives the figure, and a refusal says the exact amount). Refused with 402 if the balance cannot cover it and 409 if this key's monthly allowance cannot; nothing is spent by a refusal. Confirm the cost with the account holder first. (POST /api/v1/polls/{id}/start)
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": "start_poll"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The poll's id, or its public address (slug). | |
| 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. |