Discovery and acquisition
Public listings, consented intent, claims, moderation, and source policy.
Hosted events and aggregated listings share a public slug space. Public routes return only visible records; source-policy and moderation operations retain the existing live organiser-membership boundary.
Public and actor-scoped discovery
| Operation | Access | Purpose |
|---|---|---|
GET /api/discovery/listings | Public | Published hosted events and aggregated listings. |
GET /api/discovery/listing | Public | One published aggregated listing. |
GET /api/discovery/viewer | Optional session | Location-consent state. |
GET /api/discovery/intents/state | Optional session | Going, sharing, and visible faces for a listing. |
GET /api/discovery/claims/mine | Optional session | Whether the actor already claimed a listing. |
GET /api/discovery/listing-family | Public | Parent and alternate dates. |
GET /api/discovery/listings/looking-now | Public | Privacy-bounded recent-view count. |
POST /api/discovery/listings/view | Public | Record a privacy-bounded listing view. |
POST /api/discovery/events/view | Public | Record a visible hosted-event view. |
POST /api/discovery/intents/going | Session | Set going intent. |
POST /api/discovery/intents/show-publicly | Session | Set public face visibility. |
POST /api/discovery/intents/share-contact | Session | Set organiser contact-sharing consent. |
POST /api/discovery/claims | Optional session | Submit or update an actor-owned claim; unsigned callers receive a state error. |
POST /api/discovery/acquisition/brief | Public | Submit the existing bounded event-planning brief. |
Organiser moderation and source policy
| Operation | Purpose |
|---|---|
GET /api/discovery/studio/listings | Traffic plus pending listings and claims. |
POST /api/discovery/studio/listings/review | Approve or reject an imported listing. |
POST /api/discovery/studio/claims/review | Approve or reject a claim. |
POST /api/discovery/studio/sources | Add a bounded source URL. |
POST /api/discovery/studio/listings/import-link | Extract and stage an event from a link. |
POST /api/discovery/studio/listings/import-poster | Extract and stage an event from bounded JPEG, PNG, or WebP bytes. |
GET /api/discovery/studio/sources | Source classification, crawl suitability, cadence, and verification state. |
POST /api/discovery/studio/sources/classify | Save legal/technical source classification. |
POST /api/discovery/studio/sources/toggle | Enable only an eligible classified source. |
GET /api/discovery/events/view-phases | Before/during/after view counts for an authorised event. |
Crawler jobs, image transformation, and counted outbound redirects are
operational routes, listed in Internal endpoints, not consumer
contracts. Mutations require an exact configured Origin.