Bonfire Events

Casual meetups, big ideas, and good vibes. 🔥🎮

© 2026 Bonfire Events. Made with love for the gamedev community.

Timeline·Newsletters·Press·Developers·CoC & Legal·Attributions
Bonfire Events logoBonfire Events logo
Home
HomeUpcomingPhotosCrewSpeakSupport
Watch

Developers

Bonfire API

The API behind bnf.events, documented straight from its own code.
  • 73 endpoints
  • 17 groups
  • Generated from source
Base URL
https://www.bnf.events/api/v1
Auth
Authorization: Bearer <token>valid 15 min
Errors
{ "error": "<code>" }
Success
{ "ok": true }201 Created{ "items": [] }
$ curl https://www.bnf.events/api/v1/me \
    -H "Authorization: Bearer $TOKEN"

HTTP 401
{ "error": "unauthorized" }
GroupsAdmin3Authentication7Check-ins3Contact1Scheduled jobs1CSRF1Events11Your account12Newsletters9Photos2Recordings3Speakers2Stripe1Talk proposals1Users7Videos6System3

Admin3

GET/api/v1/admin/contact-submissions
Role: admin

Lists contact form messages, newest first (up to 1,000).

Details

Responses

  • 200{ items }
  • 401unauthorized
  • 403forbidden
  • 500internal_error

Source: app/api/v1/admin/contact-submissions/route.ts

GET/api/v1/admin/survey-responses
Role: admin

Lists event feedback survey responses, newest first (up to 1,000).

Details

Responses

  • 200{ items }
  • 401unauthorized
  • 403forbidden
  • 500internal_error

Source: app/api/v1/admin/survey-responses/route.ts

GET/api/v1/admin/talk-proposals
Role: admin

Lists submitted talk proposals, newest first (up to 1,000).

Details

Responses

  • 200{ items }
  • 401unauthorized
  • 403forbidden
  • 500internal_error

Source: app/api/v1/admin/talk-proposals/route.ts

Authentication7

POST/api/v1/auth/challenges
Public

Starts 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.

Details

Request body

