{"openapi":"3.1.0","info":{"title":"WebinarStack API","version":"1.0.0","description":"# WebinarStack API\n\nAutomate attendee registration, query webinar data, and subscribe to behavior-driven webhook events — all from your own systems.\n\n## Authentication\n\nAll API requests must include your API key in the `Authorization` header:\n\n```http\nAuthorization: Bearer wsk_live_XXXXXXXXXXXX\n```\n\nAPI keys are scoped to your account. Generate and revoke keys from **Settings → API Keys** in your dashboard.\n\nA missing or invalid key returns `401 Unauthorized`. A key that has been revoked returns `401 Unauthorized`.\n\n## Rate Limiting\n\nRequests are rate-limited per API key. When a limit is exceeded, the API returns `429 Too Many Requests` with a `Retry-After` header indicating when you may retry.\n\nResponse headers on every request:\n\n| Header | Description |\n|--------|-------------|\n| `X-RateLimit-Limit` | Maximum requests allowed in the window |\n| `X-RateLimit-Remaining` | Requests remaining in the current window |\n| `X-RateLimit-Reset` | Unix timestamp when the window resets |\n\n## Response Format\n\nEvery response with a body is an envelope. The resource is never at the top level — read it from `data`. DELETE endpoints return `204 No Content` with no body, so do not parse JSON from them.\n\nA success response carries `data` and `meta`:\n\n```json\n{\n  \"data\": { \"id\": \"...\", \"name\": \"...\" },\n  \"meta\": {}\n}\n```\n\n`meta` is always present on success. Cursor-paginated list endpoints put `{ \"nextCursor\": \"...\", \"hasMore\": true }` in it, and some endpoints add their own keys (the sessions list adds `timezone` and `timezoneMode`). Unpaginated lists and single-resource responses return `{}`.\n\nAn error response carries `error` instead, and no `data`. This is what `POST /webinars/{id}/registrations` returns for a `sessionTime` like \"tomorrow\":\n\n```json\n{\n  \"error\": {\n    \"code\": \"VALIDATION_ERROR\",\n    \"message\": \"Invalid ISO datetime\",\n    \"details\": [{ \"field\": \"sessionTime\", \"message\": \"Invalid ISO datetime\", \"code\": \"VALIDATION_ERROR\", \"recoveryHint\": \"Update the highlighted field and retry.\" }]\n  }\n}\n```\n\n`details` is present only on errors that carry field-level information. Check the HTTP status, or the presence of `error`, before reading `data`.\n\n## Quickstart\n\n### Step 1: Get your API key\n\nNavigate to **Settings → API Keys** in your WebinarStack dashboard and generate a new API key. Copy the key immediately — it is only shown once.\n\n### Step 2: List your webinars\n\nFetch all published webinars to find the webinar ID you need.\n\n**curl:**\n```bash\ncurl https://webinarstack.co/api/v1/webinars \\\n  -H \"Authorization: Bearer wsk_live_XXXXXXXXXXXX\"\n```\n\n**TypeScript:**\n```typescript\nconst response = await fetch('https://webinarstack.co/api/v1/webinars', {\n  headers: { 'Authorization': 'Bearer wsk_live_XXXXXXXXXXXX' },\n})\nconst body = await response.json()\nif (!response.ok) throw new Error(`${body.error.code}: ${body.error.message}`)\nconst { data, meta } = body\n// data — array of webinars\n// meta — { nextCursor, hasMore }: pass nextCursor as ?cursor= for the next page\n```\n\n### Step 3: Register an attendee\n\nRegister an attendee for a specific session using the webinar ID from Step 2.\n\n**curl:**\n```bash\ncurl -X POST https://webinarstack.co/api/v1/webinars/{webinarId}/registrations \\\n  -H \"Authorization: Bearer wsk_live_XXXXXXXXXXXX\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"name\": \"Jane Smith\",\n    \"email\": \"jane@example.com\",\n    \"sessionTime\": \"2026-05-01T18:00:00.000Z\"\n  }'\n```\n\n**TypeScript:**\n```typescript\nconst response = await fetch(`https://webinarstack.co/api/v1/webinars/${webinarId}/registrations`, {\n  method: 'POST',\n  headers: {\n    'Authorization': 'Bearer wsk_live_XXXXXXXXXXXX',\n    'Content-Type': 'application/json',\n  },\n  body: JSON.stringify({\n    name: 'Jane Smith',\n    email: 'jane@example.com',\n    sessionTime: '2026-05-01T18:00:00.000Z',\n  }),\n})\nconst body = await response.json()\nif (!response.ok) throw new Error(`${body.error.code}: ${body.error.message}`)\n// 201 Created. The registration is nested under \"data\", not at the top level.\nconst { id, email, name, sessionStartsAt, accessUrl } = body.data\n```\n\nThe response includes a unique `accessUrl` — send this to your attendee so they can join the webinar.\n\n### Step 4: Create a webhook subscription\n\nSubscribe to attendee events so your system is notified when actions occur during the webinar.\n\n**curl:**\n```bash\ncurl -X POST https://webinarstack.co/api/v1/webinars/{webinarId}/webhooks \\\n  -H \"Authorization: Bearer wsk_live_XXXXXXXXXXXX\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"url\": \"https://your-server.com/webhooks/webinar\",\n    \"eventTypes\": [\"registered\", \"joined\", \"video_complete\"]\n  }'\n```\n\n**TypeScript:**\n```typescript\nconst response = await fetch(`https://webinarstack.co/api/v1/webinars/${webinarId}/webhooks`, {\n  method: 'POST',\n  headers: {\n    'Authorization': 'Bearer wsk_live_XXXXXXXXXXXX',\n    'Content-Type': 'application/json',\n  },\n  body: JSON.stringify({\n    url: 'https://your-server.com/webhooks/webinar',\n    eventTypes: ['registered', 'joined', 'video_complete'],\n  }),\n})\nconst body = await response.json()\nif (!response.ok) throw new Error(`${body.error.code}: ${body.error.message}`)\n// 201 Created. The subscription is nested under \"data\", not at the top level.\nconst { id, secret } = body.data\n// Store \"secret\" securely — it is only returned once\n```\n\nStore the `secret` from the response securely. It is used to verify webhook authenticity.\n\n### Step 5: Verify webhook delivery\n\nWhen your endpoint receives a webhook, verify the `X-WebinarStack-Signature` header to confirm the payload originated from WebinarStack.\n\nTwo details decide whether verification works at all:\n\n- **The header value is prefixed.** It is `sha256=<hex>`, not a bare digest. Split on `=` and compare only the hex half, or every comparison fails.\n- **Sign the raw body, not a re-serialized one.** The signature is computed over the exact bytes we send. `JSON.stringify(req.body)` re-serializes a parsed object and is not guaranteed to reproduce them, so capture the raw body before any JSON body parser runs.\n\n**Delivered payload:**\n\n```json\n{\n  \"event_type\": \"registered\",\n  \"attendee\": {\n    \"name\": \"Jane Doe\",\n    \"email\": \"jane@example.com\",\n    \"registration_id\": \"a1b2c3d4-...\",\n    \"utm_source\": null,\n    \"utm_medium\": null,\n    \"utm_campaign\": null\n  },\n  \"webinar\": { \"id\": \"f5e6d7c8-...\", \"title\": \"Launch Masterclass\" },\n  \"event_data\": {},\n  \"timestamp\": \"2026-01-15T14:32:10.000Z\"\n}\n```\n\n`event_type` is the subscribed event — one of `registered`, `joined`, `left`, `no_show`, `video_complete`, `cta_click`. The webinar is nested under `webinar`, so its identifier is `webinar.id`. `event_data` carries the fields specific to that event type and is `{}` when the event has none. A re-fired delivery also carries `is_refire: true`.\n\n**TypeScript:**\n```typescript\nimport crypto from 'crypto'\nimport express from 'express'\n\nconst app = express()\n\nfunction verifyWebhook(rawBody: string, headerValue: string | undefined, secret: string): boolean {\n  if (!headerValue) return false\n  const [scheme, provided] = headerValue.split('=', 2)\n  if (scheme !== 'sha256' || !provided) return false\n\n  const expected = crypto.createHmac('sha256', secret).update(rawBody).digest('hex')\n  const a = Buffer.from(expected, 'hex')\n  const b = Buffer.from(provided, 'hex')\n  // Length check first: timingSafeEqual throws when the buffers differ in length.\n  if (a.length !== b.length) return false\n  return crypto.timingSafeEqual(a, b)\n}\n\n// express.raw() keeps the body as bytes so the signature can be checked against\n// what we actually sent. Mount it on this route only.\napp.post('/webhooks/webinar', express.raw({ type: 'application/json' }), (req, res) => {\n  const rawBody = (req.body as Buffer).toString('utf8')\n  const signature = req.headers['x-webinarstack-signature'] as string | undefined\n  if (!verifyWebhook(rawBody, signature, process.env.WEBHOOK_SECRET!)) {\n    return res.status(401).send('Invalid signature')\n  }\n\n  const { event_type, attendee, webinar, event_data } = JSON.parse(rawBody)\n  // Handle the event...\n  res.status(200).send('OK')\n})\n```\n\nReturn a 2xx promptly — deliveries time out after 10 seconds. A non-2xx response is treated as a failed delivery and retried with exponential backoff, up to three retries.\n\nDeliveries are at-least-once: an attempt that times out or gets a non-2xx response is retried, and a manual re-fire resends the event with `is_refire: true`. No delivery-ID header is sent, and `timestamp` is set when each delivery attempt is built, not when the attendee acted, so a retried delivery has a different body and signature. Make your handler idempotent and dedupe on stable fields such as `event_type` + `attendee.registration_id` + `webinar.id`.\n\nYour integration is complete. The WebinarStack API will deliver webhook events to your endpoint whenever attendees trigger configured automation rules."},"servers":[{"url":"/api/v1","description":"WebinarStack API v1"}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Pass your API key as a Bearer token. Generate keys from Settings → API Keys."}},"schemas":{"ListWebhookDeliveriesQuery":{"type":"object","description":"Query parameters for listing webhook deliveries (cursor-paginated).","properties":{"cursor":{"type":"string","description":"Opaque cursor from previous page nextCursor."},"limit":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Page size (1-100, default 50)."}}},"ListAutomationsQuery":{"type":"object","description":"Query parameters for listing automation rules (cursor-paginated).","properties":{"cursor":{"type":"string","description":"Opaque cursor from previous page nextCursor."},"limit":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Page size (1-100, default 50)."},"enabled":{"type":"boolean","description":"Filter by enabled state."},"triggerType":{"type":"string","description":"Filter by trigger type."},"actionType":{"type":"string","enum":["email","webhook","integration","meta_capi"],"description":"Filter by action type."},"includeSubscriptionRules":{"type":"boolean","default":false,"description":"Include subscription-rule rows (D-17 — excluded by default)."}}},"ListAutomationExecutionsQuery":{"type":"object","description":"Query parameters for listing automation executions (cursor-paginated by executedAt DESC).","properties":{"cursor":{"type":"string","description":"Opaque cursor from previous page nextCursor."},"limit":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Page size (1-100, default 50)."},"status":{"type":"string","enum":["dispatched","success","failure","retried"],"description":"Filter by execution status."}}},"WebhookActionConfig":{"type":"object","description":"Action configuration for webhook automation rules (create request shape). webhookSecret is auto-generated if omitted on create and is returned exactly once, in the create response — it is never returned on read.","required":["webhookUrl"],"properties":{"webhookUrl":{"type":"string","format":"uri","description":"HTTPS endpoint URL."},"webhookSecret":{"type":"string","minLength":32,"description":"HMAC signing secret. This schema describes the CREATE request/response side only: auto-generated if omitted on create, returned once in the create response, and never returned by any read (GET returns secretLast4 instead — see the Automation schema)."}}},"EmailBody":{"anyOf":[{"type":"string","minLength":1,"maxLength":10000},{"type":"object","properties":{"type":{"type":"string","enum":["doc"]},"content":{"type":"array","items":{}}},"required":["type","content"]}],"description":"Body of an automation email. Two valid shapes: (1) plain-text string up to 10000 characters (personalization tokens substitute at send time); (2) Tiptap rich-text JSON doc — { type: \"doc\", content: [...] } — supporting paragraphs, text marks, and inline token chips. Supported personalization tokens: {{attendee_name}}, {{attendee_email}}, {{webinar_title}}, {{session_date}}, {{session_time}}, {{session_timezone}}, {{host_name}}, {{replay_link}}, {{watch_link}}, {{unsubscribe_link}}, {{chat_message}}. For clickable hyperlinks in Tiptap mode, use a text node with a link mark of shape attrs: { href, target?, rel? } — Tiptap default attrs target=\"_blank\" rel=\"noopener noreferrer nofollow\". See the MCP resource webinarstack://docs/automation-email-authoring for the canonical Tiptap example doc, sample values per token, and the validIn taxonomy."},"WidgetStyle":{"type":"object","properties":{"v":{"type":"integer","description":"Schema version of the stored style. Set by the server."},"templateId":{"type":"string","description":"Design this style was applied from. Read-only."},"templateVersion":{"type":"integer","description":"Version of that design. Read-only."},"host":{"type":"object","properties":{"modalWidth":{"type":"integer","description":"Modal width in pixels (320 to 1200)."},"triggerColor":{"type":"string","description":"Trigger button colour as #rrggbb, rgb() or rgba()."}},"additionalProperties":{}}},"additionalProperties":{},"description":"Sparse widget style object. Only options set by the creator or an API caller appear; absent options use their defaults. v, templateId and templateVersion are read-only. Writable in this version: the modal options host.modalWidth (integer 320-1200), host.modalPosition (center, drawer-right or sheet-bottom), host.modalChrome (frame or surface), host.overlayColor (a colour), host.overlayOpacity (0 to 1 in steps of 0.05), host.overlayBlur (integer 0-24), host.modalAnimation (none, fade, scale, slide-up or slide-right; skipped for visitors who prefer reduced motion), host.closeStyle (inside or floating; floating falls back to inside on drawers, sheets and phones) and host.mobileModal (inset, fullscreen or sheet; decides the layout below 640px), and the trigger options host.triggerColor, host.triggerStyle (solid, soft, outline or dark), host.triggerShape (rounded-sm, rounded or pill), host.triggerSize (md, lg or xl), host.triggerIcon (none, arrow or play) and host.triggerFont (system or inherit). An absent host.triggerColor follows the brand. host.modalWidth and host.triggerColor override the embed-card values, and a snippet data-* attribute still wins. The form options are also writable: surface (bg, maxWidth, borderWidth, borderColor, radius, shadow, padding), typography (headingFont, bodyFont, headingScale, headingWeight, align), header (logoPlacement, kickerStyle, trustStyle), fields (labelStyle, fieldStyle, fieldBorder, fieldRadius, fieldSize, fieldBg), button (buttonStyle, buttonShape, buttonWidth, buttonSize, buttonIcon, buttonColor), session picker (sessionStyle), countdown (countdownStyle) and layout (blockSpacing, blockTitle). Colour values accept hex (#rgb, #rrggbb), rgb() or rgba(), and some colours also take a keyword (bg: transparent, borderColor: auto, fieldBg: auto or translucent). An absent headingFont or bodyFont follows the webinar theme font. The dark and transparent options are writable too: surface (card, flat, glass or none), colorScheme (light or dark), textTone (auto, dark or light), layout (stacked or split) and, for the split layout, panelBg (brand, deep or a colour) and panelTone (auto, light or dark). null removes an option so it falls back to its default."},"WebinarListItem":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"title":{"type":"string"},"status":{"type":"string","description":"published or draft"},"videoUrl":{"type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","slug","title","status","videoUrl","createdAt","updatedAt"]},"ErrorResponse":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error identifier, e.g. UNAUTHORIZED, NOT_FOUND, RATE_LIMITED, VALIDATION_ERROR"},"message":{"type":"string","description":"Human-readable description of what went wrong"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"},"code":{"type":"string"},"recoveryHint":{"type":"string"}},"required":["field","message"]},"description":"Array of field-level validation errors (only present for 400 Validation errors)"}},"required":["code","message"]}},"required":["error"]},"CreateWebinarResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"webinar":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"title":{"type":"string"},"publicTitle":{"type":"string"},"status":{"type":"string","enum":["draft"]},"accountId":{"type":"string","format":"uuid"}},"required":["id","slug","title","publicTitle","status","accountId"]}},"required":["webinar"]},"meta":{"type":"object","properties":{}}},"required":["data","meta"]},"CreateWebinarBody":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200},"publicTitle":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":5000},"videoUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"string","enum":[""]}]},"thankYouUrl":{"type":"string","format":"uri"},"thankYouMode":{"type":"string","enum":["hosted","external"]},"brandLogoUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"string","enum":[""]}]},"brandPrimaryColor":{"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"string","enum":[""]}]},"brandAccentColor":{"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"string","enum":[""]}]}},"required":["title","thankYouUrl"]},"WebinarDetail":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"status":{"type":"string"},"videoUrl":{"type":["string","null"]},"hostDisplayName":{"type":["string","null"]},"hostAvatarUrl":{"type":["string","null"]},"replayEnabled":{"type":"boolean"},"thankYouUrl":{"type":["string","null"]},"lateJoinCutoffMinutes":{"type":["number","null"]},"chatMode":{"type":["string","null"]},"dateFormat":{"type":["string","null"]},"timeFormat":{"type":["string","null"]},"language":{"type":["string","null"]},"videoDurationSeconds":{"type":["number","null"]},"hostTimezone":{"type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"sessions":{"type":"array","items":{"$ref":"#/components/schemas/SessionTime"}}},"required":["id","slug","title","description","status","videoUrl","hostDisplayName","hostAvatarUrl","replayEnabled","thankYouUrl","lateJoinCutoffMinutes","chatMode","dateFormat","timeFormat","language","videoDurationSeconds","hostTimezone","createdAt","updatedAt","sessions"]},"SessionTime":{"type":"object","properties":{"startsAt":{"type":"string","format":"date-time","description":"ISO 8601 UTC timestamp"},"type":{"type":"string","description":"Session type, e.g. fixed, recurring, jit"}},"required":["startsAt","type"]},"SettingsUpdateResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"updatedFields":{"type":"array","items":{"type":"string"},"description":"Names of fields whose values were actually patched on this request."}},"required":["webinarId","updatedFields"]},"meta":{"type":"object","properties":{}}},"required":["data"]},"UpdateCoreDetailsBody":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"title":{"type":"string","minLength":1,"maxLength":200},"publicTitle":{"type":"string","minLength":1,"maxLength":200},"description":{"type":["string","null"],"maxLength":5000},"thankYouUrl":{"type":"string","format":"uri"},"thankYouMode":{"type":"string","enum":["hosted","external"]},"hostDisplayName":{"type":["string","null"],"maxLength":100},"timezone":{"type":["string","null"]},"timezoneMode":{"type":["string","null"],"enum":["convert","same_time",null]}},"required":["webinarId"]},"UpdateBrandingBody":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"brandLogoUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"string","enum":[""]},{"type":"null"}]},"brandPrimaryColor":{"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"string","enum":[""]},{"type":"null"}]},"brandAccentColor":{"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"string","enum":[""]},{"type":"null"}]},"brandHeadline":{"type":["string","null"],"maxLength":200},"brandHeaderImageUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"string","enum":[""]},{"type":"null"}]},"hostAvatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"string","enum":[""]},{"type":"null"}]}},"required":["webinarId"]},"WidgetStyleResponse":{"type":"object","properties":{"draft":{"type":"object","additionalProperties":{},"description":"The effective draft style: the saved draft, or the published style when the widget has no separate draft yet. Values that fail validation are omitted."},"published":{"type":"object","additionalProperties":{},"description":"The live (published) style. Values that fail validation are omitted."},"updatedAt":{"type":"string","format":"date-time","description":"When the widget page was last written. Compare it before overwriting a draft."}},"required":["draft","published","updatedAt"],"description":"The widget style, draft and published. Last write wins. Responses include updatedAt. An editor tab that is open on this widget can autosave over a draft written through the API."},"UpdateWidgetStyleBody":{"type":"object","properties":{"style":{"type":"object","properties":{"bg":{"type":["string","null"],"maxLength":32,"description":"Hex (#rgb, #rrggbb) or rgb()/rgba() colour with integer channels, or one of: transparent; text drawn on it is picked for contrast, judging a translucent rgba() as if over a white page. Send null to remove it and restore the default (D-09)."},"maxWidth":{"type":["integer","null"],"minimum":280,"maximum":1200,"description":"Integer 280 to 1200. Send null to remove it and restore the default (D-09)."},"borderWidth":{"type":["string","null"],"enum":["0px","1px","1.5px","2px",null],"description":"One of: 0px, 1px, 1.5px, 2px. Send null to remove it and restore the default (D-09)."},"borderColor":{"type":["string","null"],"maxLength":32,"description":"Hex (#rgb, #rrggbb) or rgb()/rgba() colour with integer channels, or one of: auto; text drawn on it is picked for contrast, judging a translucent rgba() as if over a white page. Send null to remove it and restore the default (D-09)."},"radius":{"type":["string","null"],"enum":["0px","6px","10px","16px","18px","20px","24px","28px",null],"description":"One of: 0px, 6px, 10px, 16px, 18px, 20px, 24px, 28px. Send null to remove it and restore the default (D-09)."},"shadow":{"type":["string","null"],"enum":["none","sm","md","lg","xl","glow",null],"description":"One of: none, sm, md, lg, xl, glow. Send null to remove it and restore the default (D-09)."},"padding":{"type":["string","null"],"enum":["compact","comfortable","roomy","spacious",null],"description":"One of: compact, comfortable, roomy, spacious. Send null to remove it and restore the default (D-09)."},"headingFont":{"type":["string","null"],"enum":["inter","roboto","open-sans","lato","poppins","montserrat","nunito","source-sans-3","raleway","space-grotesk","playfair-display","merriweather",null],"description":"One of: inter, roboto, open-sans, lato, poppins, montserrat, nunito, source-sans-3, raleway, space-grotesk, playfair-display, merriweather. Absent means the heading follows the body font, which in turn follows the webinar theme font. Send null to remove it and restore the default (D-09)."},"bodyFont":{"type":["string","null"],"enum":["inter","roboto","open-sans","lato","poppins","montserrat","nunito","source-sans-3","raleway","space-grotesk","playfair-display","merriweather",null],"description":"One of: inter, roboto, open-sans, lato, poppins, montserrat, nunito, source-sans-3, raleway, space-grotesk, playfair-display, merriweather. Absent means the font follows the webinar theme font. Send null to remove it and restore the default (D-09)."},"headingScale":{"type":["string","null"],"enum":["body","sm","md","lg","xl",null],"description":"One of: body, sm, md, lg, xl. Send null to remove it and restore the default (D-09)."},"headingWeight":{"type":["string","null"],"enum":["400","500","600","700","800",null],"description":"One of: 400, 500, 600, 700, 800. Send null to remove it and restore the default (D-09)."},"align":{"type":["string","null"],"enum":["center","left",null],"description":"One of: center, left. Send null to remove it and restore the default (D-09)."},"logoPlacement":{"type":["string","null"],"enum":["none","top","top-left",null],"description":"One of: none, top, top-left. Send null to remove it and restore the default (D-09)."},"kickerStyle":{"type":["string","null"],"enum":["text","pill",null],"description":"One of: text, pill. Send null to remove it and restore the default (D-09)."},"trustStyle":{"type":["string","null"],"enum":["line","checks",null],"description":"One of: line, checks. Send null to remove it and restore the default (D-09)."},"labelStyle":{"type":["string","null"],"enum":["above","floating","eyebrow",null],"description":"One of: above, floating, eyebrow. Send null to remove it and restore the default (D-09)."},"fieldStyle":{"type":["string","null"],"enum":["outlined","filled","underline","soft",null],"description":"One of: outlined, filled, underline, soft. Send null to remove it and restore the default (D-09)."},"fieldBorder":{"type":["string","null"],"enum":["subtle","defined","strong",null],"description":"One of: subtle, defined, strong. Send null to remove it and restore the default (D-09)."},"fieldRadius":{"type":["string","null"],"enum":["0","6","10","14","pill",null],"description":"One of: 0, 6, 10, 14, pill. Send null to remove it and restore the default (D-09)."},"fieldSize":{"type":["string","null"],"enum":["md","lg",null],"description":"One of: md, lg. Send null to remove it and restore the default (D-09)."},"fieldBg":{"type":["string","null"],"maxLength":32,"description":"Hex (#rgb, #rrggbb) or rgb()/rgba() colour with integer channels, or one of: auto, translucent; text drawn on it is picked for contrast, judging a translucent rgba() as if over a white page. Send null to remove it and restore the default (D-09)."},"buttonStyle":{"type":["string","null"],"enum":["solid","soft","outline","elevated",null],"description":"One of: solid, soft, outline, elevated. Send null to remove it and restore the default (D-09)."},"buttonShape":{"type":["string","null"],"enum":["square","rounded","pill",null],"description":"One of: square, rounded, pill. Send null to remove it and restore the default (D-09)."},"buttonWidth":{"type":["string","null"],"enum":["full","auto",null],"description":"One of: full, auto. Send null to remove it and restore the default (D-09)."},"buttonSize":{"type":["string","null"],"enum":["md","lg",null],"description":"One of: md, lg. Send null to remove it and restore the default (D-09)."},"buttonIcon":{"type":["string","null"],"enum":["none","arrow","play",null],"description":"One of: none, arrow, play. Send null to remove it and restore the default (D-09)."},"buttonColor":{"type":["string","null"],"maxLength":32,"description":"Hex (#rgb, #rrggbb) or rgb()/rgba() colour with integer channels; text drawn on it is picked for contrast, judging a translucent rgba() as if over a white page. Absent means follow the theme primary. Send null to remove it and restore the default (D-09)."},"sessionStyle":{"type":["string","null"],"enum":["dropdown","list","cards","chips",null],"description":"One of: dropdown, list, cards, chips. Send null to remove it and restore the default (D-09)."},"countdownStyle":{"type":["string","null"],"enum":["tiles","soft-tiles","inline","minimal","text",null],"description":"One of: tiles, soft-tiles, inline, minimal, text. Send null to remove it and restore the default (D-09)."},"blockSpacing":{"type":["string","null"],"enum":["legacy","snug","airy",null],"description":"One of: legacy, snug, airy. Send null to remove it and restore the default (D-09)."},"blockTitle":{"type":["string","null"],"enum":["heading","label","eyebrow",null],"description":"One of: heading, label, eyebrow. Send null to remove it and restore the default (D-09)."},"surface":{"type":["string","null"],"enum":["card","flat","glass","none",null],"description":"One of: card, flat, glass, none. Send null to remove it and restore the default (D-09)."},"colorScheme":{"type":["string","null"],"enum":["light","dark",null],"description":"One of: light, dark. Send null to remove it and restore the default (D-09)."},"textTone":{"type":["string","null"],"enum":["auto","dark","light",null],"description":"One of: auto, dark, light. Send null to remove it and restore the default (D-09)."},"layout":{"type":["string","null"],"enum":["stacked","split",null],"description":"One of: stacked, split. Send null to remove it and restore the default (D-09)."},"panelBg":{"type":["string","null"],"maxLength":32,"description":"Hex (#rgb, #rrggbb) or rgb()/rgba() colour with integer channels, or one of: brand, deep; text drawn on it is picked for contrast, judging a translucent rgba() as if over a white page. Send null to remove it and restore the default (D-09)."},"panelTone":{"type":["string","null"],"enum":["auto","light","dark",null],"description":"One of: auto, light, dark. Send null to remove it and restore the default (D-09)."},"host":{"type":"object","properties":{"modalWidth":{"type":["integer","null"],"minimum":320,"maximum":1200,"description":"Integer 320 to 1200. Overrides the embed card (widget_configs) value; the snippet data-* attribute still wins (L-08). Send null to remove it and restore the default (D-09)."},"triggerColor":{"type":["string","null"],"maxLength":32,"description":"Hex (#rgb, #rrggbb) or rgb()/rgba() colour with integer channels; text drawn on it is picked for contrast, judging a translucent rgba() as if over a white page. Overrides the embed card (widget_configs) value; the snippet data-* attribute still wins (L-08). Absent means follow the brand. Send null to remove it and restore the default (D-09)."},"modalPosition":{"type":["string","null"],"enum":["center","drawer-right","sheet-bottom",null],"description":"One of: center, drawer-right, sheet-bottom. Send null to remove it and restore the default (D-09)."},"modalChrome":{"type":["string","null"],"enum":["frame","surface",null],"description":"One of: frame, surface. Send null to remove it and restore the default (D-09)."},"overlayColor":{"type":["string","null"],"maxLength":32,"description":"Hex (#rgb, #rrggbb) or rgb()/rgba() colour with integer channels; text drawn on it is picked for contrast, judging a translucent rgba() as if over a white page. Send null to remove it and restore the default (D-09)."},"overlayOpacity":{"type":["number","null"],"minimum":0,"maximum":1,"description":"Number 0 to 1. Send null to remove it and restore the default (D-09)."},"overlayBlur":{"type":["integer","null"],"minimum":0,"maximum":24,"description":"Integer 0 to 24. Send null to remove it and restore the default (D-09)."},"modalAnimation":{"type":["string","null"],"enum":["none","fade","scale","slide-up","slide-right",null],"description":"One of: none, fade, scale, slide-up, slide-right. Send null to remove it and restore the default (D-09)."},"closeStyle":{"type":["string","null"],"enum":["inside","floating",null],"description":"One of: inside, floating. Send null to remove it and restore the default (D-09)."},"mobileModal":{"type":["string","null"],"enum":["inset","fullscreen","sheet",null],"description":"One of: inset, fullscreen, sheet. Send null to remove it and restore the default (D-09)."},"triggerStyle":{"type":["string","null"],"enum":["solid","soft","outline","dark",null],"description":"One of: solid, soft, outline, dark. Send null to remove it and restore the default (D-09)."},"triggerShape":{"type":["string","null"],"enum":["rounded-sm","rounded","pill",null],"description":"One of: rounded-sm, rounded, pill. Send null to remove it and restore the default (D-09)."},"triggerSize":{"type":["string","null"],"enum":["md","lg","xl",null],"description":"One of: md, lg, xl. Send null to remove it and restore the default (D-09)."},"triggerIcon":{"type":["string","null"],"enum":["none","arrow","play",null],"description":"One of: none, arrow, play. Send null to remove it and restore the default (D-09)."},"triggerFont":{"type":["string","null"],"enum":["system","inherit",null],"description":"One of: system, inherit. Send null to remove it and restore the default (D-09)."}}}}}},"required":["style"],"description":"JSON merge patch (RFC 7396) of the widget style. Send only keys you change; null removes an option. Writable in this version: the modal options host.modalWidth (integer 320-1200), host.modalPosition (center, drawer-right or sheet-bottom), host.modalChrome (frame or surface), host.overlayColor (a colour), host.overlayOpacity (0 to 1 in steps of 0.05), host.overlayBlur (integer 0-24), host.modalAnimation (none, fade, scale, slide-up or slide-right; skipped for visitors who prefer reduced motion), host.closeStyle (inside or floating; floating falls back to inside on drawers, sheets and phones) and host.mobileModal (inset, fullscreen or sheet; decides the layout below 640px), and the trigger options host.triggerColor, host.triggerStyle (solid, soft, outline or dark), host.triggerShape (rounded-sm, rounded or pill), host.triggerSize (md, lg or xl), host.triggerIcon (none, arrow or play) and host.triggerFont (system or inherit). An absent host.triggerColor follows the brand. host.modalWidth and host.triggerColor override the embed-card values, and a snippet data-* attribute still wins. The form options are also writable: surface (bg, maxWidth, borderWidth, borderColor, radius, shadow, padding), typography (headingFont, bodyFont, headingScale, headingWeight, align), header (logoPlacement, kickerStyle, trustStyle), fields (labelStyle, fieldStyle, fieldBorder, fieldRadius, fieldSize, fieldBg), button (buttonStyle, buttonShape, buttonWidth, buttonSize, buttonIcon, buttonColor), session picker (sessionStyle), countdown (countdownStyle) and layout (blockSpacing, blockTitle). Colour values accept hex (#rgb, #rrggbb), rgb() or rgba(), and some colours also take a keyword (bg: transparent, borderColor: auto, fieldBg: auto or translucent). An absent headingFont or bodyFont follows the webinar theme font. The dark and transparent options are writable too: surface (card, flat, glass or none), colorScheme (light or dark), textTone (auto, dark or light), layout (stacked or split) and, for the split layout, panelBg (brand, deep or a colour) and panelTone (auto, light or dark). null removes an option so it falls back to its default."},"WidgetPublishResponse":{"type":"object","properties":{"published":{"type":"object","additionalProperties":{},"description":"The live (published) style after this call. Values that fail validation are omitted."},"publishedAt":{"type":"string","format":"date-time","description":"When the widget was published. The widget page has one write timestamp, so this equals updatedAt."},"updatedAt":{"type":"string","format":"date-time","description":"When the widget page was last written."},"changed":{"type":"boolean","description":"False when the draft already equalled the live widget (or there was no draft), so nothing was copied."}},"required":["published","publishedAt","updatedAt","changed"],"description":"Result of publishing the widget draft. Publishing copies the whole widget draft, including any unpublished editor changes to its content, to the live widget, exactly like the editor's Publish button. For about 45 to 60 seconds after each publish or branding change, the live modal chrome can briefly wrap the previous form while the CDN snapshot refreshes; it heals on its own."},"WidgetDesignListResponse":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"mode":{"type":"string","enum":["inline","modal"]},"designs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"mode":{"type":"string","enum":["inline","modal"]},"latestVersion":{"type":"integer"},"thumbnailUrl":{"type":"string"}},"required":["id","code","name","description","mode","latestVersion","thumbnailUrl"]}},"current":{"type":["object","null"],"properties":{"templateId":{"type":"string","description":"The design the widget was applied from."},"templateVersion":{"type":"integer","description":"The design version the widget was applied from."},"name":{"type":"string"},"changedKeys":{"type":"array","items":{"type":"string"},"description":"Style options whose value differs from the design (draft style against the stored design version)."}},"required":["templateId","templateVersion","name","changedKeys"],"description":"The design recorded on the draft with the options changed since, or null when the draft has no known design."}},"required":["webinarId","mode","designs","current"],"description":"The designs this widget can use, in gallery order, and the design on its draft. This writes the widget DRAFT only. It cannot publish; the live widget does not change until the creator publishes, exactly like a draft edit in the editor."},"WidgetDesignApplyResponse":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"design":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"name":{"type":"string"},"version":{"type":"integer"}},"required":["id","code","name","version"]},"style":{"type":"object","additionalProperties":{},"description":"The stored draft style after the apply."},"removed":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["logo","kicker","container"]},"blockId":{"type":"string"}},"required":["kind","blockId"]},"description":"Blocks the apply left out: a logo or kicker the design has no place for, and any extra block holding a form, session picker or countdown."},"kickerAdded":{"type":["string","null"],"description":"The kicker text the apply added (the webinar title), or null when it added none."},"updatedAt":{"type":"string","format":"date-time"}},"required":["webinarId","design","style","removed","kickerAdded","updatedAt"],"description":"Result of applying a design to the widget draft. This writes the widget DRAFT only. It cannot publish; the live widget does not change until the creator publishes, exactly like a draft edit in the editor. The heading, subheading, logo, session picker, countdown and the form's consent, GDPR, SMS and phone settings are kept. The trigger text is never changed. Last write wins. Responses include updatedAt. An editor tab that is open on this widget can autosave over a draft written through the API. If the widget draft changed while the design was being applied, the call returns CONFLICT and nothing is saved; read the widget again and retry."},"ApplyWidgetDesignBody":{"type":"object","properties":{"designId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,63}$","description":"The design to apply, one of the ids returned by the list call for this widget, for example i5-editorial.","example":"i5-editorial"},"extraBlocks":{"type":"string","enum":["keep","drop"],"description":"Required. extraBlocks 'keep' places the blocks you added after the design's blocks, in their order. 'drop' leaves them out. Blocks holding a form, a session picker or a countdown are always left out."}},"required":["designId","extraBlocks"],"description":"Which design to apply and what to do with blocks you added. extraBlocks 'keep' places the blocks you added after the design's blocks, in their order. 'drop' leaves them out. Blocks holding a form, a session picker or a countdown are always left out."},"WidgetDesignResetResponse":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"style":{"type":"object","additionalProperties":{},"description":"The stored draft style after the reset."},"current":{"type":["object","null"],"properties":{"templateId":{"type":"string","description":"The design the widget was applied from."},"templateVersion":{"type":"integer","description":"The design version the widget was applied from."},"name":{"type":"string"},"changedKeys":{"type":"array","items":{"type":"string"},"description":"Style options whose value differs from the design (draft style against the stored design version)."}},"required":["templateId","templateVersion","name","changedKeys"],"description":"The design recorded on the draft with the options changed since, or null when the draft has no known design."},"updatedAt":{"type":"string","format":"date-time"}},"required":["webinarId","style","current","updatedAt"],"description":"Result of putting style options back to the design the widget was applied from. Blocks and copy are not changed. This writes the widget DRAFT only. It cannot publish; the live widget does not change until the creator publishes, exactly like a draft edit in the editor. Last write wins. Responses include updatedAt. An editor tab that is open on this widget can autosave over a draft written through the API. If the widget draft changed while the design was being applied, the call returns CONFLICT and nothing is saved; read the widget again and retry."},"ResetWidgetDesignBody":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"string","maxLength":100},"minItems":1,"maxItems":64,"description":"Style option keys to put back to the design, for example radius or host.overlayOpacity. Omit to reset every style option; an empty list is refused rather than treated as a reset of nothing. Only writable style options are accepted, never v, templateId or templateVersion, and never layout (it moves the blocks of the widget, so use the layout operation).","example":["radius"]}},"description":"Which style options to put back to the design the widget was applied from. Omit keys, or send an empty body, to reset every option."},"WidgetColorSchemeResponse":{"type":"object","properties":{"draft":{"type":"object","additionalProperties":{},"description":"The draft style after the switch. Values that fail validation are omitted."},"swapped":{"type":"array","items":{"type":"string"},"description":"The style keys the switch set (to dark) or removed (to light), for example bg and borderColor. Empty when the scheme was already selected."},"updatedAt":{"type":"string","format":"date-time","description":"When the widget page was last written. Unchanged when nothing was written."}},"required":["draft","swapped","updatedAt"],"description":"Result of switching the widget draft's colour scheme. This writes the widget DRAFT only. It cannot publish; the live widget does not change until the creator publishes, exactly like a draft edit in the editor. Switching to dark also changes the background and the border colour when they are still at their light defaults (white and automatic); a colour the creator chose is kept. Switching back to light puts those two defaults back. Selecting the scheme already in place changes nothing. Last write wins. Responses include updatedAt. An editor tab that is open on this widget can autosave over a draft written through the API. If the widget draft changed while the scheme was being saved, the call returns CONFLICT and nothing is saved; read the widget again and retry."},"SwitchWidgetColorSchemeBody":{"type":"object","properties":{"scheme":{"type":"string","enum":["light","dark"],"description":"Required. The colour scheme to switch the widget draft to. Switching to dark also changes the background and the border colour when they are still at their light defaults (white and automatic); a colour the creator chose is kept. Switching back to light puts those two defaults back. Selecting the scheme already in place changes nothing.","example":"dark"}},"required":["scheme"],"description":"Which colour scheme to switch the widget draft to. Switching to dark also changes the background and the border colour when they are still at their light defaults (white and automatic); a colour the creator chose is kept. Switching back to light puts those two defaults back. Selecting the scheme already in place changes nothing."},"WidgetLayoutResponse":{"type":"object","properties":{"draft":{"type":"object","additionalProperties":{},"description":"The draft style after the change. Values that fail validation are omitted."},"layout":{"type":"string","enum":["stacked","split"],"description":"The layout of the draft after the call."},"moved":{"type":"array","items":{"type":"string"},"description":"The names of the blocks that changed pane, for example heading and trust line. Empty when the layout was already selected."},"updatedAt":{"type":"string","format":"date-time","description":"When the widget page was last written. Unchanged when nothing was written."}},"required":["draft","layout","moved","updatedAt"],"description":"Result of switching the widget draft's layout. This writes the widget DRAFT only. It cannot publish; the live widget does not change until the creator publishes, exactly like a draft edit in the editor. Switching to split moves the kicker, heading, subheading, trust line and countdown into the brand panel and keeps the registration form and session picker on the form side. Switching back to stacked puts the blocks back in the order of the design the widget was applied from. Selecting the layout already in place changes nothing. Last write wins. Responses include updatedAt. An editor tab that is open on this widget can autosave over a draft written through the API. If the widget draft changed while the layout was being saved, the call returns CONFLICT and nothing is saved; read the widget again and retry."},"SetWidgetLayoutBody":{"type":"object","properties":{"layout":{"type":"string","enum":["stacked","split"],"description":"Required. The layout to switch the widget draft to. Switching to split moves the kicker, heading, subheading, trust line and countdown into the brand panel and keeps the registration form and session picker on the form side. Switching back to stacked puts the blocks back in the order of the design the widget was applied from. Selecting the layout already in place changes nothing.","example":"split"}},"required":["layout"],"description":"Which layout to switch the widget draft to. Switching to split moves the kicker, heading, subheading, trust line and countdown into the brand panel and keeps the registration form and session picker on the form side. Switching back to stacked puts the blocks back in the order of the design the widget was applied from. Selecting the layout already in place changes nothing."},"UpdateVideoProviderResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"scope":{"type":"string","enum":["webinar","segment"]},"videoProvider":{"type":"string","enum":["youtube","vimeo","bunny"]},"videoRef":{"type":"string","description":"Provider-canonical video reference (YouTube id, Vimeo id, or WebinarStack CDN video id)."},"bunnyVideoId":{"type":"string","format":"uuid","description":"WebinarStack CDN video row id (only present on Bunny webinar-scope updates)."}},"required":["webinarId","scope","videoProvider","videoRef"]},"meta":{"type":"object","properties":{}}},"required":["data"]},"UpdateVideoProviderBody":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"scope":{"type":"string","enum":["webinar","segment"]},"videoProvider":{"type":"string","enum":["youtube","vimeo","bunny"]},"videoUrl":{"type":"string","format":"uri"},"segmentId":{"type":"string","format":"uuid"},"bunnyVideoId":{"type":"string","format":"uuid"}},"required":["webinarId","scope","videoProvider"]},"ConfigureScheduleResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"kind":{"type":"string","enum":["fixed","recurring","jit"]},"webinarId":{"type":"string","format":"uuid"},"upcomingSessions":{"type":"array","items":{"type":"object","properties":{"startsAt":{"type":"string","format":"date-time"},"type":{"type":"string","enum":["fixed","recurring","jit"]},"sessionId":{"type":"string","format":"uuid"}},"required":["startsAt","type"]},"description":"Preview of upcoming sessions after the schedule mutation, merged via getNextSessions."},"previewSource":{"type":"string","enum":["getNextSessions"]}},"required":["kind","webinarId","upcomingSessions","previewSource"]},"meta":{"type":"object","properties":{}}},"required":["data"]},"ConfigureScheduleBody":{"oneOf":[{"$ref":"#/components/schemas/ScheduleFixedBody"},{"$ref":"#/components/schemas/ScheduleRecurringBody"},{"$ref":"#/components/schemas/ScheduleJitBody"}],"discriminator":{"propertyName":"kind","mapping":{"fixed":"#/components/schemas/ScheduleFixedBody","recurring":"#/components/schemas/ScheduleRecurringBody","jit":"#/components/schemas/ScheduleJitBody"}}},"ScheduleFixedBody":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"previewLimit":{"type":"integer","minimum":1,"maximum":20,"default":5},"kind":{"type":"string","enum":["fixed"]},"sessions":{"type":"array","items":{"type":"object","properties":{"startsAt":{"type":"string","format":"date-time"}},"required":["startsAt"]},"minItems":1}},"required":["webinarId","kind","sessions"]},"ScheduleRecurringBody":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"previewLimit":{"type":"integer","minimum":1,"maximum":20,"default":5},"kind":{"type":"string","enum":["recurring"]},"hostTimezone":{"type":"string","minLength":1},"config":{"type":"object","properties":{"days":{"type":"array","items":{"type":"object","properties":{"day":{"type":"integer","minimum":0,"maximum":6},"times":{"type":"array","items":{"type":"string","pattern":"^\\d{2}:\\d{2}$"},"minItems":1}},"required":["day","times"]},"minItems":1}},"required":["days"]},"availableDays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}},"availableStartHour":{"type":"integer","minimum":0,"maximum":23},"availableEndHour":{"type":"integer","minimum":1,"maximum":24}},"required":["webinarId","kind","hostTimezone","config"]},"ScheduleJitBody":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"previewLimit":{"type":"integer","minimum":1,"maximum":20,"default":5},"kind":{"type":"string","enum":["jit"]},"hostTimezone":{"type":"string","minLength":1},"config":{"type":"object","properties":{"intervalMinutes":{"anyOf":[{"type":"string","enum":["5","10","15","30","60"]},{"type":"integer"}]}},"required":["intervalMinutes"]},"availableDays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}},"availableStartHour":{"type":"integer","minimum":0,"maximum":23},"availableEndHour":{"type":"integer","minimum":1,"maximum":24}},"required":["webinarId","kind","hostTimezone","config"]},"UpdateReplayDefaultsBody":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"replayEnabled":{"type":"boolean"},"replayExpiryDays":{"type":["integer","null"],"minimum":1,"maximum":365},"replayVideoUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"string","enum":[""]},{"type":"null"}]},"replayRedirectEnabled":{"type":"boolean"},"replayRedirectUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"string","enum":[""]},{"type":"null"}]},"expiredReplayRedirectEnabled":{"type":"boolean"},"expiredReplayRedirectUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"string","enum":[""]},{"type":"null"}]},"replayChatMode":{"type":"string","enum":["builtin","external","disabled"]},"replayChatExternalScript":{"type":["string","null"]},"replayAllowScrubbing":{"type":"boolean"}},"required":["webinarId"]},"UpdateRegistrationPageResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"pageType":{"type":"string","enum":["registration"]},"status":{"type":"string","enum":["draft","published"]},"updatedBlocks":{"type":"array","items":{"type":"string","enum":["hero","session_picker","registration_form"]}}},"required":["webinarId","pageType","status","updatedBlocks"]},"meta":{"type":"object","properties":{}}},"required":["data"]},"UpdateRegistrationPageBody":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["draft","published"],"default":"draft"},"headline":{"type":"string","minLength":1,"maxLength":200},"subhead":{"type":["string","null"],"maxLength":500},"sessionPickerHeading":{"type":"string","minLength":1,"maxLength":120},"submitLabel":{"type":"string","minLength":1,"maxLength":80},"privacyNote":{"type":["string","null"],"maxLength":500}},"required":["webinarId"]},"UpdateOfferReplayResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"timeline":{"type":"string","enum":["live","replay"]},"interactionId":{"type":"string","format":"uuid"},"created":{"type":"boolean","description":"true if a new CTA interaction was inserted; false if an existing CTA was updated."},"replayUpdated":{"type":"boolean","description":"true if any replay-defaults field was included in the patch and applied."}},"required":["webinarId","timeline","interactionId","created","replayUpdated"]},"meta":{"type":"object","properties":{}}},"required":["data"]},"UpdateOfferReplayBody":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"timeline":{"type":"string","enum":["live","replay"],"default":"live"},"headline":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":500},"buttonLabel":{"type":"string","minLength":1,"maxLength":80},"buttonUrl":{"type":"string","format":"uri"},"appearsAtSeconds":{"type":"integer","minimum":0,"default":0},"endsAtSeconds":{"type":"integer","minimum":1},"attributionWindowDays":{"type":"integer","minimum":0,"maximum":365,"default":7},"replayEnabled":{"type":"boolean"},"replayExpiryDays":{"type":["integer","null"],"minimum":1,"maximum":365},"replayVideoUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"string","enum":[""]},{"type":"null"}]},"replayRedirectEnabled":{"type":"boolean"},"replayRedirectUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"string","enum":[""]},{"type":"null"}]}},"required":["webinarId","headline","endsAtSeconds"]},"PublishWebinarResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["published"]},"alreadyPublished":{"type":"boolean","description":"true if the webinar was already published before this call — the response is a no-op (D-10 idempotent)."}},"required":["webinarId","status","alreadyPublished"]},"meta":{"type":"object","properties":{}}},"required":["data"]},"PublishBlockedResponse":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["PUBLISH_BLOCKED"],"description":"Machine-readable error identifier"},"message":{"type":"string","description":"Human-readable summary of why the publish was blocked"},"blockers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Stable identifier of the unmet readiness requirement, e.g. video_provider"},"state":{"type":"string","description":"Blocker state, e.g. blocking"},"deepLinkTarget":{"type":"object","additionalProperties":{},"description":"Where in the editor the creator resolves this blocker (tab / route reference)"}},"required":["id","state"]},"description":"The unresolved readiness requirements preventing publish — resolve all of them, then retry"}},"required":["code","message","blockers"]}},"required":["error"]},"ArchiveWebinarResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["archived"]},"alreadyArchived":{"type":"boolean","description":"true if the webinar was already archived before this call — the response is a no-op."}},"required":["webinarId","status","alreadyArchived"]},"meta":{"type":"object","properties":{}}},"required":["data"]},"DuplicateWebinarResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"webinar":{"$ref":"#/components/schemas/WebinarDetail"}},"required":["webinar"]},"meta":{"type":"object","properties":{}}},"required":["data"]},"ListSessionsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SessionSlotDto"}},"meta":{"type":"object","properties":{"nextCursor":{"type":["string","null"]},"hasMore":{"type":"boolean"},"timezone":{"type":["string","null"]},"timezoneMode":{"type":["string","null"]}},"required":["nextCursor","hasMore"]}},"required":["data","meta"]},"SessionSlotDto":{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string","enum":["fixed","recurring","jit"]},"startsAt":{"type":"string","format":"date-time"},"hostTimezone":{"type":"string"}},"required":["id","type","startsAt","hostTimezone"]},"GetSessionResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SessionSlotDto"}},"required":["data"]},"ForceProgressResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"registrationId":{"type":"string","format":"uuid"},"effectiveSessionStartsAt":{"type":"string","format":"date-time"}},"required":["registrationId","effectiveSessionStartsAt"]}},"required":["data"]},"ForceProgressRequest":{"type":"object","properties":{"registrationId":{"type":"string","format":"uuid"},"advanceSeconds":{"type":"integer","minimum":-86400,"maximum":86400}},"required":["registrationId","advanceSeconds"]},"ResetResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"registrationId":{"type":"string","format":"uuid"},"sessionStartsAt":{"type":"string","format":"date-time"}},"required":["registrationId","sessionStartsAt"]}},"required":["data"]},"ResetRequest":{"type":"object","properties":{"registrationId":{"type":"string","format":"uuid"}},"required":["registrationId"]},"CreateRegistrationResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"email":{"type":"string","format":"email"},"name":{"type":["string","null"]},"sessionStartsAt":{"type":"string","format":"date-time"},"accessUrl":{"type":"string","format":"uri"}},"required":["id","email","name","sessionStartsAt","accessUrl"]}},"required":["data"]},"CreateRegistrationRequest":{"type":"object","properties":{"email":{"type":"string","format":"email"},"name":{"type":["string","null"],"minLength":1,"maxLength":200},"sessionTime":{"type":"string","format":"date-time"},"viewerTimezone":{"type":["string","null"]},"utmSource":{"type":["string","null"],"maxLength":200},"utmMedium":{"type":["string","null"],"maxLength":200},"utmCampaign":{"type":["string","null"],"maxLength":200}},"required":["email","sessionTime"]},"ListRegistrationsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/RegistrationDto"}},"meta":{"type":"object","properties":{"nextCursor":{"type":["string","null"]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]}},"required":["data","meta"]},"RegistrationDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"email":{"type":"string","format":"email"},"name":{"type":["string","null"]},"sessionStartsAt":{"type":"string","format":"date-time"},"accessUrl":{"type":"string","format":"uri"},"registeredAt":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["registered","attended"]}},"required":["id","email","name","sessionStartsAt","accessUrl","registeredAt"]},"RotateTokenResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"accessUrl":{"type":"string","format":"uri"},"rotatedAt":{"type":"string","format":"date-time"}},"required":["id","accessUrl","rotatedAt"]}},"required":["data"]},"BulkCreateRegistrationsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/BulkRowOk"},{"$ref":"#/components/schemas/BulkRowError"}],"discriminator":{"propertyName":"ok","mapping":{"true":"#/components/schemas/BulkRowOk","false":"#/components/schemas/BulkRowError"}}}},"meta":{"type":"object","properties":{}}},"required":["data"]},"BulkRowOk":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"id":{"type":"string","format":"uuid"},"email":{"type":"string","format":"email"},"accessUrl":{"type":"string","format":"uri"}},"required":["ok","id","email","accessUrl"]},"BulkRowError":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"code":{"type":"string","enum":["DUPLICATE_IN_BATCH","VALIDATION_ERROR","INTERNAL_ERROR"]},"message":{"type":"string"}},"required":["code","message"]}},"required":["ok","error"]},"BulkCreateRegistrationsRequest":{"type":"object","properties":{"registrations":{"type":"array","items":{"$ref":"#/components/schemas/BulkRegistrationItem"},"minItems":1,"maxItems":100}},"required":["registrations"]},"BulkRegistrationItem":{"type":"object","properties":{"email":{"type":"string","format":"email"},"name":{"type":["string","null"],"minLength":1,"maxLength":200},"sessionTime":{"type":"string","format":"date-time"},"viewerTimezone":{"type":["string","null"]},"utmSource":{"type":["string","null"],"maxLength":200},"utmMedium":{"type":["string","null"],"maxLength":200},"utmCampaign":{"type":["string","null"],"maxLength":200}},"required":["email","sessionTime"]},"CreateWebhookSubscriptionResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Subscription ID (nanoid 21 chars)."},"webinarId":{"type":"string","format":"uuid"},"url":{"type":"string","format":"uri"},"eventTypes":{"type":"array","items":{"$ref":"#/components/schemas/WebhookEventType"}},"active":{"type":"boolean"},"secret":{"type":"string","description":"HMAC signing secret (shown exactly once; use idempotency replay to recover)."},"createdAt":{"type":"string","format":"date-time"}},"required":["id","webinarId","url","eventTypes","active","secret","createdAt"]}},"required":["data"],"description":"Created webhook subscription including one-time signing secret."},"WebhookEventType":{"type":"string","enum":["registered","joined","left","no_show","video_complete","cta_click"],"description":"Supported webhook event trigger types."},"CreateWebhookSubscriptionRequest":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"HTTPS endpoint to receive webhook deliveries. SSRF validation applied server-side."},"eventTypes":{"type":"array","items":{"$ref":"#/components/schemas/WebhookEventType"},"minItems":1,"description":"One or more event types to subscribe to."},"active":{"type":"boolean","default":true,"description":"Whether the subscription is active."}},"required":["url","eventTypes"],"description":"Create a webhook subscription for a webinar."},"WebhookSubscription":{"type":"object","properties":{"id":{"type":"string"},"webinarId":{"type":"string","format":"uuid"},"url":{"type":"string","format":"uri"},"eventTypes":{"type":"array","items":{"$ref":"#/components/schemas/WebhookEventType"}},"active":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"}},"required":["id","webinarId","url","eventTypes","active","createdAt"],"description":"Webhook subscription summary (no secret). Use the single-get endpoint for secretLast4."},"WebhookSubscriptionDetail":{"type":"object","properties":{"id":{"type":"string"},"webinarId":{"type":"string","format":"uuid"},"url":{"type":"string","format":"uri"},"eventTypes":{"type":"array","items":{"$ref":"#/components/schemas/WebhookEventType"}},"active":{"type":"boolean"},"secretLast4":{"type":"string","minLength":4,"maxLength":4,"description":"Last 4 characters of the signing secret."},"secretRotatedAt":{"type":"string","format":"date-time","description":"ISO timestamp of the last secret rotation (or subscription creation)."},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","webinarId","url","eventTypes","active","secretLast4","secretRotatedAt","createdAt","updatedAt"],"description":"Webhook subscription detail. Includes secretLast4 and secretRotatedAt for key management; full secret is never returned after creation."},"PatchWebhookSubscriptionRequest":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"New HTTPS endpoint. SSRF validation applied server-side."},"eventTypes":{"type":"array","items":{"$ref":"#/components/schemas/WebhookEventType"},"minItems":1,"description":"Replace all subscribed event types."},"active":{"type":"boolean","description":"Enable or disable all rows in the subscription."}},"description":"Partial update for a webhook subscription. At least one field required (enforced server-side)."},"RotateWebhookSecretResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Subscription ID."},"secret":{"type":"string","description":"New HMAC signing secret (shown exactly once; use idempotency replay to recover)."},"rotatedAt":{"type":"string","format":"date-time"}},"required":["id","secret","rotatedAt"]}},"required":["data"],"description":"New signing secret after rotation. Replayed verbatim on idempotency retry (D-25)."},"ListWebhookDeliveriesResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WebhookDelivery"}},"meta":{"type":"object","properties":{"nextCursor":{"type":["string","null"]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]}},"required":["data","meta"],"description":"Cursor-paginated list of webhook delivery attempts for a subscription."},"WebhookDelivery":{"type":"object","properties":{"deliveryId":{"type":"string","format":"uuid","description":"Unique delivery attempt ID."},"eventType":{"type":"string","description":"The trigger type that fired this delivery (e.g., registered, joined)."},"responseStatus":{"type":["integer","null"],"description":"HTTP response status code from the receiver; null if not yet delivered."},"durationMs":{"type":["integer","null"],"description":"Delivery duration in milliseconds (deliveredAt - createdAt); null if pending."},"deliveredAt":{"type":["string","null"],"format":"date-time","description":"ISO timestamp when delivery completed; null if still pending."}},"required":["deliveryId","eventType","responseStatus","durationMs","deliveredAt"],"description":"Summary of a single webhook delivery attempt. Use the single-get endpoint for requestBody and responseBody."},"WebhookDeliveryDetail":{"type":"object","properties":{"deliveryId":{"type":"string","format":"uuid","description":"Unique delivery attempt ID."},"eventType":{"type":"string","description":"The trigger type that fired this delivery."},"responseStatus":{"type":["integer","null"],"description":"HTTP response status code from the receiver; null if not yet delivered."},"durationMs":{"type":["integer","null"],"description":"Delivery duration in milliseconds; null if pending."},"deliveredAt":{"type":["string","null"],"format":"date-time","description":"ISO timestamp when delivery completed; null if still pending."},"requestBody":{"type":["string","null"],"description":"JSON-serialised outbound payload sent to the receiver."},"responseBody":{"type":["string","null"],"description":"Truncated receiver response body (max 500 chars per D-26)."},"attemptCount":{"type":"integer","description":"Number of delivery attempts (including retries)."},"status":{"type":"string","enum":["pending","success","failed"],"description":"Terminal delivery status."}},"required":["deliveryId","eventType","responseStatus","durationMs","deliveredAt","requestBody","responseBody","attemptCount","status"],"description":"Full detail of a single webhook delivery attempt including request/response bodies."},"RedeliverWebhookResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"deliveryId":{"type":"string","format":"uuid","description":"New delivery attempt UUID"},"status":{"type":"string","enum":["pending"]}},"required":["deliveryId","status"]},"error":{"type":"null"},"meta":{"type":"object","properties":{}}},"required":["data","error","meta"]},"Automation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"accountId":{"type":"string","format":"uuid"},"webinarId":{"type":"string","format":"uuid"},"name":{"type":"string"},"triggerType":{"type":"string"},"conditions":{"description":"JSONB conditions array (raw passthrough)."},"actionType":{"type":"string"},"actionConfig":{"description":"JSONB action configuration, returned as raw passthrough (Pitfall 5) — EXCEPT that for webhook action types the HMAC signing secret is never returned on read: the response carries secretLast4 (the final four characters) in place of webhookSecret."},"delayMinutes":{"type":"integer"},"enabled":{"type":"boolean"},"segmentId":{"type":["string","null"],"format":"uuid"},"branchId":{"type":["string","null"],"format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","accountId","webinarId","name","triggerType","actionType","delayMinutes","enabled","segmentId","branchId","createdAt","updatedAt"],"description":"An automation rule. actionConfig is returned as raw JSONB passthrough, except that webhook-action rows never return the HMAC signing secret on read — actionConfig.secretLast4 (the final four characters) replaces actionConfig.webhookSecret. The full secret is returned exactly once, in the POST /v1/webinars/{id}/automations create response, and remains visible in the WebinarStack dashboard's automation editor for that rule. There is no rotate endpoint on this surface: secret rotation lives at /v1/webinars/{id}/webhooks/{webhookId}/rotate-secret, keyed by webhook subscription rather than by automation rule."},"CreateAutomationRequest":{"oneOf":[{"$ref":"#/components/schemas/CreateAutomationEmailVariant"},{"$ref":"#/components/schemas/CreateAutomationWebhookVariant"},{"$ref":"#/components/schemas/CreateAutomationIntegrationVariant"},{"$ref":"#/components/schemas/CreateAutomationMetaCapiVariant"}],"discriminator":{"propertyName":"actionType","mapping":{"email":"#/components/schemas/CreateAutomationEmailVariant","webhook":"#/components/schemas/CreateAutomationWebhookVariant","integration":"#/components/schemas/CreateAutomationIntegrationVariant","meta_capi":"#/components/schemas/CreateAutomationMetaCapiVariant"}},"description":"Create an automation rule. Discriminated by actionType: email | webhook | integration | meta_capi."},"CreateAutomationEmailVariant":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200,"description":"Human-readable rule name."},"triggerType":{"$ref":"#/components/schemas/AutomationTriggerType"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/AutomationCondition"},"default":[],"description":"AND-only condition array; empty means unconditional."},"delayMinutes":{"type":"integer","minimum":0,"default":0,"description":"Delay in minutes before executing the action."},"enabled":{"type":"boolean","default":true,"description":"Whether this rule is active."},"segmentId":{"type":["string","null"],"format":"uuid","description":"Segment ID (requires webinars.adaptive capability)."},"branchId":{"type":["string","null"],"format":"uuid","description":"Branch ID (requires webinars.adaptive capability)."},"actionType":{"type":"string","enum":["email"]},"actionConfig":{"$ref":"#/components/schemas/EmailActionConfig"}},"required":["name","triggerType","actionType","actionConfig"],"description":"Create an email automation rule."},"AutomationTriggerType":{"type":"string","enum":["registered","joined","left","no_show","watched_minutes","watched_percent","video_complete","live_complete","replay_started","replay_complete","cta_click","poll_response","time_elapsed","before_session","after_session","branch_taken","segment_completed","chat_response"],"description":"One of 18 internal trigger types."},"AutomationCondition":{"type":"object","properties":{"field":{"type":"string","minLength":1},"op":{"type":"string","enum":["==","!=",">=","<=",">","<","contains"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}},"required":["field","op","value"],"description":"A single condition in the automation conditions array (AND-only logic)."},"EmailActionConfig":{"type":"object","properties":{"subject":{"type":"string","minLength":1,"maxLength":200},"body":{"anyOf":[{"type":"string","minLength":1,"maxLength":10000},{"type":"object","properties":{"type":{"type":"string","enum":["doc"]},"content":{"type":"array","items":{}}},"required":["type","content"]}]},"fromName":{"type":"string","maxLength":100},"fromEmail":{"type":"string","format":"email"},"attachIcs":{"type":"boolean","default":false}},"required":["subject","body"],"description":"Action configuration for email automation rules."},"CreateAutomationWebhookVariant":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200,"description":"Human-readable rule name."},"triggerType":{"$ref":"#/components/schemas/AutomationTriggerType"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/AutomationCondition"},"default":[],"description":"AND-only condition array; empty means unconditional."},"delayMinutes":{"type":"integer","minimum":0,"default":0,"description":"Delay in minutes before executing the action."},"enabled":{"type":"boolean","default":true,"description":"Whether this rule is active."},"segmentId":{"type":["string","null"],"format":"uuid","description":"Segment ID (requires webinars.adaptive capability)."},"branchId":{"type":["string","null"],"format":"uuid","description":"Branch ID (requires webinars.adaptive capability)."},"actionType":{"type":"string","enum":["webhook"]},"actionConfig":{"type":"object","properties":{"webhookUrl":{"type":"string","format":"uri"},"webhookSecret":{"type":"string","minLength":1,"description":"HMAC signing secret (auto-generated if omitted)."}},"required":["webhookUrl"]}},"required":["name","triggerType","actionType","actionConfig"],"description":"Create a webhook automation rule. webhookSecret is auto-generated if omitted."},"CreateAutomationIntegrationVariant":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200,"description":"Human-readable rule name."},"triggerType":{"$ref":"#/components/schemas/AutomationTriggerType"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/AutomationCondition"},"default":[],"description":"AND-only condition array; empty means unconditional."},"delayMinutes":{"type":"integer","minimum":0,"default":0,"description":"Delay in minutes before executing the action."},"enabled":{"type":"boolean","default":true,"description":"Whether this rule is active."},"segmentId":{"type":["string","null"],"format":"uuid","description":"Segment ID (requires webinars.adaptive capability)."},"branchId":{"type":["string","null"],"format":"uuid","description":"Branch ID (requires webinars.adaptive capability)."},"actionType":{"type":"string","enum":["integration"]},"actionConfig":{"$ref":"#/components/schemas/IntegrationActionConfig"}},"required":["name","triggerType","actionType","actionConfig"],"description":"Create an integration automation rule. Provider must be connected."},"IntegrationActionConfig":{"type":"object","properties":{"provider":{"type":"string","enum":["kit","activecampaign","mailchimp","mailerlite"]},"action":{"type":"string","minLength":1},"params":{"type":"object","additionalProperties":{}}},"required":["provider","action"],"description":"Action configuration for integration automation rules (ESP connectors)."},"CreateAutomationMetaCapiVariant":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200,"description":"Human-readable rule name."},"triggerType":{"$ref":"#/components/schemas/AutomationTriggerType"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/AutomationCondition"},"default":[],"description":"AND-only condition array; empty means unconditional."},"delayMinutes":{"type":"integer","minimum":0,"default":0,"description":"Delay in minutes before executing the action."},"enabled":{"type":"boolean","default":true,"description":"Whether this rule is active."},"segmentId":{"type":["string","null"],"format":"uuid","description":"Segment ID (requires webinars.adaptive capability)."},"branchId":{"type":["string","null"],"format":"uuid","description":"Branch ID (requires webinars.adaptive capability)."},"actionType":{"type":"string","enum":["meta_capi"]},"actionConfig":{"$ref":"#/components/schemas/MetaCapiActionConfig"}},"required":["name","triggerType","actionType","actionConfig"],"description":"Create a Meta Pixel event (meta_capi) automation rule. Requires the Growth plan (403 FORBIDDEN, field plan). metaPixelId must be a pixel id of this account (400 VALIDATION_ERROR on actionConfig.metaPixelId otherwise)."},"MetaCapiActionConfig":{"type":"object","properties":{"metaPixelId":{"type":"string","format":"uuid","description":"id of a row from GET /v1/integrations/meta-pixels — not Meta’s pixelId."},"eventName":{"type":"string","minLength":1,"maxLength":100,"description":"One of Meta's standard event names (AddPaymentInfo, AddToCart, AddToWishlist, CompleteRegistration, Contact, CustomizeProduct, Donate, FindLocation, InitiateCheckout, Lead, Purchase, Schedule, Search, StartTrial, SubmitApplication, Subscribe, ViewContent) or a custom event name matching ^[A-Za-z0-9_]{1,50}$. PageView is rejected — it cannot be sent server-side."},"customData":{"type":"array","items":{"$ref":"#/components/schemas/MetaCapiCustomDataPair"},"maxItems":50,"description":"Custom data key/value pairs sent with the event. Allowed personalization token names in a value: webinar_title, session_date, session_time, session_timezone, host_name, offer_name, watched_percent, watched_minutes. Attendee PII tokens (attendee_name, attendee_email, attendee_phone) and link tokens (watch_link, replay_link, unsubscribe_link, chat_message) are rejected. The reserved keys value and currency must be sent together, with currency an ISO-4217 code."}},"required":["metaPixelId","eventName"],"description":"Action configuration for Meta Pixel event (meta_capi) automation rules. Mirrors metaCapiActionConfigSchema in src/lib/schemas/automation.ts; see the MCP resource webinarstack://docs/meta-pixel-authoring."},"MetaCapiCustomDataPair":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":100},"value":{"type":"string","maxLength":500}},"required":["key","value"],"description":"A single custom_data key/value pair for a Meta Pixel event (meta_capi) automation rule."},"PatchAutomationRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"triggerType":{"$ref":"#/components/schemas/AutomationTriggerType"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/AutomationCondition"}},"actionType":{"type":"string","enum":["email","webhook","integration","meta_capi"]},"actionConfig":{"type":"object","additionalProperties":{},"description":"Action config for the rule. Shape depends on actionType."},"delayMinutes":{"type":"integer","minimum":0},"enabled":{"type":"boolean"},"segmentId":{"type":["string","null"],"format":"uuid"},"branchId":{"type":["string","null"],"format":"uuid"}},"description":"Partial update for an automation rule. At least one field required (enforced server-side)."},"AutomationExecution":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"ruleId":{"type":"string","format":"uuid"},"registrationId":{"type":["string","null"],"format":"uuid","description":"Registration that triggered this execution; null if registration was purged."},"sessionStartsAt":{"type":"string","format":"date-time"},"messageEventId":{"type":["string","null"],"format":"uuid","description":"Opaque reference to the dispatched message event; null if no message was sent or if the event row was retention-purged (Pitfall 6 — never JOINed on read)."},"status":{"type":"string","enum":["dispatched","success","failure","retried"],"description":"Execution status."},"executedAt":{"type":"string","format":"date-time"}},"required":["id","ruleId","registrationId","sessionStartsAt","messageEventId","status","executedAt"],"description":"A single automation execution ledger row. messageEventId is opaque and nullable — it is never JOINed to message_events on read (Pitfall 6)."},"Interaction":{"oneOf":[{"$ref":"#/components/schemas/CtaInteraction"},{"$ref":"#/components/schemas/PollInteraction"}],"discriminator":{"propertyName":"type","mapping":{"cta":"#/components/schemas/CtaInteraction","poll":"#/components/schemas/PollInteraction"}},"description":"An interaction (poll or CTA offer). Discriminated union on the `type` field: \"cta\" or \"poll\". See webinarstack://docs/interaction-authoring for field documentation and worked examples."},"CtaInteraction":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"webinarId":{"type":"string","format":"uuid"},"accountId":{"type":"string","format":"uuid"},"timeline":{"type":"string","enum":["live","replay"]},"appearsAtSeconds":{"type":"integer","minimum":0},"endsAtSeconds":{"type":"integer","minimum":0},"headline":{"type":"string"},"internalName":{"type":["string","null"],"description":"Host-only internal label. Included on host-side reads per D-10."},"imageUrl":{"type":["string","null"]},"segmentId":{"type":["string","null"],"format":"uuid","description":"Always null in v1.31 (D-08a). Exposed for v2 forward-compat."},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time","description":"D-08c: added in Phase 163. Set by DEFAULT now() on creation; explicitly stamped by Phase 164/165 writes."},"type":{"type":"string","enum":["cta"]},"description":{"type":["string","null"]},"buttonLabel":{"type":["string","null"]},"buttonUrl":{"type":["string","null"]},"buttonColor":{"type":["string","null"]},"buttonTextColor":{"type":["string","null"]},"iconName":{"type":["string","null"]},"countdownSeconds":{"type":["integer","null"]},"countdownMode":{"type":["string","null"],"enum":["none","fixed","until_end",null],"description":"Countdown behavior: 'none', 'fixed' (uses countdownSeconds), or 'until_end' (counts down to the webinar video end)."},"attributionWindowDays":{"type":"integer","description":"D-08b: attribution window in days for offer conversion tracking. Default 7."}},"required":["id","webinarId","accountId","timeline","appearsAtSeconds","endsAtSeconds","headline","internalName","imageUrl","segmentId","createdAt","updatedAt","type","description","buttonLabel","buttonUrl","buttonColor","buttonTextColor","iconName","countdownSeconds","countdownMode","attributionWindowDays"],"description":"CTA interaction response shape (type=cta). Includes attributionWindowDays for offer conversion tracking. See webinarstack://docs/interaction-authoring for field documentation."},"PollInteraction":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"webinarId":{"type":"string","format":"uuid"},"accountId":{"type":"string","format":"uuid"},"timeline":{"type":"string","enum":["live","replay"]},"appearsAtSeconds":{"type":"integer","minimum":0},"endsAtSeconds":{"type":"integer","minimum":0},"headline":{"type":"string"},"internalName":{"type":["string","null"],"description":"Host-only internal label. Included on host-side reads per D-10."},"imageUrl":{"type":["string","null"]},"segmentId":{"type":["string","null"],"format":"uuid","description":"Always null in v1.31 (D-08a). Exposed for v2 forward-compat."},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time","description":"D-08c: added in Phase 163. Set by DEFAULT now() on creation; explicitly stamped by Phase 164/165 writes."},"type":{"type":"string","enum":["poll"]},"options":{"type":["array","null"],"items":{"type":"string"},"description":"Legacy flat string array of option labels."},"optionSpecs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"}},"required":["id","label"]},"description":"Rich option specs with stable IDs for attribution and analytics."},"choiceMode":{"type":"string","enum":["single","multi"]},"resultsDisplayMode":{"type":"string","enum":["off","session","historical","custom"]},"aggregateMinVotes":{"type":"integer","minimum":0},"customAggregatePercentages":{"type":["object","null"],"additionalProperties":{"type":"number"}}},"required":["id","webinarId","accountId","timeline","appearsAtSeconds","endsAtSeconds","headline","internalName","imageUrl","segmentId","createdAt","updatedAt","type","options","optionSpecs","choiceMode","resultsDisplayMode","aggregateMinVotes","customAggregatePercentages"],"description":"Poll interaction response shape (type=poll). Includes choiceMode, resultsDisplayMode, optionSpecs, and aggregateMinVotes. See webinarstack://docs/interaction-authoring for field documentation."},"InteractionBody":{"oneOf":[{"$ref":"#/components/schemas/CtaBody"},{"$ref":"#/components/schemas/PollBody"}],"discriminator":{"propertyName":"type","mapping":{"cta":"#/components/schemas/CtaBody","poll":"#/components/schemas/PollBody"}},"description":"Request body for creating or updating a poll or CTA interaction. Discriminated on the `type` field: \"cta\" for a call-to-action offer overlay, \"poll\" for an audience poll. CTA required fields: type, webinarId, appearsAtSeconds, endsAtSeconds, headline. Poll required fields: type, webinarId, appearsAtSeconds, endsAtSeconds, headline, options. CTA optional fields: description, buttonLabel, buttonUrl, countdownSeconds, countdownMode, buttonColor, buttonTextColor, iconName, imageUrl, timeline, internalName. Poll optional fields: choiceMode, resultsDisplayMode, aggregateMinVotes, optionSpecs, customAggregatePercentages, imageUrl, timeline, internalName. Available CTA icon names: ShoppingCart, Zap, Gift, ArrowRight, Star. buttonColor must match regex ^#[0-9A-Fa-f]{6}$. Poll choiceMode values: single, multi. Poll resultsDisplayMode values: off, session, historical, custom. Poll options array: 2–8 items. aggregateMinVotes range: 0–1000. Timeline: appearsAtSeconds and endsAtSeconds are seconds from video start; endsAtSeconds must be strictly greater than appearsAtSeconds. See the MCP resource webinarstack://docs/interaction-authoring for worked examples and the full authoring guide."},"CtaBody":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid","description":"Webinar UUID"},"appearsAtSeconds":{"type":"integer","minimum":0,"description":"Seconds into the video when the interaction appears."},"endsAtSeconds":{"type":"integer","minimum":1,"description":"Seconds into the video when the interaction ends. Must be greater than appearsAtSeconds."},"headline":{"type":"string","minLength":1,"maxLength":200,"description":"Main headline shown to attendees."},"timeline":{"type":"string","enum":["live","replay"],"description":"Whether the interaction appears during live playback, replay, or both. Defaults to live."},"imageUrl":{"type":"string","format":"uri","description":"Optional image URL to display alongside the interaction."},"internalName":{"type":["string","null"],"maxLength":200,"description":"Host-only internal label. Not shown to attendees."},"type":{"type":"string","enum":["cta"]},"description":{"type":"string","maxLength":500,"description":"Optional body copy shown below the headline."},"buttonLabel":{"type":"string","minLength":1,"maxLength":80,"description":"CTA button label."},"buttonUrl":{"type":"string","format":"uri","description":"URL opened when the attendee clicks the CTA button."},"countdownSeconds":{"type":"integer","minimum":0,"description":"Optional countdown timer in seconds shown on the CTA."},"countdownMode":{"type":"string","enum":["none","fixed","until_end"],"description":"Countdown behavior: 'none', 'fixed' (uses countdownSeconds), or 'until_end' (counts down to the webinar video end)."},"buttonColor":{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$","description":"Hex color code for the button (e.g. #FF5733)."},"buttonTextColor":{"anyOf":[{"type":"string","enum":["auto"]},{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$"},{"type":"null"}],"description":"Offer button text color: 'auto' (contrast-picked), or a #RRGGBB hex."},"iconName":{"type":["string","null"],"enum":["ShoppingCart","Zap","Gift","ArrowRight","Star",null],"description":"Optional icon displayed on the CTA button. Valid values: ShoppingCart, Zap, Gift, ArrowRight, Star."}},"required":["webinarId","appearsAtSeconds","endsAtSeconds","headline","type"],"description":"Request body for a CTA (call-to-action offer) interaction. type must be \"cta\". All base fields plus CTA-specific optional fields. See webinarstack://docs/interaction-authoring for the full authoring guide and worked example."},"PollBody":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid","description":"Webinar UUID"},"appearsAtSeconds":{"type":"integer","minimum":0,"description":"Seconds into the video when the interaction appears."},"endsAtSeconds":{"type":"integer","minimum":1,"description":"Seconds into the video when the interaction ends. Must be greater than appearsAtSeconds."},"headline":{"type":"string","minLength":1,"maxLength":200,"description":"Main headline shown to attendees."},"timeline":{"type":"string","enum":["live","replay"],"description":"Whether the interaction appears during live playback, replay, or both. Defaults to live."},"imageUrl":{"type":"string","format":"uri","description":"Optional image URL to display alongside the interaction."},"internalName":{"type":["string","null"],"maxLength":200,"description":"Host-only internal label. Not shown to attendees."},"type":{"type":"string","enum":["poll"]},"options":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"minItems":2,"maxItems":8,"description":"Poll answer options (2–8 items). The service derives optionSpecs from these when optionSpecs is not provided."},"choiceMode":{"type":"string","enum":["single","multi"],"description":"Whether attendees may select one or multiple answers. Defaults to single."},"resultsDisplayMode":{"type":"string","enum":["off","session","historical","custom"],"description":"How poll results are displayed after voting. Defaults to session."},"aggregateMinVotes":{"type":"integer","minimum":0,"maximum":1000,"description":"Minimum votes before aggregate results are shown. Range: 0–1000. Defaults to 25."},"customAggregatePercentages":{"type":["object","null"],"additionalProperties":{"type":"number","minimum":0,"maximum":100},"description":"Custom display percentages keyed by optionSpecs[].id. Keys must reference optionSpecs IDs."},"optionSpecs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"label":{"type":"string","minLength":1}},"required":["id","label"]},"description":"Rich option specs with stable UUIDs for analytics attribution. Auto-derived from options when omitted."}},"required":["webinarId","appearsAtSeconds","endsAtSeconds","headline","type","options"],"description":"Request body for a poll interaction. type must be \"poll\". options (2–8 items) is required; choiceMode, resultsDisplayMode, aggregateMinVotes (0–1000) are optional with defaults. See webinarstack://docs/interaction-authoring for the full authoring guide and worked example."},"BuiltInTrigger":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"ipaasExposed":{"type":"boolean"},"dashboardGroup":{"type":"string","enum":["behavior","time","branch"]},"parameters":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"label":{"type":"string"},"type":{"type":"string","enum":["number","string"]},"required":{"type":"boolean"},"min":{"type":"number"},"max":{"type":"number"},"description":{"type":"string"}},"required":["name","label","type","required","description"]}},"payloadFields":{"type":"array","items":{"type":"string"}},"samplePayload":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"required":["id","label","description","ipaasExposed","dashboardGroup","parameters","payloadFields","samplePayload"],"description":"A built-in webinar behavior trigger available to the Zapier and Make automation apps."},"MetaPixelSummary":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"meta_pixels row id — use this as actionConfig.metaPixelId"},"label":{"type":["string","null"]},"pixelId":{"type":"string","description":"Meta's own pixel ID — informational; NOT accepted as metaPixelId"},"status":{"type":"string","enum":["connected","paused","error"]},"lastSuccessAt":{"type":["string","null"],"format":"date-time"},"metaPixelName":{"type":["string","null"]},"errorMessage":{"type":["string","null"],"description":"Meta's error text as stored, token-scrubbed"},"errorAt":{"type":["string","null"],"format":"date-time"},"consentRequired":{"type":"boolean"},"lduEnabled":{"type":"boolean"}},"required":["id","label","pixelId","status","lastSuccessAt","metaPixelName","errorMessage","errorAt","consentRequired","lduEnabled"],"description":"A connected Meta pixel summary. Access tokens and test-event codes are never returned."},"IntegrationIdentity":{"type":"object","properties":{"accountId":{"type":"string","format":"uuid"},"accountName":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["accountId","accountName","scopes"],"description":"The authenticated account's identity: id, display name (used as the connection label), and the verified key's own scopes."},"FindRegistrationsByEmailResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/RegistrationLookupItem"}},"meta":{"type":"object","properties":{"nextCursor":{"type":["string","null"]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]}},"required":["data","meta"],"description":"Every registration in the account matching the queried email address, newest registered first, page-limited."},"RegistrationLookupItem":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"webinarId":{"type":"string","format":"uuid"},"email":{"type":"string"},"name":{"type":"string"},"sessionStartsAt":{"type":"string"},"registeredAt":{"type":"string"},"accessUrl":{"type":"string"}},"required":["id","webinarId","email","name","sessionStartsAt","registeredAt","accessUrl"],"description":"A single registration matching the queried email address. `accessUrl` is the attendee's unique join link — treat it as a bearer credential, never log or audit it."},"CreateIpaasSubscriptionResult":{"type":"object","properties":{"id":{"type":"string"},"platform":{"type":"string","enum":["zapier","make"]},"webinarId":{"type":"string","format":"uuid"},"triggerKey":{"type":"string"},"triggerType":{"type":"string"},"targetUrl":{"type":"string"},"connectionLabel":{"type":"string"},"externalId":{"type":["string","null"]},"externalName":{"type":["string","null"]},"sourceAutomationRuleId":{"type":["string","null"]},"active":{"type":"boolean"},"createdAt":{"type":"string"}},"required":["id","platform","webinarId","triggerKey","triggerType","targetUrl","connectionLabel","externalId","externalName","sourceAutomationRuleId","active","createdAt"],"description":"The newly created subscription. `id` lands at `data.id` in the envelope because Zapier reads `bundle.subscribeData.id` — this constraint is load-bearing for the Zapier app."},"CreateZapierSubscriptionRequest":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"triggerKey":{"type":"string"},"targetUrl":{"type":"string","format":"uri"},"connectionLabel":{"type":"string","minLength":1,"maxLength":120},"externalId":{"type":["string","null"],"maxLength":200},"externalName":{"type":["string","null"],"maxLength":200},"threshold":{"type":"integer","minimum":1,"maximum":100},"automationRuleId":{"type":"string","format":"uuid"}},"required":["webinarId","triggerKey","targetUrl","connectionLabel"],"description":"Subscribes a Zap to a WebinarStack behavior trigger. `platform` is implied by the path and must not be included."},"CreateMakeSubscriptionRequest":{"type":"object","properties":{"webinarId":{"type":"string","format":"uuid"},"triggerKey":{"type":"string"},"targetUrl":{"type":"string","format":"uri"},"connectionLabel":{"type":"string","minLength":1,"maxLength":120},"externalId":{"type":["string","null"],"maxLength":200},"externalName":{"type":["string","null"],"maxLength":200},"threshold":{"type":"integer","minimum":1,"maximum":100},"automationRuleId":{"type":"string","format":"uuid"}},"required":["webinarId","triggerKey","targetUrl","connectionLabel"],"description":"Subscribes a Make scenario to a WebinarStack behavior trigger. `platform` is implied by the path and must not be included."}},"parameters":{}},"paths":{"/webinars":{"get":{"operationId":"listWebinars","tags":["Webinars"],"summary":"List webinars","description":"Returns a paginated list of webinars scoped to your account.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Pagination cursor (UUID) from previous response"},"required":false,"description":"Pagination cursor (UUID) from previous response","name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Number of items to return (1–100, default 25)"},"required":false,"description":"Number of items to return (1–100, default 25)","name":"limit","in":"query"},{"schema":{"type":"string","enum":["published","draft","all"],"default":"published","description":"Filter by webinar status (default: published)"},"required":false,"description":"Filter by webinar status (default: published)","name":"status","in":"query"}],"responses":{"200":{"description":"Paginated list of webinars (canonical envelope per Phase 153 D-05)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WebinarListItem"}},"meta":{"type":"object","properties":{"nextCursor":{"type":["string","null"],"description":"Pass as cursor in the next request to get the next page. null when no more pages."},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]}},"required":["data","meta"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createWebinar","tags":["Webinars"],"summary":"Create webinar draft","description":"Creates a new draft webinar scoped to your account. Returns 201 with a Location header pointing at the new resource.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebinarBody"}}}},"responses":{"201":{"description":"Webinar draft created","headers":{"Location":{"description":"Path to the newly created webinar resource","schema":{"type":"string"}},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebinarResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}":{"get":{"operationId":"getWebinar","tags":["Webinars"],"summary":"Get webinar","description":"Returns the full detail of a single webinar including all sessions.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"responses":{"200":{"description":"Webinar detail (canonical envelope per Phase 153 D-05)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/WebinarDetail"},"meta":{"type":"object","properties":{}}},"required":["data","meta"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteWebinar","tags":["Webinars"],"summary":"Soft-delete a webinar","description":"Soft-deletes a webinar by setting `deletedAt = now()`. Returns 204 No Content. Subsequent reads (single-resource GET + list GET + any PATCH/POST verb) return 404 NOT_FOUND — soft-deleted webinars are invisible to every API surface. Non-idempotent by contract: re-deleting an already-soft-deleted webinar returns 404. Hard-deletion remains operator-only via the GDPR runbook (no API surface in v1.29).","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"responses":{"204":{"description":"Webinar soft-deleted","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/core-details":{"patch":{"operationId":"updateWebinarCoreDetails","tags":["Webinars"],"summary":"Update webinar core details","description":"Patches the webinar title, slug, description, host display name, and related core fields.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCoreDetailsBody"}}}},"responses":{"200":{"description":"Core details updated","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsUpdateResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/branding":{"patch":{"operationId":"updateWebinarBranding","tags":["Webinars"],"summary":"Update webinar branding","description":"Patches logo, color palette, host avatar, and branded headline / header image.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateBrandingBody"}}}},"responses":{"200":{"description":"Branding settings updated","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsUpdateResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/widget/style":{"get":{"operationId":"getWebinarWidgetStyle","tags":["Webinars"],"summary":"Get widget style","description":"Returns the widget's draft and published style and updatedAt. Requires scope webinars:read. This changes the widget's style object only. It is not page-builder authoring: it cannot add, remove or edit blocks or form fields.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"responses":{"200":{"description":"The widget draft and published style","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/WidgetStyleResponse"},"meta":{"type":"object","properties":{}}},"required":["data"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateWebinarWidgetStyle","tags":["Webinars"],"summary":"Update widget style","description":"Applies a JSON merge patch (RFC 7396) to the widget's draft style. The live widget does not change until you call publish. Requires scope webinars:write. This changes the widget's style object only. It is not page-builder authoring: it cannot add, remove or edit blocks or form fields. Writable in this version: the modal options host.modalWidth (integer 320-1200), host.modalPosition (center, drawer-right or sheet-bottom), host.modalChrome (frame or surface), host.overlayColor (a colour), host.overlayOpacity (0 to 1 in steps of 0.05), host.overlayBlur (integer 0-24), host.modalAnimation (none, fade, scale, slide-up or slide-right; skipped for visitors who prefer reduced motion), host.closeStyle (inside or floating; floating falls back to inside on drawers, sheets and phones) and host.mobileModal (inset, fullscreen or sheet; decides the layout below 640px), and the trigger options host.triggerColor, host.triggerStyle (solid, soft, outline or dark), host.triggerShape (rounded-sm, rounded or pill), host.triggerSize (md, lg or xl), host.triggerIcon (none, arrow or play) and host.triggerFont (system or inherit). An absent host.triggerColor follows the brand. host.modalWidth and host.triggerColor override the embed-card values, and a snippet data-* attribute still wins. The form options are also writable: surface (bg, maxWidth, borderWidth, borderColor, radius, shadow, padding), typography (headingFont, bodyFont, headingScale, headingWeight, align), header (logoPlacement, kickerStyle, trustStyle), fields (labelStyle, fieldStyle, fieldBorder, fieldRadius, fieldSize, fieldBg), button (buttonStyle, buttonShape, buttonWidth, buttonSize, buttonIcon, buttonColor), session picker (sessionStyle), countdown (countdownStyle) and layout (blockSpacing, blockTitle). Colour values accept hex (#rgb, #rrggbb), rgb() or rgba(), and some colours also take a keyword (bg: transparent, borderColor: auto, fieldBg: auto or translucent). An absent headingFont or bodyFont follows the webinar theme font. The dark and transparent options are writable too: surface (card, flat, glass or none), colorScheme (light or dark), textTone (auto, dark or light), layout (stacked or split) and, for the split layout, panelBg (brand, deep or a colour) and panelTone (auto, light or dark). null removes an option so it falls back to its default. Two combinations are refused after the patch is merged with the draft. A surface of none needs a textTone of dark or light: \"textTone must be dark or light when surface is none.\" A surface of glass is for modal widgets only: \"surface glass is available for modal widgets only.\" Because the check runs on the merged style, a patch of surface none passes when the draft already has textTone dark or light. A PATCH of colorScheme sets only the scheme and leaves the background and border colours as they are. To switch the scheme and also swap the default background and border colours (white and automatic for light, dark values for dark), use the colour scheme switch operation, POST /v1/webinars/{id}/widget/color-scheme. Layout changes go through the layout operation, POST /v1/webinars/{id}/widget/layout, which moves the blocks between the brand panel and the form side and sets the layout option in one write. A style PATCH that changes layout without the blocks moving is refused. Last write wins. Responses include updatedAt. An editor tab that is open on this widget can autosave over a draft written through the API.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWidgetStyleBody"}}}},"responses":{"200":{"description":"The draft after the patch, with the published style and updatedAt","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/WidgetStyleResponse"},"meta":{"type":"object","properties":{}}},"required":["data"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/widget/publish":{"post":{"operationId":"publishWebinarWidget","tags":["Webinars"],"summary":"Publish widget","description":"Publishes the widget draft to the live widget. Requires scope webinars:write. Publishing copies the whole widget draft, including any unpublished editor changes to its content, to the live widget, exactly like the editor's Publish button. For about 45 to 60 seconds after each publish or branding change, the live modal chrome can briefly wrap the previous form while the CDN snapshot refreshes; it heals on its own. Last write wins. Responses include updatedAt. An editor tab that is open on this widget can autosave over a draft written through the API.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"responses":{"200":{"description":"The published style, publish time and whether anything changed","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/WidgetPublishResponse"},"meta":{"type":"object","properties":{}}},"required":["data"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/widget/designs":{"get":{"operationId":"listWebinarWidgetDesigns","tags":["Webinars"],"summary":"List widget designs","description":"Returns the designs this widget's mode can use, in gallery order with thumbnails, and the design on its draft with the style options changed since it was applied. Designs that are not available yet are not listed. Requires scope webinars:read. This writes the widget DRAFT only. It cannot publish; the live widget does not change until the creator publishes, exactly like a draft edit in the editor.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"responses":{"200":{"description":"The designs this widget can use and the design on its draft","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/WidgetDesignListResponse"},"meta":{"type":"object","properties":{}}},"required":["data"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/widget/design":{"post":{"operationId":"applyWebinarWidgetDesign","tags":["Webinars"],"summary":"Apply widget design","description":"Applies a design from the widget design gallery to the widget's draft. Requires scope webinars:write. This writes the widget DRAFT only. It cannot publish; the live widget does not change until the creator publishes, exactly like a draft edit in the editor. extraBlocks 'keep' places the blocks you added after the design's blocks, in their order. 'drop' leaves them out. Blocks holding a form, a session picker or a countdown are always left out. The heading, subheading, logo, session picker, countdown and the form's consent, GDPR, SMS and phone settings are kept. The trigger text is never changed. Last write wins. Responses include updatedAt. An editor tab that is open on this widget can autosave over a draft written through the API. If the widget draft changed while the design was being applied, the call returns CONFLICT and nothing is saved; read the widget again and retry.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplyWidgetDesignBody"}}}},"responses":{"200":{"description":"The stored draft style, the design applied, the blocks the apply left out and any kicker it added","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/WidgetDesignApplyResponse"},"meta":{"type":"object","properties":{}}},"required":["data"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict. Either the Idempotency-Key was reused with a different request body or a prior request under the same key is still processing, or the widget draft changed while the design was being saved (The widget draft changed while the design was being saved. Nothing was saved. Read the widget again and retry).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/widget/design/reset":{"post":{"operationId":"resetWebinarWidgetDesign","tags":["Webinars"],"summary":"Reset widget design options","description":"Puts the draft style options back to the design the widget was applied from: every option, or only the keys you name. Blocks and copy are not changed. A widget with no known design returns 412; apply a design first. Requires scope webinars:write. This writes the widget DRAFT only. It cannot publish; the live widget does not change until the creator publishes, exactly like a draft edit in the editor. Last write wins. Responses include updatedAt. An editor tab that is open on this widget can autosave over a draft written through the API. If the widget draft changed while the design was being applied, the call returns CONFLICT and nothing is saved; read the widget again and retry.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetWidgetDesignBody"}}}},"responses":{"200":{"description":"The stored draft style after the reset and the design on the draft","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/WidgetDesignResetResponse"},"meta":{"type":"object","properties":{}}},"required":["data"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict. Either the Idempotency-Key was reused with a different request body or a prior request under the same key is still processing, or the widget draft changed while the design was being saved (The widget draft changed while the design was being saved. Nothing was saved. Read the widget again and retry).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"412":{"description":"The widget has no known design to reset to. Apply a design first.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/widget/color-scheme":{"post":{"operationId":"switchWebinarWidgetColorScheme","tags":["Webinars"],"summary":"Switch widget colour scheme","description":"Switches the widget's draft between the light and dark colour scheme and swaps the default background and border colours with it. Requires scope webinars:write. This writes the widget DRAFT only. It cannot publish; the live widget does not change until the creator publishes, exactly like a draft edit in the editor. Switching to dark also changes the background and the border colour when they are still at their light defaults (white and automatic); a colour the creator chose is kept. Switching back to light puts those two defaults back. Selecting the scheme already in place changes nothing. A PATCH of colorScheme sets only the scheme and leaves the background and border colours as they are. To switch the scheme and also swap the default background and border colours (white and automatic for light, dark values for dark), use the colour scheme switch operation, POST /v1/webinars/{id}/widget/color-scheme. Last write wins. Responses include updatedAt. An editor tab that is open on this widget can autosave over a draft written through the API. If the widget draft changed while the scheme was being saved, the call returns CONFLICT and nothing is saved; read the widget again and retry.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwitchWidgetColorSchemeBody"}}}},"responses":{"200":{"description":"The draft style after the switch and the style keys the switch changed","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/WidgetColorSchemeResponse"},"meta":{"type":"object","properties":{}}},"required":["data"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict. Either the Idempotency-Key was reused with a different request body or a prior request under the same key is still processing, or the widget draft changed while the scheme was being saved. Nothing was saved. Read the widget again and retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/widget/layout":{"post":{"operationId":"setWebinarWidgetLayout","tags":["Webinars"],"summary":"Set widget layout","description":"Switches the widget's draft between the stacked and split layout, moving the blocks between the brand panel and the form side. Requires scope webinars:write. This writes the widget DRAFT only. It cannot publish; the live widget does not change until the creator publishes, exactly like a draft edit in the editor. Switching to split moves the kicker, heading, subheading, trust line and countdown into the brand panel and keeps the registration form and session picker on the form side. Switching back to stacked puts the blocks back in the order of the design the widget was applied from. Selecting the layout already in place changes nothing. Layout changes go through the layout operation, POST /v1/webinars/{id}/widget/layout, which moves the blocks between the brand panel and the form side and sets the layout option in one write. A style PATCH that changes layout without the blocks moving is refused. Last write wins. Responses include updatedAt. An editor tab that is open on this widget can autosave over a draft written through the API. If the widget draft changed while the layout was being saved, the call returns CONFLICT and nothing is saved; read the widget again and retry.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetWidgetLayoutBody"}}}},"responses":{"200":{"description":"The draft style after the change, the layout now in place and the blocks that changed pane","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/WidgetLayoutResponse"},"meta":{"type":"object","properties":{}}},"required":["data"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict. Either the Idempotency-Key was reused with a different request body or a prior request under the same key is still processing, or the widget draft changed while the layout was being saved. Nothing was saved. Read the widget again and retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/video-provider":{"patch":{"operationId":"updateWebinarVideoProvider","tags":["Webinars"],"summary":"Update webinar or segment video provider","description":"Sets the video provider (YouTube, Vimeo, or WebinarStack CDN) at webinar or segment scope. Provider-canonical references are returned in the response so clients can confirm what was written.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateVideoProviderBody"}}}},"responses":{"200":{"description":"Video provider updated","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateVideoProviderResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/schedule":{"patch":{"operationId":"configureWebinarSchedule","tags":["Webinars"],"summary":"Configure webinar schedule (fixed | recurring | jit)","description":"Sets the webinar schedule via a discriminated union body. `kind: \"fixed\"` accepts an explicit list of session start times; `kind: \"recurring\"` accepts a weekly day/time grid + host timezone; `kind: \"jit\"` accepts an interval (5/10/15/30/60 minutes). Modes are additive — separate calls can configure multiple modes on the same webinar without clearing each other.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfigureScheduleBody"}}}},"responses":{"200":{"description":"Schedule configured; response includes a preview of upcoming sessions","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfigureScheduleResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/replay-defaults":{"patch":{"operationId":"updateWebinarReplayDefaults","tags":["Webinars"],"summary":"Update webinar replay defaults","description":"Patches replay expiry, redirect rules, replay video URL, chat mode, and scrubbing policy.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateReplayDefaultsBody"}}}},"responses":{"200":{"description":"Replay defaults updated","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsUpdateResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/registration-page":{"patch":{"operationId":"updateWebinarRegistrationPage","tags":["Webinars"],"summary":"Update webinar registration page basics","description":"Patches the registration page hero headline / subhead, session picker heading, and registration form submit label / privacy note. Returns the list of block types that were actually rewritten.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRegistrationPageBody"}}}},"responses":{"200":{"description":"Registration page basics updated","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRegistrationPageResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/offer-replay":{"patch":{"operationId":"updateWebinarOfferReplay","tags":["Webinars"],"summary":"Update webinar offer (CTA) and replay basics","description":"Upserts the timeline-scoped CTA interaction for this webinar (live or replay) and optionally patches replay defaults. The runtime constraint `endsAtSeconds > appearsAtSeconds` is enforced at the boundary.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateOfferReplayBody"}}}},"responses":{"200":{"description":"Offer and replay basics updated","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateOfferReplayResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}:publish":{"post":{"operationId":"publishWebinar","tags":["Webinars"],"summary":"Publish a webinar","description":"Transitions a webinar to status `published`. Idempotent: re-publishing returns `alreadyPublished: true` with no state change. Per the v1.29 lifecycle decision, publishing an archived webinar transitions it directly to published (implicit unarchive; an explicit `:unarchive` verb may land in a later milestone). A webinar that is not publish-ready is rejected with 422 `PUBLISH_BLOCKED` and the list of unresolved blockers — there is no `force` bypass. Note: a 422 blocked response is cached and replayed verbatim under the same Idempotency-Key, so after resolving the blockers you must retry with a NEW Idempotency-Key.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"responses":{"200":{"description":"Webinar published (or already published)","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishWebinarResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Publish blocked — the webinar is not publish-ready. The body carries the array of unresolved blockers. Resolve them and retry with a new Idempotency-Key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishBlockedResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}:archive":{"post":{"operationId":"archiveWebinar","tags":["Webinars"],"summary":"Archive a webinar","description":"Transitions a webinar to status `archived`. Idempotent: re-archiving returns `alreadyArchived: true` with no state change. Archived webinars stay readable via GET /v1/webinars/{id} (with status: \"archived\") and are excluded from the default list filter (use `?status=all` to include them). Soft-deletion is a separate axis — see DELETE /v1/webinars/{id}.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"responses":{"200":{"description":"Webinar archived (or already archived)","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArchiveWebinarResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}:duplicate":{"post":{"operationId":"duplicateWebinar","tags":["Webinars"],"summary":"Duplicate a webinar","description":"Creates a tenant-scoped clone of the source webinar. The duplicate inherits every webinar setting (branding, video, replay defaults, etc.) EXCEPT: a new id and slug (`{source-slug}-copy` on first attempt; nanoid suffix appended on collision), `status: \"draft\"`, scheduling cleared (no sessions / schedule rules / blackout dates copied), automations and webhooks NOT copied (Phase 156 scope), and `replayExpiresAt: null`. Returns 201 Created with a Location header pointing at the new resource and the full new webinar detail in the response body.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Source webinar UUID"},"required":true,"description":"Source webinar UUID","name":"id","in":"path"}],"responses":{"201":{"description":"Webinar duplicated","headers":{"Location":{"description":"Path to the newly created duplicate","schema":{"type":"string"}},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicateWebinarResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/sessions":{"get":{"operationId":"listSessions","tags":["Sessions"],"summary":"List sessions for a webinar","description":"Returns upcoming session slots for a webinar. Fixed sessions return their DB UUID; recurring and JIT slots return synthetic `slot_<base64url>` IDs. Pass `?includePast=true` to include past fixed sessions in the response. Soft-deleted webinars return 404 (Pitfall D).","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"boolean","default":false},"required":false,"name":"includePast","in":"query"}],"responses":{"200":{"description":"Paginated session list with timezone metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListSessionsResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/sessions/{sessionId}":{"get":{"operationId":"getSession","tags":["Sessions"],"summary":"Get a single session","description":"Returns a single session slot by UUID (fixed) or synthetic `slot_<base64url>` ID (recurring/jit). All 404 paths return the same error shape — past slots, malformed IDs, and cross-webinar mismatches are indistinguishable to the caller (OQ-5 enumeration guard).","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","minLength":1,"description":"Session UUID or synthetic slot_<base64url> ID"},"required":true,"description":"Session UUID or synthetic slot_<base64url> ID","name":"sessionId","in":"path"}],"responses":{"200":{"description":"Single session slot","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetSessionResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/sessions/{sessionId}/force-progress":{"post":{"operationId":"forceProgressSession","tags":["Sessions"],"summary":"Force-progress a test attendee through a session","description":"Advances a test registration's `effectiveSessionStartsAt` by `advanceSeconds`. Only test registrations (utm.source ∈ {mcp-test-registration, api-test-registration}) may be force-progressed — production registrations return 403 FORBIDDEN_NOT_TEST. The non-existent registration path returns 404 BEFORE the test-mode check (OQ-2 — no info leak). Requires `sessions:write` scope. Idempotency-Key is recommended for retries.","security":[{"BearerAuth":[]}],"parameters":[{"name":"X-Test-Mode","in":"header","required":false,"schema":{"type":"string","enum":["true"]},"description":"Pass X-Test-Mode: true to signal test context. The service enforces UTM sentinel regardless."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","minLength":1,"description":"Session UUID or synthetic slot_<base64url> ID"},"required":true,"description":"Session UUID or synthetic slot_<base64url> ID","name":"sessionId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForceProgressRequest"}}}},"responses":{"200":{"description":"effectiveSessionStartsAt updated","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForceProgressResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"FORBIDDEN_NOT_TEST — registration is not a test registration (category: test_mode_operation)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/sessions/{sessionId}/reset":{"post":{"operationId":"resetSession","tags":["Sessions"],"summary":"Reset a test attendee to the original session start time","description":"Restores a test registration's `effectiveSessionStartsAt` back to the original `sessionStartsAt`. The event log is preserved (D-08). Same access control as force-progress: only test registrations may be reset; non-existent registration returns 404 before the 403 check. Requires `sessions:write` scope.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","minLength":1,"description":"Session UUID or synthetic slot_<base64url> ID"},"required":true,"description":"Session UUID or synthetic slot_<base64url> ID","name":"sessionId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetRequest"}}}},"responses":{"200":{"description":"effectiveSessionStartsAt restored to sessionStartsAt","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"FORBIDDEN_NOT_TEST — registration is not a test registration (category: test_mode_operation)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/registrations":{"post":{"operationId":"createRegistration","tags":["Registrations"],"summary":"Create a registration","description":"Registers an attendee for a specific webinar session. Returns a unique `accessUrl` watch link. No service-level deduplication (D-12) — every POST creates a new row. For replay protection, pass an `Idempotency-Key` header (SDK auto-generates one in Phase 158). Pass `X-Test-Mode: true` to stamp the registration as a test registration (utm.source = api-test-registration). Soft-deleted webinars return 404 (Pitfall D). Requires `registrations:write` scope.","security":[{"BearerAuth":[]}],"parameters":[{"name":"X-Test-Mode","in":"header","required":false,"schema":{"type":"string","enum":["true"]},"description":"Pass X-Test-Mode: true to create a test registration (stamped with utm.source = api-test-registration)."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRegistrationRequest"}}}},"responses":{"201":{"description":"Registration created. Location header points to the new registration resource.","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRegistrationResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"operationId":"listRegistrations","tags":["Registrations"],"summary":"List registrations","description":"Returns registrations for a webinar with cursor pagination (by registeredAt DESC). `?status=attended` uses an EXISTS subquery against `attendee_metering_dedupe.firstJoinedAt` (cheaper than a GROUP BY over the events table — OQ-1). `?session=` accepts a fixed session UUID or a synthetic `slot_<base64url>` ID. Soft-deleted webinars return 404 (Pitfall D).","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","enum":["registered","attended"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","minLength":1},"required":false,"name":"session","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"from","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"to","in":"query"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Cursor-paginated list of registrations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListRegistrationsResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/registrations/{registrationId}":{"get":{"operationId":"getRegistration","tags":["Registrations"],"summary":"Get a single registration","description":"Returns a single registration by ID. Always includes `accessUrl` in `data` (D-14 / D-16 amendment). Cross-tenant registration IDs return 404 — not 403 — to prevent existence enumeration. Soft-deleted webinars return 404 (Pitfall D).","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","format":"uuid","description":"Registration UUID"},"required":true,"description":"Registration UUID","name":"registrationId","in":"path"}],"responses":{"200":{"description":"Single registration resource with accessUrl","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RegistrationDto"}},"required":["data"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/registrations/{registrationId}/rotate-token":{"post":{"operationId":"rotateRegistrationToken","tags":["Registrations"],"summary":"Rotate a registration access token","description":"Mints a fresh nanoid(32) access token for the registration and returns the new `accessUrl`. The old token is invalidated IMMEDIATELY (D-15) — no grace period. Use case: customer forwarded the watch link and it leaked. Idempotency-Key is recommended (prevents double-rotation on retry). Requires `registrations:write` scope.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","format":"uuid","description":"Registration UUID"},"required":true,"description":"Registration UUID","name":"registrationId","in":"path"}],"responses":{"200":{"description":"New access token minted. Old accessUrl is immediately invalid.","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RotateTokenResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/registrations/bulk":{"post":{"operationId":"bulkCreateRegistrations","tags":["Registrations"],"summary":"Bulk-create registrations (up to 100; partial success allowed)","description":"Creates up to 100 registrations in a single call. Returns a fixed-length array matching the input order: each row has either `{ ok: true, id, email, accessUrl }` or `{ ok: false, error: { code, message } }`. The HTTP 200 indicates the BATCH succeeded — not that every individual row succeeded. In-batch duplicates (same email + sessionTime as an earlier row in the batch) return `{ ok: false, error: { code: \"DUPLICATE_IN_BATCH\" } }` — first occurrence wins (D-10). Idempotency-Key is strongly recommended: replay returns the byte-identical response array. Soft-deleted webinars return 404 for the entire batch (Pitfall D). Requires `registrations:write` scope.","security":[{"BearerAuth":[]}],"parameters":[{"name":"X-Test-Mode","in":"header","required":false,"schema":{"type":"string","enum":["true"]},"description":"Pass X-Test-Mode: true to stamp all rows as test registrations (utm.source = api-test-registration)."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkCreateRegistrationsRequest"}}}},"responses":{"200":{"description":"Batch processed. Response contains a fixed-length array matching input order. Each element is either a success row ({ ok: true, id, email, accessUrl }) or an error row ({ ok: false, error: { code, message } }). HTTP 200 even if all rows fail.","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkCreateRegistrationsResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/webhooks":{"post":{"operationId":"createWebhookSubscription","tags":["Webhooks"],"summary":"Create webhook subscription","description":"Creates a multi-event webhook subscription. Inserts one automation_rules row per eventType, all sharing one subscriptionId and one signing secret. The secret is returned ONCE — store it securely. Use the Idempotency-Key header to safely replay creation (replay returns the same secret — D-24). SSRF validation applied on the URL server-side. Soft-deleted webinars return 404 (Pitfall D). Requires automations:write scope.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhookSubscriptionRequest"}}}},"responses":{"201":{"description":"Webhook subscription created. Secret shown once.","headers":{"Location":{"description":"Path to the newly created subscription resource","schema":{"type":"string"}},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhookSubscriptionResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"operationId":"listWebhookSubscriptions","tags":["Webhooks"],"summary":"List webhook subscriptions","description":"Returns all webhook subscriptions for the specified webinar. Signing secrets are never returned in list responses (use GET single for secretLast4). Subscription-rule rows from the automation surface are included only when actionConfig.subscriptionId IS NOT NULL (i.e., only WHK-* subscriptions appear here; standalone webhook automations created via POST /automations are excluded per D-16). Soft-deleted webinars return 404 (Pitfall D).","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"responses":{"200":{"description":"List of webhook subscriptions","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WebhookSubscription"}},"error":{"type":"null"},"meta":{"type":"object","properties":{}}},"required":["data","error","meta"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/webhooks/{webhookId}":{"get":{"operationId":"getWebhookSubscription","tags":["Webhooks"],"summary":"Get webhook subscription","description":"Returns full subscription detail including secretLast4 and secretRotatedAt. The full secret is never returned after creation. Use secretLast4 to confirm which key is in use after a rotation (D-06, R-06). Cross-tenant subscription IDs return 404. Soft-deleted webinars return 404 (Pitfall D).","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","minLength":1,"description":"Subscription ID (nanoid 21)"},"required":true,"description":"Subscription ID (nanoid 21)","name":"webhookId","in":"path"}],"responses":{"200":{"description":"Webhook subscription detail with secretLast4","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/WebhookSubscriptionDetail"},"error":{"type":"null"},"meta":{"type":"object","properties":{}}},"required":["data","error","meta"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateWebhookSubscription","tags":["Webhooks"],"summary":"Update webhook subscription","description":"Partially updates a webhook subscription: URL, eventTypes, or active state. At least one field is required (enforced server-side — Pitfall H). PUT is no longer supported — returns 405 with Allow: PATCH, DELETE, GET (R-07 hard cutover). URL change triggers SSRF re-validation. eventTypes change deletes+recreates rules in tx. Soft-deleted webinars return 404 (Pitfall D). Requires automations:write scope.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","minLength":1,"description":"Subscription ID (nanoid 21)"},"required":true,"description":"Subscription ID (nanoid 21)","name":"webhookId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchWebhookSubscriptionRequest"}}}},"responses":{"200":{"description":"Webhook subscription updated","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/WebhookSubscriptionDetail"},"error":{"type":"null"},"meta":{"type":"object","properties":{}}},"required":["data","error","meta"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteWebhookSubscription","tags":["Webhooks"],"summary":"Delete webhook subscription","description":"Permanently deletes a webhook subscription (all automation_rules rows sharing the subscriptionId). Returns 204 No Content. Cascades to webhook_deliveries rows (FK ON DELETE CASCADE). Soft-deleted webinars return 404 (Pitfall D). Requires automations:write scope.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","minLength":1,"description":"Subscription ID (nanoid 21)"},"required":true,"description":"Subscription ID (nanoid 21)","name":"webhookId","in":"path"}],"responses":{"204":{"description":"Webhook subscription deleted","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/webhooks/{webhookId}/rotate-secret":{"post":{"operationId":"rotateWebhookSecret","tags":["Webhooks"],"summary":"Rotate webhook signing secret","description":"Generates a new HMAC signing secret and immediately invalidates the old one (D-09). No dual-signing grace window in v1.29 — old secret is invalid on next outbound delivery. The new secret is returned ONCE (use Idempotency-Key for safe retry — D-25). Soft-deleted webinars return 404 (Pitfall D). Requires automations:write scope.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","minLength":1,"description":"Subscription ID (nanoid 21)"},"required":true,"description":"Subscription ID (nanoid 21)","name":"webhookId","in":"path"}],"responses":{"200":{"description":"Secret rotated. New secret shown once.","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RotateWebhookSecretResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/webhooks/{webhookId}/deliveries":{"get":{"operationId":"listWebhookDeliveries","tags":["Webhooks"],"summary":"List webhook delivery history","description":"Returns past webhook delivery attempts for a subscription (GitHub model). Cursor-paginated by created_at DESC; eventType derived at query time via JOIN to automation_rules. Use the single-delivery GET endpoint for requestBody/responseBody (WHK-08-supplement). Soft-deleted webinars return 404 (Pitfall D).","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","minLength":1,"description":"Subscription ID (nanoid 21)"},"required":true,"description":"Subscription ID (nanoid 21)","name":"webhookId","in":"path"},{"schema":{"type":"string","description":"Opaque cursor from previous page nextCursor."},"required":false,"description":"Opaque cursor from previous page nextCursor.","name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Page size (1-100, default 50)."},"required":false,"description":"Page size (1-100, default 50).","name":"limit","in":"query"}],"responses":{"200":{"description":"Cursor-paginated delivery list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListWebhookDeliveriesResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/webhooks/{webhookId}/deliveries/{deliveryId}":{"get":{"operationId":"getWebhookDelivery","tags":["Webhooks"],"summary":"Get a single webhook delivery","description":"Returns the full detail of a single webhook delivery attempt including requestBody and responseBody. Required to poll the redeliver outcome after a 202 accept (WHK-09). Cross-tenant delivery IDs return 404. Soft-deleted webinars return 404 (Pitfall D).","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","minLength":1,"description":"Subscription ID (nanoid 21)"},"required":true,"description":"Subscription ID (nanoid 21)","name":"webhookId","in":"path"},{"schema":{"type":"string","format":"uuid","description":"Delivery UUID"},"required":true,"description":"Delivery UUID","name":"deliveryId","in":"path"}],"responses":{"200":{"description":"Single webhook delivery detail","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/WebhookDeliveryDetail"},"error":{"type":"null"},"meta":{"type":"object","properties":{}}},"required":["data","error","meta"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/webhooks/{webhookId}/deliveries/{deliveryId}/redeliver":{"post":{"operationId":"redeliverWebhook","tags":["Webhooks"],"summary":"Redeliver a webhook","description":"Accepts a redeliver request synchronously (202 Accepted with new deliveryId + Location header). Actual delivery rides the same retry-equipped Inngest pipeline as the original (D-12). Final state observable via the single-delivery GET endpoint (WHK-08-supplement). Works for any past delivery state — success, failed, or pending (D-13). Idempotency-Key replay returns the same deliveryId, preventing duplicate Inngest events (D-26). Soft-deleted webinars return 404 (Pitfall D). Requires automations:write scope.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","minLength":1,"description":"Subscription ID (nanoid 21)"},"required":true,"description":"Subscription ID (nanoid 21)","name":"webhookId","in":"path"},{"schema":{"type":"string","format":"uuid","description":"Original delivery UUID to redeliver"},"required":true,"description":"Original delivery UUID to redeliver","name":"deliveryId","in":"path"}],"responses":{"202":{"description":"202 Accepted — new delivery queued. Poll Location for final status.","headers":{"Location":{"description":"Path to the new pending delivery row (same as WHK-08-supplement GET)","schema":{"type":"string"}},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RedeliverWebhookResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/automations":{"post":{"operationId":"createAutomation","tags":["Automations"],"summary":"Create an automation rule","description":"Creates an automation rule with flat AND-only conditions array. Discriminated by actionType: email | webhook | integration | meta_capi. integration actionType requires the provider to be connected (422 PRECONDITION_FAILED if not). webhook actionType: webhookSecret auto-generated if omitted; subscriptionId is stripped (standalone webhook automations are orthogonal to WHK-* subscriptions per D-16). meta_capi actionType requires the Growth plan (403 FORBIDDEN, field plan) and a metaPixelId from GET /v1/integrations/meta-pixels — a missing, other-account or deleted pixel returns one uniform 400 VALIDATION_ERROR on actionConfig.metaPixelId; config errors list every issue with its path. See the MCP resource webinarstack://docs/meta-pixel-authoring. segmentId/branchId require webinars.adaptive capability (403 if not). Soft-deleted webinars return 404 (Pitfall D). Requires automations:write scope. For email actionType, see the EmailBody component schema and the MCP resource webinarstack://docs/automation-email-authoring for the personalization-token catalog and Tiptap body example.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAutomationRequest"}}}},"responses":{"201":{"description":"Automation rule created","headers":{"Location":{"description":"Path to the newly created automation resource","schema":{"type":"string"}},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Automation"},"error":{"type":"null"},"meta":{"type":"object","properties":{}}},"required":["data","error","meta"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"PRECONDITION_FAILED — integration provider not connected for this account","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"operationId":"listAutomations","tags":["Automations"],"summary":"List automation rules","description":"Returns automation rules for a webinar with cursor pagination (by createdAt DESC). Default excludes subscription-rule rows (where actionConfig.subscriptionId IS NOT NULL). Pass ?includeSubscriptionRules=true to include them for audit/debug purposes (D-17). Additional filters: enabled, triggerType, actionType. Soft-deleted webinars return 404 (Pitfall D). Requires automations:read scope.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","description":"Opaque cursor from previous page nextCursor."},"required":false,"description":"Opaque cursor from previous page nextCursor.","name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Page size (1-100, default 50)."},"required":false,"description":"Page size (1-100, default 50).","name":"limit","in":"query"},{"schema":{"type":["boolean","null"],"description":"Filter by enabled state."},"required":false,"description":"Filter by enabled state.","name":"enabled","in":"query"},{"schema":{"allOf":[{"$ref":"#/components/schemas/AutomationTriggerType"},{"description":"Filter by trigger type."}]},"required":false,"description":"Filter by trigger type.","name":"triggerType","in":"query"},{"schema":{"type":"string","enum":["email","webhook","integration","meta_capi"],"description":"Filter by action type."},"required":false,"description":"Filter by action type.","name":"actionType","in":"query"},{"schema":{"type":["boolean","null"],"default":false,"description":"Include subscription-rule rows (D-17 — excluded by default)."},"required":false,"description":"Include subscription-rule rows (D-17 — excluded by default).","name":"includeSubscriptionRules","in":"query"}],"responses":{"200":{"description":"Cursor-paginated list of automation rules","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Automation"}},"error":{"type":"null"},"meta":{"type":"object","properties":{"nextCursor":{"type":["string","null"]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]}},"required":["data","error","meta"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/automations/{automationId}":{"get":{"operationId":"getAutomation","tags":["Automations"],"summary":"Get an automation rule","description":"Returns a single automation rule. actionConfig is returned as raw JSONB passthrough — not re-validated on read (Pitfall 5). Cross-tenant automation IDs return 404. Soft-deleted webinars return 404 (Pitfall D).","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","format":"uuid","description":"Automation rule UUID"},"required":true,"description":"Automation rule UUID","name":"automationId","in":"path"}],"responses":{"200":{"description":"Single automation rule","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Automation"},"error":{"type":"null"},"meta":{"type":"object","properties":{}}},"required":["data","error","meta"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateAutomation","tags":["Automations"],"summary":"Update an automation rule","description":"Partially updates an automation rule. At least one field is required (enforced server-side — Pitfall H). PATCH does NOT touch automation_executions rows (D-18 — preserves the dispatch ledger). Capability gate applies if segmentId/branchId is non-null after merge. W5 defense: subscriptionId is stripped from actionConfig on the PATCH path. For meta_capi rules: an actionConfig fully replaces metaPixelId/eventName/customData and is re-validated; disabledReason, disabledAt and triggerOn are system keys preserved from the stored rule; below Growth only { enabled: false } (and DELETE) is accepted; changing actionType to meta_capi requires a complete meta_capi actionConfig. Soft-deleted webinars return 404 (Pitfall D). Requires automations:write scope. For email actionType, see the EmailBody component schema and the MCP resource webinarstack://docs/automation-email-authoring for the personalization-token catalog and Tiptap body example.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","format":"uuid","description":"Automation rule UUID"},"required":true,"description":"Automation rule UUID","name":"automationId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchAutomationRequest"}}}},"responses":{"200":{"description":"Automation rule updated. Execution ledger preserved.","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Automation"},"error":{"type":"null"},"meta":{"type":"object","properties":{}}},"required":["data","error","meta"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteAutomation","tags":["Automations"],"summary":"Delete an automation rule","description":"Permanently deletes an automation rule. Returns 204 No Content. Cascades to automation_executions rows (FK ON DELETE CASCADE — D-20). Soft-deleted webinars return 404 (Pitfall D). Requires automations:write scope.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","format":"uuid","description":"Automation rule UUID"},"required":true,"description":"Automation rule UUID","name":"automationId","in":"path"}],"responses":{"204":{"description":"Automation rule deleted (cascade: automation_executions)","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/automations/{automationId}/executions":{"get":{"operationId":"listAutomationExecutions","tags":["Automations"],"summary":"List automation execution history","description":"Returns past automation executions from the idempotency ledger for a rule. Cursor-paginated by executedAt DESC. Optional ?status filter. messageEventId is opaque and nullable — never JOINed to message_events on read (rows may dangle after retention purge — Pitfall 6). Cross-tenant rule IDs return 404. Soft-deleted webinars return 404 (Pitfall D).","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","format":"uuid","description":"Automation rule UUID"},"required":true,"description":"Automation rule UUID","name":"automationId","in":"path"},{"schema":{"type":"string","description":"Opaque cursor from previous page nextCursor."},"required":false,"description":"Opaque cursor from previous page nextCursor.","name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Page size (1-100, default 50)."},"required":false,"description":"Page size (1-100, default 50).","name":"limit","in":"query"},{"schema":{"type":"string","enum":["dispatched","success","failure","retried"],"description":"Filter by execution status."},"required":false,"description":"Filter by execution status.","name":"status","in":"query"}],"responses":{"200":{"description":"Cursor-paginated execution history","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AutomationExecution"}},"error":{"type":"null"},"meta":{"type":"object","properties":{"nextCursor":{"type":["string","null"]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]}},"required":["data","error","meta"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/interactions":{"get":{"operationId":"listInteractions","tags":["Interactions"],"summary":"List interactions for a webinar","description":"List polls and CTA offers for a tenant-owned webinar, ordered by appearsAtSeconds ASC. Optional filters: type (cta|poll), timeline (live|replay). Returns a plain array — no cursor pagination (D-05). Soft-deleted webinars return 404 (Pitfall D). Requires interactions:read scope. See webinarstack://docs/interaction-authoring for interaction field documentation.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","enum":["cta","poll"],"description":"Filter by interaction type."},"required":false,"description":"Filter by interaction type.","name":"type","in":"query"},{"schema":{"type":"string","enum":["live","replay"],"description":"Filter by timeline (live or replay)."},"required":false,"description":"Filter by timeline (live or replay).","name":"timeline","in":"query"}],"responses":{"200":{"description":"List of interactions ordered by appearsAtSeconds ASC","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Interaction"}},"meta":{"type":"object","properties":{},"additionalProperties":{}}},"required":["data","meta"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createInteraction","tags":["Interactions"],"summary":"Create an interaction (poll or CTA)","description":"Create a new poll or CTA offer on a tenant-owned webinar. Discriminated on the type field: cta or poll. BEFORE calling this, call interactions_find_matching (MCP) or GET /webinars/{id}/interactions (REST) to avoid creating a duplicate that would confuse live attendees seeing two competing interactions at the same moment. Returns 201 with a Location header pointing at the new resource. Supports optional Idempotency-Key header for safe retries (OQ-4). Requires interactions:write scope. See webinarstack://docs/interaction-authoring for interaction authoring guidance.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"},"description":"Webinar UUID"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InteractionBody"}}}},"responses":{"201":{"description":"Interaction created","headers":{"Location":{"description":"Path to the newly created interaction resource","schema":{"type":"string"}},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Interaction"},"meta":{"type":"object","properties":{},"additionalProperties":{}}},"required":["data","meta"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webinars/{id}/interactions/{interactionId}":{"get":{"operationId":"getInteraction","tags":["Interactions"],"summary":"Get a single interaction","description":"Returns a single poll or CTA interaction with its full discriminated-union configuration. CTA response includes attributionWindowDays (D-08b); poll response includes optionSpecs. Cross-tenant interaction IDs return 404. Soft-deleted webinars return 404 (Pitfall D). Requires interactions:read scope. See webinarstack://docs/interaction-authoring for interaction field documentation.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","format":"uuid","description":"Interaction UUID"},"required":true,"description":"Interaction UUID","name":"interactionId","in":"path"}],"responses":{"200":{"description":"Single interaction (discriminated union: cta or poll)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Interaction"},"meta":{"type":"object","properties":{},"additionalProperties":{}}},"required":["data","meta"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateInteraction","tags":["Interactions"],"summary":"Update an interaction (poll or CTA)","description":"Fully replaces an interaction's configuration. PUT-style replace-not-merge: all base fields are required; omitted type-specific optional fields reset to null/default (D-01). The type field must match the existing row's type — type is immutable after creation (D-02). To change one field, call GET first and resend the full body. Returns 200 with the projected updated interaction (discriminated union: cta or poll). Supports optional Idempotency-Key header for safe retries. Cross-tenant interaction IDs return 404. Soft-deleted webinars return 404. Requires interactions:write scope. See webinarstack://docs/interaction-authoring for interaction authoring guidance.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","format":"uuid","description":"Interaction UUID"},"required":true,"description":"Interaction UUID","name":"interactionId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InteractionBody"}}}},"responses":{"200":{"description":"Interaction updated (full-replace). Returns the projected interaction.","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Interaction"},"error":{"type":"null"},"meta":{"type":"object","properties":{}}},"required":["data","error","meta"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteInteraction","tags":["Interactions"],"summary":"Delete an interaction (poll or CTA)","description":"Permanently deletes a poll or CTA interaction. Returns 204 No Content (D-07). DESTRUCTIVE: deleting a poll permanently removes its poll_vote_snapshots via FK CASCADE — not recoverable from the snapshot (snapshot recreates config only). Deleting a CTA offer clears purchase_records.attribution_offer_id via ON DELETE SET NULL — the ledger row is preserved, only the attribution pointer is lost. Recommend checking whether the interaction has live engagement before deleting. Cross-tenant interaction IDs return 404. Soft-deleted webinars return 404. Supports optional Idempotency-Key header for replay-safe 204 (Phase 154 D-21). Requires interactions:write scope.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."},{"schema":{"type":"string","format":"uuid","description":"Webinar UUID"},"required":true,"description":"Webinar UUID","name":"id","in":"path"},{"schema":{"type":"string","format":"uuid","description":"Interaction UUID"},"required":true,"description":"Interaction UUID","name":"interactionId","in":"path"}],"responses":{"204":{"description":"Interaction deleted (poll: vote snapshots cascaded; CTA: attribution pointer cleared)","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/integrations/triggers":{"get":{"operationId":"listBuiltInTriggers","tags":["Integrations"],"summary":"List built-in automation triggers available to iPaaS apps","description":"Returns the 9-entry iPaaS-exposed subset of WebinarStack's built-in automation trigger taxonomy — this is the single source of truth consumed by the Zapier and Make apps for their dynamic trigger dropdowns (D-12), so the two platform apps cannot drift apart. The response is static, account-agnostic metadata identical for every caller. Requires automations:read scope.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"The iPaaS-exposed built-in trigger taxonomy, in canonical declaration order","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BuiltInTrigger"}},"meta":{"type":"object","properties":{}}},"required":["data","meta"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/integrations/meta-pixels":{"get":{"operationId":"listMetaPixels","tags":["Integrations"],"summary":"List connected Meta pixels","description":"Lists the authenticated account's connected Meta pixels for use as actionConfig.metaPixelId on a meta_capi automation rule (the row id, not Meta’s pixelId). Deleted pixels are excluded; paused and error pixels are included with their status. Access tokens and test-event codes are never returned. Requires automations:read scope.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"The authenticated account's connected Meta pixels, token-free","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MetaPixelSummary"}},"meta":{"type":"object","properties":{}}},"required":["data","meta"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/integrations/identity":{"get":{"operationId":"getIntegrationIdentity","tags":["Integrations"],"summary":"Get the authenticated account identity","description":"Returns the authenticated account's id, display name, and the verified key's own scopes. The Zapier and Make platform apps call this first, both as a connection test and as the source of the connection label they display (the response's `accountName`). Requires NO scope — unlike every other endpoint in this document, any valid, non-revoked, REST-surfaced API key authenticates here regardless of its scopes, because the response is only the caller's own identity, never account data.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"The authenticated account's identity and the verified key's scopes","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntegrationIdentity"},"meta":{"type":"object","properties":{}}},"required":["data","meta"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/integrations/registrations/find":{"get":{"operationId":"findRegistrationsByEmail","tags":["Integrations"],"summary":"Find registrations by attendee email","description":"Returns every registration in the account matching the queried email address, newest `registeredAt` first, page-limited. Matching is case-insensitive EXACT — not a prefix or wildcard search. A query with zero matches returns 200 with an empty `data` array, never 404. Each result carries `accessUrl`, the matching attendee's unique join link — treat it as a bearer credential. Requires registrations:read scope.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"email","description":"Exact email address to search for (case-insensitive)."},"required":true,"description":"Exact email address to search for (case-insensitive).","name":"email","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Page size (1-100, default 25)."},"required":false,"description":"Page size (1-100, default 25).","name":"limit","in":"query"},{"schema":{"type":"string","description":"Opaque cursor from a previous response's meta.nextCursor."},"required":false,"description":"Opaque cursor from a previous response's meta.nextCursor.","name":"cursor","in":"query"}],"responses":{"200":{"description":"Matching registrations, newest first, page-limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindRegistrationsByEmailResponse"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/integrations/zapier/subscriptions":{"post":{"operationId":"createZapierSubscription","tags":["Integrations"],"summary":"Subscribe a Zap to a WebinarStack behavior trigger","description":"Creates a shadow automation rule that fires this Zap's webhook whenever the requested trigger matches. `platform` is implied by the path and hardcoded server-side — any value sent in the body is ignored. The created id lands at `data.id` because Zapier's REST Hook subscribe contract reads `bundle.subscribeData.id` from the response — this is load-bearing for the Zapier app. Supports the Idempotency-Key header. Requires automations:write scope.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateZapierSubscriptionRequest"}}}},"responses":{"201":{"description":"Subscription created","headers":{"Location":{"description":"Path to the newly created subscription","schema":{"type":"string"}},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateIpaasSubscriptionResult"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/integrations/zapier/subscriptions/{id}":{"delete":{"operationId":"deleteZapierSubscription","tags":["Integrations"],"summary":"Unsubscribe a Zap from a WebinarStack behavior trigger","description":"Soft-disables the subscription (the delivery history is preserved for the retention window). Naturally idempotent — repeated deletes against an already-disabled subscription are a no-op 204. Requires automations:write scope.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","minLength":1,"description":"Subscription id"},"required":true,"description":"Subscription id","name":"id","in":"path"}],"responses":{"204":{"description":"Subscription unsubscribed (or already unsubscribed)"},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/integrations/make/subscriptions":{"post":{"operationId":"createMakeSubscription","tags":["Integrations"],"summary":"Subscribe a Make scenario to a WebinarStack behavior trigger","description":"Creates a shadow automation rule that fires this scenario's webhook whenever the requested trigger matches. `platform` is implied by the path and hardcoded server-side — any value sent in the body is ignored. The created id lands at `data.id`, mirroring the Zapier endpoint's contract. Supports the Idempotency-Key header. Requires automations:write scope.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Client-supplied key (recommended UUID v4) for safe retry. Same key + same body within 24h → cached response replayed with X-Idempotent-Replayed: true. Same key + different body → 409 Conflict. Same key while prior request still processing → 409 (retry shortly)."}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMakeSubscriptionRequest"}}}},"responses":{"201":{"description":"Subscription created","headers":{"Location":{"description":"Path to the newly created subscription","schema":{"type":"string"}},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Max requests per minute (300 in v1.29)."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix seconds until the window resets."},"X-Idempotent-Replayed":{"schema":{"type":"boolean"},"description":"Present and `true` only when this response was replayed from the idempotency cache."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateIpaasSubscriptionResult"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key conflict — either reused with a different request body, or a prior request under the same key is still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/integrations/make/subscriptions/{id}":{"delete":{"operationId":"deleteMakeSubscription","tags":["Integrations"],"summary":"Unsubscribe a Make scenario from a WebinarStack behavior trigger","description":"Soft-disables the subscription (the delivery history is preserved for the retention window). Naturally idempotent — repeated deletes against an already-disabled subscription are a no-op 204. Requires automations:write scope.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","minLength":1,"description":"Subscription id"},"required":true,"description":"Subscription id","name":"id","in":"path"}],"responses":{"204":{"description":"Subscription unsubscribed (or already unsubscribed)"},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"webhooks":{}}