/api /v1 /admin /contact-submissionsLists contact form messages, newest first (up to 1,000).
Details
Responses
- 200
{ items } - 401
unauthorized - 403
forbidden - 500
internal_error
Source: app/api/v1/admin/contact-submissions/route.ts
Developers
https://www.bnf.events/api/v1Authorization: Bearer <token>valid 15 min{ "error": "<code>" }{ "ok": true }201 Created{ "items": [] }$ curl https://www.bnf.events/api/v1/me \
-H "Authorization: Bearer $TOKEN"
HTTP 401
{ "error": "unauthorized" }/api /v1 /admin /contact-submissionsLists contact form messages, newest first (up to 1,000).
{ items }unauthorizedforbiddeninternal_errorSource: app/api/v1/admin/contact-submissions/route.ts
/api /v1 /admin /survey-responsesLists event feedback survey responses, newest first (up to 1,000).
{ items }unauthorizedforbiddeninternal_errorSource: app/api/v1/admin/survey-responses/route.ts
/api /v1 /admin /talk-proposalsLists submitted talk proposals, newest first (up to 1,000).
{ items }unauthorizedforbiddeninternal_errorSource: app/api/v1/admin/talk-proposals/route.ts
/api /v1 /auth /challengesStarts an email sign-in by sending a one-time code.
Requires a Cloudflare Turnstile token. Exchange the returned challenge_token and the emailed code at POST /api/v1/auth/token.
{ email: string // email turnstileToken: string // min 1 type: "email"}{ ok }{ challenge_token, ok }captcha_failedinvalid_requestSource: app/api/v1/auth/challenges/route.ts
/api /v1 /auth /passkey /authenticate /optionsReturns WebAuthn options for signing in with a passkey.
rate_limitedinternal_errorSource: app/api/v1/auth/passkey/authenticate/options/route.ts
/api /v1 /auth /passkey /authenticate /verifyVerifies a passkey assertion and signs the user in, returning access and ID tokens.
{ response: { id: string rawId: string response: { clientDataJSON: string authenticatorData: string signature: string userHandle?: string } authenticatorAttachment?: "platform" | "cross-platform" clientExtensionResults: record type: "public-key" } challenge: string}{ access_token, expires_in, id_token, token_type }challenge_expiredinvalid_requestverification_failedrate_limitedinternal_errorSource: app/api/v1/auth/passkey/authenticate/verify/route.ts
/api /v1 /auth /passkey /register /optionsReturns WebAuthn options for adding a passkey to the signed-in account.
unauthorizeduser_not_foundrate_limitedinternal_errorSource: app/api/v1/auth/passkey/register/options/route.ts
/api /v1 /auth /passkey /register /verifyVerifies a passkey registration and saves the passkey to the account.
{ response: { id: string rawId: string response: { clientDataJSON: string attestationObject: string transports?: string[] publicKeyAlgorithm?: number publicKey?: string authenticatorData?: string } authenticatorAttachment?: "platform" | "cross-platform" clientExtensionResults: record type: "public-key" } challenge: string name?: string // max 100}{ ok, passkey }challenge_expiredinvalid_challengeinvalid_requestverification_failedunauthorizedrate_limitedinternal_errorSource: app/api/v1/auth/passkey/register/verify/route.ts
/api /v1 /auth /revokeSigns out by revoking the session's refresh token.
Set revoke_all to sign out every device, or revoke_family to end only the current login session.
{ revoke_all?: boolean // default false revoke_family?: boolean // default false}{ ok, revoked }unauthorizedrate_limitedSource: app/api/v1/auth/revoke/route.ts
/api /v1 /auth /tokenIssues an access token and ID token.
Use grant_type urn:bonfire:grant-type:email-otp to exchange an emailed code, or refresh_token to renew a session from the refresh-token cookie. Access tokens last 15 minutes.
{ grant_type: "urn:bonfire:grant-type:email-otp" challenge_token: string // min 32 code: string // pattern email: string // email}| { grant_type: "refresh_token"}{ access_token, expires_in, id_token, token_type }invalid_codeinvalid_requestunauthorizedexpiredrate_limitedtoo_many_attemptsauthentication_failedSource: app/api/v1/auth/token/route.ts
/api /v1 /check-insChecks a ticket holder in to an event. Used by the crew QR reader.
{ eventId: string // min 1, max 100 userId: string // min 1, max 100}{ ok }invalid_requestunauthorizedforbiddenalready_checked_incheck_in_failedinternal_errorSource: app/api/v1/check-ins/route.ts
/api /v1 /check-ins /lookupLooks up a ticket holder by their backup ID, for when a QR code can't be scanned.
{ publicId: string // min 1, max 100}{ email, name, publicId, valid }invalid_requestunauthorizedforbiddenuser_not_foundinternal_errorSource: app/api/v1/check-ins/lookup/route.ts
/api /v1 /check-ins /verifyVerifies a scanned check-in QR token and returns who it belongs to.
Expired tickets still return the holder, with expired: true.
{ token: string // min 1, max 2000}{ email, expired, name, publicId, valid }{ email, name, publicId, valid }invalid_requestunauthorizedforbiddenuser_not_foundinternal_errorSource: app/api/v1/check-ins/verify/route.ts
/api /v1 /contact-messagesSends a message through the contact form.
Requires a Cloudflare Turnstile token and the CSRF token from GET /api/v1/csrf in the X-CSRF-Token header. Invalid fields come back in fields, keyed by field name.
{ email: string // email, max 255 inquiryType?: unknown // default "general" message: string // min 10, max 5000 name: string // min 2, max 100 subject: string // min 3, max 200 turnstileToken: string // min 1 website?: string}{ ok }captcha_failedinvalid_requestbot_blockedcsrf_invalidinvalid_originrate_limitedinternal_errorSource: app/api/v1/contact-messages/route.ts
/api /v1 /cron /cleanupDeletes expired sign-in challenges, passkey challenges and refresh tokens. Called by the scheduled cron job.
{ ok, summary }unauthorizedcron_not_configuredinternal_errorpartial_failureSource: app/api/v1/cron/cleanup/route.ts
/api /v1 /csrfIssues a CSRF token and sets the matching cookie for form submissions.
{ token }rate_limitedSource: app/api/v1/csrf/route.ts
/api /v1 /eventsLists Bonfire events in date order, each with its talks and an isPast flag.
Pass when=upcoming or when=past to narrow the list; past events come newest first.
when{ items }Source: app/api/v1/events/route.ts
/api /v1 /events /{eventId}Returns one event: venue, date, time, links and its talks with speakers.
eventId{ …, isPast }event_not_foundSource: app/api/v1/events/[eventId]/route.ts
/api /v1 /events /{eventId} /questionsLists community questions for an event, with whether the question window is open and how many boosts you have left.
eventId{ availableBoosts, canParticipate, closesAt, isAuthenticated, isWindowOpen, items }event_not_foundrate_limitedinternal_errorSource: app/api/v1/events/[eventId]/questions/route.ts
/api /v1 /events /{eventId} /questionsAsks a question for an event, optionally about a specific talk. Only works while the question window is open.
eventId{ locale?: "en" | "cs" talkIndex?: number | null // int, min 0 text: string // min 3, max 600}{ ok }invalid_requestinvalid_talk_indexprofanity_not_allowedquestion_window_closedunauthorizedevent_not_foundrate_limitedinternal_errorSource: app/api/v1/events/[eventId]/questions/route.ts
/api /v1 /events /{eventId} /questions /{questionId}Deletes one of your own questions while the question window is open.
eventIdquestionId{ ok }question_window_closedunauthorizedforbiddenevent_not_foundquestion_not_foundrate_limitedinternal_errorSource: app/api/v1/events/[eventId]/questions/[questionId]/route.ts
/api /v1 /events /{eventId} /questions /{questionId} /boostsBoosts a question, spending one of your boosts.
eventIdquestionId{ added?: boolean count: number // int, min 0 removed?: boolean availableBoosts?: number // int, min 0, max BOOST_CONFIG.MAX_BOOSTS}question_window_closedunauthorizedno_boosts_availableevent_not_foundquestion_not_foundrate_limitedinternal_errorSource: app/api/v1/events/[eventId]/questions/[questionId]/boosts/route.ts
/api /v1 /events /{eventId} /questions /{questionId} /boostsRemoves your boost from a question and gives the boost back.
eventIdquestionId{ added?: boolean count: number // int, min 0 removed?: boolean availableBoosts?: number // int, min 0, max BOOST_CONFIG.MAX_BOOSTS}question_window_closedunauthorizedevent_not_foundquestion_not_foundrate_limitedinternal_errorSource: app/api/v1/events/[eventId]/questions/[questionId]/boosts/route.ts
/api /v1 /events /{eventId} /rsvpsReturns an event's RSVP count and public attendees, and whether you've RSVP'd when signed in.
eventIdinternal_errorSource: app/api/v1/events/[eventId]/rsvps/route.ts
/api /v1 /events /{eventId} /rsvpsRSVPs you to an upcoming event.
eventId{ ok }rsvp_closedunauthorizedalready_rsvpedrate_limitedinternal_errorSource: app/api/v1/events/[eventId]/rsvps/route.ts
/api /v1 /events /{eventId} /rsvpsCancels your RSVP to an upcoming event.
eventId{ ok }rsvp_closedunauthorizedrate_limitedinternal_errorSource: app/api/v1/events/[eventId]/rsvps/route.ts
/api /v1 /events /{eventId} /survey-responsesSubmits the feedback survey for an event.
Every answer is optional, but at least one is required. Ratings are 0–5. talkIndex is the talk's position in the event's lineup. Requires a Cloudflare Turnstile token and the CSRF token from GET /api/v1/csrf in the X-CSRF-Token header.
eventId{ favoriteParts?: unknown[] // max 5, default [] favoritePartsOther?: string // max 500 futureTopics?: unknown[] // max 8, default [] futureTopicsOther?: string // max 500 nextEventLikelihood?: number // int, min 0, max 5 overallRating?: number // int, min 0, max 5 suggestions?: string // max 5000 talkFeedback?: { comment?: string // max 1000 rating?: number // int, min 0, max 5 talkIndex: number // int, min 0 }[] // max 50, default [] talkFeedbackEnabled?: boolean // default false talkFormat?: unknown talkFormatOther?: string // max 500 talksOverallRating?: number // int, min 0, max 5 turnstileToken: string // min 1 website?: string}{ ok }captcha_failedinvalid_requestbot_blockedcsrf_invalidinvalid_originevent_not_foundrate_limitedinternal_errorSource: app/api/v1/events/[eventId]/survey-responses/route.ts
/api /v1 /meReturns your profile, recent sign-in attempts, and boost balance and history.
{ attempts, boostAllocation, boostLedger, profile }unauthorizednot_foundrate_limitedinternal_errorSource: app/api/v1/me/route.ts
/api /v1 /mePermanently deletes your account.
Requires the code emailed by POST /api/v1/me/deletion-challenges.
{ challenge_token: string // min 32 code: string // pattern}{ ok }invalid_codeinvalid_requestunauthorizednot_foundexpiredrate_limitedtoo_many_attemptsdelete_failedSource: app/api/v1/me/route.ts
/api /v1 /me /auth-attemptsLists recent sign-in attempts on your account.
{ items }unauthorizednot_foundrate_limitedinternal_errorSource: app/api/v1/me/auth-attempts/route.ts
/api /v1 /me /deletion-challengesEmails a confirmation code for deleting your account.
{ challenge_token, ok }unauthorizednot_foundrate_limitedSource: app/api/v1/me/deletion-challenges/route.ts
/api /v1 /me /passkeysLists the passkeys registered on your account.
{ items }unauthorizedrate_limitedinternal_errorSource: app/api/v1/me/passkeys/route.ts
/api /v1 /me /passkeys /{id}Renames one of your passkeys.
id{ name: string | null // max 100}{ ok }invalid_requestunauthorizednot_foundrate_limitedinternal_errorSource: app/api/v1/me/passkeys/[id]/route.ts
/api /v1 /me /passkeys /{id}Removes one of your passkeys.
id{ ok }unauthorizednot_foundrate_limitedinternal_errorSource: app/api/v1/me/passkeys/[id]/route.ts
/api /v1 /me /preferencesUpdates your display name, public profile visibility, or community email preference.
{ allowCommunityEmails?: boolean name?: string | null // max NAME_MAX_LENGTH publicProfile?: boolean}{ ok }invalid_requestname_too_longprofanity_detectedunauthorizedrate_limitedupdate_failedSource: app/api/v1/me/preferences/route.ts
/api /v1 /me /subscriptionReturns your Guild membership: tier, status, current period, and last and upcoming charges.
unauthorizedrate_limitedinternal_errorSource: app/api/v1/me/subscription/route.ts
/api /v1 /me /subscription /checkoutStarts a Stripe Checkout session for a Guild membership tier and returns its URL.
{ tier: 1 | 2 | 3}invalid_requestunauthorizedfeature_disabledalready_subscribedsubscription_managed_in_portalrate_limitedcheckout_failedSource: app/api/v1/me/subscription/checkout/route.ts
/api /v1 /me /subscription /portalOpens a Stripe billing portal session for managing your Guild membership and returns its URL.
unauthorizednot_foundrate_limitedportal_failedSource: app/api/v1/me/subscription/portal/route.ts
/api /v1 /me /subscription /syncRefreshes your Guild membership from Stripe, for example right after returning from Checkout.
{ checkoutSessionId?: string // min 1}invalid_requestunauthorizedforbiddenrate_limitedsync_failedSource: app/api/v1/me/subscription/sync/route.ts
/api /v1 /photos /albumsLists event photo albums, newest event first, with cover image and photo count.
{ items }Source: app/api/v1/photos/albums/route.ts
/api /v1 /photos /albums /{album}Returns one photo album with every photo's URL and dimensions. album is the album slug.
albumnot_foundSource: app/api/v1/photos/albums/[album]/route.ts
/api /v1 /recordingsLists recorded talks, newest first.
Filter with location (prague, zlin), tag, episode, a free-text q, or a shelf (early-access, guild-vault, member-picks, hot, hidden-gems; ranked shelves keep their ranking). Paginate with limit (default 50, max 500) and offset.
limitoffsetrate_limitedSource: app/api/v1/recordings/route.ts
/api /v1 /recordings /{shortId}Returns one recorded talk by its short ID.
shortIdnot_foundSource: app/api/v1/recordings/[shortId]/route.ts
/api /v1 /recordings /facetsReturns the filter values still available for a recordings query: tags, episodes, and which locations have matching talks.
Takes the same filters as GET /api/v1/recordings. Each facet ignores its own filter, so picking a tag still lists every other tag that would match.
rate_limitedSource: app/api/v1/recordings/facets/route.ts
/api /v1 /speakersLists everyone who has spoken at Bonfire, with their number of talks.
{ items }Source: app/api/v1/speakers/route.ts
/api /v1 /speakers /{slug}Returns a speaker's profile and every talk they gave, newest first.
slug is the speaker page's URL segment; only its trailing id matters.
slugnot_foundSource: app/api/v1/speakers/[slug]/route.ts
/api /v1 /stripe /webhooksReceives Stripe webhook events that keep Guild memberships in sync. Verified with the stripe-signature header.
{ ok }invalid_signaturewebhook_failedSource: app/api/v1/stripe/webhooks/route.ts
/api /v1 /talk-proposalsSubmits a talk proposal.
Requires a Cloudflare Turnstile token and the CSRF token from GET /api/v1/csrf in the X-CSRF-Token header. Invalid fields come back in fields, keyed by field name.
{ abstract: string // min 50, max 5000 company?: string duration: "15" | "30" | "45" email: string // email, max 255 experience?: string // max 2000 preferredLocation?: "prague" | "zlin" | "either" // default "either" speakerName: string // min 2, max 100 talkTitle: string // min 5, max 200 turnstileToken: string // min 1}{ ok }captcha_failedinvalid_requestbot_blockedcsrf_invalidinvalid_originrate_limitedinternal_errorSource: app/api/v1/talk-proposals/route.ts
/api /v1 /users /{userId}userIdinvalid_idprivate_profilenot_foundrate_limitedinternal_errorSource: app/api/v1/users/[userId]/route.ts
/api /v1 /users /{userId} /boostsLists the videos you've boosted. Use me as the user ID.
userIdUse me for your own account.
{ items }unauthorizedforbiddenrate_limitedinternal_errorSource: app/api/v1/users/[userId]/boosts/route.ts
/api /v1 /users /{userId} /check-insReturns your personal check-in QR token for events. Use me as the user ID.
userIdUse me for your own account.
{ token, expiresAt, publicId }unauthorizedforbiddenrate_limitedcheck_in_not_configuredinternal_errorSource: app/api/v1/users/[userId]/check-ins/route.ts
/api /v1 /users /{userId} /watchlistLists the videos on your Watch Later list, newest first, with each recording. Use me as the user ID.
userIdUse me for your own account.
{ items }unauthorizedforbiddenrate_limitedinternal_errorSource: app/api/v1/users/[userId]/watchlist/route.ts
/api /v1 /users /{userId} /watchlist /{videoId}Returns whether a video is on your Watch Later list. Always false when signed out.
userIdvideoIdUse me for your own account.
{ inWatchlist }invalid_idforbiddenrate_limitedinternal_errorSource: app/api/v1/users/[userId]/watchlist/[videoId]/route.ts
/api /v1 /users /{userId} /watchlist /{videoId}Adds a video to your Watch Later list.
userIdvideoIdUse me for your own account.
{ added, inWatchlist }invalid_idunauthorizedforbiddenrate_limitedinternal_errorSource: app/api/v1/users/[userId]/watchlist/[videoId]/route.ts
/api /v1 /users /{userId} /watchlist /{videoId}Removes a video from your Watch Later list.
userIdvideoIdUse me for your own account.
{ removed, inWatchlist }invalid_idunauthorizedforbiddenrate_limitedinternal_errorSource: app/api/v1/users/[userId]/watchlist/[videoId]/route.ts
/api /v1 /videos /{id} /boostsReturns a video's boost count and who boosted it. When signed in, also whether you boosted it and how many boosts you have left.
id{ availableBoosts?: number // int, min 0, max BOOST_CONFIG.MAX_BOOSTS boostedBy?: { privateCount: number // int, min 0 publicUsers: { name: string | null publicId: string // pattern }[] } count: number // int, min 0 hasBoosted: boolean}invalid_idunauthorizedbot_blockedinvalid_originrate_limitedinternal_errorSource: app/api/v1/videos/[id]/boosts/route.ts
/api /v1 /videos /{id} /boostsBoosts a video, spending one of your boosts. Requires sign-in.
id{ added?: boolean count: number // int, min 0 removed?: boolean availableBoosts?: number // int, min 0, max BOOST_CONFIG.MAX_BOOSTS}invalid_idunauthorizedbot_blockedinvalid_originno_boosts_availablerate_limitedinternal_errorSource: app/api/v1/videos/[id]/boosts/route.ts
/api /v1 /videos /{id} /boostsRemoves your boost from a video and gives the boost back. Requires sign-in.
id{ added?: boolean count: number // int, min 0 removed?: boolean availableBoosts?: number // int, min 0, max BOOST_CONFIG.MAX_BOOSTS}invalid_idunauthorizedbot_blockedinvalid_originrate_limitedinternal_errorSource: app/api/v1/videos/[id]/boosts/route.ts
/api /v1 /videos /{id} /likesReturns a video's like count and whether this visitor has liked it.
id{ count: number // int, min 0 hasLiked: boolean}invalid_idbot_blockedinvalid_originrate_limitedinternal_errorSource: app/api/v1/videos/[id]/likes/route.ts
/api /v1 /videos /{id} /likesLikes a video. No account needed: likes are tied to the visitor.
id{ added?: boolean count: number // int, min 0 removed?: boolean}invalid_idbot_blockedinvalid_originrate_limitedinternal_errorSource: app/api/v1/videos/[id]/likes/route.ts
/api /v1 /videos /{id} /likesRemoves this visitor's like from a video.
id{ added?: boolean count: number // int, min 0 removed?: boolean}invalid_idbot_blockedinvalid_originrate_limitedinternal_errorSource: app/api/v1/videos/[id]/likes/route.ts
/.well-known /jwks.jsonPublishes the public keys for verifying Bonfire access and ID tokens.
{ keys }internal_errorSource: app/.well-known/jwks.json/route.ts
/.well-known /openid-configurationOpenID Connect discovery document describing the token endpoint and signing keys.
{ grant_types_supported, id_token_signing_alg_values_supported, issuer, jwks_uri, response_types_supported, scopes_supported, subject_types_supported, token_endpoint, token_endpoint_auth_methods_supported }Source: app/.well-known/openid-configuration/route.ts
/api /healthReports service and database health. Returns 503 when the database is unreachable.
{ status, timestamp, version, database }{ status, timestamp, version, database, message }Source: app/api/health/route.ts