Polls

File: 12-polls.md

Loading documentation...

# Polls

## Overview

Create public or dashboard-only polls with options and responses. Supports multiple vote policies.

## Features
- Poll CRUD, options management
- Public voting endpoints
- Results endpoints

## Data Model
- `Poll` → user_id, question, slug, is_public, allows_multiple_votes
- `PollOption` → poll_id, option_text, order, votes_count
- `PollResponse` → poll_id, poll_option_id, user_id (nullable)

## Key API Endpoints
- Public: `/api/public/polls/{poll}/results`, `/api/public/polls/{poll}/check-vote`, `/api/public/polls/{poll}/vote`
- Dashboard: `/api/polls` (CRUD, results, vote)

## Usage Examples
```javascript
// Create poll
const poll = await apiPost('/api/polls', { question: 'Favorite track?', slug: 'fav-track' });

// Add option
await apiPost(`/api/dashboard/polls/${pollId}/options`, { option_text: 'Track A' });

// Vote (public)
await apiPost(`/api/public/polls/${pollSlug}/vote`, { option_id });
```

## Tips
- For public polls, ensure slug is unique and `is_public` is true
- Use results endpoint to render charts

Polls

Polls

📝 Page Notes

Add New Note