create_decision
Create a group decision
Create a poll, check-in, availability board, or ranking and get a link to share with the group.
Easiest: pass `text` in plain language and SettleIt infers the type and options, e.g. "Dinner: pizza or thai" (poll), "Who's in for bowling Thursday?" (checkin), "Find a time for dinner next week" (availability), "Rank snacks: chips, popcorn, pretzels" (ranking).
For exact control, pass `question` plus `options` (2-5 for polls, 2-12 for rankings); with `question` alone you get a check-in. Availability must be created from `text`.
For availability, also pass the user's `timezone` (IANA name, e.g. "America/Los_Angeles") so the time slots are in their local time; without it slots are in UTC.
Returns the decision (share its `url`), plus an `admin_token` and `manage_url` to keep private.
输入参数texttypeoptionsquestiontimezonecloses_in_minutes
get_decision
Get decision results
Read a decision and its current results: votes and leaders for polls, rankings with points, In/Maybe/Out names for check-ins, and per-slot counts plus best_slot_ids for availability. Also returns the option or slot ids that respond_to_decision needs.
输入参数decision_id必填
respond_to_decision
Respond on behalf of a person
Record one person's answer, only when that person asked you to. Which fields you need depends on the decision's type (get_decision shows it in `respond.fields`):
- poll: voter_id + option (exact label) or option_id
- ranking: voter_id + order (every option label or id, best first)
- checkin: name + status (in, maybe, out)
- availability: name + slot_ids (from get_decision `slots`)
Answering again with the same voter_id or name (case-insensitive) replaces that person's earlier answer.
输入参数nameorderoptionstatusslot_idsvoter_idoption_iddecision_id必填
close_decision
Close a decision
Stop accepting responses. Results stay visible. Requires the admin_token.
输入参数admin_token必填decision_id必填
reopen_decision
Reopen a decision
Accept responses again after closing (clears an automatic close time that has passed). Requires the admin_token.
输入参数admin_token必填decision_id必填
delete_decision
Delete a decision
Permanently delete a decision and all its responses. The share link stops working. This cannot be undone, so confirm with the user first. Requires the admin_token.
输入参数admin_token必填decision_id必填