{"openapi":"3.1.0","info":{"title":"Barq Meet Developer API","version":"1.0.0","description":"## Webhooks\n\n- booking.created — A booking was confirmed immediately, without an approval step.\n- booking.cancelled — A host or guest canceled the booking.\n- booking.rescheduled — A replacement booking was created. The replaced booking becomes canceled as part of the reschedule. The payload includes its UID and start in data.previousBooking.\n- booking.reschedule_requested — The host asked the guest to choose another time. The original booking stays confirmed.\n- booking.requested — An approval-required booking was created in pending status.\n- booking.approved — The host approved a pending request. This is its confirmation event.\n- booking.declined — The host declined a pending request.\n- booking.expired — A pending request reached its approval deadline.\n- booking.no_show — The host marked the guest as a no-show.\n- converge.ready — A group poll has an eligible time when the Converge experiment is enabled.\n- converge.booked — A group poll reserved its chosen time when the Converge experiment is enabled.\n\nIn Settings → API & webhooks, add a public HTTPS endpoint and save the signing secret. Verify the HMAC-SHA256 of timestamp + \".\" + the raw bytes. Allow five minutes of clock skew. Accept each event ID once, durably enqueue it, then return 2xx. The delivery header BarqMeet-Delivery contains the same UUID as payload.id. Failed deliveries make up to eight attempts within 24 hours, starting after five minutes and doubling each delay. Endpoints with three days of consecutive failures are disabled.\n\nUse Rotate secret on an endpoint to get a new signing secret. Save it when shown. For 24 hours each header contains the current and previous v1 signatures. A receiver should accept any v1 value that matches its signing secret. Use Delivery log → Redeliver to queue a stored payload to the current endpoint. Redelivery preserves the event ID for deduplication and signs with the current key. Test sends include test: true.\n\ndata.booking includes uid, status, start, end, duration, timeZone, eventTitle, hostName, location, guest, extraGuests, addToCalendar, id, eventTypeId, answers, utm, source, noShow, createdAt and Google sync state. Approval, cancellation and reschedule fields appear when relevant. The booking is a snapshot at the time of the event.\n\nConverge events include data.converge with id, title, status, bookingId and bookedSlot.\n\nExample payload (booking fields trimmed):\n\n```json\n\n{\n  \"id\": \"81f9b41a-34ba-4d29-90f9-cf4a7d039080\",\n  \"event\": \"booking.created\",\n  \"createdAt\": \"2027-01-12T09:00:00Z\",\n  \"data\": {\n    \"booking\": {\n      \"uid\": \"bk_example\",\n      \"status\": \"confirmed\",\n      \"start\": \"2027-01-12T10:00:00Z\"\n    }\n  }\n}\n\n```\n\n### Node / Express signature verification\n\n```js\n\nimport { createHmac, timingSafeEqual } from 'node:crypto';\n// Mount before express.json(); enqueueOnce must durably, atomically deduplicate by id.\napp.post('/webhooks/meetings', express.raw({ type: 'application/json' }), async (req, res) => {\n  const parts = (req.get('BarqMeet-Signature') || '').split(',').map(p => p.trim().split('='));\n  const timestamps = parts.filter(([name]) => name === 't').map(([, value]) => value);\n  const [t = ''] = timestamps;\n  if (timestamps.length !== 1 || !/^\\d+$/.test(t) || Math.abs(Date.now() / 1000 - Number(t)) > 300) return res.sendStatus(401);\n  const expected = createHmac('sha256', process.env.WEBHOOK_SECRET).update(t + '.').update(req.body).digest();\n  const signatures = parts.filter(([name]) => name === 'v1').map(([, value]) => value);\n  const verified = signatures.some(v1 => /^[a-f0-9]{64}$/i.test(v1 ?? '') && timingSafeEqual(expected, Buffer.from(v1, 'hex')));\n  if (!verified) return res.sendStatus(401);\n  const payload = JSON.parse(req.body.toString('utf8'));\n  await enqueueOnce(payload.id, payload); res.sendStatus(204);\n});\n\n```"},"servers":[{"url":"/api/v1"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Publishable keys require an allowed Origin; secret keys require no Origin. Publishable keys can read and create bookings (Turnstile required); booking detail also requires a manage token. Listing requires a secret key. Cancel and reschedule accept either a secret key or the booking manage token in the body (token) with a publishable key. Duration on slots defaults to the event default."}}},"paths":{"/api/c/join/{token}":{"get":{"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"},"description":"Signed group poll join token.","example":"JOIN_TOKEN"}],"servers":[{"url":"/"}],"security":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":120},"hostFirstName":{"type":"string"},"durationMin":{"type":"integer","minimum":5,"maximum":720},"windowStart":{"type":"string","format":"date-time"},"windowEnd":{"type":"string","format":"date-time"},"spotsLeft":{"type":"integer","minimum":0,"maximum":15}},"required":["title","hostFirstName","durationMin","windowStart","windowEnd","spotsLeft"],"additionalProperties":false}}}},"400":{"description":"Invalid form or verification token.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"The link is invalid or the feature is disabled.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"410":{"description":"The poll is closed, expired, or full.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Too many requests or invitation emails.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"description":"Read the meeting summary and remaining spots for a Converge join link. Zero spots means the poll is full."},"post":{"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"},"description":"Signed group poll join token.","example":"JOIN_TOKEN"}],"servers":[{"url":"/"}],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120,"description":"Display name.","example":"Guest"},"email":{"type":"string","format":"email","maxLength":254,"description":"Email address.","example":"guest@example.com"},"turnstileToken":{"type":"string","minLength":1,"maxLength":4096,"description":"Required Turnstile verification token."}},"required":["name","email","turnstileToken"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"status":{"const":"joined","description":"Booking status filter or current status."},"token":{"type":"string","description":"Booking manage token; required with a publishable key for booking access or mutations.","example":"MANAGE_TOKEN"}},"required":["status","token"],"additionalProperties":false},{"type":"object","properties":{"status":{"const":"check_email","description":"Booking status filter or current status."}},"required":["status"],"additionalProperties":false}]}}}},"400":{"description":"Invalid form or verification token.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"The link is invalid or the feature is disabled.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"410":{"description":"The poll is closed, expired, or full.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Too many requests or invitation emails.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"description":"Join a Converge poll. Requires Turnstile. A new participant receives a personal token; a returning participant receives their link by email."}},"/event-types":{"get":{"security":[{"bearerAuth":[]}],"parameters":[{"name":"includeSecret","in":"query","schema":{"type":"boolean"},"description":"Include secret event types; requires a secret key."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"eventTypes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-f\\d]{24}$"},"slug":{"type":"string","minLength":1,"maxLength":60,"pattern":"^[a-z0-9-]+$","description":"Event type slug.","example":"intro-call"},"title":{"type":"string"},"description":{"type":"string"},"descriptionHtml":{"type":"string"},"look":{"type":"object","properties":{"preset":{"type":"string","enum":["classic","focus","split","calendar","compact","bold"]},"accentColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"appearance":{"type":"string","enum":["light","dark","auto"]},"fontPair":{"type":"string","enum":["instrument","serif-pair","grotesk-pair"]},"radius":{"type":"string","enum":["square","soft","round"]},"slotStyle":{"type":"string","enum":["list","grid"]},"showAvatar":{"type":"boolean"},"showDescription":{"type":"boolean"},"showTimeZoneSwitcher":{"type":"boolean"},"coverImageUrl":{"anyOf":[{"anyOf":[{"type":"string","format":"uri","maxLength":2048},{"type":"string","pattern":"^\\/api\\/public\\/files\\/[a-f0-9]{24}$"}]},{"type":"null"}]},"coverVersion":{"type":"string","pattern":"^[a-f0-9]{24}$"},"coverImageAlt":{"type":"string","maxLength":200},"coverFocal":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false},"version":{"const":1},"radiusPx":{"type":"number"},"theme":{"type":"object","properties":{"tokens":{"type":"object","properties":{"version":{"const":1},"palette":{"type":"object","properties":{"light":{"type":"object","properties":{"bg":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surface":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surfaceAlt":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"text":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"textMuted":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"border":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"accent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"onAccent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"focus":{"type":"string","pattern":"^#[a-f0-9]{6}$"}},"required":["bg","surface","surfaceAlt","text","textMuted","border","accent","onAccent","focus"],"additionalProperties":false},"dark":{"type":"object","properties":{"bg":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surface":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surfaceAlt":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"text":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"textMuted":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"border":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"accent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"onAccent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"focus":{"type":"string","pattern":"^#[a-f0-9]{6}$"}},"required":["bg","surface","surfaceAlt","text","textMuted","border","accent","onAccent","focus"],"additionalProperties":false}},"required":["light","dark"],"additionalProperties":false},"typography":{"type":"object","properties":{"heading":{"type":"string","enum":["instrument-sans","dm-sans","manrope","outfit","space-grotesk","archivo","syne","nunito","fraunces","playfair-display","libre-baskerville","ibm-plex-serif","jetbrains-mono","dm-mono"]},"body":{"type":"string","enum":["instrument-sans","dm-sans","manrope","outfit","space-grotesk","archivo","syne","nunito","fraunces","playfair-display","libre-baskerville","ibm-plex-serif","jetbrains-mono","dm-mono"]},"scale":{"type":"number","minimum":0.9,"maximum":1.2},"headingWeight":{"type":"number","minimum":400,"maximum":800},"headingCase":{"type":"string","enum":["none","upper"]},"letterSpacing":{"type":"string","enum":["tight","normal","wide"]}},"required":["heading","body","scale","headingWeight","headingCase","letterSpacing"],"additionalProperties":false},"shape":{"type":"object","properties":{"radius":{"type":"number","minimum":0,"maximum":28},"borderWidth":{"type":"number","minimum":0,"maximum":2},"shadow":{"type":"string","enum":["none","soft","lifted","hard"]}},"required":["radius","borderWidth","shadow"],"additionalProperties":false},"layout":{"type":"object","properties":{"base":{"type":"string","enum":["classic","focus","split","calendar","compact","bold"]},"sidebar":{"type":"string","enum":["left","right","top"]},"density":{"type":"string","enum":["comfy","compact"]},"slotStyle":{"type":"string","enum":["list","grid","pill"]},"calendarStyle":{"type":"string","enum":["grid","week-strip"]}},"required":["base","sidebar","density","slotStyle","calendarStyle"],"additionalProperties":false},"background":{"anyOf":[{"type":"object","properties":{"kind":{"const":"solid"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"gradient"},"angle":{"type":"number","minimum":0,"maximum":360},"stops":{"type":"array","items":{"type":"object","properties":{"color":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"position":{"type":"number","minimum":0,"maximum":100}},"required":["color","position"],"additionalProperties":false},"minItems":2,"maxItems":3}},"required":["kind","angle","stops"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"pattern"},"pattern":{"type":"string","enum":["dots","grid","waves","noise","diagonal"]},"color":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"opacity":{"type":"number","minimum":0,"maximum":0.25}},"required":["kind","pattern","color","opacity"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"mesh"},"blobs":{"type":"array","items":{"type":"object","properties":{"color":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"x":{"type":"number","minimum":0,"maximum":100},"y":{"type":"number","minimum":0,"maximum":100},"size":{"type":"number","minimum":15,"maximum":100}},"required":["color","x","y","size"],"additionalProperties":false},"minItems":3,"maxItems":4}},"required":["kind","blobs"],"additionalProperties":false}]},"components":{"type":"object","properties":{"button":{"type":"string","enum":["solid","outline","soft","pill","brutal"]},"card":{"type":"string","enum":["flat","bordered","elevated","glass"]},"header":{"type":"string","enum":["plain","band","cover"]}},"required":["button","card","header"],"additionalProperties":false},"motion":{"type":"string","enum":["none","subtle"]},"mode":{"type":"string","enum":["light","dark","auto"]}},"required":["version","palette","typography","shape","layout","background","components","motion","mode"],"additionalProperties":false},"variables":{"type":"object","properties":{"light":{"type":"object","additionalProperties":{"type":"string"}},"dark":{"type":"object","additionalProperties":{"type":"string"}}},"required":["light","dark"],"additionalProperties":false}},"required":["tokens","variables"],"additionalProperties":false},"tokens":{"type":"object","properties":{"light":{"type":"object","properties":{"fill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"onFill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"text":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"ring":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"adjusted":{"type":"boolean"}},"required":["fill","onFill","text","ring","adjusted"],"additionalProperties":false},"dark":{"type":"object","properties":{"fill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"onFill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"text":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"ring":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"adjusted":{"type":"boolean"}},"required":["fill","onFill","text","ring","adjusted"],"additionalProperties":false}},"required":["light","dark"],"additionalProperties":false}},"required":["preset","accentColor","appearance","fontPair","slotStyle","showAvatar","showDescription","showTimeZoneSwitcher","coverImageUrl","coverImageAlt","coverFocal","version","radiusPx","tokens"],"additionalProperties":false},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"durations":{"type":"array","items":{"type":"number"}},"defaultDuration":{"type":"number"},"location":{"type":"object","properties":{"type":{"type":"string","enum":["google_meet","custom"]},"label":{"type":"string"}},"required":["type","label"],"additionalProperties":false},"questions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,60}$"},"label":{"type":"string","minLength":1,"maxLength":1000},"type":{"type":"string","enum":["short_text","long_text","single_choice","multiple_choice","dropdown","phone","checkbox"]},"required":{"type":"boolean"},"options":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":100}},"required":["id","label","type","required","options"],"additionalProperties":false}},"allowGuests":{"type":"boolean"},"maxGuests":{"type":"number"},"businessEmailOnly":{"type":"boolean"},"requiresConfirmation":{"type":"boolean"},"bookingWindowEnd":{"type":"string"},"redirectUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"passDetailsToRedirect":{"type":"boolean"}},"required":["id","slug","title","description","descriptionHtml","color","durations","defaultDuration","location","questions","allowGuests","maxGuests","requiresConfirmation","redirectUrl","passDetailsToRedirect"],"additionalProperties":false}}},"required":["eventTypes"],"additionalProperties":false}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"405":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"413":{"description":"The JSON body exceeds the configured size limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"422":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"description":"List active event types owned by the API key host."}},"/event-types/{slug}":{"get":{"security":[{"bearerAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Event type slug.","example":"intro-call"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"host":{"type":"object","properties":{"eventsHidden":{"const":true},"timeZone":{"type":"string","maxLength":100,"description":"IANA time zone identifier.","example":"Europe/London"},"vacationTimeZone":{"type":"string","maxLength":100},"publicEmail":{"type":"string"},"name":{"type":"string","description":"Display name.","example":"Guest"},"username":{"type":"string","minLength":1,"maxLength":60,"pattern":"^[a-z0-9-]+$"},"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"bio":{"type":"string"},"look":{"type":"object","properties":{"preset":{"type":"string","enum":["classic","focus","split","calendar","compact","bold"]},"accentColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"appearance":{"type":"string","enum":["light","dark","auto"]},"fontPair":{"type":"string","enum":["instrument","serif-pair","grotesk-pair"]},"radius":{"type":"string","enum":["square","soft","round"]},"slotStyle":{"type":"string","enum":["list","grid"]},"showAvatar":{"type":"boolean"},"showDescription":{"type":"boolean"},"showTimeZoneSwitcher":{"type":"boolean"},"coverImageUrl":{"anyOf":[{"anyOf":[{"type":"string","format":"uri","maxLength":2048},{"type":"string","pattern":"^\\/api\\/public\\/files\\/[a-f0-9]{24}$"}]},{"type":"null"}]},"coverVersion":{"type":"string","pattern":"^[a-f0-9]{24}$"},"coverImageAlt":{"type":"string","maxLength":200},"coverFocal":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false},"version":{"const":1},"radiusPx":{"type":"number"},"theme":{"type":"object","properties":{"tokens":{"type":"object","properties":{"version":{"const":1},"palette":{"type":"object","properties":{"light":{"type":"object","properties":{"bg":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surface":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surfaceAlt":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"text":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"textMuted":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"border":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"accent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"onAccent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"focus":{"type":"string","pattern":"^#[a-f0-9]{6}$"}},"required":["bg","surface","surfaceAlt","text","textMuted","border","accent","onAccent","focus"],"additionalProperties":false},"dark":{"type":"object","properties":{"bg":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surface":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surfaceAlt":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"text":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"textMuted":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"border":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"accent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"onAccent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"focus":{"type":"string","pattern":"^#[a-f0-9]{6}$"}},"required":["bg","surface","surfaceAlt","text","textMuted","border","accent","onAccent","focus"],"additionalProperties":false}},"required":["light","dark"],"additionalProperties":false},"typography":{"type":"object","properties":{"heading":{"type":"string","enum":["instrument-sans","dm-sans","manrope","outfit","space-grotesk","archivo","syne","nunito","fraunces","playfair-display","libre-baskerville","ibm-plex-serif","jetbrains-mono","dm-mono"]},"body":{"type":"string","enum":["instrument-sans","dm-sans","manrope","outfit","space-grotesk","archivo","syne","nunito","fraunces","playfair-display","libre-baskerville","ibm-plex-serif","jetbrains-mono","dm-mono"]},"scale":{"type":"number","minimum":0.9,"maximum":1.2},"headingWeight":{"type":"number","minimum":400,"maximum":800},"headingCase":{"type":"string","enum":["none","upper"]},"letterSpacing":{"type":"string","enum":["tight","normal","wide"]}},"required":["heading","body","scale","headingWeight","headingCase","letterSpacing"],"additionalProperties":false},"shape":{"type":"object","properties":{"radius":{"type":"number","minimum":0,"maximum":28},"borderWidth":{"type":"number","minimum":0,"maximum":2},"shadow":{"type":"string","enum":["none","soft","lifted","hard"]}},"required":["radius","borderWidth","shadow"],"additionalProperties":false},"layout":{"type":"object","properties":{"base":{"type":"string","enum":["classic","focus","split","calendar","compact","bold"]},"sidebar":{"type":"string","enum":["left","right","top"]},"density":{"type":"string","enum":["comfy","compact"]},"slotStyle":{"type":"string","enum":["list","grid","pill"]},"calendarStyle":{"type":"string","enum":["grid","week-strip"]}},"required":["base","sidebar","density","slotStyle","calendarStyle"],"additionalProperties":false},"background":{"anyOf":[{"type":"object","properties":{"kind":{"const":"solid"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"gradient"},"angle":{"type":"number","minimum":0,"maximum":360},"stops":{"type":"array","items":{"type":"object","properties":{"color":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"position":{"type":"number","minimum":0,"maximum":100}},"required":["color","position"],"additionalProperties":false},"minItems":2,"maxItems":3}},"required":["kind","angle","stops"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"pattern"},"pattern":{"type":"string","enum":["dots","grid","waves","noise","diagonal"]},"color":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"opacity":{"type":"number","minimum":0,"maximum":0.25}},"required":["kind","pattern","color","opacity"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"mesh"},"blobs":{"type":"array","items":{"type":"object","properties":{"color":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"x":{"type":"number","minimum":0,"maximum":100},"y":{"type":"number","minimum":0,"maximum":100},"size":{"type":"number","minimum":15,"maximum":100}},"required":["color","x","y","size"],"additionalProperties":false},"minItems":3,"maxItems":4}},"required":["kind","blobs"],"additionalProperties":false}]},"components":{"type":"object","properties":{"button":{"type":"string","enum":["solid","outline","soft","pill","brutal"]},"card":{"type":"string","enum":["flat","bordered","elevated","glass"]},"header":{"type":"string","enum":["plain","band","cover"]}},"required":["button","card","header"],"additionalProperties":false},"motion":{"type":"string","enum":["none","subtle"]},"mode":{"type":"string","enum":["light","dark","auto"]}},"required":["version","palette","typography","shape","layout","background","components","motion","mode"],"additionalProperties":false},"variables":{"type":"object","properties":{"light":{"type":"object","additionalProperties":{"type":"string"}},"dark":{"type":"object","additionalProperties":{"type":"string"}}},"required":["light","dark"],"additionalProperties":false}},"required":["tokens","variables"],"additionalProperties":false},"tokens":{"type":"object","properties":{"light":{"type":"object","properties":{"fill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"onFill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"text":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"ring":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"adjusted":{"type":"boolean"}},"required":["fill","onFill","text","ring","adjusted"],"additionalProperties":false},"dark":{"type":"object","properties":{"fill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"onFill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"text":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"ring":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"adjusted":{"type":"boolean"}},"required":["fill","onFill","text","ring","adjusted"],"additionalProperties":false}},"required":["light","dark"],"additionalProperties":false}},"required":["preset","accentColor","appearance","fontPair","slotStyle","showAvatar","showDescription","showTimeZoneSwitcher","coverImageUrl","coverImageAlt","coverFocal","version","radiusPx","tokens"],"additionalProperties":false},"branding":{"type":"object","properties":{"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"accentColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"hidePoweredBy":{"type":"boolean"}},"required":["logoUrl","accentColor","hidePoweredBy"],"additionalProperties":false},"timeFormat":{"type":"string","enum":["12h","24h"]},"vacation":{"anyOf":[{"type":"object","properties":{"from":{"type":"string","description":"Inclusive start filter, ISO 8601 UTC.","example":"2027-01-01T00:00:00Z"},"until":{"type":"string"}},"required":[],"additionalProperties":false},{"type":"null"}]},"vacationMessage":{"type":"string"}},"required":["name","username","avatarUrl","bio","branding","timeFormat"],"additionalProperties":false},"eventType":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-f\\d]{24}$"},"slug":{"type":"string","minLength":1,"maxLength":60,"pattern":"^[a-z0-9-]+$","description":"Event type slug.","example":"intro-call"},"title":{"type":"string"},"description":{"type":"string"},"descriptionHtml":{"type":"string"},"look":{"type":"object","properties":{"preset":{"type":"string","enum":["classic","focus","split","calendar","compact","bold"]},"accentColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"appearance":{"type":"string","enum":["light","dark","auto"]},"fontPair":{"type":"string","enum":["instrument","serif-pair","grotesk-pair"]},"radius":{"type":"string","enum":["square","soft","round"]},"slotStyle":{"type":"string","enum":["list","grid"]},"showAvatar":{"type":"boolean"},"showDescription":{"type":"boolean"},"showTimeZoneSwitcher":{"type":"boolean"},"coverImageUrl":{"anyOf":[{"anyOf":[{"type":"string","format":"uri","maxLength":2048},{"type":"string","pattern":"^\\/api\\/public\\/files\\/[a-f0-9]{24}$"}]},{"type":"null"}]},"coverVersion":{"type":"string","pattern":"^[a-f0-9]{24}$"},"coverImageAlt":{"type":"string","maxLength":200},"coverFocal":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false},"version":{"const":1},"radiusPx":{"type":"number"},"theme":{"type":"object","properties":{"tokens":{"type":"object","properties":{"version":{"const":1},"palette":{"type":"object","properties":{"light":{"type":"object","properties":{"bg":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surface":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surfaceAlt":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"text":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"textMuted":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"border":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"accent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"onAccent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"focus":{"type":"string","pattern":"^#[a-f0-9]{6}$"}},"required":["bg","surface","surfaceAlt","text","textMuted","border","accent","onAccent","focus"],"additionalProperties":false},"dark":{"type":"object","properties":{"bg":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surface":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surfaceAlt":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"text":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"textMuted":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"border":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"accent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"onAccent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"focus":{"type":"string","pattern":"^#[a-f0-9]{6}$"}},"required":["bg","surface","surfaceAlt","text","textMuted","border","accent","onAccent","focus"],"additionalProperties":false}},"required":["light","dark"],"additionalProperties":false},"typography":{"type":"object","properties":{"heading":{"type":"string","enum":["instrument-sans","dm-sans","manrope","outfit","space-grotesk","archivo","syne","nunito","fraunces","playfair-display","libre-baskerville","ibm-plex-serif","jetbrains-mono","dm-mono"]},"body":{"type":"string","enum":["instrument-sans","dm-sans","manrope","outfit","space-grotesk","archivo","syne","nunito","fraunces","playfair-display","libre-baskerville","ibm-plex-serif","jetbrains-mono","dm-mono"]},"scale":{"type":"number","minimum":0.9,"maximum":1.2},"headingWeight":{"type":"number","minimum":400,"maximum":800},"headingCase":{"type":"string","enum":["none","upper"]},"letterSpacing":{"type":"string","enum":["tight","normal","wide"]}},"required":["heading","body","scale","headingWeight","headingCase","letterSpacing"],"additionalProperties":false},"shape":{"type":"object","properties":{"radius":{"type":"number","minimum":0,"maximum":28},"borderWidth":{"type":"number","minimum":0,"maximum":2},"shadow":{"type":"string","enum":["none","soft","lifted","hard"]}},"required":["radius","borderWidth","shadow"],"additionalProperties":false},"layout":{"type":"object","properties":{"base":{"type":"string","enum":["classic","focus","split","calendar","compact","bold"]},"sidebar":{"type":"string","enum":["left","right","top"]},"density":{"type":"string","enum":["comfy","compact"]},"slotStyle":{"type":"string","enum":["list","grid","pill"]},"calendarStyle":{"type":"string","enum":["grid","week-strip"]}},"required":["base","sidebar","density","slotStyle","calendarStyle"],"additionalProperties":false},"background":{"anyOf":[{"type":"object","properties":{"kind":{"const":"solid"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"gradient"},"angle":{"type":"number","minimum":0,"maximum":360},"stops":{"type":"array","items":{"type":"object","properties":{"color":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"position":{"type":"number","minimum":0,"maximum":100}},"required":["color","position"],"additionalProperties":false},"minItems":2,"maxItems":3}},"required":["kind","angle","stops"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"pattern"},"pattern":{"type":"string","enum":["dots","grid","waves","noise","diagonal"]},"color":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"opacity":{"type":"number","minimum":0,"maximum":0.25}},"required":["kind","pattern","color","opacity"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"mesh"},"blobs":{"type":"array","items":{"type":"object","properties":{"color":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"x":{"type":"number","minimum":0,"maximum":100},"y":{"type":"number","minimum":0,"maximum":100},"size":{"type":"number","minimum":15,"maximum":100}},"required":["color","x","y","size"],"additionalProperties":false},"minItems":3,"maxItems":4}},"required":["kind","blobs"],"additionalProperties":false}]},"components":{"type":"object","properties":{"button":{"type":"string","enum":["solid","outline","soft","pill","brutal"]},"card":{"type":"string","enum":["flat","bordered","elevated","glass"]},"header":{"type":"string","enum":["plain","band","cover"]}},"required":["button","card","header"],"additionalProperties":false},"motion":{"type":"string","enum":["none","subtle"]},"mode":{"type":"string","enum":["light","dark","auto"]}},"required":["version","palette","typography","shape","layout","background","components","motion","mode"],"additionalProperties":false},"variables":{"type":"object","properties":{"light":{"type":"object","additionalProperties":{"type":"string"}},"dark":{"type":"object","additionalProperties":{"type":"string"}}},"required":["light","dark"],"additionalProperties":false}},"required":["tokens","variables"],"additionalProperties":false},"tokens":{"type":"object","properties":{"light":{"type":"object","properties":{"fill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"onFill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"text":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"ring":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"adjusted":{"type":"boolean"}},"required":["fill","onFill","text","ring","adjusted"],"additionalProperties":false},"dark":{"type":"object","properties":{"fill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"onFill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"text":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"ring":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"adjusted":{"type":"boolean"}},"required":["fill","onFill","text","ring","adjusted"],"additionalProperties":false}},"required":["light","dark"],"additionalProperties":false}},"required":["preset","accentColor","appearance","fontPair","slotStyle","showAvatar","showDescription","showTimeZoneSwitcher","coverImageUrl","coverImageAlt","coverFocal","version","radiusPx","tokens"],"additionalProperties":false},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"durations":{"type":"array","items":{"type":"number"}},"defaultDuration":{"type":"number"},"location":{"type":"object","properties":{"type":{"type":"string","enum":["google_meet","custom"]},"label":{"type":"string"}},"required":["type","label"],"additionalProperties":false},"questions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,60}$"},"label":{"type":"string","minLength":1,"maxLength":1000},"type":{"type":"string","enum":["short_text","long_text","single_choice","multiple_choice","dropdown","phone","checkbox"]},"required":{"type":"boolean"},"options":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":100}},"required":["id","label","type","required","options"],"additionalProperties":false}},"allowGuests":{"type":"boolean"},"maxGuests":{"type":"number"},"businessEmailOnly":{"type":"boolean"},"requiresConfirmation":{"type":"boolean"},"bookingWindowEnd":{"type":"string"},"redirectUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"passDetailsToRedirect":{"type":"boolean"}},"required":["id","slug","title","description","descriptionHtml","color","durations","defaultDuration","location","questions","allowGuests","maxGuests","requiresConfirmation","redirectUrl","passDetailsToRedirect"],"additionalProperties":false,"description":"Event type slug owned by the API key host.","example":"intro-call"},"status":{"type":"string","enum":["ok","vacation","unavailable","inactive"],"description":"Booking status filter or current status."},"prefill":{"type":"object","properties":{"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":5000},{"type":"array","items":{"type":"string","maxLength":1000},"maxItems":100},{"type":"boolean"}]},"description":"Answers keyed by event question ID."}},"required":["answers"],"additionalProperties":false},"vacation":{"anyOf":[{"type":"object","properties":{"from":{"type":"string","description":"Inclusive start filter, ISO 8601 UTC.","example":"2027-01-01T00:00:00Z"},"until":{"type":"string"}},"required":[],"additionalProperties":false},{"type":"null"}]},"vacationMessage":{"type":"string"},"firstAvailableDate":{"type":"string"},"nextAvailableMonth":{"type":"string","pattern":"^\\d{4}-\\d{2}$"}},"required":["host","eventType","status","vacation"],"additionalProperties":false}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"405":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"413":{"description":"The JSON body exceeds the configured size limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"422":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"description":"Read an event type, its questions, durations and branding."}},"/event-types/{slug}/slots":{"get":{"security":[{"bearerAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Event type slug.","example":"intro-call"},{"name":"start","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"description":"Start instant in ISO 8601 UTC.","example":"2027-01-12T10:00:00Z"},{"name":"end","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"description":"End instant in ISO 8601 UTC; slots allow at most 31 days per call.","example":"2027-01-12T10:30:00Z"},{"name":"timeZone","in":"query","required":false,"schema":{"type":"string","maxLength":100},"description":"IANA time zone identifier.","example":"Europe/London"},{"name":"duration","in":"query","required":false,"schema":{"type":"integer","minimum":5,"maximum":720},"description":"Duration in minutes; slots default to the event default.","example":30}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"timeZone":{"type":"string","maxLength":100,"description":"IANA time zone identifier.","example":"Europe/London"},"slots":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string","format":"date-time","description":"Start instant in ISO 8601 UTC.","example":"2027-01-12T10:00:00Z"},"end":{"type":"string","format":"date-time","description":"End instant in ISO 8601 UTC; slots allow at most 31 days per call.","example":"2027-01-12T10:30:00Z"},"preferred":{"type":"boolean"}},"required":["start","end","preferred"],"additionalProperties":false}},"suggested":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string","format":"date-time","description":"Start instant in ISO 8601 UTC.","example":"2027-01-12T10:00:00Z"},"end":{"type":"string","format":"date-time","description":"End instant in ISO 8601 UTC; slots allow at most 31 days per call.","example":"2027-01-12T10:30:00Z"}},"required":["start","end"],"additionalProperties":false}},"firstAvailableDate":{"type":"string"},"nextAvailableMonth":{"type":"string","pattern":"^\\d{4}-\\d{2}$"}},"required":["timeZone","slots","suggested"],"additionalProperties":false}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"405":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"413":{"description":"The JSON body exceeds the configured size limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"422":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"description":"Find available slots (maximum 31 days); duration defaults to the event default. timeZone defaults to the event schedule time zone (UTC if unavailable) and is echoed in the response."}},"/bookings":{"get":{"security":[{"bearerAuth":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["pending","confirmed","declined","expired","canceled"]},"description":"Booking status filter or current status."},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Inclusive start filter, ISO 8601 UTC.","example":"2027-01-01T00:00:00Z"},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Exclusive end filter, ISO 8601 UTC.","example":"2027-02-01T00:00:00Z"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000000},"description":"Page number (default 1).","example":1},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Results per page (default 50, maximum 100).","example":50}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"bookings":{"type":"array","items":{"type":"object","properties":{"uid":{"type":"string","description":"Booking identifier.","example":"bk_example"},"status":{"type":"string","enum":["pending","confirmed","declined","expired","canceled"],"description":"Booking status filter or current status."},"start":{"type":"string","format":"date-time","description":"Start instant in ISO 8601 UTC.","example":"2027-01-12T10:00:00Z"},"end":{"type":"string","format":"date-time","description":"End instant in ISO 8601 UTC; slots allow at most 31 days per call.","example":"2027-01-12T10:30:00Z"},"duration":{"type":"number","description":"Duration in minutes; slots default to the event default.","example":30},"timeZone":{"type":"string","maxLength":100,"description":"IANA time zone identifier.","example":"Europe/London"},"eventTitle":{"type":"string"},"hostName":{"type":"string"},"location":{"type":"object","properties":{"type":{"type":"string","enum":["google_meet","custom"]},"label":{"type":"string"},"joinUrl":{"type":"string","format":"uri"}},"required":["type","label"],"additionalProperties":false},"guest":{"type":"object","properties":{"name":{"type":"string","description":"Display name.","example":"Guest"},"email":{"type":"string","format":"email","maxLength":254,"description":"Email address.","example":"guest@example.com"}},"required":["name","email"],"additionalProperties":false,"description":"Guest contact details and time zone."},"embedGuestEmailAllowed":{"type":"boolean"},"extraGuests":{"type":"array","items":{"type":"string","format":"email"},"description":"Additional guest email addresses (maximum 10)."},"requestExpiresAt":{"type":"string","format":"date-time"},"withdrawnByGuest":{"type":"boolean"},"joinLinkUnavailable":{"type":"boolean"},"manageToken":{"type":"string","maxLength":200},"manageUrl":{"type":"string","format":"uri"},"addToCalendar":{"type":"object","properties":{"google":{"type":"string","format":"uri"},"outlook":{"type":"string","format":"uri"},"icsUrl":{"type":"string","format":"uri"}},"required":["google","outlook","icsUrl"],"additionalProperties":false},"id":{"type":"string","pattern":"^[a-f\\d]{24}$"},"eventTypeId":{"type":"string","pattern":"^[a-f\\d]{24}$"},"answers":{"type":"array","items":{"type":"object","properties":{"questionId":{"type":"string"},"label":{"type":"string"},"value":{"anyOf":[{"type":"string","maxLength":5000},{"type":"array","items":{"type":"string","maxLength":1000},"maxItems":100},{"type":"boolean"}]}},"required":["questionId","label","value"],"additionalProperties":false},"description":"Answers keyed by event question ID."},"utm":{"type":"object","properties":{"source":{"type":"string","maxLength":500},"medium":{"type":"string","maxLength":500},"campaign":{"type":"string","maxLength":500},"term":{"type":"string","maxLength":500},"content":{"type":"string","maxLength":500},"ref":{"type":"string","maxLength":2000}},"required":[],"additionalProperties":false,"description":"Optional campaign attribution fields."},"source":{"type":"string","enum":["page","embed","api"]},"noShow":{"type":"boolean"},"emailActivity":{"type":"object","properties":{"confirmationOpenedAt":{"type":"string","format":"date-time"},"lastOpenedAt":{"type":"string","format":"date-time"},"opens":{"type":"integer","minimum":0},"linkClicks":{"type":"integer","minimum":0}},"required":["opens","linkClicks"],"additionalProperties":false},"cancel":{"type":"object","properties":{"by":{"type":"string","enum":["host","guest"]},"reason":{"type":"string","description":"Optional cancellation or reschedule reason (maximum 2000 characters)."},"at":{"type":"string","format":"date-time"}},"required":["by","at"],"additionalProperties":false},"approval":{"type":"object","properties":{"decidedAt":{"type":"string","format":"date-time"},"decidedBy":{"type":"string","pattern":"^[a-f\\d]{24}$"},"reason":{"type":"string","description":"Optional cancellation or reschedule reason (maximum 2000 characters)."}},"required":[],"additionalProperties":false},"rescheduleReason":{"type":"string"},"rescheduledFrom":{"type":"string","pattern":"^[a-f\\d]{24}$"},"rescheduledBy":{"type":"string","enum":["host","guest"]},"rescheduledTo":{"type":"string","pattern":"^[a-f\\d]{24}$"},"createdAt":{"type":"string","format":"date-time"},"googleSyncState":{"type":"string","enum":["pending","synced","error","deleted"]}},"required":["uid","status","start","end","duration","timeZone","eventTitle","hostName","location","guest","extraGuests","manageUrl","addToCalendar","id","eventTypeId","answers","utm","source","noShow","createdAt","googleSyncState"],"additionalProperties":false}},"total":{"type":"number"},"page":{"type":"number","description":"Page number (default 1).","example":1},"limit":{"type":"number","description":"Results per page (default 50, maximum 100).","example":50}},"required":["bookings","total","page","limit"],"additionalProperties":false}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"405":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"413":{"description":"The JSON body exceeds the configured size limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"422":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"description":"List bookings with filters and pagination; requires a secret key."},"post":{"security":[{"bearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string","maxLength":200},"description":"Unique key reused for retries of the same booking.","example":"checkout-123"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"start":{"type":"string","format":"date-time","description":"Start instant in ISO 8601 UTC.","example":"2027-01-12T10:00:00Z"},"duration":{"type":"integer","minimum":5,"maximum":720,"description":"Duration in minutes; slots default to the event default.","example":30},"guest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120,"description":"Display name.","example":"Guest"},"email":{"type":"string","format":"email","maxLength":254,"description":"Email address.","example":"guest@example.com"},"timeZone":{"type":"string","maxLength":100,"description":"IANA time zone identifier.","example":"Europe/London"},"timeFormat":{"type":"string","enum":["12h","24h"]}},"required":["name","email","timeZone"],"additionalProperties":false,"description":"Guest contact details and time zone."},"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":5000},{"type":"array","items":{"type":"string","maxLength":1000},"maxItems":100},{"type":"boolean"}]},"description":"Answers keyed by event question ID."},"extraGuests":{"type":"array","items":{"type":"string","format":"email","maxLength":254},"maxItems":10,"description":"Additional guest email addresses (maximum 10)."},"utm":{"type":"object","properties":{"source":{"type":"string","maxLength":500},"medium":{"type":"string","maxLength":500},"campaign":{"type":"string","maxLength":500},"term":{"type":"string","maxLength":500},"content":{"type":"string","maxLength":500},"ref":{"type":"string","maxLength":2000}},"required":[],"additionalProperties":false,"description":"Optional campaign attribution fields."},"turnstileToken":{"type":"string","minLength":1,"maxLength":4096,"description":"Required for booking creation, cancellation and rescheduling with a publishable key; omit with a secret key."},"website":{"type":"string","maxLength":2000,"description":"Honeypot; leave empty.","example":""},"locale":{"type":"string","maxLength":100,"description":"Guest locale for notifications.","example":"en-US"},"startedAt":{"type":"string","format":"date-time","description":"When the guest form was first shown; wait at least 3 seconds before submitting."},"eventType":{"type":"string","minLength":1,"maxLength":60,"description":"Event type slug owned by the API key host.","example":"intro-call"}},"required":["start","duration","guest","eventType"],"additionalProperties":false}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"booking":{"anyOf":[{"type":"object","properties":{"uid":{"type":"string","description":"Booking identifier.","example":"bk_example"},"status":{"type":"string","enum":["pending","confirmed","declined","expired","canceled"],"description":"Booking status filter or current status."},"start":{"type":"string","format":"date-time","description":"Start instant in ISO 8601 UTC.","example":"2027-01-12T10:00:00Z"},"end":{"type":"string","format":"date-time","description":"End instant in ISO 8601 UTC; slots allow at most 31 days per call.","example":"2027-01-12T10:30:00Z"},"duration":{"type":"number","description":"Duration in minutes; slots default to the event default.","example":30},"timeZone":{"type":"string","maxLength":100,"description":"IANA time zone identifier.","example":"Europe/London"},"eventTitle":{"type":"string"},"hostName":{"type":"string"},"location":{"type":"object","properties":{"type":{"type":"string","enum":["google_meet","custom"]},"label":{"type":"string"},"joinUrl":{"type":"string","format":"uri"}},"required":["type","label"],"additionalProperties":false},"guest":{"type":"object","properties":{"name":{"type":"string","description":"Display name.","example":"Guest"},"email":{"type":"string","format":"email","maxLength":254,"description":"Email address.","example":"guest@example.com"}},"required":["name","email"],"additionalProperties":false,"description":"Guest contact details and time zone."},"embedGuestEmailAllowed":{"type":"boolean"},"extraGuests":{"type":"array","items":{"type":"string","format":"email"},"description":"Additional guest email addresses (maximum 10)."},"requestExpiresAt":{"type":"string","format":"date-time"},"withdrawnByGuest":{"type":"boolean"},"joinLinkUnavailable":{"type":"boolean"},"manageToken":{"type":"string","maxLength":200},"manageUrl":{"type":"string","format":"uri"},"addToCalendar":{"type":"object","properties":{"google":{"type":"string","format":"uri"},"outlook":{"type":"string","format":"uri"},"icsUrl":{"type":"string","format":"uri"}},"required":["google","outlook","icsUrl"],"additionalProperties":false},"id":{"type":"string","pattern":"^[a-f\\d]{24}$"},"eventTypeId":{"type":"string","pattern":"^[a-f\\d]{24}$"},"answers":{"type":"array","items":{"type":"object","properties":{"questionId":{"type":"string"},"label":{"type":"string"},"value":{"anyOf":[{"type":"string","maxLength":5000},{"type":"array","items":{"type":"string","maxLength":1000},"maxItems":100},{"type":"boolean"}]}},"required":["questionId","label","value"],"additionalProperties":false},"description":"Answers keyed by event question ID."},"utm":{"type":"object","properties":{"source":{"type":"string","maxLength":500},"medium":{"type":"string","maxLength":500},"campaign":{"type":"string","maxLength":500},"term":{"type":"string","maxLength":500},"content":{"type":"string","maxLength":500},"ref":{"type":"string","maxLength":2000}},"required":[],"additionalProperties":false,"description":"Optional campaign attribution fields."},"source":{"type":"string","enum":["page","embed","api"]},"noShow":{"type":"boolean"},"emailActivity":{"type":"object","properties":{"confirmationOpenedAt":{"type":"string","format":"date-time"},"lastOpenedAt":{"type":"string","format":"date-time"},"opens":{"type":"integer","minimum":0},"linkClicks":{"type":"integer","minimum":0}},"required":["opens","linkClicks"],"additionalProperties":false},"cancel":{"type":"object","properties":{"by":{"type":"string","enum":["host","guest"]},"reason":{"type":"string","description":"Optional cancellation or reschedule reason (maximum 2000 characters)."},"at":{"type":"string","format":"date-time"}},"required":["by","at"],"additionalProperties":false},"approval":{"type":"object","properties":{"decidedAt":{"type":"string","format":"date-time"},"decidedBy":{"type":"string","pattern":"^[a-f\\d]{24}$"},"reason":{"type":"string","description":"Optional cancellation or reschedule reason (maximum 2000 characters)."}},"required":[],"additionalProperties":false},"rescheduleReason":{"type":"string"},"rescheduledFrom":{"type":"string","pattern":"^[a-f\\d]{24}$"},"rescheduledBy":{"type":"string","enum":["host","guest"]},"rescheduledTo":{"type":"string","pattern":"^[a-f\\d]{24}$"},"createdAt":{"type":"string","format":"date-time"},"googleSyncState":{"type":"string","enum":["pending","synced","error","deleted"]}},"required":["uid","status","start","end","duration","timeZone","eventTitle","hostName","location","guest","extraGuests","manageUrl","addToCalendar","id","eventTypeId","answers","utm","source","noShow","createdAt","googleSyncState"],"additionalProperties":false},{"type":"object","properties":{"uid":{"type":"string","description":"Booking identifier.","example":"bk_example"},"status":{"type":"string","enum":["pending","confirmed","declined","expired","canceled"],"description":"Booking status filter or current status."},"start":{"type":"string","format":"date-time","description":"Start instant in ISO 8601 UTC.","example":"2027-01-12T10:00:00Z"},"end":{"type":"string","format":"date-time","description":"End instant in ISO 8601 UTC; slots allow at most 31 days per call.","example":"2027-01-12T10:30:00Z"},"duration":{"type":"number","description":"Duration in minutes; slots default to the event default.","example":30},"timeZone":{"type":"string","maxLength":100,"description":"IANA time zone identifier.","example":"Europe/London"},"eventTitle":{"type":"string"},"hostName":{"type":"string"},"location":{"type":"object","properties":{"type":{"type":"string","enum":["google_meet","custom"]},"label":{"type":"string"},"joinUrl":{"type":"string","format":"uri"}},"required":["type","label"],"additionalProperties":false},"guest":{"type":"object","properties":{"name":{"type":"string","description":"Display name.","example":"Guest"},"email":{"type":"string","format":"email","maxLength":254,"description":"Email address.","example":"guest@example.com"}},"required":["name"],"additionalProperties":false,"description":"Guest contact details and time zone."},"embedGuestEmailAllowed":{"type":"boolean"},"extraGuests":{"type":"array","items":{"type":"string","format":"email"},"description":"Additional guest email addresses (maximum 10)."},"requestExpiresAt":{"type":"string","format":"date-time"},"withdrawnByGuest":{"type":"boolean"},"joinLinkUnavailable":{"type":"boolean"},"manageToken":{"type":"string","maxLength":200},"manageUrl":{"type":"string","format":"uri"},"addToCalendar":{"type":"object","properties":{"google":{"type":"string","format":"uri"},"outlook":{"type":"string","format":"uri"},"icsUrl":{"type":"string","format":"uri"}},"required":["google","outlook","icsUrl"],"additionalProperties":false}},"required":["uid","status","start","end","duration","timeZone","eventTitle","hostName","location","guest","extraGuests","manageUrl","addToCalendar"],"additionalProperties":false}]}},"required":["booking"],"additionalProperties":false}}},"headers":{"Idempotency-Replayed":{"description":"true on a replay","schema":{"type":"string"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Forbidden. Blocked guests receive booking_not_allowed with a neutral message.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"405":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"413":{"description":"The JSON body exceeds the configured size limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"422":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"description":"Create a booking; publishable keys require Turnstile. Supports Idempotency-Key."}},"/bookings/{uid}":{"get":{"security":[{"bearerAuth":[]}],"parameters":[{"name":"uid","in":"path","required":true,"schema":{"type":"string"},"description":"Booking identifier.","example":"bk_example"},{"name":"token","in":"query","schema":{"type":"string"},"description":"Booking manage token; required with a publishable key for booking access or mutations.","example":"MANAGE_TOKEN"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"booking":{"anyOf":[{"type":"object","properties":{"uid":{"type":"string","description":"Booking identifier.","example":"bk_example"},"status":{"type":"string","enum":["pending","confirmed","declined","expired","canceled"],"description":"Booking status filter or current status."},"start":{"type":"string","format":"date-time","description":"Start instant in ISO 8601 UTC.","example":"2027-01-12T10:00:00Z"},"end":{"type":"string","format":"date-time","description":"End instant in ISO 8601 UTC; slots allow at most 31 days per call.","example":"2027-01-12T10:30:00Z"},"duration":{"type":"number","description":"Duration in minutes; slots default to the event default.","example":30},"timeZone":{"type":"string","maxLength":100,"description":"IANA time zone identifier.","example":"Europe/London"},"eventTitle":{"type":"string"},"hostName":{"type":"string"},"location":{"type":"object","properties":{"type":{"type":"string","enum":["google_meet","custom"]},"label":{"type":"string"},"joinUrl":{"type":"string","format":"uri"}},"required":["type","label"],"additionalProperties":false},"guest":{"type":"object","properties":{"name":{"type":"string","description":"Display name.","example":"Guest"},"email":{"type":"string","format":"email","maxLength":254,"description":"Email address.","example":"guest@example.com"}},"required":["name","email"],"additionalProperties":false,"description":"Guest contact details and time zone."},"embedGuestEmailAllowed":{"type":"boolean"},"extraGuests":{"type":"array","items":{"type":"string","format":"email"},"description":"Additional guest email addresses (maximum 10)."},"requestExpiresAt":{"type":"string","format":"date-time"},"withdrawnByGuest":{"type":"boolean"},"joinLinkUnavailable":{"type":"boolean"},"manageToken":{"type":"string","maxLength":200},"manageUrl":{"type":"string","format":"uri"},"addToCalendar":{"type":"object","properties":{"google":{"type":"string","format":"uri"},"outlook":{"type":"string","format":"uri"},"icsUrl":{"type":"string","format":"uri"}},"required":["google","outlook","icsUrl"],"additionalProperties":false},"id":{"type":"string","pattern":"^[a-f\\d]{24}$"},"eventTypeId":{"type":"string","pattern":"^[a-f\\d]{24}$"},"answers":{"type":"array","items":{"type":"object","properties":{"questionId":{"type":"string"},"label":{"type":"string"},"value":{"anyOf":[{"type":"string","maxLength":5000},{"type":"array","items":{"type":"string","maxLength":1000},"maxItems":100},{"type":"boolean"}]}},"required":["questionId","label","value"],"additionalProperties":false},"description":"Answers keyed by event question ID."},"utm":{"type":"object","properties":{"source":{"type":"string","maxLength":500},"medium":{"type":"string","maxLength":500},"campaign":{"type":"string","maxLength":500},"term":{"type":"string","maxLength":500},"content":{"type":"string","maxLength":500},"ref":{"type":"string","maxLength":2000}},"required":[],"additionalProperties":false,"description":"Optional campaign attribution fields."},"source":{"type":"string","enum":["page","embed","api"]},"noShow":{"type":"boolean"},"emailActivity":{"type":"object","properties":{"confirmationOpenedAt":{"type":"string","format":"date-time"},"lastOpenedAt":{"type":"string","format":"date-time"},"opens":{"type":"integer","minimum":0},"linkClicks":{"type":"integer","minimum":0}},"required":["opens","linkClicks"],"additionalProperties":false},"cancel":{"type":"object","properties":{"by":{"type":"string","enum":["host","guest"]},"reason":{"type":"string","description":"Optional cancellation or reschedule reason (maximum 2000 characters)."},"at":{"type":"string","format":"date-time"}},"required":["by","at"],"additionalProperties":false},"approval":{"type":"object","properties":{"decidedAt":{"type":"string","format":"date-time"},"decidedBy":{"type":"string","pattern":"^[a-f\\d]{24}$"},"reason":{"type":"string","description":"Optional cancellation or reschedule reason (maximum 2000 characters)."}},"required":[],"additionalProperties":false},"rescheduleReason":{"type":"string"},"rescheduledFrom":{"type":"string","pattern":"^[a-f\\d]{24}$"},"rescheduledBy":{"type":"string","enum":["host","guest"]},"rescheduledTo":{"type":"string","pattern":"^[a-f\\d]{24}$"},"createdAt":{"type":"string","format":"date-time"},"googleSyncState":{"type":"string","enum":["pending","synced","error","deleted"]}},"required":["uid","status","start","end","duration","timeZone","eventTitle","hostName","location","guest","extraGuests","manageUrl","addToCalendar","id","eventTypeId","answers","utm","source","noShow","createdAt","googleSyncState"],"additionalProperties":false},{"type":"object","properties":{"uid":{"type":"string","description":"Booking identifier.","example":"bk_example"},"status":{"type":"string","enum":["pending","confirmed","declined","expired","canceled"],"description":"Booking status filter or current status."},"start":{"type":"string","format":"date-time","description":"Start instant in ISO 8601 UTC.","example":"2027-01-12T10:00:00Z"},"end":{"type":"string","format":"date-time","description":"End instant in ISO 8601 UTC; slots allow at most 31 days per call.","example":"2027-01-12T10:30:00Z"},"duration":{"type":"number","description":"Duration in minutes; slots default to the event default.","example":30},"timeZone":{"type":"string","maxLength":100,"description":"IANA time zone identifier.","example":"Europe/London"},"eventTitle":{"type":"string"},"hostName":{"type":"string"},"location":{"type":"object","properties":{"type":{"type":"string","enum":["google_meet","custom"]},"label":{"type":"string"},"joinUrl":{"type":"string","format":"uri"}},"required":["type","label"],"additionalProperties":false},"guest":{"type":"object","properties":{"name":{"type":"string","description":"Display name.","example":"Guest"},"email":{"type":"string","format":"email","maxLength":254,"description":"Email address.","example":"guest@example.com"}},"required":["name"],"additionalProperties":false,"description":"Guest contact details and time zone."},"embedGuestEmailAllowed":{"type":"boolean"},"extraGuests":{"type":"array","items":{"type":"string","format":"email"},"description":"Additional guest email addresses (maximum 10)."},"requestExpiresAt":{"type":"string","format":"date-time"},"withdrawnByGuest":{"type":"boolean"},"joinLinkUnavailable":{"type":"boolean"},"manageToken":{"type":"string","maxLength":200},"manageUrl":{"type":"string","format":"uri"},"addToCalendar":{"type":"object","properties":{"google":{"type":"string","format":"uri"},"outlook":{"type":"string","format":"uri"},"icsUrl":{"type":"string","format":"uri"}},"required":["google","outlook","icsUrl"],"additionalProperties":false}},"required":["uid","status","start","end","duration","timeZone","eventTitle","hostName","location","guest","extraGuests","manageUrl","addToCalendar"],"additionalProperties":false}]}},"required":["booking"],"additionalProperties":false}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"405":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"413":{"description":"The JSON body exceeds the configured size limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"422":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"description":"Read a booking; requires a secret key or a publishable key plus its manage token."}},"/bookings/{uid}/cancel":{"post":{"security":[{"bearerAuth":[]}],"parameters":[{"name":"uid","in":"path","required":true,"schema":{"type":"string"},"description":"Booking identifier.","example":"bk_example"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"startedAt":{"type":"string","format":"date-time","description":"When the guest form was first shown; wait at least 3 seconds before submitting."},"turnstileToken":{"type":"string","minLength":1,"maxLength":4096,"description":"Required for booking creation, cancellation and rescheduling with a publishable key; omit with a secret key."},"reason":{"type":"string","maxLength":2000,"description":"Optional cancellation or reschedule reason (maximum 2000 characters)."},"token":{"type":"string","minLength":1,"maxLength":200,"description":"Booking manage token; required with a publishable key for booking access or mutations.","example":"MANAGE_TOKEN"}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"booking":{"anyOf":[{"type":"object","properties":{"uid":{"type":"string","description":"Booking identifier.","example":"bk_example"},"status":{"type":"string","enum":["pending","confirmed","declined","expired","canceled"],"description":"Booking status filter or current status."},"start":{"type":"string","format":"date-time","description":"Start instant in ISO 8601 UTC.","example":"2027-01-12T10:00:00Z"},"end":{"type":"string","format":"date-time","description":"End instant in ISO 8601 UTC; slots allow at most 31 days per call.","example":"2027-01-12T10:30:00Z"},"duration":{"type":"number","description":"Duration in minutes; slots default to the event default.","example":30},"timeZone":{"type":"string","maxLength":100,"description":"IANA time zone identifier.","example":"Europe/London"},"eventTitle":{"type":"string"},"hostName":{"type":"string"},"location":{"type":"object","properties":{"type":{"type":"string","enum":["google_meet","custom"]},"label":{"type":"string"},"joinUrl":{"type":"string","format":"uri"}},"required":["type","label"],"additionalProperties":false},"guest":{"type":"object","properties":{"name":{"type":"string","description":"Display name.","example":"Guest"},"email":{"type":"string","format":"email","maxLength":254,"description":"Email address.","example":"guest@example.com"}},"required":["name","email"],"additionalProperties":false,"description":"Guest contact details and time zone."},"embedGuestEmailAllowed":{"type":"boolean"},"extraGuests":{"type":"array","items":{"type":"string","format":"email"},"description":"Additional guest email addresses (maximum 10)."},"requestExpiresAt":{"type":"string","format":"date-time"},"withdrawnByGuest":{"type":"boolean"},"joinLinkUnavailable":{"type":"boolean"},"manageToken":{"type":"string","maxLength":200},"manageUrl":{"type":"string","format":"uri"},"addToCalendar":{"type":"object","properties":{"google":{"type":"string","format":"uri"},"outlook":{"type":"string","format":"uri"},"icsUrl":{"type":"string","format":"uri"}},"required":["google","outlook","icsUrl"],"additionalProperties":false},"id":{"type":"string","pattern":"^[a-f\\d]{24}$"},"eventTypeId":{"type":"string","pattern":"^[a-f\\d]{24}$"},"answers":{"type":"array","items":{"type":"object","properties":{"questionId":{"type":"string"},"label":{"type":"string"},"value":{"anyOf":[{"type":"string","maxLength":5000},{"type":"array","items":{"type":"string","maxLength":1000},"maxItems":100},{"type":"boolean"}]}},"required":["questionId","label","value"],"additionalProperties":false},"description":"Answers keyed by event question ID."},"utm":{"type":"object","properties":{"source":{"type":"string","maxLength":500},"medium":{"type":"string","maxLength":500},"campaign":{"type":"string","maxLength":500},"term":{"type":"string","maxLength":500},"content":{"type":"string","maxLength":500},"ref":{"type":"string","maxLength":2000}},"required":[],"additionalProperties":false,"description":"Optional campaign attribution fields."},"source":{"type":"string","enum":["page","embed","api"]},"noShow":{"type":"boolean"},"emailActivity":{"type":"object","properties":{"confirmationOpenedAt":{"type":"string","format":"date-time"},"lastOpenedAt":{"type":"string","format":"date-time"},"opens":{"type":"integer","minimum":0},"linkClicks":{"type":"integer","minimum":0}},"required":["opens","linkClicks"],"additionalProperties":false},"cancel":{"type":"object","properties":{"by":{"type":"string","enum":["host","guest"]},"reason":{"type":"string","description":"Optional cancellation or reschedule reason (maximum 2000 characters)."},"at":{"type":"string","format":"date-time"}},"required":["by","at"],"additionalProperties":false},"approval":{"type":"object","properties":{"decidedAt":{"type":"string","format":"date-time"},"decidedBy":{"type":"string","pattern":"^[a-f\\d]{24}$"},"reason":{"type":"string","description":"Optional cancellation or reschedule reason (maximum 2000 characters)."}},"required":[],"additionalProperties":false},"rescheduleReason":{"type":"string"},"rescheduledFrom":{"type":"string","pattern":"^[a-f\\d]{24}$"},"rescheduledBy":{"type":"string","enum":["host","guest"]},"rescheduledTo":{"type":"string","pattern":"^[a-f\\d]{24}$"},"createdAt":{"type":"string","format":"date-time"},"googleSyncState":{"type":"string","enum":["pending","synced","error","deleted"]}},"required":["uid","status","start","end","duration","timeZone","eventTitle","hostName","location","guest","extraGuests","manageUrl","addToCalendar","id","eventTypeId","answers","utm","source","noShow","createdAt","googleSyncState"],"additionalProperties":false},{"type":"object","properties":{"uid":{"type":"string","description":"Booking identifier.","example":"bk_example"},"status":{"type":"string","enum":["pending","confirmed","declined","expired","canceled"],"description":"Booking status filter or current status."},"start":{"type":"string","format":"date-time","description":"Start instant in ISO 8601 UTC.","example":"2027-01-12T10:00:00Z"},"end":{"type":"string","format":"date-time","description":"End instant in ISO 8601 UTC; slots allow at most 31 days per call.","example":"2027-01-12T10:30:00Z"},"duration":{"type":"number","description":"Duration in minutes; slots default to the event default.","example":30},"timeZone":{"type":"string","maxLength":100,"description":"IANA time zone identifier.","example":"Europe/London"},"eventTitle":{"type":"string"},"hostName":{"type":"string"},"location":{"type":"object","properties":{"type":{"type":"string","enum":["google_meet","custom"]},"label":{"type":"string"},"joinUrl":{"type":"string","format":"uri"}},"required":["type","label"],"additionalProperties":false},"guest":{"type":"object","properties":{"name":{"type":"string","description":"Display name.","example":"Guest"},"email":{"type":"string","format":"email","maxLength":254,"description":"Email address.","example":"guest@example.com"}},"required":["name"],"additionalProperties":false,"description":"Guest contact details and time zone."},"embedGuestEmailAllowed":{"type":"boolean"},"extraGuests":{"type":"array","items":{"type":"string","format":"email"},"description":"Additional guest email addresses (maximum 10)."},"requestExpiresAt":{"type":"string","format":"date-time"},"withdrawnByGuest":{"type":"boolean"},"joinLinkUnavailable":{"type":"boolean"},"manageToken":{"type":"string","maxLength":200},"manageUrl":{"type":"string","format":"uri"},"addToCalendar":{"type":"object","properties":{"google":{"type":"string","format":"uri"},"outlook":{"type":"string","format":"uri"},"icsUrl":{"type":"string","format":"uri"}},"required":["google","outlook","icsUrl"],"additionalProperties":false}},"required":["uid","status","start","end","duration","timeZone","eventTitle","hostName","location","guest","extraGuests","manageUrl","addToCalendar"],"additionalProperties":false}]}},"required":["booking"],"additionalProperties":false}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"405":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"413":{"description":"The JSON body exceeds the configured size limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"422":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"description":"Cancel a booking; use a secret key or a publishable key with token in the body.","x-booking-status":"canceled"}},"/bookings/{uid}/reschedule":{"post":{"security":[{"bearerAuth":[]}],"parameters":[{"name":"uid","in":"path","required":true,"schema":{"type":"string"},"description":"Booking identifier.","example":"bk_example"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"startedAt":{"type":"string","format":"date-time","description":"When the guest form was first shown; wait at least 3 seconds before submitting."},"turnstileToken":{"type":"string","minLength":1,"maxLength":4096,"description":"Required for booking creation, cancellation and rescheduling with a publishable key; omit with a secret key."},"start":{"type":"string","format":"date-time","description":"Start instant in ISO 8601 UTC.","example":"2027-01-12T10:00:00Z"},"reason":{"type":"string","maxLength":2000,"description":"Optional cancellation or reschedule reason (maximum 2000 characters)."},"duration":{"type":"integer","minimum":5,"maximum":720,"description":"Duration in minutes; slots default to the event default.","example":30},"token":{"type":"string","minLength":1,"maxLength":200,"description":"Booking manage token; required with a publishable key for booking access or mutations.","example":"MANAGE_TOKEN"}},"required":["start","duration"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"booking":{"anyOf":[{"type":"object","properties":{"uid":{"type":"string","description":"Booking identifier.","example":"bk_example"},"status":{"type":"string","enum":["pending","confirmed","declined","expired","canceled"],"description":"Booking status filter or current status."},"start":{"type":"string","format":"date-time","description":"Start instant in ISO 8601 UTC.","example":"2027-01-12T10:00:00Z"},"end":{"type":"string","format":"date-time","description":"End instant in ISO 8601 UTC; slots allow at most 31 days per call.","example":"2027-01-12T10:30:00Z"},"duration":{"type":"number","description":"Duration in minutes; slots default to the event default.","example":30},"timeZone":{"type":"string","maxLength":100,"description":"IANA time zone identifier.","example":"Europe/London"},"eventTitle":{"type":"string"},"hostName":{"type":"string"},"location":{"type":"object","properties":{"type":{"type":"string","enum":["google_meet","custom"]},"label":{"type":"string"},"joinUrl":{"type":"string","format":"uri"}},"required":["type","label"],"additionalProperties":false},"guest":{"type":"object","properties":{"name":{"type":"string","description":"Display name.","example":"Guest"},"email":{"type":"string","format":"email","maxLength":254,"description":"Email address.","example":"guest@example.com"}},"required":["name","email"],"additionalProperties":false,"description":"Guest contact details and time zone."},"embedGuestEmailAllowed":{"type":"boolean"},"extraGuests":{"type":"array","items":{"type":"string","format":"email"},"description":"Additional guest email addresses (maximum 10)."},"requestExpiresAt":{"type":"string","format":"date-time"},"withdrawnByGuest":{"type":"boolean"},"joinLinkUnavailable":{"type":"boolean"},"manageToken":{"type":"string","maxLength":200},"manageUrl":{"type":"string","format":"uri"},"addToCalendar":{"type":"object","properties":{"google":{"type":"string","format":"uri"},"outlook":{"type":"string","format":"uri"},"icsUrl":{"type":"string","format":"uri"}},"required":["google","outlook","icsUrl"],"additionalProperties":false},"id":{"type":"string","pattern":"^[a-f\\d]{24}$"},"eventTypeId":{"type":"string","pattern":"^[a-f\\d]{24}$"},"answers":{"type":"array","items":{"type":"object","properties":{"questionId":{"type":"string"},"label":{"type":"string"},"value":{"anyOf":[{"type":"string","maxLength":5000},{"type":"array","items":{"type":"string","maxLength":1000},"maxItems":100},{"type":"boolean"}]}},"required":["questionId","label","value"],"additionalProperties":false},"description":"Answers keyed by event question ID."},"utm":{"type":"object","properties":{"source":{"type":"string","maxLength":500},"medium":{"type":"string","maxLength":500},"campaign":{"type":"string","maxLength":500},"term":{"type":"string","maxLength":500},"content":{"type":"string","maxLength":500},"ref":{"type":"string","maxLength":2000}},"required":[],"additionalProperties":false,"description":"Optional campaign attribution fields."},"source":{"type":"string","enum":["page","embed","api"]},"noShow":{"type":"boolean"},"emailActivity":{"type":"object","properties":{"confirmationOpenedAt":{"type":"string","format":"date-time"},"lastOpenedAt":{"type":"string","format":"date-time"},"opens":{"type":"integer","minimum":0},"linkClicks":{"type":"integer","minimum":0}},"required":["opens","linkClicks"],"additionalProperties":false},"cancel":{"type":"object","properties":{"by":{"type":"string","enum":["host","guest"]},"reason":{"type":"string","description":"Optional cancellation or reschedule reason (maximum 2000 characters)."},"at":{"type":"string","format":"date-time"}},"required":["by","at"],"additionalProperties":false},"approval":{"type":"object","properties":{"decidedAt":{"type":"string","format":"date-time"},"decidedBy":{"type":"string","pattern":"^[a-f\\d]{24}$"},"reason":{"type":"string","description":"Optional cancellation or reschedule reason (maximum 2000 characters)."}},"required":[],"additionalProperties":false},"rescheduleReason":{"type":"string"},"rescheduledFrom":{"type":"string","pattern":"^[a-f\\d]{24}$"},"rescheduledBy":{"type":"string","enum":["host","guest"]},"rescheduledTo":{"type":"string","pattern":"^[a-f\\d]{24}$"},"createdAt":{"type":"string","format":"date-time"},"googleSyncState":{"type":"string","enum":["pending","synced","error","deleted"]}},"required":["uid","status","start","end","duration","timeZone","eventTitle","hostName","location","guest","extraGuests","manageUrl","addToCalendar","id","eventTypeId","answers","utm","source","noShow","createdAt","googleSyncState"],"additionalProperties":false},{"type":"object","properties":{"uid":{"type":"string","description":"Booking identifier.","example":"bk_example"},"status":{"type":"string","enum":["pending","confirmed","declined","expired","canceled"],"description":"Booking status filter or current status."},"start":{"type":"string","format":"date-time","description":"Start instant in ISO 8601 UTC.","example":"2027-01-12T10:00:00Z"},"end":{"type":"string","format":"date-time","description":"End instant in ISO 8601 UTC; slots allow at most 31 days per call.","example":"2027-01-12T10:30:00Z"},"duration":{"type":"number","description":"Duration in minutes; slots default to the event default.","example":30},"timeZone":{"type":"string","maxLength":100,"description":"IANA time zone identifier.","example":"Europe/London"},"eventTitle":{"type":"string"},"hostName":{"type":"string"},"location":{"type":"object","properties":{"type":{"type":"string","enum":["google_meet","custom"]},"label":{"type":"string"},"joinUrl":{"type":"string","format":"uri"}},"required":["type","label"],"additionalProperties":false},"guest":{"type":"object","properties":{"name":{"type":"string","description":"Display name.","example":"Guest"},"email":{"type":"string","format":"email","maxLength":254,"description":"Email address.","example":"guest@example.com"}},"required":["name"],"additionalProperties":false,"description":"Guest contact details and time zone."},"embedGuestEmailAllowed":{"type":"boolean"},"extraGuests":{"type":"array","items":{"type":"string","format":"email"},"description":"Additional guest email addresses (maximum 10)."},"requestExpiresAt":{"type":"string","format":"date-time"},"withdrawnByGuest":{"type":"boolean"},"joinLinkUnavailable":{"type":"boolean"},"manageToken":{"type":"string","maxLength":200},"manageUrl":{"type":"string","format":"uri"},"addToCalendar":{"type":"object","properties":{"google":{"type":"string","format":"uri"},"outlook":{"type":"string","format":"uri"},"icsUrl":{"type":"string","format":"uri"}},"required":["google","outlook","icsUrl"],"additionalProperties":false}},"required":["uid","status","start","end","duration","timeZone","eventTitle","hostName","location","guest","extraGuests","manageUrl","addToCalendar"],"additionalProperties":false}]}},"required":["booking"],"additionalProperties":false}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"405":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"413":{"description":"The JSON body exceeds the configured size limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"422":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"description":"Reschedule a booking; use a secret key or a publishable key with token in the body."}},"/bookings/{uid}/ics":{"get":{"security":[{"bearerAuth":[]}],"parameters":[{"name":"uid","in":"path","required":true,"schema":{"type":"string"},"description":"Booking identifier.","example":"bk_example"}],"responses":{"200":{"description":"ICS calendar file","content":{"text/calendar":{"schema":{"type":"string"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"405":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"413":{"description":"The JSON body exceeds the configured size limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"422":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"description":"Download the calendar file for a confirmed or canceled booking using a secret key."}},"/api/public/bookings/{uid}":{"get":{"servers":[{"url":"/"}],"security":[],"parameters":[{"name":"uid","in":"path","required":true,"schema":{"type":"string"},"description":"Booking identifier.","example":"bk_example"},{"name":"token","in":"query","required":true,"schema":{"type":"string"},"description":"Booking manage token; required with a publishable key for booking access or mutations.","example":"MANAGE_TOKEN"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"booking":{"type":"object","properties":{"uid":{"type":"string","description":"Booking identifier.","example":"bk_example"},"status":{"type":"string","enum":["pending","confirmed","declined","expired","canceled"],"description":"Booking status filter or current status."},"start":{"type":"string","format":"date-time","description":"Start instant in ISO 8601 UTC.","example":"2027-01-12T10:00:00Z"},"end":{"type":"string","format":"date-time","description":"End instant in ISO 8601 UTC; slots allow at most 31 days per call.","example":"2027-01-12T10:30:00Z"},"duration":{"type":"number","description":"Duration in minutes; slots default to the event default.","example":30},"timeZone":{"type":"string","maxLength":100,"description":"IANA time zone identifier.","example":"Europe/London"},"eventTitle":{"type":"string"},"hostName":{"type":"string"},"location":{"type":"object","properties":{"type":{"type":"string","enum":["google_meet","custom"]},"label":{"type":"string"},"joinUrl":{"type":"string","format":"uri"}},"required":["type","label"],"additionalProperties":false},"guest":{"type":"object","properties":{"name":{"type":"string","description":"Display name.","example":"Guest"},"email":{"type":"string","format":"email","maxLength":254,"description":"Email address.","example":"guest@example.com"}},"required":["name"],"additionalProperties":false,"description":"Guest contact details and time zone."},"embedGuestEmailAllowed":{"type":"boolean"},"extraGuests":{"type":"array","items":{"type":"string","format":"email"},"description":"Additional guest email addresses (maximum 10)."},"requestExpiresAt":{"type":"string","format":"date-time"},"withdrawnByGuest":{"type":"boolean"},"joinLinkUnavailable":{"type":"boolean"},"manageToken":{"type":"string","maxLength":200},"manageUrl":{"type":"string","format":"uri"},"addToCalendar":{"type":"object","properties":{"google":{"type":"string","format":"uri"},"outlook":{"type":"string","format":"uri"},"icsUrl":{"type":"string","format":"uri"}},"required":["google","outlook","icsUrl"],"additionalProperties":false}},"required":["uid","status","start","end","duration","timeZone","eventTitle","hostName","location","guest","extraGuests","manageUrl","addToCalendar"],"additionalProperties":false},"oneOffToken":{"type":"string"},"scopedSlots":{"type":"boolean"},"rescheduled":{"type":"boolean"},"replacementUrl":{"type":"string"},"declineReason":{"type":"string"},"host":{"type":"object","properties":{"eventsHidden":{"const":true},"timeZone":{"type":"string","maxLength":100,"description":"IANA time zone identifier.","example":"Europe/London"},"vacationTimeZone":{"type":"string","maxLength":100},"publicEmail":{"type":"string"},"name":{"type":"string","description":"Display name.","example":"Guest"},"username":{"type":"string","minLength":1,"maxLength":60,"pattern":"^[a-z0-9-]+$"},"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"bio":{"type":"string"},"look":{"type":"object","properties":{"preset":{"type":"string","enum":["classic","focus","split","calendar","compact","bold"]},"accentColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"appearance":{"type":"string","enum":["light","dark","auto"]},"fontPair":{"type":"string","enum":["instrument","serif-pair","grotesk-pair"]},"radius":{"type":"string","enum":["square","soft","round"]},"slotStyle":{"type":"string","enum":["list","grid"]},"showAvatar":{"type":"boolean"},"showDescription":{"type":"boolean"},"showTimeZoneSwitcher":{"type":"boolean"},"coverImageUrl":{"anyOf":[{"anyOf":[{"type":"string","format":"uri","maxLength":2048},{"type":"string","pattern":"^\\/api\\/public\\/files\\/[a-f0-9]{24}$"}]},{"type":"null"}]},"coverVersion":{"type":"string","pattern":"^[a-f0-9]{24}$"},"coverImageAlt":{"type":"string","maxLength":200},"coverFocal":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false},"version":{"const":1},"radiusPx":{"type":"number"},"theme":{"type":"object","properties":{"tokens":{"type":"object","properties":{"version":{"const":1},"palette":{"type":"object","properties":{"light":{"type":"object","properties":{"bg":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surface":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surfaceAlt":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"text":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"textMuted":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"border":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"accent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"onAccent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"focus":{"type":"string","pattern":"^#[a-f0-9]{6}$"}},"required":["bg","surface","surfaceAlt","text","textMuted","border","accent","onAccent","focus"],"additionalProperties":false},"dark":{"type":"object","properties":{"bg":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surface":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surfaceAlt":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"text":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"textMuted":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"border":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"accent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"onAccent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"focus":{"type":"string","pattern":"^#[a-f0-9]{6}$"}},"required":["bg","surface","surfaceAlt","text","textMuted","border","accent","onAccent","focus"],"additionalProperties":false}},"required":["light","dark"],"additionalProperties":false},"typography":{"type":"object","properties":{"heading":{"type":"string","enum":["instrument-sans","dm-sans","manrope","outfit","space-grotesk","archivo","syne","nunito","fraunces","playfair-display","libre-baskerville","ibm-plex-serif","jetbrains-mono","dm-mono"]},"body":{"type":"string","enum":["instrument-sans","dm-sans","manrope","outfit","space-grotesk","archivo","syne","nunito","fraunces","playfair-display","libre-baskerville","ibm-plex-serif","jetbrains-mono","dm-mono"]},"scale":{"type":"number","minimum":0.9,"maximum":1.2},"headingWeight":{"type":"number","minimum":400,"maximum":800},"headingCase":{"type":"string","enum":["none","upper"]},"letterSpacing":{"type":"string","enum":["tight","normal","wide"]}},"required":["heading","body","scale","headingWeight","headingCase","letterSpacing"],"additionalProperties":false},"shape":{"type":"object","properties":{"radius":{"type":"number","minimum":0,"maximum":28},"borderWidth":{"type":"number","minimum":0,"maximum":2},"shadow":{"type":"string","enum":["none","soft","lifted","hard"]}},"required":["radius","borderWidth","shadow"],"additionalProperties":false},"layout":{"type":"object","properties":{"base":{"type":"string","enum":["classic","focus","split","calendar","compact","bold"]},"sidebar":{"type":"string","enum":["left","right","top"]},"density":{"type":"string","enum":["comfy","compact"]},"slotStyle":{"type":"string","enum":["list","grid","pill"]},"calendarStyle":{"type":"string","enum":["grid","week-strip"]}},"required":["base","sidebar","density","slotStyle","calendarStyle"],"additionalProperties":false},"background":{"anyOf":[{"type":"object","properties":{"kind":{"const":"solid"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"gradient"},"angle":{"type":"number","minimum":0,"maximum":360},"stops":{"type":"array","items":{"type":"object","properties":{"color":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"position":{"type":"number","minimum":0,"maximum":100}},"required":["color","position"],"additionalProperties":false},"minItems":2,"maxItems":3}},"required":["kind","angle","stops"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"pattern"},"pattern":{"type":"string","enum":["dots","grid","waves","noise","diagonal"]},"color":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"opacity":{"type":"number","minimum":0,"maximum":0.25}},"required":["kind","pattern","color","opacity"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"mesh"},"blobs":{"type":"array","items":{"type":"object","properties":{"color":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"x":{"type":"number","minimum":0,"maximum":100},"y":{"type":"number","minimum":0,"maximum":100},"size":{"type":"number","minimum":15,"maximum":100}},"required":["color","x","y","size"],"additionalProperties":false},"minItems":3,"maxItems":4}},"required":["kind","blobs"],"additionalProperties":false}]},"components":{"type":"object","properties":{"button":{"type":"string","enum":["solid","outline","soft","pill","brutal"]},"card":{"type":"string","enum":["flat","bordered","elevated","glass"]},"header":{"type":"string","enum":["plain","band","cover"]}},"required":["button","card","header"],"additionalProperties":false},"motion":{"type":"string","enum":["none","subtle"]},"mode":{"type":"string","enum":["light","dark","auto"]}},"required":["version","palette","typography","shape","layout","background","components","motion","mode"],"additionalProperties":false},"variables":{"type":"object","properties":{"light":{"type":"object","additionalProperties":{"type":"string"}},"dark":{"type":"object","additionalProperties":{"type":"string"}}},"required":["light","dark"],"additionalProperties":false}},"required":["tokens","variables"],"additionalProperties":false},"tokens":{"type":"object","properties":{"light":{"type":"object","properties":{"fill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"onFill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"text":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"ring":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"adjusted":{"type":"boolean"}},"required":["fill","onFill","text","ring","adjusted"],"additionalProperties":false},"dark":{"type":"object","properties":{"fill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"onFill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"text":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"ring":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"adjusted":{"type":"boolean"}},"required":["fill","onFill","text","ring","adjusted"],"additionalProperties":false}},"required":["light","dark"],"additionalProperties":false}},"required":["preset","accentColor","appearance","fontPair","slotStyle","showAvatar","showDescription","showTimeZoneSwitcher","coverImageUrl","coverImageAlt","coverFocal","version","radiusPx","tokens"],"additionalProperties":false},"branding":{"type":"object","properties":{"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"accentColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"hidePoweredBy":{"type":"boolean"}},"required":["logoUrl","accentColor","hidePoweredBy"],"additionalProperties":false},"timeFormat":{"type":"string","enum":["12h","24h"]},"vacation":{"anyOf":[{"type":"object","properties":{"from":{"type":"string","description":"Inclusive start filter, ISO 8601 UTC.","example":"2027-01-01T00:00:00Z"},"until":{"type":"string"}},"required":[],"additionalProperties":false},{"type":"null"}]},"vacationMessage":{"type":"string"}},"required":["name","username","avatarUrl","bio","branding","timeFormat"],"additionalProperties":false},"eventType":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-f\\d]{24}$"},"slug":{"type":"string","minLength":1,"maxLength":60,"pattern":"^[a-z0-9-]+$","description":"Event type slug.","example":"intro-call"},"title":{"type":"string"},"description":{"type":"string"},"descriptionHtml":{"type":"string"},"look":{"type":"object","properties":{"preset":{"type":"string","enum":["classic","focus","split","calendar","compact","bold"]},"accentColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"appearance":{"type":"string","enum":["light","dark","auto"]},"fontPair":{"type":"string","enum":["instrument","serif-pair","grotesk-pair"]},"radius":{"type":"string","enum":["square","soft","round"]},"slotStyle":{"type":"string","enum":["list","grid"]},"showAvatar":{"type":"boolean"},"showDescription":{"type":"boolean"},"showTimeZoneSwitcher":{"type":"boolean"},"coverImageUrl":{"anyOf":[{"anyOf":[{"type":"string","format":"uri","maxLength":2048},{"type":"string","pattern":"^\\/api\\/public\\/files\\/[a-f0-9]{24}$"}]},{"type":"null"}]},"coverVersion":{"type":"string","pattern":"^[a-f0-9]{24}$"},"coverImageAlt":{"type":"string","maxLength":200},"coverFocal":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false},"version":{"const":1},"radiusPx":{"type":"number"},"theme":{"type":"object","properties":{"tokens":{"type":"object","properties":{"version":{"const":1},"palette":{"type":"object","properties":{"light":{"type":"object","properties":{"bg":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surface":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surfaceAlt":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"text":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"textMuted":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"border":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"accent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"onAccent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"focus":{"type":"string","pattern":"^#[a-f0-9]{6}$"}},"required":["bg","surface","surfaceAlt","text","textMuted","border","accent","onAccent","focus"],"additionalProperties":false},"dark":{"type":"object","properties":{"bg":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surface":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"surfaceAlt":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"text":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"textMuted":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"border":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"accent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"onAccent":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"focus":{"type":"string","pattern":"^#[a-f0-9]{6}$"}},"required":["bg","surface","surfaceAlt","text","textMuted","border","accent","onAccent","focus"],"additionalProperties":false}},"required":["light","dark"],"additionalProperties":false},"typography":{"type":"object","properties":{"heading":{"type":"string","enum":["instrument-sans","dm-sans","manrope","outfit","space-grotesk","archivo","syne","nunito","fraunces","playfair-display","libre-baskerville","ibm-plex-serif","jetbrains-mono","dm-mono"]},"body":{"type":"string","enum":["instrument-sans","dm-sans","manrope","outfit","space-grotesk","archivo","syne","nunito","fraunces","playfair-display","libre-baskerville","ibm-plex-serif","jetbrains-mono","dm-mono"]},"scale":{"type":"number","minimum":0.9,"maximum":1.2},"headingWeight":{"type":"number","minimum":400,"maximum":800},"headingCase":{"type":"string","enum":["none","upper"]},"letterSpacing":{"type":"string","enum":["tight","normal","wide"]}},"required":["heading","body","scale","headingWeight","headingCase","letterSpacing"],"additionalProperties":false},"shape":{"type":"object","properties":{"radius":{"type":"number","minimum":0,"maximum":28},"borderWidth":{"type":"number","minimum":0,"maximum":2},"shadow":{"type":"string","enum":["none","soft","lifted","hard"]}},"required":["radius","borderWidth","shadow"],"additionalProperties":false},"layout":{"type":"object","properties":{"base":{"type":"string","enum":["classic","focus","split","calendar","compact","bold"]},"sidebar":{"type":"string","enum":["left","right","top"]},"density":{"type":"string","enum":["comfy","compact"]},"slotStyle":{"type":"string","enum":["list","grid","pill"]},"calendarStyle":{"type":"string","enum":["grid","week-strip"]}},"required":["base","sidebar","density","slotStyle","calendarStyle"],"additionalProperties":false},"background":{"anyOf":[{"type":"object","properties":{"kind":{"const":"solid"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"gradient"},"angle":{"type":"number","minimum":0,"maximum":360},"stops":{"type":"array","items":{"type":"object","properties":{"color":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"position":{"type":"number","minimum":0,"maximum":100}},"required":["color","position"],"additionalProperties":false},"minItems":2,"maxItems":3}},"required":["kind","angle","stops"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"pattern"},"pattern":{"type":"string","enum":["dots","grid","waves","noise","diagonal"]},"color":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"opacity":{"type":"number","minimum":0,"maximum":0.25}},"required":["kind","pattern","color","opacity"],"additionalProperties":false},{"type":"object","properties":{"kind":{"const":"mesh"},"blobs":{"type":"array","items":{"type":"object","properties":{"color":{"type":"string","pattern":"^#[a-f0-9]{6}$"},"x":{"type":"number","minimum":0,"maximum":100},"y":{"type":"number","minimum":0,"maximum":100},"size":{"type":"number","minimum":15,"maximum":100}},"required":["color","x","y","size"],"additionalProperties":false},"minItems":3,"maxItems":4}},"required":["kind","blobs"],"additionalProperties":false}]},"components":{"type":"object","properties":{"button":{"type":"string","enum":["solid","outline","soft","pill","brutal"]},"card":{"type":"string","enum":["flat","bordered","elevated","glass"]},"header":{"type":"string","enum":["plain","band","cover"]}},"required":["button","card","header"],"additionalProperties":false},"motion":{"type":"string","enum":["none","subtle"]},"mode":{"type":"string","enum":["light","dark","auto"]}},"required":["version","palette","typography","shape","layout","background","components","motion","mode"],"additionalProperties":false},"variables":{"type":"object","properties":{"light":{"type":"object","additionalProperties":{"type":"string"}},"dark":{"type":"object","additionalProperties":{"type":"string"}}},"required":["light","dark"],"additionalProperties":false}},"required":["tokens","variables"],"additionalProperties":false},"tokens":{"type":"object","properties":{"light":{"type":"object","properties":{"fill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"onFill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"text":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"ring":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"adjusted":{"type":"boolean"}},"required":["fill","onFill","text","ring","adjusted"],"additionalProperties":false},"dark":{"type":"object","properties":{"fill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"onFill":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"text":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"ring":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"adjusted":{"type":"boolean"}},"required":["fill","onFill","text","ring","adjusted"],"additionalProperties":false}},"required":["light","dark"],"additionalProperties":false}},"required":["preset","accentColor","appearance","fontPair","slotStyle","showAvatar","showDescription","showTimeZoneSwitcher","coverImageUrl","coverImageAlt","coverFocal","version","radiusPx","tokens"],"additionalProperties":false},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"durations":{"type":"array","items":{"type":"number"}},"defaultDuration":{"type":"number"},"location":{"type":"object","properties":{"type":{"type":"string","enum":["google_meet","custom"]},"label":{"type":"string"}},"required":["type","label"],"additionalProperties":false},"questions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,60}$"},"label":{"type":"string","minLength":1,"maxLength":1000},"type":{"type":"string","enum":["short_text","long_text","single_choice","multiple_choice","dropdown","phone","checkbox"]},"required":{"type":"boolean"},"options":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":100}},"required":["id","label","type","required","options"],"additionalProperties":false}},"allowGuests":{"type":"boolean"},"maxGuests":{"type":"number"},"businessEmailOnly":{"type":"boolean"},"requiresConfirmation":{"type":"boolean"},"bookingWindowEnd":{"type":"string"},"redirectUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"passDetailsToRedirect":{"type":"boolean"}},"required":["id","slug","title","description","descriptionHtml","color","durations","defaultDuration","location","questions","allowGuests","maxGuests","requiresConfirmation","redirectUrl","passDetailsToRedirect"],"additionalProperties":false,"description":"Event type slug owned by the API key host.","example":"intro-call"},"canCancel":{"type":"boolean"},"canReschedule":{"type":"boolean"},"rescheduleUnavailable":{"type":"string"},"cancelUnavailable":{"type":"string"},"cancelDeadline":{"type":"string","format":"date-time"}},"required":["booking","host","eventType","canCancel","canReschedule"],"additionalProperties":false}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"405":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"413":{"description":"The JSON body exceeds the configured size limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"422":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"description":"Read a booking using its manage token (no API key). Returns oneOffToken only for a booking made through a one-off link, so the guest can load that link when rescheduling."}}}}