create_poll

Create a Discord native poll. Use when the user says ‘faz uma poll’, ‘poll: …’ or wants a vote. Provide question and 2-10 answers. The poll renders as a real Discord poll, not emoji reactions.

User guide / All capabilities

Contract

Effect: write. Evidence role: discovery_only.

Create Discord poll.

Parameters

This is the current provider-facing JSON Schema, generated from the runtime definition.

{
  "type": "object",
  "properties": {
    "channel_id": {
      "type": "string",
      "description": "Channel ID to send the poll to. If omitted, uses the current channel."
    },
    "question": {
      "type": "string",
      "description": "Poll question (max 300 chars)."
    },
    "answers": {
      "type": "array",
      "description": "Poll answers (2-10 strings, each max 55 chars).",
      "items": {
        "type": "string"
      }
    },
    "duration_hours": {
      "type": "number",
      "description": "Duration in hours (1-768, default 24). 1h minimum for Discord polls."
    },
    "allow_multiselect": {
      "type": "boolean",
      "description": "Allow multiple answers per voter (default false)."
    }
  },
  "required": [
    "question",
    "answers"
  ]
}

Execution requirements

• isGuildMember
• bot has SendMessages permission in target channel

Expected postconditions

• poll message created with ID and channel mention