{  email: string  // email  turnstileToken: string  // min 1  type: "email"}

Responses

  • 200{ ok }
  • 200{ challenge_token, ok }
  • 400captcha_failed
  • 400invalid_request

Source: app/api/v1/auth/challenges/route.ts

POST/api/v1/auth/passkey/authenticate/options
PublicRate limited

Returns WebAuthn options for signing in with a passkey.

Details

Responses

  • 200JSON body
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/auth/passkey/authenticate/options/route.ts

POST/api/v1/auth/passkey/authenticate/verify
PublicRate limited

Verifies a passkey assertion and signs the user in, returning access and ID tokens.

Details

Request body

{  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}

Responses

  • 200{ access_token, expires_in, id_token, token_type }
  • 400challenge_expired
  • 400invalid_request
  • 400verification_failed
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/auth/passkey/authenticate/verify/route.ts

POST/api/v1/auth/passkey/register/options
Signed inRate limited

Returns WebAuthn options for adding a passkey to the signed-in account.

Details

Responses

  • 200JSON body
  • 401unauthorized
  • 404user_not_found
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/auth/passkey/register/options/route.ts

POST/api/v1/auth/passkey/register/verify
Signed inRate limited

Verifies a passkey registration and saves the passkey to the account.

Details

Request body

{  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}

Responses

  • 200{ ok, passkey }
  • 400challenge_expired
  • 400invalid_challenge
  • 400invalid_request
  • 400verification_failed
  • 401unauthorized
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/auth/passkey/register/verify/route.ts

POST/api/v1/auth/revoke
Public · personalized when signed inRate limited

Signs 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.

Details

Request body

{  revoke_all?: boolean  // default false  revoke_family?: boolean  // default false}

Responses

  • 200{ ok, revoked }
  • 401unauthorized
  • 429rate_limited

Source: app/api/v1/auth/revoke/route.ts

POST/api/v1/auth/token
PublicRate limited

Issues 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.

Details

Request body

{  grant_type: "urn:bonfire:grant-type:email-otp"  challenge_token: string  // min 32  code: string  // pattern  email: string  // email}| {  grant_type: "refresh_token"}

Responses

  • 200{ access_token, expires_in, id_token, token_type }
  • 400invalid_code
  • 400invalid_request
  • 401unauthorized
  • 410expired
  • 429rate_limited
  • 429too_many_attempts
  • 500authentication_failed

Source: app/api/v1/auth/token/route.ts

Check-ins3

POST/api/v1/check-ins
Role: crew

Checks a ticket holder in to an event. Used by the crew QR reader.

Details

Request body

{  eventId: string  // min 1, max 100  userId: string  // min 1, max 100}

Responses

  • 201{ ok }
  • 400invalid_request
  • 401unauthorized
  • 403forbidden
  • 409already_checked_in
  • 500check_in_failed
  • 500internal_error

Source: app/api/v1/check-ins/route.ts

POST/api/v1/check-ins/lookup
Role: crew

Looks up a ticket holder by their backup ID, for when a QR code can't be scanned.

Details

Request body

{  publicId: string  // min 1, max 100}

Responses

  • 200{ email, name, publicId, valid }
  • 400invalid_request
  • 401unauthorized
  • 403forbidden
  • 404user_not_found
  • 500internal_error

Source: app/api/v1/check-ins/lookup/route.ts

POST/api/v1/check-ins/verify
Role: crew

Verifies a scanned check-in QR token and returns who it belongs to.

Expired tickets still return the holder, with expired: true.

Details

Request body

{  token: string  // min 1, max 2000}

Responses

  • 200{ email, expired, name, publicId, valid }
  • 200{ email, name, publicId, valid }
  • 400invalid_request
  • 401unauthorized
  • 403forbidden
  • 404user_not_found
  • 500internal_error

Source: app/api/v1/check-ins/verify/route.ts

Contact1

POST/api/v1/contact-messages
PublicRate limited

Sends 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.

Details

Request body

{  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}

Responses

  • 201{ ok }
  • 400captcha_failed
  • 400invalid_request
  • 403bot_blocked
  • 403csrf_invalid
  • 403invalid_origin
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/contact-messages/route.ts

Scheduled jobs1

GET/api/v1/cron/cleanup
Cron secret

Deletes expired sign-in challenges, passkey challenges and refresh tokens. Called by the scheduled cron job.

Details

Responses

  • 200{ ok, summary }
  • 401unauthorized
  • 500cron_not_configured
  • 500internal_error
  • 500partial_failure

Source: app/api/v1/cron/cleanup/route.ts

CSRF1

GET/api/v1/csrf
PublicRate limited

Issues a CSRF token and sets the matching cookie for form submissions.

Details

Responses

  • 200{ token }
  • 429rate_limited

Source: app/api/v1/csrf/route.ts

Events11

GET/api/v1/events
Public

Lists 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.

Details

Query parameters

  • when

Responses

  • 200{ items }

Source: app/api/v1/events/route.ts

GET/api/v1/events/{eventId}
Public

Returns one event: venue, date, time, links and its talks with speakers.

Details

Path parameters

  • eventId

Responses

  • 200{ …, isPast }
  • 404event_not_found

Source: app/api/v1/events/[eventId]/route.ts

GET/api/v1/events/{eventId}/questions
Public · personalized when signed inRate limited

Lists community questions for an event, with whether the question window is open and how many boosts you have left.

Details

Path parameters

  • eventId

Responses

  • 200{ availableBoosts, canParticipate, closesAt, isAuthenticated, isWindowOpen, items }
  • 404event_not_found
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/events/[eventId]/questions/route.ts

POST/api/v1/events/{eventId}/questions
Signed inRate limited

Asks a question for an event, optionally about a specific talk. Only works while the question window is open.

Details

Path parameters

  • eventId

Request body

{  locale?: "en" | "cs"  talkIndex?: number | null  // int, min 0  text: string  // min 3, max 600}

Responses

  • 201{ ok }
  • 400invalid_request
  • 400invalid_talk_index
  • 400profanity_not_allowed
  • 400question_window_closed
  • 401unauthorized
  • 404event_not_found
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/events/[eventId]/questions/route.ts

DELETE/api/v1/events/{eventId}/questions/{questionId}
Signed inRate limited

Deletes one of your own questions while the question window is open.

Details

Path parameters

  • eventId
  • questionId

Responses

  • 200{ ok }
  • 400question_window_closed
  • 401unauthorized
  • 403forbidden
  • 404event_not_found
  • 404question_not_found
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/events/[eventId]/questions/[questionId]/route.ts

POST/api/v1/events/{eventId}/questions/{questionId}/boosts
Signed inRate limited

Boosts a question, spending one of your boosts.

Details

Path parameters

  • eventId
  • questionId

Responses

  • 200
    {  added?: boolean  count: number  // int, min 0  removed?: boolean  availableBoosts?: number  // int, min 0, max BOOST_CONFIG.MAX_BOOSTS}
  • 400question_window_closed
  • 401unauthorized
  • 403no_boosts_available
  • 404event_not_found
  • 404question_not_found
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/events/[eventId]/questions/[questionId]/boosts/route.ts

DELETE/api/v1/events/{eventId}/questions/{questionId}/boosts
Signed inRate limited

Removes your boost from a question and gives the boost back.

Details

Path parameters

  • eventId
  • questionId

Responses

  • 200
    {  added?: boolean  count: number  // int, min 0  removed?: boolean  availableBoosts?: number  // int, min 0, max BOOST_CONFIG.MAX_BOOSTS}
  • 400question_window_closed
  • 401unauthorized
  • 404event_not_found
  • 404question_not_found
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/events/[eventId]/questions/[questionId]/boosts/route.ts

GET/api/v1/events/{eventId}/rsvps
Public · personalized when signed in

Returns an event's RSVP count and public attendees, and whether you've RSVP'd when signed in.

Details

Path parameters

  • eventId

Responses

  • 200JSON body
  • 500internal_error

Source: app/api/v1/events/[eventId]/rsvps/route.ts

POST/api/v1/events/{eventId}/rsvps
Signed inRate limited

RSVPs you to an upcoming event.

Details

Path parameters

  • eventId

Responses

  • 201{ ok }
  • 400rsvp_closed
  • 401unauthorized
  • 409already_rsvped
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/events/[eventId]/rsvps/route.ts

DELETE/api/v1/events/{eventId}/rsvps
Signed inRate limited

Cancels your RSVP to an upcoming event.

Details

Path parameters

  • eventId

Responses

  • 200{ ok }
  • 400rsvp_closed
  • 401unauthorized
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/events/[eventId]/rsvps/route.ts

POST/api/v1/events/{eventId}/survey-responses
PublicRate limited

Submits 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.

Details

Path parameters

  • eventId

Request body

{  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}

Responses

  • 201{ ok }
  • 400captcha_failed
  • 400invalid_request
  • 403bot_blocked
  • 403csrf_invalid
  • 403invalid_origin
  • 404event_not_found
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/events/[eventId]/survey-responses/route.ts

Your account12

GET/api/v1/me
Signed inRate limited

Returns your profile, recent sign-in attempts, and boost balance and history.

Details

Responses

  • 200{ attempts, boostAllocation, boostLedger, profile }
  • 401unauthorized
  • 404not_found
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/me/route.ts

DELETE/api/v1/me
Signed inRate limited

Permanently deletes your account.

Requires the code emailed by POST /api/v1/me/deletion-challenges.

Details

Request body

{  challenge_token: string  // min 32  code: string  // pattern}

Responses

  • 200{ ok }
  • 400invalid_code
  • 400invalid_request
  • 401unauthorized
  • 404not_found
  • 410expired
  • 429rate_limited
  • 429too_many_attempts
  • 500delete_failed

Source: app/api/v1/me/route.ts

GET/api/v1/me/auth-attempts
Signed inRate limited

Lists recent sign-in attempts on your account.

Details

Responses

  • 200{ items }
  • 401unauthorized
  • 404not_found
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/me/auth-attempts/route.ts

POST/api/v1/me/deletion-challenges
Signed inRate limited

Emails a confirmation code for deleting your account.

Details

Responses

  • 200{ challenge_token, ok }
  • 401unauthorized
  • 404not_found
  • 429rate_limited

Source: app/api/v1/me/deletion-challenges/route.ts

GET/api/v1/me/passkeys
Signed inRate limited

Lists the passkeys registered on your account.

Details

Responses

  • 200{ items }
  • 401unauthorized
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/me/passkeys/route.ts

PATCH/api/v1/me/passkeys/{id}
Signed inRate limited

Renames one of your passkeys.

Details

Path parameters

  • id

Request body

{  name: string | null  // max 100}

Responses

  • 200{ ok }
  • 400invalid_request
  • 401unauthorized
  • 404not_found
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/me/passkeys/[id]/route.ts

DELETE/api/v1/me/passkeys/{id}
Signed inRate limited

Removes one of your passkeys.

Details

Path parameters

  • id

Responses

  • 200{ ok }
  • 401unauthorized
  • 404not_found
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/me/passkeys/[id]/route.ts

PATCH/api/v1/me/preferences
Signed inRate limited

Updates your display name, public profile visibility, or community email preference.

Details

Request body

{  allowCommunityEmails?: boolean  name?: string | null  // max NAME_MAX_LENGTH  publicProfile?: boolean}

Responses

  • 200{ ok }
  • 400invalid_request
  • 400name_too_long
  • 400profanity_detected
  • 401unauthorized
  • 429rate_limited
  • 500update_failed

Source: app/api/v1/me/preferences/route.ts

GET/api/v1/me/subscription
Signed inRate limited

Returns your Guild membership: tier, status, current period, and last and upcoming charges.

Details

Responses

  • 200JSON body
  • 401unauthorized
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/me/subscription/route.ts

POST/api/v1/me/subscription/checkout
Signed inRate limited

Starts a Stripe Checkout session for a Guild membership tier and returns its URL.

Details

Request body

{  tier: 1 | 2 | 3}

Responses

  • 200JSON body
  • 400invalid_request
  • 401unauthorized
  • 404feature_disabled
  • 409already_subscribed
  • 409subscription_managed_in_portal
  • 429rate_limited
  • 500checkout_failed

Source: app/api/v1/me/subscription/checkout/route.ts

POST/api/v1/me/subscription/portal
Signed inRate limited

Opens a Stripe billing portal session for managing your Guild membership and returns its URL.

Details

Responses

  • 200JSON body
  • 401unauthorized
  • 404not_found
  • 429rate_limited
  • 500portal_failed

Source: app/api/v1/me/subscription/portal/route.ts

POST/api/v1/me/subscription/sync
Signed inRate limited

Refreshes your Guild membership from Stripe, for example right after returning from Checkout.

Details

Request body

{  checkoutSessionId?: string  // min 1}

Responses

  • 200JSON body
  • 400invalid_request
  • 401unauthorized
  • 403forbidden
  • 429rate_limited
  • 500sync_failed

Source: app/api/v1/me/subscription/sync/route.ts

Newsletters9

GET/api/v1/newsletters
PublicRate limited

Lists sent newsletters, newest first. Paginate with limit and offset.

Pass testSend=true to list test sends instead; that requires the editor role.

Details

Query parameters

  • limit
  • offset
  • testSend

Responses

  • 200{ …, items }
  • 401unauthorized
  • 403forbidden
  • 429rate_limited

Source: app/api/v1/newsletters/route.ts

POST/api/v1/newsletters
Role: editor

Sends a new newsletter and saves it to the archive.

The response streams progress while the emails go out.

Details

Request body

{  subject: string  // min 1  previewText?: string  sections: {    id: string    title: string  // min 1    text: string  // min 1    imageUrl?: string    ctaLabel?: string    ctaHref?: string  }[]  // min 1  audience: {    type: "all" | "subscribers" | "registered" | "manual"    manualEmails?: string[]  // default []  }  testMode?: boolean  // default false}

Responses

  • 200Streamed response
  • 400invalid_request
  • 400no_recipients
  • 400user_not_found
  • 401unauthorized
  • 403forbidden
  • 500send_failed

Source: app/api/v1/newsletters/route.ts

GET/api/v1/newsletters/{slug}
PublicRate limited

Returns a newsletter from the archive: subject, preview text, send date and sections.

Details

Path parameters

  • slug

Responses

  • 200JSON body
  • 404not_found
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/newsletters/[slug]/route.ts

DELETE/api/v1/newsletters/{slug}
Role: editor

Deletes a newsletter from the archive.

Details

Path parameters

  • slug

Responses

  • 200{ ok }
  • 401unauthorized
  • 403forbidden
  • 404not_found
  • 500internal_error

Source: app/api/v1/newsletters/[slug]/route.ts

POST/api/v1/newsletters/{slug}/sends
Role: editor

Sends an archived newsletter again to a chosen audience.

The response streams progress while the emails go out.

Details

Path parameters

  • slug

Request body

{  audience: {    type: "all" | "subscribers" | "registered" | "manual"    manualEmails?: string[]  // default []  }  testMode?: boolean  // default false}

Responses

  • 200Streamed response
  • 400invalid_request
  • 400no_recipients
  • 400user_not_found
  • 401unauthorized
  • 403forbidden
  • 404not_found
  • 422invalid_archive
  • 500send_failed

Source: app/api/v1/newsletters/[slug]/sends/route.ts

GET/api/v1/newsletters/audience/counts
Role: editor

Returns how many recipients each newsletter audience has.

Details

Responses

  • 200{ all, subscribers, registered }
  • 401unauthorized
  • 403forbidden

Source: app/api/v1/newsletters/audience/counts/route.ts

GET/api/v1/newsletters/subscriptions
PublicRate limited

Checks which address an unsubscribe link's token belongs to and whether it's still subscribed.

Details

Query parameters

  • token

Responses

  • 200{ subscribedAs }
  • 400invalid_request
  • 400invalid_token
  • 400not_subscribed
  • 429rate_limited
  • 500check_failed

Source: app/api/v1/newsletters/subscriptions/route.ts

POST/api/v1/newsletters/subscriptions
PublicRate limited

Subscribes an email address to the newsletter.

Details

Request body

{  email: string  // email, min 1, max 255}

Responses

  • 200
    {  subscribed: boolean}
  • 400invalid_email
  • 403bot_blocked
  • 403invalid_origin
  • 429rate_limited
  • 500subscribe_failed

Source: app/api/v1/newsletters/subscriptions/route.ts

DELETE/api/v1/newsletters/subscriptions
PublicRate limited

Unsubscribes using the token from an email's unsubscribe link.

Details

Request body

{  token: string  // min 1}

Responses

  • 200{ ok, email, unsubscribedFrom }
  • 400invalid_request
  • 400invalid_token
  • 400not_subscribed
  • 429rate_limited
  • 500unsubscribe_failed

Source: app/api/v1/newsletters/subscriptions/route.ts

Photos2

GET/api/v1/photos/albums
Public

Lists event photo albums, newest event first, with cover image and photo count.

Details

Responses

  • 200{ items }

Source: app/api/v1/photos/albums/route.ts

GET/api/v1/photos/albums/{album}
Public

Returns one photo album with every photo's URL and dimensions. album is the album slug.

Details

Path parameters

  • album

Responses

  • 200JSON body
  • 404not_found

Source: app/api/v1/photos/albums/[album]/route.ts

Recordings3

GET/api/v1/recordings
PublicRate limited

Lists 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.

Details

Query parameters

  • limit
  • offset

Responses

  • 200JSON body
  • 429rate_limited

Source: app/api/v1/recordings/route.ts

GET/api/v1/recordings/{shortId}
Public

Returns one recorded talk by its short ID.

Details

Path parameters

  • shortId

Responses

  • 200JSON body
  • 404not_found

Source: app/api/v1/recordings/[shortId]/route.ts

GET/api/v1/recordings/facets
PublicRate limited

Returns 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.

Details

Responses

  • 200JSON body
  • 429rate_limited

Source: app/api/v1/recordings/facets/route.ts

Speakers2

GET/api/v1/speakers
Public

Lists everyone who has spoken at Bonfire, with their number of talks.

Details

Responses

  • 200{ items }

Source: app/api/v1/speakers/route.ts

GET/api/v1/speakers/{slug}
Public

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.

Details

Path parameters

  • slug

Responses

  • 200JSON body
  • 404not_found

Source: app/api/v1/speakers/[slug]/route.ts

Stripe1

POST/api/v1/stripe/webhooks
Stripe signature

Receives Stripe webhook events that keep Guild memberships in sync. Verified with the stripe-signature header.

Details

Responses

  • 200{ ok }
  • 400invalid_signature
  • 500webhook_failed

Source: app/api/v1/stripe/webhooks/route.ts

Talk proposals1

POST/api/v1/talk-proposals
PublicRate limited

Submits 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.

Details

Request body

{  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}

Responses

  • 201{ ok }
  • 400captcha_failed
  • 400invalid_request
  • 403bot_blocked
  • 403csrf_invalid
  • 403invalid_origin
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/talk-proposals/route.ts

Users7

GET/api/v1/users/{userId}
PublicRate limited
Details

Path parameters

  • userId

Responses

  • 200JSON body
  • 400invalid_id
  • 403private_profile
  • 404not_found
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/users/[userId]/route.ts

GET/api/v1/users/{userId}/boosts
Signed in · own dataRate limited

Lists the videos you've boosted. Use me as the user ID.

Details

Path parameters

  • userId

Use me for your own account.

Responses

  • 200{ items }
  • 401unauthorized
  • 403forbidden
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/users/[userId]/boosts/route.ts

GET/api/v1/users/{userId}/check-ins
Signed in · own dataRate limited

Returns your personal check-in QR token for events. Use me as the user ID.

Details

Path parameters

  • userId

Use me for your own account.

Responses

  • 200{ token, expiresAt, publicId }
  • 401unauthorized
  • 403forbidden
  • 429rate_limited
  • 500check_in_not_configured
  • 500internal_error

Source: app/api/v1/users/[userId]/check-ins/route.ts

GET/api/v1/users/{userId}/watchlist
Signed in · own dataRate limited

Lists the videos on your Watch Later list, newest first, with each recording. Use me as the user ID.

Details

Path parameters

  • userId

Use me for your own account.

Responses

  • 200{ items }
  • 401unauthorized
  • 403forbidden
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/users/[userId]/watchlist/route.ts

GET/api/v1/users/{userId}/watchlist/{videoId}
Public · personalized when signed inRate limited

Returns whether a video is on your Watch Later list. Always false when signed out.

Details

Path parameters

  • userId
  • videoId

Use me for your own account.

Responses

  • 200{ inWatchlist }
  • 400invalid_id
  • 403forbidden
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/users/[userId]/watchlist/[videoId]/route.ts

PUT/api/v1/users/{userId}/watchlist/{videoId}
Signed in · own dataRate limited

Adds a video to your Watch Later list.

Details

Path parameters

  • userId
  • videoId

Use me for your own account.

Responses

  • 200{ added, inWatchlist }
  • 400invalid_id
  • 401unauthorized
  • 403forbidden
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/users/[userId]/watchlist/[videoId]/route.ts

DELETE/api/v1/users/{userId}/watchlist/{videoId}
Signed in · own dataRate limited

Removes a video from your Watch Later list.

Details

Path parameters

  • userId
  • videoId

Use me for your own account.

Responses

  • 200{ removed, inWatchlist }
  • 400invalid_id
  • 401unauthorized
  • 403forbidden
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/users/[userId]/watchlist/[videoId]/route.ts

Videos6

GET/api/v1/videos/{id}/boosts
Public · personalized when signed inRate limited

Returns a video's boost count and who boosted it. When signed in, also whether you boosted it and how many boosts you have left.

Details

Path parameters

  • id

Responses

  • 200
    {  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}
  • 400invalid_id
  • 401unauthorized
  • 403bot_blocked
  • 403invalid_origin
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/videos/[id]/boosts/route.ts

POST/api/v1/videos/{id}/boosts
Public · personalized when signed inRate limited

Boosts a video, spending one of your boosts. Requires sign-in.

Details

Path parameters

  • id

Responses

  • 200
    {  added?: boolean  count: number  // int, min 0  removed?: boolean  availableBoosts?: number  // int, min 0, max BOOST_CONFIG.MAX_BOOSTS}
  • 400invalid_id
  • 401unauthorized
  • 403bot_blocked
  • 403invalid_origin
  • 403no_boosts_available
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/videos/[id]/boosts/route.ts

DELETE/api/v1/videos/{id}/boosts
Public · personalized when signed inRate limited

Removes your boost from a video and gives the boost back. Requires sign-in.

Details

Path parameters

  • id

Responses

  • 200
    {  added?: boolean  count: number  // int, min 0  removed?: boolean  availableBoosts?: number  // int, min 0, max BOOST_CONFIG.MAX_BOOSTS}
  • 400invalid_id
  • 401unauthorized
  • 403bot_blocked
  • 403invalid_origin
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/videos/[id]/boosts/route.ts

GET/api/v1/videos/{id}/likes
PublicRate limited

Returns a video's like count and whether this visitor has liked it.

Details

Path parameters

  • id

Responses

  • 200
    {  count: number  // int, min 0  hasLiked: boolean}
  • 400invalid_id
  • 403bot_blocked
  • 403invalid_origin
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/videos/[id]/likes/route.ts

POST/api/v1/videos/{id}/likes
PublicRate limited

Likes a video. No account needed: likes are tied to the visitor.

Details

Path parameters

  • id

Responses

  • 200
    {  added?: boolean  count: number  // int, min 0  removed?: boolean}
  • 400invalid_id
  • 403bot_blocked
  • 403invalid_origin
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/videos/[id]/likes/route.ts

DELETE/api/v1/videos/{id}/likes
PublicRate limited

Removes this visitor's like from a video.

Details

Path parameters

  • id

Responses

  • 200
    {  added?: boolean  count: number  // int, min 0  removed?: boolean}
  • 400invalid_id
  • 403bot_blocked
  • 403invalid_origin
  • 429rate_limited
  • 500internal_error

Source: app/api/v1/videos/[id]/likes/route.ts

System3

GET/.well-known/jwks.json
Public

Publishes the public keys for verifying Bonfire access and ID tokens.

Details

Responses

  • 200{ keys }
  • 500internal_error

Source: app/.well-known/jwks.json/route.ts

GET/.well-known/openid-configuration
Public

OpenID Connect discovery document describing the token endpoint and signing keys.

Details

Responses

  • 200{ 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

GET/api/health
Public

Reports service and database health. Returns 503 when the database is unreachable.

Details

Responses

  • 200{ status, timestamp, version, database }
  • 503{ status, timestamp, version, database, message }

Source: app/api/health/route.ts