# Dashpoint Organiser Public API

Organisation-scoped API for Dashpoint organiser automation and MCP clients.

Base URL: /v1/public-api
OpenAPI: /v1/public-api/openapi.json

Authentication:
- API key via `Authorization: Bearer <dp_live_...>`.
- API keys are bound to one organisation and scoped by capability.

Primary resource groups:
- API-key context
- organisation profile
- event setup, posts, media and timetables
- event maps, stages, areas and scene objects
- attendee, ticket, order and check-in operations
- ticketing config, categories, coupons and vouchers
- artists, rich profiles, linktrees and media uploads
- venues
- newsletters and organisation settings

Timetable model:
- Create a timetable under the main event with `POST /events/{eventId}/timetables`.
- Add programme entries with `POST /timetables/{timetableId}/events`.
- Each programme entry is itself an event document linked by `parentEvent` to the main event and by `inTimetables` to the timetable.
- Link artists to entries with `POST /timetables/{timetableId}/events/{childEventId}/artists/{artistId}`.
- Create stages with `POST /events/{eventId}/maps/{mapId}/locations`, then reference them from timetable entries via `atMapLocationIds`.
- Add session-specific links with `PUT /timetables/{timetableId}/events/{childEventId}/linktree`.

Ticketing setup model:
- Create categories first, then save checkout sections that group those category ids.
- `POST /ticketings/{ticketingId}/checkout-sections` stores both category ids and category references for checkout compatibility.

Use the OpenAPI document for machine-readable request and response schemas.