create_poll

Previous value: -"If true, hide voter identities."New value: +"Permanent. Needs closing_at; not for count, question, meeting."

Added value: +{
+  "description": "meeting: allow 'maybe'. API default is false.",
+  "type": "boolean"
+}

Previous value: -"ISO-8601 timestamp at which the poll closes."New value: +"ISO-8601, future. Effectively REQUIRED: omitted = unopened draft."

Removed value: -"Optional poll body / context."

Previous value: -"Format of `details`. Defaults to 'md'."New value: +"Default 'md'; 'html' when `details` is HTML."

Added value: +[
+  {
+    "pattern": "^[A-Za-z0-9_-]+$",
+    "type": "string"
+  },
+  {
+    "exclusiveMinimum": 0,
+    "maximum": 9007199254740991,
+    "type": "integer"
+  }
+]

Previous value: -"Attach the poll to an existing discussion. When set, group_id is taken from the discussion."New value: +"Discussion to attach to (id or key; +1 call). Prefer topic_id."

Removed value: -0

Removed value: -9007199254740991

Removed value: -"integer"

Added value: +{
+  "description": "dot_vote: points per voter (default 8).",
+  "exclusiveMinimum": 0,
+  "maximum": 9007199254740991,
+  "type": "integer"
+}

Previous value: -"Group the poll belongs to. Required when not attaching to an existing discussion via discussion_id."New value: +"Group of a STANDALONE poll (else only cross-checked)."

Previous value: -"Results visibility policy. Defaults to 'off'."New value: +"Default 'off'; anonymous polls force 'until_closed'."

Added value: +{
+  "description": "score: max per option (default 5); meeting: 2.",
+  "maximum": 9007199254740991,
+  "minimum": -9007199254740991,
+  "type": "integer"
+}

Added value: +{
+  "description": "Max options per voter (poll: 1; raise for multi-choice).",
+  "exclusiveMinimum": 0,
+  "maximum": 9007199254740991,
+  "type": "integer"
+}

Added value: +{
+  "description": "meeting: slot minutes. No default through the API.",
+  "exclusiveMinimum": 0,
+  "maximum": 9007199254740991,
+  "type": "integer"
+}

Added value: +{
+  "description": "score: min per option (default 0).",
+  "maximum": 9007199254740991,
+  "minimum": -9007199254740991,
+  "type": "integer"
+}

Added value: +{
+  "description": "Min options per voter (ranked_choice: ranks, default 3).",
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}

Previous value: -"Who Loomio notifies as the closing date approaches. Defaults to 'nobody'."New value: +"24h closing reminder; API default is 'nobody'."

Previous value: -[
-  "nobody",
-  "author",
-  "voters",
-  "undecided_voters",
-  "all_members"
-]New value: +[
+  "nobody",
+  "author",
+  "undecided_voters",
+  "voters"
+]

Added value: +{
+  "description": "Announce (`poll_announced`) on opening; Loomio's default is TRUE.",
+  "type": "boolean"
+}

Previous value: -"If false, suppress the initial notification email. Defaults to false."New value: +"Email/push the named recipients; SEPARATE from notify_on_open."

Previous value: -"Voting options. `proposal` has built-in agree/disagree/abstain options; for poll / count / score / ranked_choice / meeting / dot_vote you MUST supply your own."New value: +"Option names in order. REQUIRED except 'question'; ranked_choice/stv need 2+."

Previous value: -"Poll type. One of: proposal, poll, count, score, ranked_choice, meeting, dot_vote."New value: +"'question' has no options; 'meeting' options are ISO-8601 times; 'stv' takes stv_seats."

Previous value: -[
-  "proposal",
-  "poll",
-  "count",
-  "score",
-  "ranked_choice",
-  "meeting",
-  "dot_vote"
-]New value: +[
+  "proposal",
+  "poll",
+  "count",
+  "score",
+  "ranked_choice",
+  "meeting",
+  "dot_vote",
+  "check",
+  "question",
+  "stv"
+]

Added value: +{
+  "description": "Prompt above the reason box.",
+  "type": "string"
+}

Added value: +"'group' = every member (needs announce permission)."

Added value: +"Emails to invite; non-members become guests."

Previous value: -"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"New value: +"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"

Added value: +"Text for the notification."

Added value: +"User ids to invite / notify."

Added value: +{
+  "description": "Offer 'none of the above' (poll, ranked_choice).",
+  "type": "boolean"
+}

Previous value: -"If true, shuffle option display order."New value: +"Randomise option order per voter."

Previous value: -"If true, only users in recipient_user_ids / recipient_emails can vote."New value: +"Only the named recipients may vote."

Added value: +{
+  "description": "Default 'optional'; anonymous polls force 'disabled'.",
+  "enum": [
+    "disabled",
+    "optional",
+    "required",
+    "required_for_disagree_or_block",
+    "required_for_block"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "stv: seats to fill.",
+  "exclusiveMinimum": 0,
+  "maximum": 9007199254740991,
+  "type": "integer"
+}

Added value: +{
+  "description": "Tags for a standalone poll's thread.",
+  "items": {
+    "minLength": 1,
+    "type": "string"
+  },
+  "type": "array"
+}

Removed value: -"Poll title (required)."

Added value: +{
+  "description": "Thread id (`topic_id` on any thread row); no extra call.",
+  "exclusiveMinimum": 0,
+  "maximum": 9007199254740991,
+  "type": "integer"
+}