polls
Workforce module · 4 operations
List poll rows
GET/polls
A quick poll in the feed, attached to a post of kind Poll. Returns a cursor page of poll rows the caller may see. The default order is `created_at` ascending. Supports sparse fieldsets and the filter grammar.
Get a poll
GET/polls/{id}
A quick poll in the feed, attached to a post of kind Poll. Returns one poll with its `ETag`. A poll the caller may not see returns 404.
Vote in a poll
POST/polls/{id}/vote
Votes once: one option, or several when the poll allows it. Requires `Idempotency-Key`; a replay returns the original response. A rule that refuses the request returns 422 with `refusal` and `reason`.
Poll results
GET/polls/{id}/results
Votes per option. A rule that refuses the request returns 422 with `refusal` and `reason`.