Update a poll
update_pollReplace a poll's definition with a new one. Before its first run the version is edited in place; once a version has run it is locked and a new version is made, so results always say what was asked. Send the whole definition, as create_poll takes it. (PUT /api/v1/polls/{id})
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>",
"title": "<title>",
"schedule": "<schedule>",
"samples_per_cell": "<samples_per_cell>",
"questions": "<questions>",
"panel": "<panel>"
},
"name": "update_poll"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The poll's id, or its public address (slug). | |
| panel | Yes | 1 to 30 models to ask, each once. | |
| title | Yes | The poll's title. | |
| delivery | No | realtime (the default), or batch: scheduled runs ask the models that can be batched (Anthropic) through the providers' batch APIs, cheaper, with answers arriving up to 2 hours after the run starts; run_poll_now is always real time. OpenAI and Google models are asked at their flex tier, the same price, in real time, either way. Left out: unchanged. | |
| end_date | No | The last day it runs, at most 90 days after start_date. | |
| run_time | No | The time of day it runs, HH:MM in time_zone; null runs from the moment it is started. | |
| schedule | Yes | once, daily or weekly. | |
| questions | Yes | 1 to 50 questions, in order. | |
| time_zone | No | The IANA time zone of its dates and run time. | America/Anchorage |
| index_name | No | A name for the composite of the poll's Better-Worse index questions, such as "AI Economy Index"; empty for "Composite Better-Worse index". Shown only when two or more questions have the index. | |
| start_date | No | The first day it runs, YYYY-MM-DD in time_zone; needs run_time. | |
| change_note | No | Why this version differs from the last, kept in the poll's history. | |
| description | No | What the poll is for, or empty. | |
| run_weekday | No | Weekly polls: the day it runs, 0 = Sunday. | |
| search_depth | No | Searches allowed per answer, for every model with search on. | |
| restored_from | No | The earlier version this one was started from, or null. | |
| system_prompt | No | The system prompt every wording is asked under unless it has its own; empty for none. | |
| sample_percent | No | The share of the poll's wordings each scheduled run asks, 1 to 100 percent; every wording is asked once before any is asked again. Left out: unchanged (100 for a new poll). run_poll_now asks this share with share=true, every wording otherwise. | |
| samples_per_cell | Yes | How many times each model is asked each wording per run, 1 to 50: more samples, narrower ranges. |