Surveys

File: 11-surveys.md

Loading documentation...

# Surveys

## Overview

Create surveys with questions and collect responses/analytics.

## Features
- Survey CRUD with public access pages
- Questions per survey with types and ordering
- Responses and analytics endpoints

## Data Model
- `Survey` → user_id, title, slug, description, is_public
- `SurveyQuestion` → survey_id, question, type, order, required
- `SurveyOption` → survey_question_id, option_text, order
- `SurveyResponse` → survey_id, user_id (nullable)
- `SurveyAnswer` → survey_response_id, survey_question_id, answer_text

## Key API Endpoints
- Public: `/api/surveys/{slug}`, `/api/surveys/{slug}/{id}`
- Dashboard: `/api/dashboard/surveys` (CRUD), questions CRUD, responses, analytics

## Usage Examples
```javascript
// Create survey
const survey = await apiPost('/api/dashboard/surveys', { title: 'Audience Survey', slug: 'audience' });

// Add question
await apiPost(`/api/dashboard/surveys/${surveyId}/questions`, {
  question: 'How did you hear about us?',
  type: 'select',
  required: true,
  order: 1,
  options: ['Twitter','YouTube','Friend','Other']
});

// View analytics
const stats = await apiGet(`/api/dashboard/surveys/${surveyId}/analytics`);
```

## Tips
- Keep questions concise; leverage `required` appropriately
- Use analytics to iterate on content strategy

Surveys

Surveys

📝 Page Notes

Add New Note