Événements
Créer, lire, modifier et annuler des événements via l'API.
Dans cet article
/v1/eventscreateEventTry It! → /api/events
Chemin actuel : /api/events
Scopes : events:write
Paramètres
Modifiez les valeurs puis cliquez Try It! à droite.
AuthorizationheaderrequisToken Bearer Clerk (session dashboard)
Corps (JSON)
Lecture
/v1/calendars/:slugFiche calendrier
/v1/calendars/:slug/events?status=PUBLISHED&after=Liste avec filtres
/v1/events/:slugDétail public par slug
/v1/events/:id/manageVue gestion (invités, stats internes)
/v1/events/:id/ticketsCatégories billets actives
/v1/events/:id/stats?range=7d|30d|allVues, inscriptions, check-ins
Écriture
/v1/eventsCréer (scope events:write)
/v1/events/:idModifier champs partiels
/v1/events/:id/cancelBody: { message } — e-mail invités
/v1/events/:id/duplicateCopie brouillon ou publiée
/v1/events/:id/announcementsBody: { subject, body } — quota e-mail
/v1/events/:id/reminders/:kind/sendkind: QUICK | ONE_DAY | ONE_HOUR
Corps POST /v1/events
Champs principaux
titlestringrequisMax 200 caractères
descriptionstringrequisMarkdown supporté
startAt / endAtISO 8601 UTCrequisendAt > startAt
timezoneIANArequisEurope/Paris, America/New_York…
organizationIdstringoptionnelID calendrier — requis si multi-calendrier
visibilityenumoptionnelPUBLIC | PRIVATE | UNLISTED
requiresApprovalbooleanoptionnelInscriptions en attente de validation
registrationQuestionsarrayoptionnelMax 5 { label, required }
Billets
Objet ticket (max 5 à la création)
namestringrequisEx. Early bird
priceintegerrequisCentimes — 0 = gratuit
currencystringoptionnelEUR par défaut
capacityintegeroptionnelQuota — null = illimité