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 require an independent live platform-administrator record.

Public and actor-scoped discovery

OperationAccessPurpose
GET /api/discovery/listingsPublicPublished hosted events and aggregated listings.
GET /api/discovery/listingPublicOne published aggregated listing.
GET /api/discovery/viewerOptional sessionLocation-consent state.
GET /api/discovery/intents/stateOptional sessionGoing, sharing, and visible faces for a listing.
GET /api/discovery/claims/mineOptional sessionWhether the actor already claimed a listing.
GET /api/discovery/listing-familyPublicParent and alternate dates.
GET /api/discovery/listings/looking-nowPublicPrivacy-bounded recent-view count.
POST /api/discovery/listings/viewPublicRecord a privacy-bounded listing view.
POST /api/discovery/events/viewPublicRecord a visible hosted-event view.
POST /api/discovery/intents/goingSessionSet going intent.
POST /api/discovery/intents/show-publiclySessionSet public face visibility.
POST /api/discovery/intents/share-contactSessionSet organiser contact-sharing consent.
POST /api/discovery/claimsOptional sessionSubmit or update an actor-owned claim; unsigned callers receive a state error.
POST /api/discovery/acquisition/briefPublicSubmit the existing bounded event-planning brief.

Platform moderation and source policy

OperationAccessPurpose
GET /api/discovery/studio/listingsPlatform adminTraffic plus pending listings and claims.
POST /api/discovery/studio/listings/reviewPlatform adminApprove or reject an imported listing.
POST /api/discovery/studio/claims/reviewPlatform adminApprove or reject a claim.
POST /api/discovery/studio/sourcesPlatform adminAdd a bounded source URL.
POST /api/discovery/studio/listings/import-linkPlatform adminExtract and stage an event from a link.
POST /api/discovery/studio/listings/import-posterPlatform adminExtract and stage an event from bounded JPEG, PNG, or WebP bytes.
GET /api/discovery/studio/sourcesPlatform adminSource classification, crawl suitability, cadence, and verification state.
POST /api/discovery/studio/sources/classifyPlatform adminSave legal/technical source classification.
POST /api/discovery/studio/sources/togglePlatform adminEnable only an eligible classified source.
GET /api/discovery/events/view-phasesOrganiser membershipBefore/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.

On this page