Events

File: 10-events.md

Loading documentation...

# Events & Event Lists

## Overview

Create public events and group them into lists for profiles or pages.

## Features
- Event CRUD with images and dates
- Event Lists as collections
- Public endpoints per profile/page slug

## Data Model
- `Event` → user_id, public_profile_id (nullable), event_list_id (nullable), title, dates, location, image_media_id, is_public
  - **Note:** Events use IDs (no slug field)
- `EventList` → user_id, title, slug, description, is_public
  - **Note:** Event Lists have slugs for public URLs, but dashboard APIs use IDs

## Key API Endpoints

**Public Endpoints** (use slugs):
- `GET /api/events/{slug}` - List events for a profile (slug = profile slug)
- `GET /api/events/{slug}/{id}` - Get event details (slug = profile slug, id = event ID)
- `GET /api/event-lists/{slug}` - List events in an event list (slug = event list slug)
- `GET /api/event-lists/{slug}/{eventSlug}` - Get event from list (slug = event list slug, eventSlug = event slug)

**Dashboard Endpoints** (use IDs):
- `GET /api/dashboard/events` - List all events (paginated)
- `GET /api/dashboard/events/{id}` - Get event by ID
- `POST /api/dashboard/events` - Create event
- `PUT /api/dashboard/events/{id}` - Update event by ID
- `DELETE /api/dashboard/events/{id}` - Delete event by ID
- `GET /api/dashboard/event-lists` - List all event lists
- `GET /api/dashboard/event-lists/{id}` - Get event list by ID
- `POST /api/dashboard/event-lists` - Create event list
- `PUT /api/dashboard/event-lists/{id}` - Update event list by ID
- `DELETE /api/dashboard/event-lists/{id}` - Delete event list by ID
- `GET /api/dashboard/event-lists/{id}/events` - Get events in list (by ID)
- `POST /api/dashboard/event-lists/{id}/events` - Add event to list (by ID)
- `DELETE /api/dashboard/event-lists/{id}/events` - Remove event from list (by ID)

## Usage Examples
```javascript
// Create an event (returns event with ID)
const response = await apiPost('/api/dashboard/events', {
  title: 'Live Show',
  start_date: '2025-12-01',
  location: 'NYC',
  is_public: true
});
const eventId = response.event.id;

// Get event by ID
const event = await apiGet(`/api/dashboard/events/${eventId}`);

// Update event by ID
await apiPut(`/api/dashboard/events/${eventId}`, {
  location: 'New Venue'
});

// Create event list (returns list with ID)
const listResponse = await apiPost('/api/dashboard/event-lists', {
  name: 'Summer Tour',
  description: '2025 Summer Tour Dates'
});
const listId = listResponse.event_list.id;

// Add event to list (using IDs)
await apiPost(`/api/dashboard/event-lists/${listId}/events`, { 
  event_id: eventId 
});

// Get public events (using profile slug)
const publicEvents = await apiGet(`/api/events/${profileSlug}`);
```

## Tips
- Set `public_profile_id` when tying events to a profile
- Use lists to curate homepage sections

Events

Events

📝 Page Notes

Add New Note