{"name":"Mind Polling API","version":"1.0.0","base_url":"https://mindpolling.com/api/v1","openapi":"https://mindpolling.com/openapi.json","docs":"https://mindpolling.com/docs/api.md","auth":{"how":"https://mindpolling.com/auth.md","get_a_key":"https://mindpolling.com/app/settings/api","public_reads_need_no_key":true},"operations":[{"id":"get_me","method":"GET","path":"/api/v1/me","summary":"Your account, balance, this key's scopes and allowance, and what it cannot do.","auth":"key"},{"id":"list_polls","method":"GET","path":"/api/v1/polls","summary":"List public polls, and with a key your own.","auth":"optional"},{"id":"get_poll","method":"GET","path":"/api/v1/polls/{id}","summary":"A poll with every version in full.","auth":"optional"},{"id":"get_results","method":"GET","path":"/api/v1/polls/{id}/results","summary":"Per model, per run: shares or means with 95% ranges.","auth":"optional"},{"id":"list_runs","method":"GET","path":"/api/v1/polls/{id}/runs","summary":"Each run, newest first, with when it became available.","auth":"optional"},{"id":"list_calls","method":"GET","path":"/api/v1/polls/{id}/calls","summary":"Every model call, with everything needed to rerun it.","auth":"key","scope":"read"},{"id":"list_models","method":"GET","path":"/api/v1/models","summary":"The models a poll can ask, with typical charges.","auth":"none"},{"id":"search_places","method":"GET","path":"/api/v1/places","summary":"Find the place a wording asks about: countries, states, counties, cities.","auth":"key","scope":"read"},{"id":"get_place","method":"GET","path":"/api/v1/places/{id}","summary":"A place, ready to put in a wording's place field.","auth":"key","scope":"read"},{"id":"rotate_key","method":"POST","path":"/api/v1/me/key/rotate","summary":"Replace this key's secret; the old one stops working at once.","auth":"key","scope":"any"},{"id":"revoke_key","method":"DELETE","path":"/api/v1/me/key","summary":"Stop this key for good.","auth":"key","scope":"any"},{"id":"create_poll","method":"POST","path":"/api/v1/polls","summary":"Create a draft poll. Free: nothing runs until it is started.","auth":"key","scope":"write"},{"id":"update_poll","method":"PUT","path":"/api/v1/polls/{id}","summary":"Replace a poll's definition; a version that has run is kept and a new one made.","auth":"key","scope":"write"},{"id":"estimate_poll","method":"GET","path":"/api/v1/polls/{id}/estimate","summary":"What one run and the whole schedule will cost.","auth":"key","scope":"read"},{"id":"start_poll","method":"POST","path":"/api/v1/polls/{id}/start","summary":"Start a poll on its schedule. Spends the balance.","auth":"key","scope":"run"},{"id":"run_poll_now","method":"POST","path":"/api/v1/polls/{id}/run","summary":"Queue one run now. Spends the balance.","auth":"key","scope":"run"},{"id":"pause_poll","method":"POST","path":"/api/v1/polls/{id}/pause","summary":"Stop a poll's schedule. Spends nothing.","auth":"key","scope":"write"},{"id":"get_live_run","method":"GET","path":"/api/v1/polls/{id}/status","summary":"A poll's run in progress, cell by cell, and its last settled run.","auth":"key","scope":"read"},{"id":"list_changes","method":"GET","path":"/api/v1/changes","summary":"Everything that changed since a cursor: settled runs, publishing, new versions, revisions.","auth":"key","scope":"read"},{"id":"create_webhook","method":"POST","path":"/api/v1/webhooks","summary":"Be told when something changes, by a signed POST to your URL.","auth":"key","scope":"read"},{"id":"list_webhooks","method":"GET","path":"/api/v1/webhooks","summary":"Your webhook endpoints, and whether each still works.","auth":"key","scope":"read"},{"id":"delete_webhook","method":"DELETE","path":"/api/v1/webhooks/{id}","summary":"Stop sending to an endpoint.","auth":"key","scope":"read"}],"next_steps":[{"why":"List public polls","method":"GET","href":"https://mindpolling.com/api/v1/polls","tool":"list_polls"}]}