{"info":{"title":"Olive API","version":"0.1.0","description":"OpenAPI surface for Olive's app-facing endpoints."},"servers":[{"url":"https://api.fromolive.com"}],"openapi":"3.1.1","components":{"schemas":{"StoryStatus":{"enum":["ready","pending","failed"],"type":"string"},"StorySummary":{"type":"object","properties":{"storyId":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"},"pickerMessages":{"type":["array","null"],"items":{"type":"string","minLength":1},"minItems":1,"maxItems":3},"status":{"$ref":"#/components/schemas/StoryStatus"},"reaction":{"enum":["not_for_me","love"],"type":["string","null"]},"reactedAt":{"type":["string","null"]},"stickerImageUrl":{"type":"string"},"segmentCount":{"type":"integer","minimum":0},"lastViewedSegmentIndex":{"type":"integer","minimum":0},"lastTouchedAt":{"type":"string"},"createdAt":{"type":"string"},"startedAt":{"type":"string"},"completedAt":{"type":"string"},"hiddenAt":{"type":"string"},"hiddenReason":{"enum":["expired","admin","completed","disliked","errored"],"type":"string"},"archivedAt":{"type":"string"},"expiredAt":{"type":"string"},"forDate":{"type":"string"},"sharedByName":{"type":["string","null"]},"commissioned":{"default":false,"type":"boolean"},"reviewedAt":{"type":["string","null"]},"reviewedAs":{"enum":["saved","auto_saved","already_known","didnt_understand","not_interested","dismissed"],"type":["string","null"]}},"required":["storyId","title","subtitle","status","segmentCount","lastViewedSegmentIndex","lastTouchedAt","createdAt"]},"StoryListResponse":{"type":"object","properties":{"todayDate":{"type":"string"},"storiesReadToday":{"type":"integer","minimum":0},"storiesReadThisWeek":{"type":"integer","minimum":0},"previouslySeenCount":{"default":0,"type":"integer","minimum":0},"isCurating":{"default":false,"type":"boolean"},"needsFeedRefinement":{"default":false,"type":"boolean"},"stories":{"type":"array","items":{"$ref":"#/components/schemas/StorySummary"}}},"required":["todayDate","storiesReadToday","storiesReadThisWeek","stories"]},"StorySegment":{"type":"object","properties":{"body":{"type":"string"}},"required":["body"]},"StoryFollowUp":{"type":"object","properties":{"label":{"type":"string"},"subtitle":{"type":"string"},"isNextChapter":{"default":false,"type":"boolean"}},"required":["label","subtitle"]},"StorySavedLine":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"segmentIndex":{"type":"integer","minimum":0},"charOffset":{"type":"integer","minimum":0},"groupId":{"type":["string","null"]}},"required":["id","text","segmentIndex","charOffset","groupId"]},"StorySource":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"siteName":{"type":"string"},"imageUrl":{"type":"string"}},"required":["url","title"]},"StoryContent":{"type":"object","properties":{"storyId":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"},"sharedByName":{"type":["string","null"]},"segments":{"type":"array","items":{"$ref":"#/components/schemas/StorySegment"}},"followUps":{"type":"array","items":{"$ref":"#/components/schemas/StoryFollowUp"}},"savedLines":{"default":[],"type":"array","items":{"$ref":"#/components/schemas/StorySavedLine"}},"sources":{"default":[],"type":"array","items":{"$ref":"#/components/schemas/StorySource"}}},"required":["storyId","title","subtitle","segments","followUps"]},"StoryRequestNewResponse":{"type":"object","properties":{"storyList":{"$ref":"#/components/schemas/StoryListResponse"},"pendingStoryIds":{"type":"array","items":{"type":"string"}}},"required":["storyList","pendingStoryIds"]},"StorySearchResponse":{"type":"object","properties":{"title":{"type":"string"},"explainer":{"type":"string"}},"required":["title","explainer"]},"ArchivedStoriesResponse":{"type":"object","properties":{"stories":{"type":"array","items":{"$ref":"#/components/schemas/StorySummary"}}},"required":["stories"]},"ComposerSuggestion":{"type":"object","properties":{"title":{"type":"string"},"chipLabel":{"type":"string"}},"required":["title","chipLabel"]},"ComposerSuggestionsResponse":{"type":"object","properties":{"suggestions":{"type":"array","items":{"$ref":"#/components/schemas/ComposerSuggestion"}}},"required":["suggestions"]},"WordTiming":{"type":"object","properties":{"word":{"type":"string"},"startMs":{"type":"integer","minimum":0},"endMs":{"type":"integer","minimum":0},"segmentIndex":{"type":"integer","minimum":0},"charOffsetInSegment":{"type":"integer","minimum":0},"charLengthInSegment":{"type":"integer","minimum":0}},"required":["word","startMs","endMs","segmentIndex","charOffsetInSegment","charLengthInSegment"]},"User":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"emailVerified":{"type":"boolean","default":false,"readOnly":true},"image":{"type":"string"},"createdAt":{"type":"string","format":"date-time","default":"Generated at runtime"},"updatedAt":{"type":"string","format":"date-time","default":"Generated at runtime"},"phoneNumber":{"type":"string"},"phoneNumberVerified":{"type":"boolean","readOnly":true},"onboardingCompleted":{"type":"boolean","default":false,"readOnly":true},"onboardingStep":{"type":"string","default":"name","readOnly":true},"onboardingSeedText":{"type":"string","readOnly":true},"onboardingPlanResponse":{"type":"string","readOnly":true},"textsEnabled":{"type":"boolean","readOnly":true},"askOliveTipShown":{"type":"boolean","default":false,"readOnly":true},"timezone":{"type":"string","readOnly":true},"notificationsEnabled":{"type":"boolean","default":true,"readOnly":true}},"required":["name","email","createdAt","updatedAt"]},"Session":{"type":"object","properties":{"id":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"},"token":{"type":"string"},"createdAt":{"type":"string","format":"date-time","default":"Generated at runtime"},"updatedAt":{"type":"string","format":"date-time"},"ipAddress":{"type":"string"},"userAgent":{"type":"string"},"userId":{"type":"string"}},"required":["expiresAt","token","createdAt","updatedAt","userId"]},"Account":{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"providerId":{"type":"string"},"userId":{"type":"string"},"accessToken":{"type":"string"},"refreshToken":{"type":"string"},"idToken":{"type":"string"},"accessTokenExpiresAt":{"type":"string","format":"date-time"},"refreshTokenExpiresAt":{"type":"string","format":"date-time"},"scope":{"type":"string"},"password":{"type":"string"},"createdAt":{"type":"string","format":"date-time","default":"Generated at runtime"},"updatedAt":{"type":"string","format":"date-time"}},"required":["accountId","providerId","userId","createdAt","updatedAt"]},"Verification":{"type":"object","properties":{"id":{"type":"string"},"identifier":{"type":"string"},"value":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time","default":"Generated at runtime"},"updatedAt":{"type":"string","format":"date-time","default":"Generated at runtime"}},"required":["identifier","value","expiresAt","createdAt","updatedAt"]}},"securitySchemes":{"apiKeyCookie":{"type":"apiKey","in":"cookie","name":"apiKeyCookie","description":"API Key authentication via cookie"},"bearerAuth":{"type":"http","scheme":"bearer","description":"Bearer token authentication"}}},"paths":{"/api/app/version-check":{"get":{"operationId":"app.versionCheck","tags":["App"],"parameters":[{"name":"currentVersion","in":"query","required":true,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true},{"name":"currentBuild","in":"query","required":true,"schema":{"type":"integer"},"allowEmptyValue":true,"allowReserved":true},{"name":"channel","in":"query","required":true,"schema":{"enum":["appStore","testFlight"],"type":"string"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"latestVersion":{"type":"string"},"latestBuild":{"type":"integer"},"updateAvailable":{"type":"boolean"},"minVersion":{"type":"string"},"minBuild":{"type":"integer"},"updateRequired":{"type":"boolean"}},"required":["latestVersion","latestBuild","updateAvailable"]}}}}}}},"/api/user/me":{"get":{"operationId":"user.me","tags":["User"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"onboardingCompleted":{"type":"boolean"},"askOliveTipShown":{"type":"boolean"},"notificationsEnabled":{"type":"boolean"},"timezone":{"type":["string","null"]},"image":{"type":["string","null"]},"infiniteFeedEnabled":{"type":"boolean"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","onboardingCompleted","askOliveTipShown","notificationsEnabled","timezone","image","infiniteFeedEnabled","createdAt","updatedAt"]}}}}}}},"/api/user/delete-account":{"post":{"operationId":"user.deleteAccount","tags":["User"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}}}}},"/api/user/mark-ask-olive-tip-shown":{"post":{"operationId":"user.markAskOliveTipShown","tags":["User"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"askOliveTipShown":{"type":"boolean"}},"required":["askOliveTipShown"]}}}}}}},"/api/user/update-notification-settings":{"post":{"operationId":"user.updateNotificationSettings","tags":["User"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"notificationsEnabled":{"type":"boolean"}},"required":["notificationsEnabled"]}}}}}}},"/api/user/update-profile-picture":{"post":{"operationId":"user.updateProfilePicture","tags":["User"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"imageBase64":{"type":"string","minLength":1}},"required":["imageBase64"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"image":{"type":"string"}},"required":["image"]}}}}}}},"/api/user/remove-profile-picture":{"post":{"operationId":"user.removeProfilePicture","tags":["User"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}}}}},"/api/device/register-push-token":{"post":{"operationId":"device.registerPushToken","tags":["Device"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","minLength":1},"platform":{"const":"ios"},"bundleId":{"type":"string","minLength":1},"environment":{"enum":["development","production"],"type":"string"},"appVersion":{"type":"string"},"osVersion":{"type":"string"},"timezone":{"type":"string"}},"required":["token","platform","bundleId","environment"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true}},"required":["ok"]}}}}}}},"/api/voice/transcribe":{"post":{"operationId":"voice.transcribe","tags":["Voice"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"audioBase64":{"type":"string","minLength":1},"mimeType":{"default":"audio/m4a","type":"string","minLength":1},"fileName":{"type":"string"}},"required":["audioBase64"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"}},"required":["text"]}}}}}}},"/api/analytics/capture":{"post":{"operationId":"analytics.capture","tags":["Analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"events":{"default":[],"type":"array","items":{"type":"object","properties":{"event":{"type":"string","minLength":1},"eventId":{"type":"string"},"properties":{"type":"object","additionalProperties":{}},"_update":{"type":"boolean"},"timestamp":{"type":"string"}}}}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"dropped":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/analytics/reading-session":{"post":{"operationId":"analytics.recordReadingSession","tags":["Analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sessionId":{"type":"string","minLength":1},"unitKind":{"default":"story","enum":["story","card_detail"],"type":"string"},"storyId":{"type":"string","minLength":1},"cardId":{"type":"string","minLength":1},"cardHeadline":{"type":"string"},"startedAt":{"type":"string"},"endedAt":{"type":"string"},"durationMs":{"type":"integer","minimum":0},"activeMs":{"type":"integer","minimum":0},"maxScrollFraction":{"type":"number","minimum":0,"maximum":1},"endReason":{"type":"string","minLength":1},"segmentCount":{"type":"integer","minimum":0},"contentHeightPx":{"type":"number","minimum":0},"viewportHeightPx":{"type":"number","minimum":0},"samples":{"default":[],"type":"array","items":{"type":"object","properties":{"t":{"type":"integer","minimum":0},"frac":{"type":"number","minimum":0,"maximum":1}},"required":["t","frac"]}},"interactions":{"default":[],"type":"array","items":{"type":"object","properties":{"t":{"type":"integer","minimum":0},"type":{"type":"string","minLength":1}},"required":["t","type"]}},"geometry":{"type":"object","properties":{"scrollableDistancePx":{"type":"number"},"screenWidthPt":{"type":"number"},"contentWidthPt":{"type":"number"},"topInsetPt":{"type":"number"},"bottomInsetPt":{"type":"number"},"dynamicTypeScale":{"type":"number"},"segmentLayout":{"default":[],"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0},"topPx":{"type":"number"},"heightPx":{"type":"number"}},"required":["index","topPx","heightPx"]}}}}},"required":["sessionId","startedAt","endedAt","durationMs","activeMs","maxScrollFraction","endReason","segmentCount","contentHeightPx","viewportHeightPx"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"dropped":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/analytics/podcast-listening-session":{"post":{"operationId":"analytics.recordPodcastListeningSession","tags":["Analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sessionId":{"type":"string","minLength":1},"topicId":{"type":"string","minLength":1},"startedAt":{"type":"string"},"endedAt":{"type":"string"},"durationMs":{"type":"integer","minimum":0},"activeMs":{"type":"integer","minimum":0},"revision":{"type":"integer","minimum":0},"finalized":{"type":"boolean"},"endReason":{"enum":["in_progress","stopped","skipped","completed","failed","replaced"],"type":"string"},"spans":{"default":[],"type":"array","items":{"type":"object","properties":{"sessionStartMs":{"type":"integer","minimum":0},"sessionEndMs":{"type":"integer","minimum":0},"audioStartMs":{"type":"integer","minimum":0},"audioEndMs":{"type":"integer","minimum":0},"playbackRate":{"type":"number","minimum":0,"maximum":4}},"required":["sessionStartMs","sessionEndMs","audioStartMs","audioEndMs","playbackRate"]},"maxItems":2000},"interactions":{"default":[],"type":"array","items":{"type":"object","properties":{"t":{"type":"integer","minimum":0},"positionMs":{"type":"integer","minimum":0},"type":{"type":"string","minLength":1}},"required":["t","positionMs","type"]},"maxItems":2000}},"required":["sessionId","topicId","startedAt","endedAt","durationMs","activeMs","revision","finalized","endReason"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"dropped":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/onboarding/begin":{"post":{"operationId":"onboarding.begin","tags":["Onboarding"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"seedText":{"type":"string","minLength":1}},"required":["name","seedText"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"stories":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"}},"required":["id","title","subtitle"]}},"candidates":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"title":{"type":"string","minLength":1,"maxLength":140},"subtitle":{"type":"string","minLength":1,"maxLength":300},"sourceType":{"type":"string"}},"required":["id","title","subtitle","sourceType"]},"maxItems":32}},"required":["stories"]}}}}}}},"/api/onboarding/swipes":{"post":{"operationId":"onboarding.submitSwipes","tags":["Onboarding"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"swipes":{"type":"array","items":{"type":"object","properties":{"candidateId":{"type":"string","minLength":1,"maxLength":128},"direction":{"enum":["left","right"],"type":"string"},"title":{"type":"string","minLength":1,"maxLength":140},"subtitle":{"type":"string","minLength":1,"maxLength":300}},"required":["candidateId","direction"]},"minItems":1,"maxItems":32}},"required":["swipes"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"queued":{"type":"boolean"}},"required":["queued"]}}}}}}},"/api/onboarding/complete":{"post":{"operationId":"onboarding.complete","tags":["Onboarding"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"swipes":{"type":"array","items":{"type":"object","properties":{"candidateId":{"type":"string","minLength":1,"maxLength":128},"direction":{"enum":["left","right"],"type":"string"},"title":{"type":"string","minLength":1,"maxLength":140},"subtitle":{"type":"string","minLength":1,"maxLength":300}},"required":["candidateId","direction"]},"maxItems":32},"planResponse":{"type":"string"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"storyList":{"$ref":"#/components/schemas/StoryListResponse"}},"required":["storyList"]}}}}}}},"/api/onboarding/texts-enabled":{"post":{"operationId":"onboarding.setTextsEnabled","tags":["Onboarding"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"textsEnabled":{"type":"boolean"}},"required":["textsEnabled"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"textsEnabled":{"type":"boolean"}},"required":["textsEnabled"]}}}}}}},"/api/onboarding/retry-preparation":{"post":{"operationId":"onboarding.retryPreparation","tags":["Onboarding"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"enum":["preparing","ready"],"type":"string"}},"required":["status"]}}}}}}},"/api/onboarding/suggest-first-story":{"post":{"operationId":"onboarding.suggestFirstStory","tags":["Onboarding"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fascinations":{"default":"","type":"string"},"rightSwipedCandidates":{"default":[],"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"subtitle":{"type":"string"}},"required":["title","subtitle"]}}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"},"stickerImageUrl":{"type":["string","null"]},"segmentCount":{"type":"integer","minimum":0}},"required":["storyId","title","subtitle","stickerImageUrl","segmentCount"]}}}}}}},"/api/reflect/respond":{"post":{"operationId":"onboarding.reflectRespond","tags":["Onboarding"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"question":{"type":"string"},"answer":{"type":"string"},"userName":{"type":["string","null"]}},"required":["question","answer"]}}}},"responses":{"200":{"description":"OK","content":{"text/event-stream":{"schema":{"oneOf":[{"type":"object","properties":{"event":{"const":"message"},"data":{"type":"string"},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event","data"]},{"type":"object","properties":{"event":{"const":"done"},"data":{},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event"]},{"type":"object","properties":{"event":{"const":"error"},"data":{},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event"]}]}}}}}}},"/api/reflect/followup":{"post":{"operationId":"onboarding.reflectFollowup","tags":["Onboarding"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"}},"required":["answer"]}}}},"responses":{"200":{"description":"OK","content":{"text/event-stream":{"schema":{"oneOf":[{"type":"object","properties":{"event":{"const":"message"},"data":{"anyOf":[{"type":"object","properties":{"type":{"const":"message-delta"},"data":{"type":"string"}},"required":["type","data"]},{"type":"object","properties":{"type":{"const":"options"},"options":{"type":"array","items":{"type":"string"}}},"required":["type","options"]}]},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event","data"]},{"type":"object","properties":{"event":{"const":"done"},"data":{},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event"]},{"type":"object","properties":{"event":{"const":"error"},"data":{},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event"]}]}}}}}}},"/api/stories":{"get":{"operationId":"story.list","tags":["Stories"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoryListResponse"}}}}}}},"/api/stories/read":{"get":{"operationId":"story.read","tags":["Stories"],"parameters":[{"name":"storyId","in":"query","required":true,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoryContent"}}}}}}},"/api/stories/enrich-sources":{"get":{"operationId":"story.enrichSources","tags":["Stories"],"parameters":[{"name":"storyId","in":"query","required":true,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"sources":{"type":"array","items":{"$ref":"#/components/schemas/StorySource"}}},"required":["sources"]}}}}}}},"/api/stories/progress":{"post":{"operationId":"story.progress","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"},"startedOnly":{"type":"boolean"},"currentSegmentIndex":{"type":"integer","minimum":0},"currentSlideIndex":{"type":"integer","minimum":0}},"required":["storyId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"story":{"$ref":"#/components/schemas/StorySummary"}},"required":["ok","story"]}}}}}}},"/api/stories/save-line":{"post":{"operationId":"story.saveLine","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"},"segments":{"type":"array","items":{"type":"object","properties":{"segmentIndex":{"type":"integer","minimum":0},"charOffset":{"type":"integer","minimum":0},"text":{"type":"string","minLength":1}},"required":["segmentIndex","charOffset","text"]},"minItems":1},"text":{"type":"string","minLength":1},"segmentIndex":{"type":"integer","minimum":0},"slideIndex":{"type":"integer","minimum":0},"charOffset":{"type":"integer","minimum":0}},"required":["storyId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"groupId":{"type":"string"}},"required":["ok","groupId"]}}}}}}},"/api/stories/unsave-line":{"post":{"operationId":"story.unsaveLine","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"},"groupId":{"type":"string"},"savedLineId":{"type":"string"}},"required":["storyId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/stories/search-selection":{"post":{"operationId":"story.search","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"},"selectedText":{"type":"string","minLength":1},"contextText":{"type":"string"}},"required":["storyId","selectedText"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorySearchResponse"}}}}}}},"/api/stories/delete":{"post":{"operationId":"story.delete","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"}},"required":["storyId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/stories/mark-unread":{"post":{"operationId":"story.markUnread","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"}},"required":["storyId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/stories/react":{"post":{"operationId":"story.react","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"},"reaction":{"enum":["not_for_me","love"],"type":["string","null"]}},"required":["storyId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/stories/feedback":{"post":{"operationId":"story.feedback","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"},"text":{"type":"string","minLength":1}},"required":["storyId","text"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/stories/archive":{"post":{"operationId":"story.archive","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"}},"required":["storyId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/stories/review":{"post":{"operationId":"story.review","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"},"decision":{"enum":["save","already_known","didnt_understand","not_interested","dismiss","not_for_me"],"type":"string"},"reason":{"type":["string","null"]}},"required":["storyId","decision"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/stories/generate-picker-pitch":{"post":{"operationId":"story.generatePickerPitch","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"},"precedingStories":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"subtitle":{"type":"string"},"messages":{"type":"array","items":{"type":"string"}}},"required":["title","subtitle","messages"]},"maxItems":10}},"required":["storyId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"messages":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"maxItems":3},"cached":{"type":"boolean"}},"required":["messages","cached"]}}}}}}},"/api/stories/follow-ups":{"post":{"operationId":"story.followUps","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"}},"required":["storyId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"threads":{"type":"array","items":{"type":"object","properties":{"segmentIndex":{"type":"integer","minimum":0},"question":{"type":"string","minLength":1}},"required":["segmentIndex","question"]},"maxItems":4}},"required":["threads"]}}}}}}},"/api/stories/refine-feed":{"post":{"operationId":"story.refineFeed","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"clarification":{"type":"string","minLength":1,"maxLength":2000}},"required":["clarification"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoryListResponse"}}}}}}},"/api/stories/unarchive":{"post":{"operationId":"story.unarchive","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"}},"required":["storyId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/stories/archived":{"get":{"operationId":"story.listArchived","tags":["Stories"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArchivedStoriesResponse"}}}}}}},"/api/stories/advance":{"post":{"operationId":"story.advance","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"},"followUpLabel":{"type":"string","minLength":1}},"required":["storyId","followUpLabel"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoryRequestNewResponse"}}}}}}},"/api/stories/prefetch-follow-ups":{"post":{"operationId":"story.prefetchFollowUps","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"}},"required":["storyId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/stories/composer-suggestions":{"get":{"operationId":"story.composerSuggestions","tags":["Stories"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComposerSuggestionsResponse"}}}}}}},"/api/stories/lane-cards":{"get":{"operationId":"story.laneCards","tags":["Stories"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cards":{"type":"array","items":{"type":"object","properties":{"laneId":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"}},"required":["laneId","title","subtitle"]}}},"required":["cards"]}}}}}}},"/api/stories/lane-feedback":{"post":{"operationId":"story.laneFeedback","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"laneId":{"type":"string","minLength":1},"action":{"enum":["less","more"],"type":"string"}},"required":["laneId","action"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cards":{"type":"array","items":{"type":"object","properties":{"laneId":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"}},"required":["laneId","title","subtitle"]}}},"required":["cards"]}}}}}}},"/api/stories/archive-lane":{"post":{"operationId":"story.archiveLane","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"laneId":{"type":"string","minLength":1}},"required":["laneId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cards":{"type":"array","items":{"type":"object","properties":{"laneId":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"}},"required":["laneId","title","subtitle"]}}},"required":["cards"]}}}}}}},"/api/stories/claim-share":{"post":{"operationId":"story.claimShare","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sourceStoryId":{"type":"string","minLength":1}},"required":["sourceStoryId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"},"alreadyClaimed":{"type":"boolean"}},"required":["storyId","alreadyClaimed"]}}}}}}},"/api/stories/composer-submit":{"post":{"operationId":"story.composerSubmit","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"question":{"type":"string"},"userName":{"type":["string","null"]},"source":{"type":["string","null"]}},"required":["question"]}}}},"responses":{"200":{"description":"OK","content":{"text/event-stream":{"schema":{"oneOf":[{"type":"object","properties":{"event":{"const":"message"},"data":{"type":"string"},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event","data"]},{"type":"object","properties":{"event":{"const":"done"},"data":{},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event"]},{"type":"object","properties":{"event":{"const":"error"},"data":{},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event"]}]}}}}}}},"/api/stories/search-stream":{"post":{"operationId":"story.searchStream","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"},"selectedText":{"type":"string"},"contextText":{"type":["string","null"]},"history":{"type":"array","items":{"type":"object","properties":{"role":{"enum":["user","assistant"],"type":"string"},"content":{"type":"string"}},"required":["role","content"]}}},"required":["storyId","selectedText"]}}}},"responses":{"200":{"description":"OK","content":{"text/event-stream":{"schema":{"oneOf":[{"type":"object","properties":{"event":{"const":"message"},"data":{"anyOf":[{"type":"object","properties":{"type":{"const":"title"},"text":{"type":"string"}},"required":["type","text"]},{"type":"object","properties":{"type":{"const":"delta"},"text":{"type":"string"}},"required":["type","text"]}]},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event","data"]},{"type":"object","properties":{"event":{"const":"done"},"data":{},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event"]},{"type":"object","properties":{"event":{"const":"error"},"data":{},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event"]}]}}}}}}},"/api/stories/{id}/audio":{"post":{"operationId":"story.audio","tags":["Stories"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"speed":{"type":"number"},"section":{"enum":["body","pickerMessages"],"type":"string"}}}}}},"responses":{"200":{"description":"OK","content":{"text/event-stream":{"schema":{"oneOf":[{"type":"object","properties":{"event":{"const":"message"},"data":{"anyOf":[{"type":"object","properties":{"type":{"const":"started"},"payload":{"type":"object","properties":{"cacheHit":{"type":"boolean"},"totalChunks":{"type":"integer","minimum":0}},"required":["cacheHit","totalChunks"]}},"required":["type","payload"]},{"type":"object","properties":{"type":{"const":"chunk-prepared"},"payload":{"type":"object","properties":{"index":{"type":"integer","minimum":0},"url":{"type":"string"},"cumulativeDurationMs":{"type":"integer","minimum":0}},"required":["index","url","cumulativeDurationMs"]}},"required":["type","payload"]},{"type":"object","properties":{"type":{"const":"chunk-finalized"},"payload":{"type":"object","properties":{"index":{"type":"integer","minimum":0},"durationMs":{"type":"integer","minimum":0},"words":{"type":"array","items":{"$ref":"#/components/schemas/WordTiming"}}},"required":["index","durationMs","words"]}},"required":["type","payload"]},{"type":"object","properties":{"type":{"const":"complete"},"payload":{"type":"object","properties":{"totalDurationMs":{"type":"integer","minimum":0},"totalChunks":{"type":"integer","minimum":0}},"required":["totalDurationMs","totalChunks"]}},"required":["type","payload"]}]},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event","data"]},{"type":"object","properties":{"event":{"const":"done"},"data":{},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event"]},{"type":"object","properties":{"event":{"const":"error"},"data":{},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event"]}]}}}}}}},"/api/stories/prewarm-audio":{"post":{"operationId":"story.prewarmAudio","tags":["Stories"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"},"speed":{"type":"number"},"section":{"enum":["body","pickerMessages"],"type":"string"}},"required":["storyId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/search/cards":{"post":{"operationId":"search.cards","tags":["Search"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1},"batchIndex":{"default":0,"type":"integer","minimum":0,"maximum":100},"previousClusterKeys":{"default":[],"type":"array","items":{"type":"string","minLength":1,"maxLength":120},"maxItems":500},"previousExaQueries":{"default":[],"type":"array","items":{"type":"string","minLength":1,"maxLength":220},"maxItems":500},"includeLegacyCopy":{"default":false,"type":"boolean"},"includeFacets":{"default":false,"type":"boolean"}},"required":["query"]}}}},"responses":{"200":{"description":"OK","content":{"text/event-stream":{"schema":{"oneOf":[{"type":"object","properties":{"event":{"const":"message"},"data":{"anyOf":[{"type":"object","properties":{"type":{"const":"status"},"text":{"type":"string"}},"required":["type","text"]},{"type":"object","properties":{"type":{"const":"plan"},"exaQueries":{"type":"array","items":{"type":"string"}},"rejectedExaQueries":{"type":"array","items":{"type":"string"}}},"required":["type","exaQueries"]},{"type":"object","properties":{"type":{"const":"facets"},"facets":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"hint":{"type":"string"}},"required":["key","hint"]}}},"required":["type","facets"]},{"type":"object","properties":{"type":{"const":"sources"},"sources":{"type":"array","items":{"type":"object","properties":{"host":{"type":"string"},"title":{"type":"string"},"rankScore":{"type":"number"},"selected":{"type":"boolean"}},"required":["host","title","rankScore","selected"]}}},"required":["type","sources"]},{"type":"object","properties":{"type":{"const":"card"},"card":{"type":"object","properties":{"id":{"type":"string"},"clusterKey":{"type":"string"},"headline":{"type":"string"},"summary":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}},"imageUrl":{"type":"string"},"imageAttribution":{"type":["object","null"],"properties":{"originUrl":{"type":"string"},"title":{"type":["string","null"]}},"required":["originUrl"]},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]}},"facet":{"type":"string"},"headlineStyle":{"type":"string"},"rawHeadline":{"type":"string"},"rawHighlights":{"type":"array","items":{"type":"string"}}},"required":["id","clusterKey","headline","summary","highlights","imageUrl","sources"]}},"required":["type","card"]},{"type":"object","properties":{"type":{"const":"done"}},"required":["type"]}]},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event","data"]},{"type":"object","properties":{"event":{"const":"done"},"data":{},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event"]},{"type":"object","properties":{"event":{"const":"error"},"data":{},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event"]}]}}}}}}},"/api/search/card-detail":{"post":{"operationId":"search.cardDetail","tags":["Search"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"headline":{"type":"string"},"summary":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}},"query":{"type":["string","null"]},"question":{"type":["string","null"]},"glossary":{"type":"boolean"},"history":{"type":"array","items":{"type":"object","properties":{"role":{"enum":["user","assistant"],"type":"string"},"content":{"type":"string"}},"required":["role","content"]}},"discoverCardId":{"type":["string","null"]},"regenerate":{"type":"boolean"}},"required":["headline","summary"]}}}},"responses":{"200":{"description":"OK","content":{"text/event-stream":{"schema":{"oneOf":[{"type":"object","properties":{"event":{"const":"message"},"data":{"anyOf":[{"type":"object","properties":{"type":{"const":"title"},"text":{"type":"string"}},"required":["type","text"]},{"type":"object","properties":{"type":{"const":"delta"},"text":{"type":"string"}},"required":["type","text"]},{"type":"object","properties":{"type":{"const":"status"},"text":{"type":"string"}},"required":["type","text"]},{"type":"object","properties":{"type":{"const":"cached"},"text":{"type":"string"}},"required":["type","text"]},{"type":"object","properties":{"type":{"const":"sources"},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]}}},"required":["type","sources"]}]},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event","data"]},{"type":"object","properties":{"event":{"const":"done"},"data":{},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event"]},{"type":"object","properties":{"event":{"const":"error"},"data":{},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event"]}]}}}}}}},"/api/search/suggest":{"post":{"operationId":"search.suggest","tags":["Search"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":200}},"required":["query"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"suggestions":{"type":"array","items":{"type":"string"}}},"required":["suggestions"]}}}}}}},"/api/discover/feed":{"get":{"operationId":"discover.feed","tags":["Discover"],"parameters":[{"name":"excludeCardIds","in":"query","schema":{"default":[],"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":100},"style":"form","explode":true,"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cards":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"sourceQuery":{"type":"string"},"clusterKey":{"type":"string"},"headline":{"type":"string"},"summary":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}},"sourceKind":{"enum":["interest","explore","timely","search","question","shared"],"type":"string"},"isOnboardingStarter":{"type":"boolean"},"sharedByName":{"type":["string","null"]},"headlineStyle":{"type":["string","null"]},"rawHeadline":{"type":["string","null"]},"rawHighlights":{"type":["array","null"],"items":{"type":"string"}},"imageUrl":{"type":"string"},"imageAttribution":{"type":["object","null"],"properties":{"originUrl":{"type":"string"},"title":{"type":["string","null"]}},"required":["originUrl"]},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]}}},"required":["id","sourceQuery","clusterKey","headline","summary","highlights","imageUrl","sources"]}},"isGenerating":{"type":"boolean"},"preparation":{"enum":["preparing","ready","failed"],"type":"string"}},"required":["cards","isGenerating"]}}}}}}},"/api/discover/seen":{"post":{"operationId":"discover.seen","tags":["Discover"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"impressions":{"default":[],"type":"array","items":{"type":"object","properties":{"cardId":{"type":"string","minLength":1},"dwellMs":{"type":"integer","minimum":0,"maximum":600000}},"required":["cardId","dwellMs"]},"maxItems":100},"cardIds":{"default":[],"type":"array","items":{"type":"string","minLength":1},"maxItems":100},"sessionEnd":{"default":false,"type":"boolean"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"isGenerating":{"type":"boolean"}},"required":["isGenerating"]}}}}}}},"/api/discover/react":{"post":{"operationId":"discover.react","tags":["Discover"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cardId":{"type":"string","minLength":1},"reaction":{"enum":["loved","disliked"],"type":["string","null"]}},"required":["cardId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/discover/opened":{"post":{"operationId":"discover.opened","tags":["Discover"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cardId":{"type":"string","minLength":1},"dwellMs":{"default":0,"type":"integer","minimum":0,"maximum":1800000}},"required":["cardId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/discover/loved":{"get":{"operationId":"discover.loved","tags":["Discover"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cards":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"sourceQuery":{"type":"string"},"clusterKey":{"type":"string"},"headline":{"type":"string"},"summary":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}},"sourceKind":{"enum":["interest","explore","timely","search","question","shared"],"type":"string"},"isOnboardingStarter":{"type":"boolean"},"sharedByName":{"type":["string","null"]},"headlineStyle":{"type":["string","null"]},"rawHeadline":{"type":["string","null"]},"rawHighlights":{"type":["array","null"],"items":{"type":"string"}},"imageUrl":{"type":"string"},"imageAttribution":{"type":["object","null"],"properties":{"originUrl":{"type":"string"},"title":{"type":["string","null"]}},"required":["originUrl"]},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]}}},"required":["id","sourceQuery","clusterKey","headline","summary","highlights","imageUrl","sources"]}}},"required":["cards"]}}}}}}},"/api/discover/card":{"get":{"operationId":"discover.card","tags":["Discover"],"parameters":[{"name":"cardId","in":"query","required":true,"schema":{"type":"string","minLength":1},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"card":{"type":["object","null"],"properties":{"id":{"type":"string"},"sourceQuery":{"type":"string"},"clusterKey":{"type":"string"},"headline":{"type":"string"},"summary":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}},"sourceKind":{"enum":["interest","explore","timely","search","question","shared"],"type":"string"},"isOnboardingStarter":{"type":"boolean"},"sharedByName":{"type":["string","null"]},"headlineStyle":{"type":["string","null"]},"rawHeadline":{"type":["string","null"]},"rawHighlights":{"type":["array","null"],"items":{"type":"string"}},"imageUrl":{"type":"string"},"imageAttribution":{"type":["object","null"],"properties":{"originUrl":{"type":"string"},"title":{"type":["string","null"]}},"required":["originUrl"]},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]}}},"required":["id","sourceQuery","clusterKey","headline","summary","highlights","imageUrl","sources"]}},"required":["card"]}}}}}}},"/api/podcast/list":{"get":{"operationId":"podcast.list","tags":["Podcast"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"topics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status":{"enum":["queued","researching","scripting","rendering","transcribing","ready","failed"],"type":"string"},"title":{"type":"string"},"blurb":{"type":["string","null"]},"loved":{"type":"boolean"},"artworkUrl":{"type":["string","null"]},"audioUrl":{"type":["string","null"]},"durationMs":{"type":["integer","null"]},"progressMs":{"type":"integer"},"completedAt":{"type":["string","null"]},"position":{"type":"integer"}},"required":["id","status","title","blurb","loved","artworkUrl","audioUrl","durationMs","progressMs","completedAt","position"]}},"intro":{"type":["object","null"],"properties":{"id":{"type":"string"},"status":{"enum":["generating","ready","failed"],"type":"string"},"audioUrl":{"type":["string","null"]},"durationMs":{"type":["integer","null"]}},"required":["id","status","audioUrl","durationMs"]},"isGenerating":{"type":"boolean"},"nextRefreshInMs":{"type":["integer","null"],"minimum":0}},"required":["topics","intro","isGenerating","nextRefreshInMs"]}}}}}}},"/api/podcast/topic":{"get":{"operationId":"podcast.topic","tags":["Podcast"],"parameters":[{"name":"topicId","in":"query","required":true,"schema":{"type":"string","minLength":1},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"topic":{"type":"object","properties":{"id":{"type":"string"},"status":{"enum":["queued","researching","scripting","rendering","transcribing","ready","failed"],"type":"string"},"title":{"type":"string"},"blurb":{"type":["string","null"]},"loved":{"type":"boolean"},"artworkUrl":{"type":["string","null"]},"audioUrl":{"type":["string","null"]},"durationMs":{"type":["integer","null"]},"progressMs":{"type":"integer"},"completedAt":{"type":["string","null"]},"position":{"type":"integer"},"whyPicked":{"type":["string","null"]},"transcript":{"type":"array","items":{"type":"object","properties":{"word":{"type":"string"},"startMs":{"type":"integer","minimum":0},"endMs":{"type":"integer","minimum":0}},"required":["word","startMs","endMs"]}}},"required":["id","status","title","blurb","loved","artworkUrl","audioUrl","durationMs","progressMs","completedAt","position","whyPicked","transcript"]}},"required":["topic"]}}}}}}},"/api/podcast/progress":{"post":{"operationId":"podcast.progress","tags":["Podcast"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string","minLength":1},"progressMs":{"type":"integer","minimum":0}},"required":["topicId","progressMs"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/podcast/intro-played":{"post":{"operationId":"podcast.introPlayed","tags":["Podcast"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"introId":{"type":"string","minLength":1}},"required":["introId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/podcast/completed":{"post":{"operationId":"podcast.completed","tags":["Podcast"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string","minLength":1}},"required":["topicId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/podcast/react":{"post":{"operationId":"podcast.react","tags":["Podcast"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string","minLength":1},"reaction":{"enum":["loved"],"type":["string","null"]}},"required":["topicId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/podcast/library":{"get":{"operationId":"podcast.library","tags":["Podcast"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"topics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status":{"enum":["queued","researching","scripting","rendering","transcribing","ready","failed"],"type":"string"},"title":{"type":"string"},"blurb":{"type":["string","null"]},"loved":{"type":"boolean"},"artworkUrl":{"type":["string","null"]},"audioUrl":{"type":["string","null"]},"durationMs":{"type":["integer","null"]},"progressMs":{"type":"integer"},"completedAt":{"type":["string","null"]},"position":{"type":"integer"}},"required":["id","status","title","blurb","loved","artworkUrl","audioUrl","durationMs","progressMs","completedAt","position"]}}},"required":["topics"]}}}}}}},"/api/collections/save-search-card":{"post":{"operationId":"collections.saveSearchCard","tags":["Collections"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1},"card":{"type":"object","properties":{"id":{"type":"string"},"clusterKey":{"type":"string"},"headline":{"type":"string"},"summary":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}},"imageUrl":{"type":"string"},"imageAttribution":{"type":["object","null"],"properties":{"originUrl":{"type":"string"},"title":{"type":["string","null"]}},"required":["originUrl"]},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]}},"facet":{"type":"string"},"headlineStyle":{"type":"string"},"rawHeadline":{"type":"string"},"rawHighlights":{"type":"array","items":{"type":"string"}}},"required":["id","clusterKey","headline","summary","highlights","imageUrl","sources"]}},"required":["query","card"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cardId":{"type":"string"}},"required":["cardId"]}}}}}}},"/api/collections":{"get":{"operationId":"collections.list","tags":["Collections"],"parameters":[{"name":"cardId","in":"query","schema":{"type":"string","minLength":1},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"collections":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"itemCount":{"type":"integer"},"coverImageUrl":{"type":["string","null"]},"coverHeadline":{"type":["string","null"]},"containsCard":{"type":"boolean"}},"required":["id","name","itemCount","coverImageUrl","coverHeadline"]}}},"required":["collections"]}}}}}}},"/api/collections/create":{"post":{"operationId":"collections.create","tags":["Collections"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"cardId":{"type":"string","minLength":1}},"required":["name"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"collection":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"itemCount":{"type":"integer"},"coverImageUrl":{"type":["string","null"]},"coverHeadline":{"type":["string","null"]},"containsCard":{"type":"boolean"}},"required":["id","name","itemCount","coverImageUrl","coverHeadline"]}},"required":["collection"]}}}}}}},"/api/collections/update":{"post":{"operationId":"collections.update","tags":["Collections"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"collectionId":{"type":"string","minLength":1},"name":{"type":"string","minLength":1,"maxLength":80}},"required":["collectionId","name"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/collections/delete":{"post":{"operationId":"collections.delete","tags":["Collections"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"collectionId":{"type":"string","minLength":1}},"required":["collectionId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/collections/add-card":{"post":{"operationId":"collections.addCard","tags":["Collections"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"collectionId":{"type":"string","minLength":1},"cardId":{"type":"string","minLength":1}},"required":["collectionId","cardId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/collections/remove-card":{"post":{"operationId":"collections.removeCard","tags":["Collections"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"collectionId":{"type":"string","minLength":1},"cardId":{"type":"string","minLength":1}},"required":["collectionId","cardId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/collections/items":{"get":{"operationId":"collections.items","tags":["Collections"],"parameters":[{"name":"collectionId","in":"query","required":true,"schema":{"type":"string","minLength":1},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"collection":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"itemCount":{"type":"integer"},"coverImageUrl":{"type":["string","null"]},"coverHeadline":{"type":["string","null"]},"containsCard":{"type":"boolean"}},"required":["id","name","itemCount","coverImageUrl","coverHeadline"]},"cards":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"sourceQuery":{"type":"string"},"clusterKey":{"type":"string"},"headline":{"type":"string"},"summary":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}},"sourceKind":{"enum":["interest","explore","timely","search","question","shared"],"type":"string"},"isOnboardingStarter":{"type":"boolean"},"sharedByName":{"type":["string","null"]},"headlineStyle":{"type":["string","null"]},"rawHeadline":{"type":["string","null"]},"rawHighlights":{"type":["array","null"],"items":{"type":"string"}},"imageUrl":{"type":"string"},"imageAttribution":{"type":["object","null"],"properties":{"originUrl":{"type":"string"},"title":{"type":["string","null"]}},"required":["originUrl"]},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]}}},"required":["id","sourceQuery","clusterKey","headline","summary","highlights","imageUrl","sources"]}}},"required":["collection","cards"]}}}}}}},"/api/collections/suggest-names":{"get":{"operationId":"collections.suggestNames","tags":["Collections"],"parameters":[{"name":"cardId","in":"query","required":true,"schema":{"type":"string","minLength":1},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"names":{"type":"array","items":{"type":"string"}}},"required":["names"]}}}}}}},"/api/card-share/create":{"post":{"operationId":"cardShare.create","tags":["CardShare"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"discoverCardId":{"type":"string","minLength":1},"card":{"type":"object","properties":{"headline":{"type":"string","minLength":1,"maxLength":500},"summary":{"type":"string","maxLength":2000},"highlights":{"type":"array","items":{"type":"string","maxLength":1000},"maxItems":12},"imageUrl":{"type":"string","maxLength":2000},"imageAttribution":{"type":["object","null"],"properties":{"originUrl":{"type":"string","maxLength":2000},"title":{"type":["string","null"],"maxLength":500}},"required":["originUrl"]},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]},"maxItems":24},"clusterKey":{"type":"string","minLength":1,"maxLength":120},"query":{"type":"string","maxLength":500}},"required":["headline","summary","highlights","imageUrl","sources","clusterKey","query"]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"shareId":{"type":"string"},"url":{"type":"string"}},"required":["shareId","url"]}}}}}}},"/api/card-share":{"get":{"operationId":"cardShare.get","tags":["CardShare"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","minLength":1},"allowEmptyValue":true,"allowReserved":true},{"name":"surface","in":"query","required":false,"schema":{"enum":["web","appclip"],"type":"string"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"shareId":{"type":"string"},"sharedByName":{"type":["string","null"]},"headline":{"type":"string"},"summary":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}},"imageUrl":{"type":"string"},"imageAttribution":{"type":["object","null"],"properties":{"originUrl":{"type":"string"},"title":{"type":["string","null"]}},"required":["originUrl"]},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]}},"detailContent":{"type":["string","null"]},"detailSources":{"type":["array","null"],"items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]}}},"required":["shareId","sharedByName","headline","summary","highlights","imageUrl","imageAttribution","sources","detailContent","detailSources"]}}}}}}},"/api/card-share/detail":{"post":{"operationId":"cardShare.detail","tags":["CardShare"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"shareId":{"type":"string","minLength":1},"question":{"type":["string","null"],"maxLength":2000},"history":{"type":"array","items":{"type":"object","properties":{"role":{"enum":["user","assistant"],"type":"string"},"content":{"type":"string"}},"required":["role","content"]},"maxItems":24}},"required":["shareId"]}}}},"responses":{"200":{"description":"OK","content":{"text/event-stream":{"schema":{"oneOf":[{"type":"object","properties":{"event":{"const":"message"},"data":{"anyOf":[{"type":"object","properties":{"type":{"const":"title"},"text":{"type":"string"}},"required":["type","text"]},{"type":"object","properties":{"type":{"const":"delta"},"text":{"type":"string"}},"required":["type","text"]},{"type":"object","properties":{"type":{"const":"status"},"text":{"type":"string"}},"required":["type","text"]},{"type":"object","properties":{"type":{"const":"cached"},"text":{"type":"string"}},"required":["type","text"]},{"type":"object","properties":{"type":{"const":"sources"},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]}}},"required":["type","sources"]}]},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event","data"]},{"type":"object","properties":{"event":{"const":"done"},"data":{},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event"]},{"type":"object","properties":{"event":{"const":"error"},"data":{},"id":{"type":"string"},"retry":{"type":"number"}},"required":["event"]}]}}}}}}},"/api/card-share/claim":{"post":{"operationId":"cardShare.claim","tags":["CardShare"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"shareId":{"type":"string","minLength":1}},"required":["shareId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cardId":{"type":"string"},"alreadyClaimed":{"type":"boolean"}},"required":["cardId","alreadyClaimed"]}}}}}}},"/api/admin/me":{"get":{"operationId":"admin.me","tags":["Admin"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"phoneNumber":{"type":"string"},"runtimeEnvironment":{"enum":["dev","prod"],"type":"string"},"impersonating":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"phoneNumber":{"type":"string"}},"required":["id","name"]}},"required":["id","name","runtimeEnvironment"]}}}}}}},"/api/admin/users":{"get":{"operationId":"admin.users.list","tags":["Admin"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"supermemoryContainerTag":{"type":"string"},"name":{"type":"string"},"phoneNumber":{"type":"string"},"onboardingCompleted":{"type":"boolean"},"onboardingStep":{"type":"string"},"onboardingSeedText":{"type":"string"},"onboardingPlanResponse":{"type":"string"},"storyCount":{"type":"integer","minimum":0},"queueStoryCount":{"default":0,"type":"integer","minimum":0},"shelfStoryCount":{"default":0,"type":"integer","minimum":0},"activeStoryCount":{"default":0,"type":"integer","minimum":0},"completedStoryCount":{"type":"integer","minimum":0},"todayViewed":{"default":0,"type":"integer","minimum":0},"todayStarted":{"default":0,"type":"integer","minimum":0},"todayDone":{"default":0,"type":"integer","minimum":0},"createdAt":{"type":"string"},"lastSeenAt":{"type":"string"},"lastTextedAt":{"type":"string"},"textsEnabled":{"type":"boolean"},"infiniteFeedEnabled":{"default":false,"type":"boolean"},"appVersion":{"type":"string"},"isOnPublishedAppVersion":{"type":"boolean"},"deletedAt":{"type":"string"}},"required":["id","supermemoryContainerTag","name","onboardingCompleted","onboardingStep","storyCount","completedStoryCount","createdAt"]}},"publishedAppVersion":{"type":"string"}},"required":["users"]}}}}}}},"/api/admin/users/detail":{"get":{"operationId":"admin.users.detail","tags":["Admin"],"parameters":[{"name":"userId","in":"query","required":true,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"object","properties":{"id":{"type":"string"},"supermemoryContainerTag":{"type":"string"},"name":{"type":"string"},"phoneNumber":{"type":"string"},"onboardingCompleted":{"type":"boolean"},"onboardingStep":{"type":"string"},"onboardingSeedText":{"type":"string"},"onboardingPlanResponse":{"type":"string"},"storyCount":{"type":"integer","minimum":0},"queueStoryCount":{"default":0,"type":"integer","minimum":0},"shelfStoryCount":{"default":0,"type":"integer","minimum":0},"activeStoryCount":{"default":0,"type":"integer","minimum":0},"completedStoryCount":{"type":"integer","minimum":0},"todayViewed":{"default":0,"type":"integer","minimum":0},"todayStarted":{"default":0,"type":"integer","minimum":0},"todayDone":{"default":0,"type":"integer","minimum":0},"createdAt":{"type":"string"},"lastSeenAt":{"type":"string"},"lastTextedAt":{"type":"string"},"textsEnabled":{"type":"boolean"},"infiniteFeedEnabled":{"default":false,"type":"boolean"},"appVersion":{"type":"string"},"isOnPublishedAppVersion":{"type":"boolean"},"deletedAt":{"type":"string"}},"required":["id","supermemoryContainerTag","name","onboardingCompleted","onboardingStep","storyCount","completedStoryCount","createdAt"]},"publishedAppVersion":{"type":"string"},"stories":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"userId":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"},"status":{"$ref":"#/components/schemas/StoryStatus"},"archived":{"default":false,"type":"boolean"},"hiddenReason":{"enum":["expired","admin","completed","disliked","errored"],"type":"string"},"visible":{"default":true,"type":"boolean"},"reaction":{"enum":["not_for_me","love"],"type":"string"},"reviewedAs":{"enum":["saved","auto_saved","already_known","didnt_understand","not_interested","dismissed"],"type":["string","null"]},"segmentCount":{"type":"integer","minimum":0},"lastViewedSegmentIndex":{"type":"integer","minimum":0},"createdAt":{"type":"string"},"lastTouchedAt":{"type":"string"},"startedAt":{"type":"string"},"completedAt":{"type":"string"},"stickerImageUrl":{"type":"string"},"failureReason":{"type":"string"},"forDate":{"type":"string"},"tracesDashboardUrl":{"type":"string"},"errorDashboardUrl":{"type":"string"},"sourceKind":{"enum":["core","adjacent","wildcard"],"type":"string"},"sourceLane":{"type":"string"},"titleVariant":{"enum":["og","v1"],"type":"string"},"pickerMessages":{"type":["array","null"],"items":{"type":"string","minLength":1},"minItems":1,"maxItems":3},"dailyNotificationMessages":{"type":["array","null"],"items":{"type":"string","minLength":1,"maxLength":520},"maxItems":2,"minItems":2}},"required":["id","userId","title","subtitle","status","segmentCount","lastViewedSegmentIndex","createdAt","lastTouchedAt"]}},"coverViewedStoryIds":{"default":[],"type":"array","items":{"type":"string"}},"savedLines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"storyId":{"type":"string"},"storyTitle":{"type":"string"},"text":{"type":"string"},"contextText":{"type":"string"},"segmentIndex":{"type":"integer","minimum":0},"groupId":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","storyId","storyTitle","text","segmentIndex","groupId","createdAt"]}},"readerSearches":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"storyId":{"type":"string"},"storyTitle":{"type":"string"},"selectedText":{"type":"string"},"contextText":{"type":"string"},"title":{"type":"string"},"explainer":{"type":"string"},"createdAt":{"type":"string"}},"required":["id","storyId","storyTitle","selectedText","title","explainer","createdAt"]}},"storyFeedback":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"storyId":{"type":"string"},"storyTitle":{"type":"string"},"text":{"type":"string"},"createdAt":{"type":"string"}},"required":["id","storyId","storyTitle","text","createdAt"]}},"interestProfile":{"type":"object","properties":{"narrative":{"default":"","type":"string"},"archetypes":{"default":[],"type":"array","items":{"type":"string"}},"attracts":{"default":[],"type":"array","items":{"type":"string"}},"repels":{"default":[],"type":"array","items":{"type":"string"}},"confidence":{"enum":["low","medium","high"],"type":"string"},"lanes":{"type":"array","items":{"type":"object","properties":{"laneId":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"cachedScore":{"type":["object","null"],"properties":{"heat":{"type":"number"},"depth":{"type":"number"},"boost":{"default":0,"type":"number"},"effective":{"type":"number"},"computedAt":{"type":"string"}},"required":["heat","depth","effective","computedAt"]},"searchQueries":{"default":[],"type":"array","items":{"type":"string"}},"recentAnchors":{"default":[],"type":"array","items":{"type":"string"}}},"required":["name","description"]}}},"required":["confidence","lanes"]},"interestProfileGeneratedAt":{"type":"string"}},"required":["user","stories","savedLines","readerSearches","storyFeedback"]}}}}}}},"/api/admin/users/activity":{"get":{"operationId":"admin.users.activity","tags":["Admin"],"parameters":[{"name":"userId","in":"query","required":true,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"recentActivity":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"event":{"type":"string"},"summary":{"type":"string"},"timestamp":{"type":"string"},"distinctId":{"type":"string"},"userId":{"type":"string"},"unitTitle":{"type":"string"},"screenName":{"type":"string"},"sourceSurface":{"type":"string"},"properties":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}},"required":["id","event","summary","timestamp","distinctId"]}},"nextCursor":{"type":"string"}},"required":["recentActivity"]}}}}}}},"/api/admin/users/traces":{"get":{"operationId":"admin.users.traces","tags":["Admin"],"parameters":[{"name":"userId","in":"query","required":true,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"traces":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"spanId":{"type":"string"},"rootSpanId":{"type":"string"},"parentSpanId":{"type":"string"},"name":{"type":"string"},"workflowId":{"type":"string"},"userId":{"type":"string"},"storyId":{"type":"string"},"startedAt":{"type":"string"},"endedAt":{"type":"string"},"durationMs":{"type":"number"},"hasError":{"type":"boolean"},"dashboardUrl":{"type":"string"},"errorDashboardUrl":{"type":"string"},"story":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"},"stickerImageUrl":{"type":"string"},"archived":{"type":"boolean"},"hiddenReason":{"enum":["expired","admin","completed","disliked","errored"],"type":"string"},"status":{"$ref":"#/components/schemas/StoryStatus"}},"required":["id","title","archived","status"]}},"required":["id","spanId","rootSpanId","name","hasError","dashboardUrl"]}},"dashboardUrl":{"type":"string"}},"required":["traces"]}}}}}}},"/api/admin/users/replays":{"get":{"operationId":"admin.users.replays","tags":["Admin"],"parameters":[{"name":"userId","in":"query","required":true,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"replays":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"startedAt":{"type":"string"},"finishedAt":{"type":"string"},"durationSeconds":{"type":["number","null"]},"countErrors":{"type":["integer","null"]},"countSegments":{"type":["integer","null"]},"countUrls":{"type":["integer","null"]},"isArchived":{"type":"boolean"},"hasViewed":{"type":"boolean"},"activity":{"type":["number","null"]},"osName":{"type":["string","null"]},"osVersion":{"type":["string","null"]},"deviceName":{"type":["string","null"]},"deviceModel":{"type":["string","null"]},"release":{"type":["string","null"]},"environment":{"type":["string","null"]},"platform":{"type":["string","null"]},"url":{"type":"string"}},"required":["id","startedAt","url"]}},"searchUrl":{"type":["string","null"]},"organization":{"type":["string","null"]},"project":{"type":["string","null"]},"configured":{"type":"boolean"},"error":{"type":["string","null"]}},"required":["replays","searchUrl","organization","project","configured","error"]}}}}}}},"/api/admin/stories":{"get":{"operationId":"admin.stories.list","tags":["Admin"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"stories":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"userId":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"},"status":{"$ref":"#/components/schemas/StoryStatus"},"archived":{"default":false,"type":"boolean"},"hiddenReason":{"enum":["expired","admin","completed","disliked","errored"],"type":"string"},"visible":{"default":true,"type":"boolean"},"reaction":{"enum":["not_for_me","love"],"type":"string"},"reviewedAs":{"enum":["saved","auto_saved","already_known","didnt_understand","not_interested","dismissed"],"type":["string","null"]},"segmentCount":{"type":"integer","minimum":0},"lastViewedSegmentIndex":{"type":"integer","minimum":0},"createdAt":{"type":"string"},"lastTouchedAt":{"type":"string"},"startedAt":{"type":"string"},"completedAt":{"type":"string"},"stickerImageUrl":{"type":"string"},"failureReason":{"type":"string"},"forDate":{"type":"string"},"tracesDashboardUrl":{"type":"string"},"errorDashboardUrl":{"type":"string"},"sourceKind":{"enum":["core","adjacent","wildcard"],"type":"string"},"sourceLane":{"type":"string"},"titleVariant":{"enum":["og","v1"],"type":"string"},"pickerMessages":{"type":["array","null"],"items":{"type":"string","minLength":1},"minItems":1,"maxItems":3},"dailyNotificationMessages":{"type":["array","null"],"items":{"type":"string","minLength":1,"maxLength":520},"maxItems":2,"minItems":2},"userName":{"type":"string"},"userPhoneNumber":{"type":"string"}},"required":["id","userId","title","subtitle","status","segmentCount","lastViewedSegmentIndex","createdAt","lastTouchedAt","userName"]}}},"required":["stories"]}}}}}}},"/api/admin/stories/detail":{"get":{"operationId":"admin.stories.detail","tags":["Admin"],"parameters":[{"name":"storyId","in":"query","required":true,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"story":{"type":"object","properties":{"id":{"type":"string"},"userId":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"},"status":{"$ref":"#/components/schemas/StoryStatus"},"archived":{"default":false,"type":"boolean"},"hiddenReason":{"enum":["expired","admin","completed","disliked","errored"],"type":"string"},"visible":{"default":true,"type":"boolean"},"reaction":{"enum":["not_for_me","love"],"type":"string"},"reviewedAs":{"enum":["saved","auto_saved","already_known","didnt_understand","not_interested","dismissed"],"type":["string","null"]},"segmentCount":{"type":"integer","minimum":0},"lastViewedSegmentIndex":{"type":"integer","minimum":0},"createdAt":{"type":"string"},"lastTouchedAt":{"type":"string"},"startedAt":{"type":"string"},"completedAt":{"type":"string"},"stickerImageUrl":{"type":"string"},"failureReason":{"type":"string"},"forDate":{"type":"string"},"tracesDashboardUrl":{"type":"string"},"errorDashboardUrl":{"type":"string"},"sourceKind":{"enum":["core","adjacent","wildcard"],"type":"string"},"sourceLane":{"type":"string"},"titleVariant":{"enum":["og","v1"],"type":"string"},"pickerMessages":{"type":["array","null"],"items":{"type":"string","minLength":1},"minItems":1,"maxItems":3},"dailyNotificationMessages":{"type":["array","null"],"items":{"type":"string","minLength":1,"maxLength":520},"maxItems":2,"minItems":2},"sourceStoryId":{"type":"string"},"stickerSubject":{"type":"string"}},"required":["id","userId","title","subtitle","status","segmentCount","lastViewedSegmentIndex","createdAt","lastTouchedAt"]},"segments":{"type":"array","items":{"$ref":"#/components/schemas/StorySegment"}},"prePolishSegments":{"type":"array","items":{"$ref":"#/components/schemas/StorySegment"}},"followUps":{"type":"array","items":{"$ref":"#/components/schemas/StoryFollowUp"}},"research":{"type":"object","properties":{"sources":{"default":[],"type":"array","items":{"$ref":"#/components/schemas/StorySource"}}}},"briefs":{"default":[],"type":"array","items":{"type":"object","properties":{"briefId":{"type":"string"},"laneId":{"type":["string","null"]},"laneName":{"type":["string","null"]},"yaml":{"type":"string"},"parsed":{"type":["object","null"],"properties":{"reasoning":{"type":"string"},"fields":{"type":"object","additionalProperties":{"type":["string","null"]}}},"required":["reasoning","fields"]},"parseError":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]},"sourceStoryId":{"type":["string","null"]},"sourceStoryTitle":{"type":["string","null"]},"servedStoryId":{"type":["string","null"]},"servedStoryTitle":{"type":["string","null"]},"createdAt":{"type":"string"},"servedAt":{"type":["string","null"]}},"required":["briefId","yaml","parsed","createdAt"]}},"savedLines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"storyId":{"type":"string"},"storyTitle":{"type":"string"},"text":{"type":"string"},"contextText":{"type":"string"},"segmentIndex":{"type":"integer","minimum":0},"groupId":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","storyId","storyTitle","text","segmentIndex","groupId","createdAt"]}},"readerSearches":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"storyId":{"type":"string"},"storyTitle":{"type":"string"},"selectedText":{"type":"string"},"contextText":{"type":"string"},"title":{"type":"string"},"explainer":{"type":"string"},"createdAt":{"type":"string"}},"required":["id","storyId","storyTitle","selectedText","title","explainer","createdAt"]}},"storyFeedback":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"storyId":{"type":"string"},"storyTitle":{"type":"string"},"text":{"type":"string"},"createdAt":{"type":"string"}},"required":["id","storyId","storyTitle","text","createdAt"]}}},"required":["story","segments","followUps","savedLines","readerSearches","storyFeedback"]}}}}}}},"/api/admin/stories/analytics":{"get":{"operationId":"admin.stories.analytics","tags":["Admin"],"parameters":[{"name":"storyId","in":"query","required":true,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"recentActivity":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"event":{"type":"string"},"summary":{"type":"string"},"timestamp":{"type":"string"},"distinctId":{"type":"string"},"userId":{"type":"string"},"unitTitle":{"type":"string"},"screenName":{"type":"string"},"sourceSurface":{"type":"string"},"properties":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}},"required":["id","event","summary","timestamp","distinctId"]}},"nextCursor":{"type":"string"}},"required":["recentActivity"]}}}}}}},"/api/admin/stories/traces":{"get":{"operationId":"admin.stories.traces","tags":["Admin"],"parameters":[{"name":"storyId","in":"query","required":true,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"traces":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"spanId":{"type":"string"},"rootSpanId":{"type":"string"},"parentSpanId":{"type":"string"},"name":{"type":"string"},"workflowId":{"type":"string"},"userId":{"type":"string"},"storyId":{"type":"string"},"startedAt":{"type":"string"},"endedAt":{"type":"string"},"durationMs":{"type":"number"},"hasError":{"type":"boolean"},"dashboardUrl":{"type":"string"},"errorDashboardUrl":{"type":"string"},"story":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"},"stickerImageUrl":{"type":"string"},"archived":{"type":"boolean"},"hiddenReason":{"enum":["expired","admin","completed","disliked","errored"],"type":"string"},"status":{"$ref":"#/components/schemas/StoryStatus"}},"required":["id","title","archived","status"]}},"required":["id","spanId","rootSpanId","name","hasError","dashboardUrl"]}},"dashboardUrl":{"type":"string"}},"required":["traces"]}}}}}}},"/api/admin/reading-replays":{"get":{"operationId":"admin.readingReplays.list","tags":["Admin"],"parameters":[{"name":"userId","in":"query","schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true},{"name":"storyId","in":"query","schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true},{"name":"cardId","in":"query","schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"replays":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"userId":{"type":"string"},"userName":{"type":["string","null"]},"unitKind":{"enum":["story","card_detail"],"type":"string"},"storyId":{"type":["string","null"]},"cardId":{"type":["string","null"]},"unitTitle":{"type":["string","null"]},"startedAt":{"type":"string"},"endedAt":{"type":"string"},"durationMs":{"type":"number"},"activeMs":{"type":"number"},"maxScrollFraction":{"type":"number"},"endReason":{"type":"string"},"segmentCount":{"type":"number"},"interactionCount":{"type":"number"}},"required":["id","userId","userName","unitKind","storyId","cardId","unitTitle","startedAt","endedAt","durationMs","activeMs","maxScrollFraction","endReason","segmentCount","interactionCount"]}}},"required":["replays"]}}}}}}},"/api/admin/reading-replays/detail":{"get":{"operationId":"admin.readingReplays.get","tags":["Admin"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"replay":{"type":["object","null"],"properties":{"id":{"type":"string"},"userId":{"type":"string"},"userName":{"type":["string","null"]},"unitKind":{"enum":["story","card_detail"],"type":"string"},"storyId":{"type":["string","null"]},"cardId":{"type":["string","null"]},"unitTitle":{"type":["string","null"]},"startedAt":{"type":"string"},"endedAt":{"type":"string"},"durationMs":{"type":"number"},"activeMs":{"type":"number"},"maxScrollFraction":{"type":"number"},"endReason":{"type":"string"},"segmentCount":{"type":"number"},"interactionCount":{"type":"number"},"contentHeightPx":{"type":"number"},"viewportHeightPx":{"type":"number"},"storySubtitle":{"type":["string","null"]},"segments":{"type":"array","items":{"$ref":"#/components/schemas/StorySegment"}},"samples":{"type":"array","items":{"type":"object","properties":{"t":{"type":"integer","minimum":0},"frac":{"type":"number","minimum":0,"maximum":1}},"required":["t","frac"]}},"interactions":{"type":"array","items":{"type":"object","properties":{"t":{"type":"integer","minimum":0},"type":{"type":"string","minLength":1}},"required":["t","type"]}},"geometry":{"type":["object","null"],"properties":{"scrollableDistancePx":{"type":"number"},"screenWidthPt":{"type":"number"},"contentWidthPt":{"type":"number"},"topInsetPt":{"type":"number"},"bottomInsetPt":{"type":"number"},"dynamicTypeScale":{"type":"number"},"segmentLayout":{"default":[],"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0},"topPx":{"type":"number"},"heightPx":{"type":"number"}},"required":["index","topPx","heightPx"]}}}}},"required":["id","userId","userName","unitKind","storyId","cardId","unitTitle","startedAt","endedAt","durationMs","activeMs","maxScrollFraction","endReason","segmentCount","interactionCount","contentHeightPx","viewportHeightPx","storySubtitle","segments","samples","interactions","geometry"]}},"required":["replay"]}}}}}}},"/api/admin/lanes/history":{"post":{"operationId":"admin.lanes.history","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"laneId":{"type":"string"}},"required":["userId","laneId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"userName":{"type":"string"},"laneId":{"type":"string"},"laneName":{"type":"string"},"current":{"type":["object","null"],"properties":{"heat":{"type":"number"},"depth":{"type":"number"},"boost":{"default":0,"type":"number"},"effective":{"type":"number"},"computedAt":{"type":"string"}},"required":["heat","depth","effective","computedAt"]},"events":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"string"},"kind":{"enum":["thought","saved_line","feedback_positive","story_completion","story_reacted_love","not_for_me","picker_not_interested","branch","story_open","page_read","decay"],"type":"string"},"rawPoints":{"type":"number"},"boostPoints":{"type":"number"},"label":{"type":"string"},"sourceId":{"type":["string","null"]},"thought":{"type":["object","null"],"properties":{"intensity":{"type":"number","minimum":0,"maximum":1},"direction":{"enum":["positive","negative"],"type":"string"},"coAttributions":{"type":"array","items":{"type":"object","properties":{"laneName":{"type":"string"},"intensity":{"type":"number","minimum":0,"maximum":1},"direction":{"enum":["positive","negative"],"type":"string"}},"required":["laneName","intensity","direction"]}}},"required":["intensity","direction","coAttributions"]},"runningHeat":{"type":"number"},"runningDepth":{"type":"number"},"runningBoost":{"type":"number"},"runningEffective":{"type":"number"}},"required":["timestamp","kind","rawPoints","boostPoints","label","sourceId","thought","runningHeat","runningDepth","runningBoost","runningEffective"]}}},"required":["userId","userName","laneId","laneName","current","events"]}}}}}}},"/api/admin/product/metrics":{"post":{"operationId":"admin.product.metrics","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"days":{"default":30,"anyOf":[{"const":7},{"const":30},{"const":90}]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"generatedAt":{"type":"string"},"windowDays":{"type":"integer","minimum":0},"totals":{"type":"object","properties":{"totalUsers":{"type":"integer","minimum":0},"activeUsers":{"type":"integer","minimum":0},"cardsGenerated":{"type":"integer","minimum":0},"cardsUnseen":{"type":"integer","minimum":0},"cardsSeen":{"type":"integer","minimum":0},"cardsOpened":{"type":"integer","minimum":0},"cardsRead":{"type":"integer","minimum":0},"cardsSkipped":{"type":"integer","minimum":0},"cardsLoved":{"type":"integer","minimum":0},"cardsDisliked":{"type":"integer","minimum":0},"searches":{"type":"integer","minimum":0},"searchUsers":{"type":"integer","minimum":0},"questions":{"type":"integer","minimum":0},"questionUsers":{"type":"integer","minimum":0},"generationRuns":{"type":"integer","minimum":0},"failedRuns":{"type":"integer","minimum":0}},"required":["totalUsers","activeUsers","cardsGenerated","cardsUnseen","cardsSeen","cardsOpened","cardsRead","cardsSkipped","cardsLoved","cardsDisliked","searches","searchUsers","questions","questionUsers","generationRuns","failedRuns"]},"rates":{"type":"object","properties":{"activeUserRate":{"type":"number","minimum":0,"maximum":1},"cardsSeenPerActiveUser":{"type":"number","minimum":0},"openRate":{"type":"number","minimum":0,"maximum":1},"readRate":{"type":"number","minimum":0,"maximum":1},"skipRate":{"type":"number","minimum":0,"maximum":1},"loveRate":{"type":"number","minimum":0,"maximum":1},"searchUserRate":{"type":"number","minimum":0,"maximum":1},"questionUserRate":{"type":"number","minimum":0,"maximum":1},"generationFailureRate":{"type":"number","minimum":0,"maximum":1}},"required":["activeUserRate","cardsSeenPerActiveUser","openRate","readRate","skipRate","loveRate","searchUserRate","questionUserRate","generationFailureRate"]},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"totalUsers":{"type":"integer","minimum":0},"activeUsers":{"type":"integer","minimum":0},"cardsGenerated":{"type":"integer","minimum":0},"cardsSeen":{"type":"integer","minimum":0},"cardsOpened":{"type":"integer","minimum":0},"cardsRead":{"type":"integer","minimum":0},"cardsSkipped":{"type":"integer","minimum":0},"cardsLoved":{"type":"integer","minimum":0},"cardsDisliked":{"type":"integer","minimum":0},"searches":{"type":"integer","minimum":0},"searchUsers":{"type":"integer","minimum":0},"questions":{"type":"integer","minimum":0},"questionUsers":{"type":"integer","minimum":0},"generationRuns":{"type":"integer","minimum":0},"failedRuns":{"type":"integer","minimum":0}},"required":["date","totalUsers","activeUsers","cardsGenerated","cardsSeen","cardsOpened","cardsRead","cardsSkipped","cardsLoved","cardsDisliked","searches","searchUsers","questions","questionUsers","generationRuns","failedRuns"]}},"sourceKinds":{"type":"array","items":{"type":"object","properties":{"sourceKind":{"enum":["interest","explore","timely","search","question","shared"],"type":"string"},"generated":{"type":"integer","minimum":0},"seen":{"type":"integer","minimum":0},"opened":{"type":"integer","minimum":0},"loved":{"type":"integer","minimum":0}},"required":["sourceKind","generated","seen","opened","loved"]}},"pipeline":{"type":"object","properties":{"running":{"type":"integer","minimum":0},"succeeded":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0},"acceptedCards":{"type":"integer","minimum":0},"averageDurationMs":{"type":["number","null"],"minimum":0}},"required":["running","succeeded","failed","acceptedCards","averageDurationMs"]},"recentSignals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"enum":["search","question","love","dislike","open"],"type":"string"},"text":{"type":"string"},"createdAt":{"type":"string"},"userId":{"type":"string"},"userName":{"type":"string"},"cardId":{"type":["string","null"]},"cardHeadline":{"type":["string","null"]}},"required":["id","kind","text","createdAt","userId","userName","cardId","cardHeadline"]}}},"required":["generatedAt","windowDays","totals","rates","daily","sourceKinds","pipeline","recentSignals"]}}}}}}},"/api/admin/product/metric-detail":{"post":{"operationId":"admin.product.metricDetail","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"metric":{"enum":["activeUsers","cardsSeen","cardsRead","cardsSkipped","cardsOpened","searches","questions","cardsLoved","failedRuns"],"type":"string"},"days":{"default":30,"anyOf":[{"const":7},{"const":30},{"const":90}]},"limit":{"default":200,"type":"integer","minimum":1,"maximum":500}},"required":["metric"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"metric":{"enum":["activeUsers","cardsSeen","cardsRead","cardsSkipped","cardsOpened","searches","questions","cardsLoved","failedRuns"],"type":"string"},"total":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"entries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"string"},"userId":{"type":"string"},"userName":{"type":"string"},"cardId":{"type":["string","null"]},"cardHeadline":{"type":["string","null"]},"text":{"type":["string","null"]},"detail":{"type":["string","null"]}},"required":["id","createdAt","userId","userName","cardId","cardHeadline","text","detail"]}}},"required":["metric","total","truncated","entries"]}}}}}}},"/api/admin/product/users":{"get":{"operationId":"admin.product.users","tags":["Admin"],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"phoneNumber":{"type":["string","null"]},"onboardingCompleted":{"type":"boolean"},"onboardingStep":{"type":"string"},"onboardingSeedText":{"type":["string","null"]},"textsEnabled":{"type":["boolean","null"]},"infiniteFeedEnabled":{"type":"boolean"},"createdAt":{"type":"string"},"deletedAt":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"]},"cardsTotal":{"type":"integer","minimum":0},"cardsUnseen":{"type":"integer","minimum":0},"cardsSeen":{"type":"integer","minimum":0},"cardsOpened":{"type":"integer","minimum":0},"cardsLoved":{"type":"integer","minimum":0},"cardsDisliked":{"type":"integer","minimum":0},"searches":{"type":"integer","minimum":0},"questions":{"type":"integer","minimum":0},"isGenerating":{"type":"boolean"},"tasteObservations":{"type":"number","minimum":0}},"required":["id","name","phoneNumber","onboardingCompleted","onboardingStep","onboardingSeedText","textsEnabled","infiniteFeedEnabled","createdAt","deletedAt","lastSeenAt","cardsTotal","cardsUnseen","cardsSeen","cardsOpened","cardsLoved","cardsDisliked","searches","questions","isGenerating","tasteObservations"]}}},"required":["users"]}}}}}}},"/api/admin/product/user":{"post":{"operationId":"admin.product.user","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","minLength":1}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"phoneNumber":{"type":["string","null"]},"onboardingCompleted":{"type":"boolean"},"onboardingStep":{"type":"string"},"onboardingSeedText":{"type":["string","null"]},"textsEnabled":{"type":["boolean","null"]},"infiniteFeedEnabled":{"type":"boolean"},"createdAt":{"type":"string"},"deletedAt":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"]},"cardsTotal":{"type":"integer","minimum":0},"cardsUnseen":{"type":"integer","minimum":0},"cardsSeen":{"type":"integer","minimum":0},"cardsOpened":{"type":"integer","minimum":0},"cardsLoved":{"type":"integer","minimum":0},"cardsDisliked":{"type":"integer","minimum":0},"searches":{"type":"integer","minimum":0},"questions":{"type":"integer","minimum":0},"isGenerating":{"type":"boolean"},"tasteObservations":{"type":"number","minimum":0}},"required":["id","name","phoneNumber","onboardingCompleted","onboardingStep","onboardingSeedText","textsEnabled","infiniteFeedEnabled","createdAt","deletedAt","lastSeenAt","cardsTotal","cardsUnseen","cardsSeen","cardsOpened","cardsLoved","cardsDisliked","searches","questions","isGenerating","tasteObservations"]},"lanes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"kind":{"type":"string"},"source":{"type":"string"},"createdAt":{"type":"string"}},"required":["id","name","description","kind","source","createdAt"]}},"collections":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"cardCount":{"type":"integer","minimum":0},"lastUsedAt":{"type":"string"}},"required":["id","name","cardCount","lastUsedAt"]}}},"required":["user","lanes","collections"]}}}}}}},"/api/admin/product/cards":{"post":{"operationId":"admin.product.cards","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"query":{"type":"string"},"sourceKind":{"enum":["interest","explore","timely","search","question","shared"],"type":"string"},"state":{"default":"all","enum":["all","unseen","seen","opened","engaged"],"type":"string"},"reaction":{"enum":["loved","disliked"],"type":"string"},"limit":{"default":100,"type":"integer","minimum":1,"maximum":200}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cards":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"userId":{"type":"string"},"userName":{"type":"string"},"batchId":{"type":"string"},"headline":{"type":"string"},"summary":{"type":"string"},"sourceQuery":{"type":"string"},"sourceKind":{"enum":["interest","explore","timely","search","question","shared"],"type":"string"},"topicKey":{"type":["string","null"]},"imageUrl":{"type":"string"},"seenAt":{"type":["string","null"]},"dwellMs":{"type":"integer","minimum":0},"openedAt":{"type":["string","null"]},"openDwellMs":{"type":"integer","minimum":0},"engagedAt":{"type":["string","null"]},"evictedAt":{"type":["string","null"]},"reaction":{"enum":["loved","disliked"],"type":["string","null"]},"servedRank":{"type":["integer","null"]},"hasDetail":{"type":"boolean"},"createdAt":{"type":"string"}},"required":["id","userId","userName","batchId","headline","summary","sourceQuery","sourceKind","topicKey","imageUrl","seenAt","dwellMs","openedAt","openDwellMs","engagedAt","evictedAt","reaction","servedRank","hasDetail","createdAt"]}}},"required":["cards"]}}}}}}},"/api/admin/product/card":{"post":{"operationId":"admin.product.card","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cardId":{"type":"string","minLength":1}},"required":["cardId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"card":{"type":"object","properties":{"id":{"type":"string"},"userId":{"type":"string"},"userName":{"type":"string"},"batchId":{"type":"string"},"headline":{"type":"string"},"summary":{"type":"string"},"sourceQuery":{"type":"string"},"sourceKind":{"enum":["interest","explore","timely","search","question","shared"],"type":"string"},"topicKey":{"type":["string","null"]},"imageUrl":{"type":"string"},"seenAt":{"type":["string","null"]},"dwellMs":{"type":"integer","minimum":0},"openedAt":{"type":["string","null"]},"openDwellMs":{"type":"integer","minimum":0},"engagedAt":{"type":["string","null"]},"evictedAt":{"type":["string","null"]},"reaction":{"enum":["loved","disliked"],"type":["string","null"]},"servedRank":{"type":["integer","null"]},"hasDetail":{"type":"boolean"},"createdAt":{"type":"string"},"clusterKey":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"},"publishedDate":{"type":["string","null"]}},"required":["title","url"]}},"detailContent":{"type":["string","null"]},"detailSources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"},"publishedDate":{"type":["string","null"]}},"required":["title","url"]}},"generation":{"type":["object","null"],"properties":{"trigger":{"type":"string"},"status":{"enum":["running","succeeded","failed"],"type":"string"},"acceptedCount":{"type":"integer","minimum":0},"error":{"type":["string","null"]},"startedAt":{"type":"string"},"finishedAt":{"type":["string","null"]}},"required":["trigger","status","acceptedCount","error","startedAt","finishedAt"]}},"required":["id","userId","userName","batchId","headline","summary","sourceQuery","sourceKind","topicKey","imageUrl","seenAt","dwellMs","openedAt","openDwellMs","engagedAt","evictedAt","reaction","servedRank","hasDetail","createdAt","clusterKey","highlights","sources","detailContent","detailSources","generation"]}},"required":["card"]}}}}}}},"/api/admin/podcast-analytics/user-listens":{"post":{"operationId":"admin.podcastAnalytics.userListens","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","minLength":1},"days":{"default":90,"anyOf":[{"const":7},{"const":30},{"const":90}]}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"listens":{"type":"array","items":{"type":"object","properties":{"listenId":{"type":"string"},"topicId":{"type":"string"},"title":{"type":"string"},"userId":{"type":"string"},"userName":{"type":["string","null"]},"source":{"enum":["session","events"],"type":"string"},"startedAt":{"type":"string"},"endedAt":{"type":["string","null"]},"durationMs":{"type":"integer","minimum":0},"startPositionMs":{"type":"integer","minimum":0},"furthestMs":{"type":"integer","minimum":0},"dropoffMs":{"type":["integer","null"],"minimum":0},"activeMs":{"type":["integer","null"],"minimum":0},"completed":{"type":"boolean"},"endReason":{"type":"string"},"events":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string"},"type":{"type":"string"},"positionMs":{"type":"integer","minimum":0}},"required":["at","type","positionMs"]}},"spans":{"type":"array","items":{"type":"object","properties":{"sessionStartMs":{"type":"integer","minimum":0},"sessionEndMs":{"type":"integer","minimum":0},"audioStartMs":{"type":"integer","minimum":0},"audioEndMs":{"type":"integer","minimum":0},"playbackRate":{"type":"number","minimum":0,"maximum":4}},"required":["sessionStartMs","sessionEndMs","audioStartMs","audioEndMs","playbackRate"]}}},"required":["listenId","topicId","title","userId","userName","source","startedAt","endedAt","durationMs","startPositionMs","furthestMs","dropoffMs","activeMs","completed","endReason","events","spans"]}}},"required":["listens"]}}}}}}},"/api/admin/podcast-analytics/episode-listens":{"post":{"operationId":"admin.podcastAnalytics.episodeListens","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string","minLength":1}},"required":["topicId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"episode":{"type":"object","properties":{"topicId":{"type":"string"},"title":{"type":"string"},"blurb":{"type":["string","null"]},"userId":{"type":"string"},"userName":{"type":["string","null"]},"readyAt":{"type":["string","null"]},"durationMs":{"type":"integer","minimum":0},"completed":{"type":"boolean"}},"required":["topicId","title","blurb","userId","userName","readyAt","durationMs","completed"]},"transcript":{"type":"array","items":{"type":"object","properties":{"word":{"type":"string"},"startMs":{"type":"integer","minimum":0},"endMs":{"type":"integer","minimum":0}},"required":["word","startMs","endMs"]}},"listens":{"type":"array","items":{"type":"object","properties":{"listenId":{"type":"string"},"topicId":{"type":"string"},"title":{"type":"string"},"userId":{"type":"string"},"userName":{"type":["string","null"]},"source":{"enum":["session","events"],"type":"string"},"startedAt":{"type":"string"},"endedAt":{"type":["string","null"]},"durationMs":{"type":"integer","minimum":0},"startPositionMs":{"type":"integer","minimum":0},"furthestMs":{"type":"integer","minimum":0},"dropoffMs":{"type":["integer","null"],"minimum":0},"activeMs":{"type":["integer","null"],"minimum":0},"completed":{"type":"boolean"},"endReason":{"type":"string"},"events":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string"},"type":{"type":"string"},"positionMs":{"type":"integer","minimum":0}},"required":["at","type","positionMs"]}},"spans":{"type":"array","items":{"type":"object","properties":{"sessionStartMs":{"type":"integer","minimum":0},"sessionEndMs":{"type":"integer","minimum":0},"audioStartMs":{"type":"integer","minimum":0},"audioEndMs":{"type":"integer","minimum":0},"playbackRate":{"type":"number","minimum":0,"maximum":4}},"required":["sessionStartMs","sessionEndMs","audioStartMs","audioEndMs","playbackRate"]}}},"required":["listenId","topicId","title","userId","userName","source","startedAt","endedAt","durationMs","startPositionMs","furthestMs","dropoffMs","activeMs","completed","endReason","events","spans"]}}},"required":["episode","transcript","listens"]}}}}}}},"/api/admin/discover/explain":{"post":{"operationId":"admin.discover.explain","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","minLength":1}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"state":{"type":"object","properties":{"isGenerating":{"type":"boolean"},"seenSinceGeneration":{"type":"number"},"recentExaQueries":{"type":"array","items":{"type":"string"}}},"required":["isGenerating","seenSinceGeneration","recentExaQueries"]},"stats":{"type":"array","items":{"type":"object","properties":{"sourceKind":{"enum":["interest","explore","timely","search","question","shared"],"type":"string"},"seen":{"type":"number"},"engaged":{"type":"number"},"skipped":{"type":"number"},"opened":{"type":"number"},"loved":{"type":"number"}},"required":["sourceKind","seen","engaged","skipped","opened","loved"]}},"topics":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"kind":{"enum":["interest","explore"],"type":"string"},"state":{"enum":["active","cooldown"],"type":"string"},"alpha":{"type":"number"},"beta":{"type":"number"},"score":{"type":"number"},"laneId":{"type":["string","null"]},"lastEngagedAt":{"type":["string","null"]},"cooldownUntil":{"type":["string","null"]}},"required":["key","label","kind","state","alpha","beta","score","laneId","lastEngagedAt","cooldownUntil"]}},"pool":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"headline":{"type":"string"},"topicKey":{"type":["string","null"]},"sourceKind":{"enum":["interest","explore","timely","search","question","shared"],"type":"string"},"sourceQuery":{"type":"string"},"relevance":{"type":"number"},"topicScore":{"type":"number"},"score":{"type":"number"},"dislikeSim":{"type":"number"},"suppressed":{"type":"boolean"},"windowRank":{"type":["number","null"]},"position":{"type":"number"}},"required":["id","headline","topicKey","sourceKind","sourceQuery","relevance","topicScore","score","dislikeSim","suppressed","windowRank","position"]}},"recentSeen":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"headline":{"type":"string"},"topicKey":{"type":["string","null"]},"sourceKind":{"enum":["interest","explore","timely","search","question","shared"],"type":"string"},"dwellMs":{"type":"number"},"opened":{"type":"boolean"},"openDwellMs":{"type":"number"},"engaged":{"type":"boolean"},"reaction":{"enum":["loved","disliked"],"type":["string","null"]},"seenAt":{"type":["string","null"]}},"required":["id","headline","topicKey","sourceKind","dwellMs","opened","openDwellMs","engaged","reaction","seenAt"]}},"signals":{"type":"array","items":{"type":"object","properties":{"kind":{"enum":["search_query","card_question"],"type":"string"},"text":{"type":"string"},"cardId":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["kind","text","cardId","createdAt"]}}},"required":["state","stats","topics","pool","recentSeen","signals"]}}}}}}},"/api/admin/discover/steer":{"post":{"operationId":"admin.discover.steer","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","minLength":1},"action":{"anyOf":[{"type":"object","properties":{"kind":{"const":"direction"},"text":{"type":"string","minLength":2,"maxLength":300}},"required":["kind","text"]},{"type":"object","properties":{"kind":{"const":"boostTopic"},"topicKey":{"type":"string","minLength":1}},"required":["kind","topicKey"]},{"type":"object","properties":{"kind":{"const":"cooldownTopic"},"topicKey":{"type":"string","minLength":1}},"required":["kind","topicKey"]},{"type":"object","properties":{"kind":{"const":"evictCard"},"cardId":{"type":"string","minLength":1}},"required":["kind","cardId"]},{"type":"object","properties":{"kind":{"const":"generate"}},"required":["kind"]},{"type":"object","properties":{"kind":{"const":"clearPool"}},"required":["kind"]}]}},"required":["userId","action"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/admin/discover/runs":{"post":{"operationId":"admin.discover.runs","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","minLength":1}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"trigger":{"type":"string"},"status":{"enum":["running","succeeded","failed"],"type":"string"},"queries":{"type":"array","items":{"type":"object","properties":{"query":{"type":"string"},"topicKey":{"type":"string"},"topicLabel":{"type":"string"},"kind":{"enum":["interest","explore","timely"],"type":"string"},"exaQueries":{"type":"array","items":{"type":"string"}},"rejectedExaQueries":{"default":[],"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"host":{"type":"string"},"title":{"type":"string"},"rankScore":{"type":"number"},"selected":{"type":"boolean"}},"required":["host","title","rankScore","selected"]}},"editorialCandidates":{"default":[],"type":"array","items":{"type":"object","properties":{"clusterId":{"type":"string"},"key":{"type":"string"},"title":{"type":"string"},"tier":{"enum":["exceptional","strong","reject","omitted"],"type":"string"},"reason":{"type":"string"},"rationale":{"type":"string"},"detailPromise":{"type":"string"},"selectedForResearch":{"type":"boolean"}},"required":["clusterId","key","title","tier","reason","rationale","detailPromise","selectedForResearch"]}},"researchRejections":{"default":[],"type":"array","items":{"type":"object","properties":{"clusterId":{"type":"string"},"title":{"type":"string"},"reason":{"type":"string"},"rationale":{"type":"string"}},"required":["clusterId","title","reason","rationale"]}},"cards":{"type":"array","items":{"type":"object","properties":{"clusterKey":{"type":"string"},"headline":{"type":"string"},"outcome":{"enum":["accepted","cluster_dup","near_dup","judge_dup","saga_cap","explore_cap","over_target","error"],"type":"string"},"detail":{"type":["string","null"]}},"required":["clusterKey","headline","outcome","detail"]}},"error":{"type":["string","null"]}},"required":["query","topicKey","topicLabel","kind","exaQueries","sources","cards","error"]}},"plannerUsedFallback":{"type":"boolean"},"unseenBefore":{"type":["number","null"]},"targetCount":{"type":["number","null"]},"acceptedCount":{"type":"number"},"error":{"type":["string","null"]},"startedAt":{"type":"string"},"finishedAt":{"type":["string","null"]}},"required":["id","trigger","status","queries","plannerUsedFallback","unseenBefore","targetCount","acceptedCount","error","startedAt","finishedAt"]}}},"required":["runs"]}}}}}}},"/api/admin/discover/simulate-ideation":{"post":{"operationId":"admin.discover.simulateIdeation","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","minLength":1}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"context":{"type":"object","properties":{"lanes":{"type":"array","items":{"type":"object","properties":{"index":{"type":"number"},"name":{"type":"string"},"description":{"type":"string"}},"required":["index","name","description"]}},"recentEngagedHeadlines":{"type":"array","items":{"type":"string"}},"avoid":{"type":"array","items":{"type":"string"}},"counts":{"type":"object","properties":{"deepenPerLane":{"type":"number"},"adjacentCount":{"type":"number"},"bridgeCount":{"type":"number"},"wildcardCount":{"type":"number"},"timelyCount":{"type":"number"}},"required":["deepenPerLane","adjacentCount","bridgeCount","wildcardCount","timelyCount"]},"unusedPoolSize":{"type":"number"},"poolRefillFloor":{"type":"number"}},"required":["lanes","recentEngagedHeadlines","avoid","counts","unusedPoolSize","poolRefillFloor"]},"ideator":{"type":"object","properties":{"candidates":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"query":{"type":"string"},"kind":{"enum":["deepen","adjacent","bridge","wildcard"],"type":"string"},"contentType":{"enum":["story","person","history","concept","data","place","timely"],"type":["string","null"]},"laneName":{"type":["string","null"]}},"required":["label","query","kind","contentType","laneName"]}},"error":{"type":["string","null"]}},"required":["candidates","error"]},"graphs":{"type":"array","items":{"type":"object","properties":{"laneName":{"type":"string"},"laneDescription":{"type":"string"},"graph":{"type":["object","null"],"properties":{"coreConcepts":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"why":{"type":"string"}},"required":["name","why"]}},"people":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"why":{"type":"string"}},"required":["name","why"]}},"organizations":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"why":{"type":"string"}},"required":["name","why"]}},"concreteEntities":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"why":{"type":"string"}},"required":["name","why"]}},"hiddenLineage":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"why":{"type":"string"}},"required":["name","why"]}},"descendants":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"why":{"type":"string"}},"required":["name","why"]}},"rabbitHoles":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"why":{"type":"string"}},"required":["name","why"]}},"whoaConnections":{"type":"array","items":{"type":"object","properties":{"connection":{"type":"string"},"why":{"type":"string"}},"required":["connection","why"]}}},"required":["coreConcepts","people","organizations","concreteEntities","hiddenLineage","descendants","rabbitHoles","whoaConnections"]},"error":{"type":["string","null"]}},"required":["laneName","laneDescription","graph","error"]}},"graphCandidates":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"query":{"type":"string"},"kind":{"enum":["deepen","adjacent","bridge","wildcard"],"type":"string"},"contentType":{"enum":["story","person","history","concept","data","place","timely"],"type":["string","null"]},"laneName":{"type":["string","null"]}},"required":["label","query","kind","contentType","laneName"]}},"durationMs":{"type":"number"}},"required":["context","ideator","graphs","graphCandidates","durationMs"]}}}}}}},"/api/admin/discover/graph-runs":{"post":{"operationId":"admin.discover.graphRuns","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","minLength":1}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"laneName":{"type":"string"},"entity":{"type":"string"},"harvestedCount":{"type":"number"},"createdAt":{"type":"string"},"graph":{"type":"object","properties":{"coreConcepts":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"why":{"type":"string"}},"required":["name","why"]}},"people":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"why":{"type":"string"}},"required":["name","why"]}},"organizations":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"why":{"type":"string"}},"required":["name","why"]}},"concreteEntities":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"why":{"type":"string"}},"required":["name","why"]}},"hiddenLineage":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"why":{"type":"string"}},"required":["name","why"]}},"descendants":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"why":{"type":"string"}},"required":["name","why"]}},"rabbitHoles":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"why":{"type":"string"}},"required":["name","why"]}},"whoaConnections":{"type":"array","items":{"type":"object","properties":{"connection":{"type":"string"},"why":{"type":"string"}},"required":["connection","why"]}}},"required":["coreConcepts","people","organizations","concreteEntities","hiddenLineage","descendants","rabbitHoles","whoaConnections"]}},"required":["id","laneName","entity","harvestedCount","createdAt","graph"]}}},"required":["runs"]}}}}}}},"/api/admin/discover/editorial-labels/create":{"post":{"operationId":"admin.discover.editorialLabelCreate","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"profileUserId":{"type":"string","minLength":1},"targetCount":{"default":100,"type":"integer","minimum":1,"maximum":100}},"required":["profileUserId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"batchId":{"type":"string"}},"required":["batchId"]}}}}}}},"/api/admin/discover/editorial-labels/list":{"post":{"operationId":"admin.discover.editorialLabelList","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"batches":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"profileUserId":{"type":["string","null"]},"profileName":{"type":["string","null"]},"status":{"enum":["planning","generating","ready","labeling","completed","failed"],"type":"string"},"targetCount":{"type":"integer"},"readyCount":{"type":"integer"},"reviewedCount":{"type":"integer"},"publishCount":{"type":"integer"},"rejectCount":{"type":"integer"},"unsureCount":{"type":"integer"},"pendingCount":{"type":"integer"},"titleGoodCount":{"type":"integer"},"titleBadCount":{"type":"integer"},"titleUnsureCount":{"type":"integer"},"titlePendingCount":{"type":"integer"},"failedTaskCount":{"type":"integer"},"error":{"type":["string","null"]},"createdAt":{"type":"string"},"finishedAt":{"type":["string","null"]}},"required":["id","profileUserId","profileName","status","targetCount","readyCount","reviewedCount","publishCount","rejectCount","unsureCount","pendingCount","titleGoodCount","titleBadCount","titleUnsureCount","titlePendingCount","failedTaskCount","error","createdAt","finishedAt"]}}},"required":["batches"]}}}}}}},"/api/admin/discover/editorial-labels/get":{"post":{"operationId":"admin.discover.editorialLabelGet","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"batchId":{"type":"string","minLength":1}},"required":["batchId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"batch":{"type":"object","properties":{"id":{"type":"string"},"profileUserId":{"type":["string","null"]},"profileName":{"type":["string","null"]},"status":{"enum":["planning","generating","ready","labeling","completed","failed"],"type":"string"},"targetCount":{"type":"integer"},"readyCount":{"type":"integer"},"reviewedCount":{"type":"integer"},"publishCount":{"type":"integer"},"rejectCount":{"type":"integer"},"unsureCount":{"type":"integer"},"pendingCount":{"type":"integer"},"titleGoodCount":{"type":"integer"},"titleBadCount":{"type":"integer"},"titleUnsureCount":{"type":"integer"},"titlePendingCount":{"type":"integer"},"failedTaskCount":{"type":"integer"},"error":{"type":["string","null"]},"createdAt":{"type":"string"},"finishedAt":{"type":["string","null"]}},"required":["id","profileUserId","profileName","status","targetCount","readyCount","reviewedCount","publishCount","rejectCount","unsureCount","pendingCount","titleGoodCount","titleBadCount","titleUnsureCount","titlePendingCount","failedTaskCount","error","createdAt","finishedAt"]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"batchId":{"type":"string"},"ordinal":{"type":"integer"},"headline":{"type":"string"},"summary":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}},"imageUrl":{"type":"string"},"imageAttribution":{"type":["object","null"],"properties":{"originUrl":{"type":"string"},"title":{"type":["string","null"]}},"required":["originUrl"]},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]}},"decision":{"enum":["publish","reject","unsure"],"type":["string","null"]},"reason":{"enum":["trivial","too_basic","thin_evidence","generic","no_consequence","no_detail_runway","redundant"],"type":["string","null"]},"comment":{"type":["string","null"]},"reviewedAt":{"type":["string","null"]},"titleDecision":{"enum":["good","bad","unsure"],"type":["string","null"]},"titleReason":{"enum":["data_dump","vague","awkward","clickbait","hides_subject","too_long","misleading","generic"],"type":["string","null"]},"titleComment":{"type":["string","null"]},"titleReviewedAt":{"type":["string","null"]},"deepDiveContent":{"type":["string","null"]},"deepDiveSources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]}},"deepDiveGeneratedAt":{"type":["string","null"]}},"required":["id","batchId","ordinal","headline","summary","highlights","imageUrl","imageAttribution","sources","decision","reason","comment","reviewedAt","titleDecision","titleReason","titleComment","titleReviewedAt","deepDiveContent","deepDiveSources","deepDiveGeneratedAt"]}}},"required":["batch","items"]}}}}}}},"/api/admin/discover/editorial-labels/record":{"post":{"operationId":"admin.discover.editorialLabelRecord","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"itemId":{"type":"string","minLength":1},"decision":{"enum":["publish","reject","unsure"],"type":"string"},"reason":{"default":null,"enum":["trivial","too_basic","thin_evidence","generic","no_consequence","no_detail_runway","redundant"],"type":["string","null"]},"comment":{"default":null,"type":["string","null"],"maxLength":2000},"titleDecision":{"enum":["good","bad","unsure"],"type":"string"},"titleReason":{"default":null,"enum":["data_dump","vague","awkward","clickbait","hides_subject","too_long","misleading","generic"],"type":["string","null"]},"titleComment":{"default":null,"type":["string","null"],"maxLength":2000}},"required":["itemId","decision","titleDecision"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/api/admin/discover/editorial-labels/export":{"post":{"operationId":"admin.discover.editorialLabelExport","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"batchId":{"type":"string","minLength":1}},"required":["batchId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"exportedAt":{"type":"string"},"batch":{"type":"object","properties":{"id":{"type":"string"},"profileUserId":{"type":["string","null"]},"profileName":{"type":["string","null"]},"status":{"enum":["planning","generating","ready","labeling","completed","failed"],"type":"string"},"targetCount":{"type":"integer"},"readyCount":{"type":"integer"},"reviewedCount":{"type":"integer"},"publishCount":{"type":"integer"},"rejectCount":{"type":"integer"},"unsureCount":{"type":"integer"},"pendingCount":{"type":"integer"},"titleGoodCount":{"type":"integer"},"titleBadCount":{"type":"integer"},"titleUnsureCount":{"type":"integer"},"titlePendingCount":{"type":"integer"},"failedTaskCount":{"type":"integer"},"error":{"type":["string","null"]},"createdAt":{"type":"string"},"finishedAt":{"type":["string","null"]}},"required":["id","profileUserId","profileName","status","targetCount","readyCount","reviewedCount","publishCount","rejectCount","unsureCount","pendingCount","titleGoodCount","titleBadCount","titleUnsureCount","titlePendingCount","failedTaskCount","error","createdAt","finishedAt"]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"batchId":{"type":"string"},"ordinal":{"type":"integer"},"headline":{"type":"string"},"summary":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}},"imageUrl":{"type":"string"},"imageAttribution":{"type":["object","null"],"properties":{"originUrl":{"type":"string"},"title":{"type":["string","null"]}},"required":["originUrl"]},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]}},"decision":{"enum":["publish","reject","unsure"],"type":["string","null"]},"reason":{"enum":["trivial","too_basic","thin_evidence","generic","no_consequence","no_detail_runway","redundant"],"type":["string","null"]},"comment":{"type":["string","null"]},"reviewedAt":{"type":["string","null"]},"titleDecision":{"enum":["good","bad","unsure"],"type":["string","null"]},"titleReason":{"enum":["data_dump","vague","awkward","clickbait","hides_subject","too_long","misleading","generic"],"type":["string","null"]},"titleComment":{"type":["string","null"]},"titleReviewedAt":{"type":["string","null"]},"deepDiveContent":{"type":["string","null"]},"deepDiveSources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]}},"deepDiveGeneratedAt":{"type":["string","null"]},"taskId":{"type":["string","null"]},"sourceQuery":{"type":"string"},"clusterKey":{"type":"string"},"topicKey":{"type":["string","null"]},"sourceKind":{"enum":["interest","explore","timely"],"type":"string"},"laneId":{"type":["string","null"]},"headlineStyle":{"type":["string","null"]},"reviewedByUserId":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","batchId","ordinal","headline","summary","highlights","imageUrl","imageAttribution","sources","decision","reason","comment","reviewedAt","titleDecision","titleReason","titleComment","titleReviewedAt","deepDiveContent","deepDiveSources","deepDiveGeneratedAt","taskId","sourceQuery","clusterKey","topicKey","sourceKind","laneId","headlineStyle","reviewedByUserId","createdAt"]}}},"required":["exportedAt","batch","items"]}}}}}}},"/api/admin/discover/editorial-labels/deep-dive":{"post":{"operationId":"admin.discover.editorialLabelDeepDive","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"itemId":{"type":"string","minLength":1}},"required":["itemId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]}}},"required":["content","sources"]}}}}}}},"/api/admin/lab/compare-deep-dives":{"post":{"operationId":"admin.lab.compareDeepDives","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"headline":{"type":"string","minLength":1},"summary":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}},"strategies":{"type":"array","items":{"type":"string"}}},"required":["headline"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"strategy":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"model":{"type":"string"},"body":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]}},"research":{"type":["string","null"]},"ms":{"type":"number"},"error":{"type":["string","null"]}},"required":["strategy","label","description","model","body","sources","research","ms","error"]}}},"required":["results"]}}}}}}},"/api/admin/lab/search-preview":{"post":{"operationId":"admin.lab.searchPreview","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500}},"required":["query"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"exaQueries":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"host":{"type":"string"},"title":{"type":"string"},"rankScore":{"type":"number"},"selected":{"type":"boolean"}},"required":["host","title","rankScore","selected"]}},"cards":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"clusterKey":{"type":"string"},"headline":{"type":"string"},"summary":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}},"imageUrl":{"type":"string"},"imageAttribution":{"type":["object","null"],"properties":{"originUrl":{"type":"string"},"title":{"type":["string","null"]}},"required":["originUrl"]},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]}},"facet":{"type":"string"},"headlineStyle":{"type":"string"},"rawHeadline":{"type":"string"},"rawHighlights":{"type":"array","items":{"type":"string"}}},"required":["id","clusterKey","headline","summary","highlights","imageUrl","sources"]}},"durationMs":{"type":"number","minimum":0}},"required":["exaQueries","sources","cards","durationMs"]}}}}}}},"/api/admin/lab/regenerate-titles":{"post":{"operationId":"admin.lab.regenerateTitles","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","minLength":1},"limit":{"default":30,"type":"integer","minimum":1,"maximum":30}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string"},"cards":{"type":"array","items":{"type":"object","properties":{"cardId":{"type":"string"},"sourceQuery":{"type":"string"},"currentHeadline":{"type":"string"},"regeneratedHeadline":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}}},"required":["cardId","sourceQuery","currentHeadline","regeneratedHeadline","highlights"]}}},"required":["model","cards"]}}}}}}},"/api/admin/lab/podcast-scripts":{"post":{"operationId":"admin.lab.podcastScripts","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","minLength":1}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"topics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status":{"enum":["queued","researching","scripting","rendering","transcribing","ready","failed"],"type":"string"},"title":{"type":"string"},"blurb":{"type":["string","null"]},"script":{"type":["string","null"]},"audioUrl":{"type":["string","null"]},"durationMs":{"type":["integer","null"]},"progressMs":{"type":"integer","minimum":0},"position":{"type":"integer"},"servedAt":{"type":["string","null"]},"error":{"type":["string","null"]},"isDaily":{"type":"boolean"}},"required":["id","status","title","blurb","script","audioUrl","durationMs","progressMs","position","servedAt","error","isDaily"]}}},"required":["topics"]}}}}}}},"/api/admin/lab/regenerate-podcast-script":{"post":{"operationId":"admin.lab.regeneratePodcastScript","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string","minLength":1}},"required":["topicId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string"},"model":{"type":"string"},"elapsedMs":{"type":"integer","minimum":0},"title":{"type":"string"},"blurb":{"type":"string"},"script":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}},"required":["title","url"]}},"searches":{"type":"array","items":{"type":"string"}}},"required":["topicId","model","elapsedMs","title","blurb","script","sources","searches"]}}}}}}},"/api/admin/lab/apply-podcast-script":{"post":{"operationId":"admin.lab.applyPodcastScript","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string","minLength":1},"title":{"type":"string","minLength":1,"maxLength":200},"blurb":{"type":"string","minLength":1,"maxLength":1000},"script":{"type":"string","minLength":800,"maxLength":30000}},"required":["topicId","title","blurb","script"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string"},"status":{"const":"queued"}},"required":["topicId","status"]}}}}}}},"/api/admin/lab/regenerate-podcast-audio":{"post":{"operationId":"admin.lab.regeneratePodcastAudio","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string","minLength":1}},"required":["topicId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string"},"status":{"const":"queued"}},"required":["topicId","status"]}}}}}}},"/api/admin/lab/scan-podcast-archival":{"post":{"operationId":"admin.lab.scanPodcastArchival","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string","minLength":1}},"required":["topicId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string"},"model":{"type":"string"},"elapsedMs":{"type":"integer","minimum":0},"opportunities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"speaker":{"type":"string","minLength":1},"quotedText":{"type":"string","minLength":8},"narrationTextToReplace":{"type":"string","minLength":8},"anchorBefore":{"type":"string","minLength":8},"anchorAfter":{"type":"string","minLength":8},"reason":{"type":"string","minLength":1},"searchQueries":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"maxItems":3},"sourceTitle":{"type":"string","minLength":1},"sourceUrl":{"type":"string","format":"uri"},"sourceType":{"enum":["video","audio","podcast","film"],"type":"string"},"sourceTimestampSeconds":{"type":["number","null"],"minimum":0},"sourceEvidence":{"type":"string","minLength":1}},"required":["id","speaker","quotedText","narrationTextToReplace","anchorBefore","anchorAfter","reason","searchQueries","sourceTitle","sourceUrl","sourceType","sourceTimestampSeconds","sourceEvidence"]},"maxItems":3},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["title","url"]}},"searches":{"type":"array","items":{"type":"string"}}},"required":["topicId","model","elapsedMs","opportunities","sources","searches"]}}}}}}},"/api/admin/lab/preview-podcast-archival-mix":{"post":{"operationId":"admin.lab.previewPodcastArchivalMix","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string","minLength":1},"source":{"type":"object","properties":{"opportunityId":{"type":"string","minLength":1},"speaker":{"type":"string","minLength":1},"narrationTextToReplace":{"type":"string","minLength":8},"sourceTitle":{"type":"string","minLength":1,"maxLength":500},"sourcePageUrl":{"type":"string","format":"uri"},"sourceMediaUrl":{"type":"string","format":"uri"},"sourceStartMs":{"type":"integer","minimum":0},"sourceEndMs":{"type":"integer","minimum":0},"expectedText":{"type":"string","minLength":8,"maxLength":5000},"gainDb":{"default":0,"type":"number","minimum":-12,"maximum":12},"rightsStatus":{"const":"internal_test"}},"required":["opportunityId","speaker","narrationTextToReplace","sourceTitle","sourcePageUrl","sourceMediaUrl","sourceStartMs","sourceEndMs","expectedText","rightsStatus"]}},"required":["topicId","source"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string"},"previewAudioUrl":{"type":"string","format":"uri"},"previewDurationMs":{"type":"integer","minimum":0},"sourceClipAudioUrl":{"type":"string","format":"uri"},"sourceTranscript":{"type":"string"},"composition":{"type":"object","properties":{"version":{"const":1},"rightsStatus":{"const":"internal_test"},"narrationAudioUrl":{"type":"string","format":"uri"},"narrationDurationMs":{"type":"integer","minimum":0},"correctedScript":{"type":"string","minLength":1},"clips":{"type":"array","items":{"type":"object","properties":{"opportunityId":{"type":"string","minLength":1},"speaker":{"type":"string","minLength":1},"narrationTextToReplace":{"type":"string","minLength":8},"narrationStartMs":{"type":"integer","minimum":0},"narrationEndMs":{"type":"integer","minimum":0},"sourceTitle":{"type":"string","minLength":1},"sourcePageUrl":{"type":"string","format":"uri"},"sourceMediaUrl":{"type":"string","format":"uri"},"sourceStartMs":{"type":"integer","minimum":0},"sourceEndMs":{"type":"integer","minimum":0},"sourceClipUrl":{"type":"string","format":"uri"},"sourceTranscript":{"type":"string","minLength":1},"expectedText":{"type":"string","minLength":8},"gainDb":{"type":"number","minimum":-12,"maximum":12}},"required":["opportunityId","speaker","narrationTextToReplace","narrationStartMs","narrationEndMs","sourceTitle","sourcePageUrl","sourceMediaUrl","sourceStartMs","sourceEndMs","sourceClipUrl","sourceTranscript","expectedText","gainDb"]},"maxItems":1,"minItems":1}},"required":["version","rightsStatus","narrationAudioUrl","narrationDurationMs","correctedScript","clips"]}},"required":["topicId","previewAudioUrl","previewDurationMs","sourceClipAudioUrl","sourceTranscript","composition"]}}}}}}},"/api/admin/lab/apply-podcast-archival-mix":{"post":{"operationId":"admin.lab.applyPodcastArchivalMix","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string","minLength":1},"composition":{"type":"object","properties":{"version":{"const":1},"rightsStatus":{"const":"internal_test"},"narrationAudioUrl":{"type":"string","format":"uri"},"narrationDurationMs":{"type":"integer","minimum":0},"correctedScript":{"type":"string","minLength":1},"clips":{"type":"array","items":{"type":"object","properties":{"opportunityId":{"type":"string","minLength":1},"speaker":{"type":"string","minLength":1},"narrationTextToReplace":{"type":"string","minLength":8},"narrationStartMs":{"type":"integer","minimum":0},"narrationEndMs":{"type":"integer","minimum":0},"sourceTitle":{"type":"string","minLength":1},"sourcePageUrl":{"type":"string","format":"uri"},"sourceMediaUrl":{"type":"string","format":"uri"},"sourceStartMs":{"type":"integer","minimum":0},"sourceEndMs":{"type":"integer","minimum":0},"sourceClipUrl":{"type":"string","format":"uri"},"sourceTranscript":{"type":"string","minLength":1},"expectedText":{"type":"string","minLength":8},"gainDb":{"type":"number","minimum":-12,"maximum":12}},"required":["opportunityId","speaker","narrationTextToReplace","narrationStartMs","narrationEndMs","sourceTitle","sourcePageUrl","sourceMediaUrl","sourceStartMs","sourceEndMs","sourceClipUrl","sourceTranscript","expectedText","gainDb"]},"maxItems":1,"minItems":1}},"required":["version","rightsStatus","narrationAudioUrl","narrationDurationMs","correctedScript","clips"]}},"required":["topicId","composition"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"topicId":{"type":"string"},"audioUrl":{"type":"string","format":"uri"},"durationMs":{"type":"integer","minimum":0},"status":{"const":"ready"}},"required":["topicId","audioUrl","durationMs","status"]}}}}}}},"/api/admin/lab/scout-podcast-concepts":{"post":{"operationId":"admin.lab.scoutPodcastConcepts","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","minLength":1}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string"},"elapsedMs":{"type":"integer","minimum":0},"episodes":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"brief":{"type":"string"},"facts":{"type":"array","items":{"type":"string"}},"sourceUrls":{"type":"array","items":{"type":"string","format":"uri"}}},"required":["title","brief","facts","sourceUrls"]},"maxItems":5,"minItems":5},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["title","url"]}},"searches":{"type":"array","items":{"type":"string"}},"notes":{"type":"array","items":{"type":"string"}}},"required":["model","elapsedMs","episodes","sources","searches","notes"]}}}}}}},"/api/admin/briefs/user":{"get":{"operationId":"admin.briefs.user","tags":["Admin"],"parameters":[{"name":"userId","in":"query","required":true,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"lanes":{"type":"array","items":{"type":"object","properties":{"laneId":{"type":"string"},"laneName":{"type":"string"},"description":{"type":"string"},"kind":{"enum":["core","adjacent","wildcard"],"type":"string"},"source":{"enum":["profile","onboarding","admin","lane_updater","thought_attribution","adjacent_scout","wildcard_scout","engagement","backfill"],"type":"string"},"whyReaderCares":{"type":["string","null"]},"promotedAt":{"type":["string","null"]},"effectiveScore":{"type":["number","null"]},"searchQueries":{"type":"array","items":{"type":"string"}},"recentAnchors":{"type":"array","items":{"type":"string"}},"laneSchemaYaml":{"type":["string","null"]},"laneSchemaGeneratedAt":{"type":["string","null"]},"lastSearchAt":{"type":["string","null"]},"counts":{"type":"object","properties":{"unserved":{"type":"integer","minimum":0},"served":{"type":"integer","minimum":0},"candidates":{"type":"integer","minimum":0},"searches":{"type":"integer","minimum":0},"failedCandidates":{"type":"integer","minimum":0}},"required":["unserved","served","candidates","searches","failedCandidates"]}},"required":["laneId","laneName","description","kind","source","whyReaderCares","promotedAt","effectiveScore","searchQueries","recentAnchors","laneSchemaYaml","laneSchemaGeneratedAt","lastSearchAt","counts"]}}},"required":["userId","lanes"]}}}}}}},"/api/admin/briefs/lane":{"get":{"operationId":"admin.briefs.lane","tags":["Admin"],"parameters":[{"name":"userId","in":"query","required":true,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true},{"name":"laneId","in":"query","required":true,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"lane":{"type":"object","properties":{"laneId":{"type":"string"},"laneName":{"type":"string"},"description":{"type":"string"},"kind":{"enum":["core","adjacent","wildcard"],"type":"string"},"source":{"enum":["profile","onboarding","admin","lane_updater","thought_attribution","adjacent_scout","wildcard_scout","engagement","backfill"],"type":"string"},"whyReaderCares":{"type":["string","null"]},"promotedAt":{"type":["string","null"]},"effectiveScore":{"type":["number","null"]},"searchQueries":{"type":"array","items":{"type":"string"}},"recentAnchors":{"type":"array","items":{"type":"string"}},"laneSchemaYaml":{"type":["string","null"]},"laneSchemaGeneratedAt":{"type":["string","null"]},"lastSearchAt":{"type":["string","null"]},"counts":{"type":"object","properties":{"unserved":{"type":"integer","minimum":0},"served":{"type":"integer","minimum":0},"candidates":{"type":"integer","minimum":0},"searches":{"type":"integer","minimum":0},"failedCandidates":{"type":"integer","minimum":0}},"required":["unserved","served","candidates","searches","failedCandidates"]},"unservedBriefs":{"type":"array","items":{"type":"object","properties":{"briefId":{"type":"string"},"laneId":{"type":["string","null"]},"laneName":{"type":["string","null"]},"yaml":{"type":"string"},"parsed":{"type":["object","null"],"properties":{"reasoning":{"type":"string"},"fields":{"type":"object","additionalProperties":{"type":["string","null"]}}},"required":["reasoning","fields"]},"parseError":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]},"sourceStoryId":{"type":["string","null"]},"sourceStoryTitle":{"type":["string","null"]},"servedStoryId":{"type":["string","null"]},"servedStoryTitle":{"type":["string","null"]},"createdAt":{"type":"string"},"servedAt":{"type":["string","null"]}},"required":["briefId","yaml","parsed","createdAt"]}},"servedBriefs":{"type":"array","items":{"type":"object","properties":{"briefId":{"type":"string"},"laneId":{"type":["string","null"]},"laneName":{"type":["string","null"]},"yaml":{"type":"string"},"parsed":{"type":["object","null"],"properties":{"reasoning":{"type":"string"},"fields":{"type":"object","additionalProperties":{"type":["string","null"]}}},"required":["reasoning","fields"]},"parseError":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]},"sourceStoryId":{"type":["string","null"]},"sourceStoryTitle":{"type":["string","null"]},"servedStoryId":{"type":["string","null"]},"servedStoryTitle":{"type":["string","null"]},"createdAt":{"type":"string"},"servedAt":{"type":["string","null"]}},"required":["briefId","yaml","parsed","createdAt"]}},"recentCandidates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"yaml":{"type":"string"},"parsed":{"type":["object","null"],"properties":{"reasoning":{"type":"string"},"fields":{"type":"object","additionalProperties":{"type":["string","null"]}}},"required":["reasoning","fields"]},"parseError":{"type":["string","null"]},"status":{"enum":["pending","inserted","matched_existing","rejected_low_quality","failed"],"type":"string"},"statusReason":{"type":["string","null"]},"sourceType":{"enum":["article","story"],"type":"string"},"sourceUrl":{"type":["string","null"]},"sourceStoryId":{"type":["string","null"]},"sourceStoryTitle":{"type":["string","null"]},"articleContentId":{"type":["string","null"]},"articleTitle":{"type":["string","null"]},"resolvedBriefId":{"type":["string","null"]},"duplicateOfBriefId":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","yaml","parsed","status","sourceType","createdAt"]}},"searches":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"query":{"type":"string"},"createdAt":{"type":"string"},"resultCount":{"type":"integer","minimum":0},"articleCount":{"type":"integer","minimum":0},"candidateCount":{"type":"integer","minimum":0},"insertedCount":{"type":"integer","minimum":0},"matchedExistingCount":{"type":"integer","minimum":0},"failedCount":{"type":"integer","minimum":0}},"required":["id","query","createdAt","resultCount","articleCount","candidateCount","insertedCount","matchedExistingCount","failedCount"]}}},"required":["laneId","laneName","description","kind","source","whyReaderCares","promotedAt","effectiveScore","searchQueries","recentAnchors","laneSchemaYaml","laneSchemaGeneratedAt","lastSearchAt","counts","unservedBriefs","servedBriefs","recentCandidates","searches"]}},"required":["userId","lane"]}}}}}}},"/api/admin/briefs/slate":{"get":{"operationId":"admin.briefs.slate","tags":["Admin"],"parameters":[{"name":"userId","in":"query","required":true,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"deterministic":{"type":"boolean"},"note":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"briefId":{"type":"string"},"laneId":{"type":["string","null"]},"laneName":{"type":["string","null"]},"yaml":{"type":"string"},"parsed":{"type":["object","null"],"properties":{"reasoning":{"type":"string"},"fields":{"type":"object","additionalProperties":{"type":["string","null"]}}},"required":["reasoning","fields"]},"parseError":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]},"sourceStoryId":{"type":["string","null"]},"sourceStoryTitle":{"type":["string","null"]},"servedStoryId":{"type":["string","null"]},"servedStoryTitle":{"type":["string","null"]},"createdAt":{"type":"string"},"servedAt":{"type":["string","null"]},"effectiveScore":{"type":"number"},"relatedServedCount":{"default":0,"type":"integer","minimum":0}},"required":["briefId","yaml","parsed","createdAt","effectiveScore"]}}},"required":["userId","deterministic","note","items"]}}}}}}},"/api/admin/briefs/refresh-lane":{"post":{"operationId":"admin.briefs.refreshLane","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"laneId":{"type":"string"},"maxSearches":{"type":"integer","minimum":1,"maximum":10},"numResultsPerSearch":{"type":"integer","minimum":1,"maximum":25},"maxArticles":{"type":"integer","minimum":1,"maximum":100}},"required":["userId","laneId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"laneId":{"type":"string"},"laneName":{"type":"string"},"searchCount":{"type":"integer","minimum":0},"resultCount":{"type":"integer","minimum":0},"articleCount":{"type":"integer","minimum":0},"cacheHits":{"type":"integer","minimum":0},"cacheMisses":{"type":"integer","minimum":0},"briefsExtracted":{"type":"integer","minimum":0},"candidates":{"type":"integer","minimum":0},"reused":{"type":"integer","minimum":0},"matchedExisting":{"type":"integer","minimum":0},"inserted":{"type":"integer","minimum":0},"laneAssignmentsAdded":{"type":"integer","minimum":0},"durationMs":{"type":"integer","minimum":0}},"required":["userId","laneId","laneName","searchCount","resultCount","articleCount","cacheHits","cacheMisses","briefsExtracted","candidates","reused","matchedExisting","inserted","laneAssignmentsAdded","durationMs"]}}}}}}},"/api/admin/thoughts":{"get":{"operationId":"admin.thoughts.list","tags":["Admin"],"parameters":[{"name":"userId","in":"query","required":true,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"thoughts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"userId":{"type":"string"},"question":{"type":"string"},"response":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","userId","question","response","createdAt","updatedAt"]}}},"required":["thoughts"]}}}}}}},"/api/admin/actions/create-thought":{"post":{"operationId":"admin.thoughts.create","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"question":{"type":"string","minLength":1},"response":{"type":"string","minLength":1}},"required":["userId","question","response"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"thought":{"type":"object","properties":{"id":{"type":"string"},"userId":{"type":"string"},"question":{"type":"string"},"response":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","userId","question","response","createdAt","updatedAt"]}},"required":["thought"]}}}}}}},"/api/admin/actions/delete-thought":{"post":{"operationId":"admin.thoughts.delete","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"thoughtId":{"type":"string"}},"required":["userId","thoughtId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean"}},"required":["deleted"]}}}}}}},"/api/admin/dashboard":{"get":{"operationId":"admin.dashboard","tags":["Admin"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"runtimeEnvironment":{"enum":["dev","prod"],"type":"string"},"totalUsers":{"type":"integer","minimum":0},"activeStories":{"type":"integer","minimum":0},"recentActivity":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"event":{"type":"string"},"summary":{"type":"string"},"timestamp":{"type":"string"},"distinctId":{"type":"string"},"userId":{"type":"string"},"unitTitle":{"type":"string"},"screenName":{"type":"string"},"sourceSurface":{"type":"string"},"properties":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}},"required":["id","event","summary","timestamp","distinctId"]}}},"required":["runtimeEnvironment","totalUsers","activeStories","recentActivity"]}}}}}}},"/api/admin/insights":{"get":{"operationId":"admin.insights","tags":["Admin"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"runtimeEnvironment":{"enum":["dev","prod"],"type":"string"},"generatedAt":{"type":"string"},"windows":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"since":{"type":"string"},"activeUsers":{"type":"integer","minimum":0},"firstTimeUsers":{"type":"integer","minimum":0},"returningUsers":{"type":"integer","minimum":0},"openedNoRead":{"type":"integer","minimum":0},"storyOpens":{"type":"integer","minimum":0},"storyCompletions":{"type":"integer","minimum":0},"saves":{"type":"integer","minimum":0},"searches":{"type":"integer","minimum":0},"nextTurns":{"type":"integer","minimum":0},"feedback":{"type":"integer","minimum":0}},"required":["label","since","activeUsers","firstTimeUsers","returningUsers","openedNoRead","storyOpens","storyCompletions","saves","searches","nextTurns","feedback"]}},"activation":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"integer","minimum":0},"detail":{"type":"string"}},"required":["label","value"]}},"quality":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"integer","minimum":0},"detail":{"type":"string"}},"required":["label","value"]}},"momentum":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"integer","minimum":0},"detail":{"type":"string"}},"required":["label","value"]}},"operations":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"integer","minimum":0},"detail":{"type":"string"}},"required":["label","value"]}},"inbox":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"enum":["activation","quality","momentum","ops"],"type":"string"},"severity":{"enum":["high","medium","low"],"type":"string"},"title":{"type":"string"},"detail":{"type":"string"},"createdAt":{"type":"string"},"userId":{"type":"string"},"userName":{"type":"string"},"storyId":{"type":"string"},"storyTitle":{"type":"string"}},"required":["id","kind","severity","title","detail","createdAt"]}},"contentSignals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"enum":["love","not_for_me","feedback","save","search","completion","failure","unopened"],"type":"string"},"title":{"type":"string"},"detail":{"type":"string"},"createdAt":{"type":"string"},"userId":{"type":"string"},"userName":{"type":"string"},"storyId":{"type":"string"},"storyTitle":{"type":"string"}},"required":["id","kind","title","detail","createdAt","userId","userName","storyId","storyTitle"]}},"userSegments":{"type":"array","items":{"type":"object","properties":{"id":{"enum":["new","activated","read_today","curious","stalled","at_risk","empty_shelf"],"type":"string"},"label":{"type":"string"},"count":{"type":"integer","minimum":0},"userIds":{"type":"array","items":{"type":"string"}}},"required":["id","label","count","userIds"]}}},"required":["runtimeEnvironment","generatedAt","windows","activation","quality","momentum","operations","inbox","contentSignals","userSegments"]}}}}}}},"/api/admin/metrics":{"get":{"operationId":"admin.metrics","tags":["Admin"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"runtimeEnvironment":{"enum":["dev","prod"],"type":"string"},"generatedAt":{"type":"string"},"totals":{"type":"object","properties":{"totalUsers":{"type":"integer","minimum":0},"activatedUsers":{"type":"integer","minimum":0},"signupsToday":{"type":"integer","minimum":0},"signupsLast7d":{"type":"integer","minimum":0},"dau":{"type":"integer","minimum":0},"wau":{"type":"integer","minimum":0},"mau":{"type":"integer","minimum":0},"dauOverWau":{"type":"number","minimum":0,"maximum":1},"dauOverMau":{"type":"number","minimum":0,"maximum":1}},"required":["totalUsers","activatedUsers","signupsToday","signupsLast7d","dau","wau","mau","dauOverWau","dauOverMau"]},"dailyActive":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":"number","minimum":0}},"required":["date","value"]}},"weeklyActive":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":"number","minimum":0}},"required":["date","value"]}},"monthlyActive":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":"number","minimum":0}},"required":["date","value"]}},"newUsers":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":"number","minimum":0}},"required":["date","value"]}},"stickiness":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":"number","minimum":0}},"required":["date","value"]}},"storiesOpened":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":"number","minimum":0}},"required":["date","value"]}},"storiesCompleted":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":"number","minimum":0}},"required":["date","value"]}},"cohortsAppOpens":{"type":"array","items":{"type":"object","properties":{"cohortStart":{"type":"string"},"cohortSize":{"type":"integer","minimum":0},"retention":{"type":"array","items":{"type":"number","minimum":0,"maximum":1}}},"required":["cohortStart","cohortSize","retention"]}},"cohortsUnitOpens":{"type":"array","items":{"type":"object","properties":{"cohortStart":{"type":"string"},"cohortSize":{"type":"integer","minimum":0},"retention":{"type":"array","items":{"type":"number","minimum":0,"maximum":1}}},"required":["cohortStart","cohortSize","retention"]}},"retention":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"eligible":{"type":"integer","minimum":0},"retained":{"type":"integer","minimum":0},"ratio":{"type":"number","minimum":0,"maximum":1}},"required":["label","eligible","retained","ratio"]}},"activationFunnel":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"count":{"type":"integer","minimum":0},"conversionFromPrev":{"type":"number","minimum":0,"maximum":1},"conversionFromTop":{"type":"number","minimum":0,"maximum":1}},"required":["id","label","count","conversionFromPrev","conversionFromTop"]}},"denyReasons":{"type":"array","items":{"type":"object","properties":{"reason":{"enum":["already_known","didnt_understand","not_interested","dismissed"],"type":"string"},"label":{"type":"string"},"count":{"type":"integer","minimum":0},"share":{"type":"number","minimum":0,"maximum":1}},"required":["reason","label","count","share"]}}},"required":["runtimeEnvironment","generatedAt","totals","dailyActive","weeklyActive","monthlyActive","newUsers","stickiness","storiesOpened","storiesCompleted","cohortsAppOpens","cohortsUnitOpens","retention","activationFunnel","denyReasons"]}}}}}}},"/api/admin/reading-metrics":{"post":{"operationId":"admin.readingMetrics","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"days":{"default":90,"anyOf":[{"const":30},{"const":60},{"const":90}]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"runtimeEnvironment":{"enum":["dev","prod"],"type":"string"},"generatedAt":{"type":"string"},"windowDays":{"type":"integer","minimum":1},"totals":{"type":"object","properties":{"sessionsStarted":{"type":"integer","minimum":0},"sessionsWithProgress":{"type":"integer","minimum":0},"sessionsCompleted":{"type":"integer","minimum":0},"completionRate":{"type":"number","minimum":0,"maximum":1},"medianSessionDurationMs":{"type":["number","null"],"minimum":0},"p75SessionDurationMs":{"type":["number","null"],"minimum":0},"medianCompletedDurationMs":{"type":["number","null"],"minimum":0},"medianPageDwellMs":{"type":["number","null"],"minimum":0},"skimmedPageRate":{"type":"number","minimum":0,"maximum":1},"lingeredPageRate":{"type":"number","minimum":0,"maximum":1},"reachedFollowUpsRate":{"type":"number","minimum":0,"maximum":1},"medianPctReadAtCompletion":{"type":["number","null"],"minimum":0,"maximum":1},"medianPctReadAtCompletionByPages":{"type":["number","null"],"minimum":0,"maximum":1},"medianPctReadAtExit":{"type":["number","null"],"minimum":0,"maximum":1},"medianPctReadAtExitByPages":{"type":["number","null"],"minimum":0,"maximum":1},"avgPageSwipesPerSession":{"type":"number","minimum":0},"turnsPickedRate":{"type":"number","minimum":0,"maximum":1},"linesSavedRate":{"type":"number","minimum":0,"maximum":1}},"required":["sessionsStarted","sessionsWithProgress","sessionsCompleted","completionRate","medianSessionDurationMs","p75SessionDurationMs","medianCompletedDurationMs","medianPageDwellMs","skimmedPageRate","lingeredPageRate","reachedFollowUpsRate","medianPctReadAtCompletion","medianPctReadAtCompletionByPages","medianPctReadAtExit","medianPctReadAtExitByPages","avgPageSwipesPerSession","turnsPickedRate","linesSavedRate"]},"readSurvival":{"type":"array","items":{"type":"object","properties":{"pctRead":{"type":"integer","minimum":0,"maximum":100},"survivalRate":{"type":"number","minimum":0,"maximum":1},"sessions":{"type":"integer","minimum":0}},"required":["pctRead","survivalRate","sessions"]}},"readSurvivalByPages":{"type":"array","items":{"type":"object","properties":{"pctRead":{"type":"integer","minimum":0,"maximum":100},"survivalRate":{"type":"number","minimum":0,"maximum":1},"sessions":{"type":"integer","minimum":0}},"required":["pctRead","survivalRate","sessions"]}},"conditionalCompletion":{"type":"array","items":{"type":"object","properties":{"pctRead":{"type":"integer","minimum":0,"maximum":100},"reached":{"type":"integer","minimum":0},"completed":{"type":"integer","minimum":0},"conditionalCompletionRate":{"type":"number","minimum":0,"maximum":1}},"required":["pctRead","reached","completed","conditionalCompletionRate"]}},"conditionalCompletionByPages":{"type":"array","items":{"type":"object","properties":{"pctRead":{"type":"integer","minimum":0,"maximum":100},"reached":{"type":"integer","minimum":0},"completed":{"type":"integer","minimum":0},"conditionalCompletionRate":{"type":"number","minimum":0,"maximum":1}},"required":["pctRead","reached","completed","conditionalCompletionRate"]}},"exitDepth":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"count":{"type":"integer","minimum":0},"share":{"type":"number","minimum":0,"maximum":1}},"required":["label","count","share"]}},"exitDepthByPages":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"count":{"type":"integer","minimum":0},"share":{"type":"number","minimum":0,"maximum":1}},"required":["label","count","share"]}},"completionDepth":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"count":{"type":"integer","minimum":0},"share":{"type":"number","minimum":0,"maximum":1}},"required":["label","count","share"]}},"completionDepthByPages":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"count":{"type":"integer","minimum":0},"share":{"type":"number","minimum":0,"maximum":1}},"required":["label","count","share"]}},"dailySessions":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":"number","minimum":0}},"required":["date","value"]}},"dailyCompletions":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":"number","minimum":0}},"required":["date","value"]}},"topStoryDropoff":{"type":"array","items":{"type":"object","properties":{"unitId":{"type":"string"},"title":{"type":["string","null"]},"totalSegments":{"type":"integer","minimum":1},"sessions":{"type":"integer","minimum":0},"completedSessions":{"type":"integer","minimum":0},"completionRate":{"type":"number","minimum":0,"maximum":1},"points":{"type":"array","items":{"type":"object","properties":{"segmentIndex":{"type":"integer","minimum":1},"reached":{"type":"integer","minimum":0},"exited":{"type":"integer","minimum":0},"survivalRate":{"type":"number","minimum":0,"maximum":1}},"required":["segmentIndex","reached","exited","survivalRate"]}}},"required":["unitId","title","totalSegments","sessions","completedSessions","completionRate","points"]}}},"required":["runtimeEnvironment","generatedAt","windowDays","totals","readSurvival","readSurvivalByPages","conditionalCompletion","conditionalCompletionByPages","exitDepth","exitDepthByPages","completionDepth","completionDepthByPages","dailySessions","dailyCompletions","topStoryDropoff"]}}}}}}},"/api/admin/activity-overview":{"post":{"operationId":"admin.activityOverview","tags":["Admin"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"generatedAt":{"type":"string"},"model":{"type":"string"},"activeUserCount":{"type":"integer","minimum":0},"text":{"type":"string"}},"required":["generatedAt","model","activeUserCount","text"]}}}}}}},"/api/admin/curate/active-since-last-curation":{"get":{"operationId":"admin.curate.activeSinceLastCuration","tags":["Admin"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"users":{"type":"array","items":{"type":"object","properties":{"userId":{"type":"string"},"name":{"type":"string"},"phoneNumber":{"type":["string","null"]},"lastActivityAt":{"type":"string"},"lastCuratedAt":{"type":["string","null"]},"storyCount":{"type":"integer","minimum":0}},"required":["userId","name","phoneNumber","lastActivityAt","lastCuratedAt","storyCount"]}}},"required":["users"]}}}}}}},"/api/admin/curations":{"get":{"operationId":"admin.curations.list","tags":["Admin"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"curations":{"type":"array","items":{"type":"object","properties":{"userId":{"type":"string"},"name":{"type":"string"},"phoneNumber":{"type":["string","null"]},"curatedAt":{"type":"string"},"storyCount":{"type":"integer","minimum":1}},"required":["userId","name","phoneNumber","curatedAt","storyCount"]}}},"required":["curations"]}}}}}}},"/api/admin/curations/in-progress-traces":{"get":{"operationId":"admin.curations.inProgressTraces","tags":["Admin"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"traces":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"spanId":{"type":"string"},"rootSpanId":{"type":"string"},"parentSpanId":{"type":"string"},"name":{"type":"string"},"workflowId":{"type":"string"},"userId":{"type":"string"},"storyId":{"type":"string"},"startedAt":{"type":"string"},"endedAt":{"type":"string"},"durationMs":{"type":"number"},"hasError":{"type":"boolean"},"dashboardUrl":{"type":"string"},"errorDashboardUrl":{"type":"string"},"story":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"},"stickerImageUrl":{"type":"string"},"archived":{"type":"boolean"},"hiddenReason":{"enum":["expired","admin","completed","disliked","errored"],"type":"string"},"status":{"$ref":"#/components/schemas/StoryStatus"}},"required":["id","title","archived","status"]},"user":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"phoneNumber":{"type":["string","null"]}},"required":["id","name","phoneNumber"]}},"required":["id","spanId","rootSpanId","name","hasError","dashboardUrl"]}},"dashboardUrl":{"type":"string"}},"required":["traces"]}}}}}}},"/api/admin/notifications/user-notifications":{"post":{"operationId":"admin.notifications.userNotifications","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"limit":{"default":50,"type":"integer","minimum":1,"maximum":200}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"userName":{"type":["string","null"]},"timezone":{"type":["string","null"]},"notificationsEnabled":{"type":"boolean"},"apnsConfigured":{"type":"boolean"},"deviceCount":{"type":"integer","minimum":0},"lastSeenAt":{"type":["string","null"]},"goodHourLocal":{"type":["integer","null"],"minimum":0,"maximum":23},"goodMinuteLocal":{"type":["integer","null"],"minimum":0,"maximum":59},"goodHourSampleSize":{"type":"integer","minimum":0},"goodHourSource":{"enum":["computed","default","quiet_hour_clamp"],"type":["string","null"]},"activeCampaign":{"type":["object","null"],"properties":{"id":{"type":"string"},"anchorKind":{"type":"string"},"scheduledHourLocal":{"type":"integer","minimum":0,"maximum":23},"scheduledMinuteLocal":{"type":"integer","minimum":0,"maximum":59},"scheduledTimezone":{"type":"string"},"startedAt":{"type":"string"},"daySent":{"type":"integer","minimum":0,"maximum":3},"lastPushAt":{"type":["string","null"]}},"required":["id","anchorKind","scheduledHourLocal","scheduledMinuteLocal","scheduledTimezone","startedAt","daySent","lastPushAt"]},"campaigns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"userId":{"type":"string"},"userName":{"type":["string","null"]},"userPhoneNumber":{"type":["string","null"]},"anchorKind":{"type":"string"},"scheduledHourLocal":{"type":"integer","minimum":0,"maximum":23},"scheduledMinuteLocal":{"type":"integer","minimum":0,"maximum":59},"scheduledTimezone":{"type":"string"},"startedAt":{"type":"string"},"stoppedAt":{"type":["string","null"]},"stopReason":{"enum":["engaged","exhausted","send_failed","new_batch","admin_canceled"],"type":["string","null"]},"daySent":{"type":"integer","minimum":0,"maximum":3},"lastPushAt":{"type":["string","null"]}},"required":["id","userId","userName","userPhoneNumber","anchorKind","scheduledHourLocal","scheduledMinuteLocal","scheduledTimezone","startedAt","stoppedAt","stopReason","daySent","lastPushAt"]}},"personalStats":{"type":"object","properties":{"sent30d":{"type":"integer","minimum":0},"opened30d":{"type":"integer","minimum":0},"openRate30d":{"type":"number","minimum":0,"maximum":1}},"required":["sent30d","opened30d","openRate30d"]},"discoverPush":{"type":"object","properties":{"eligible":{"type":"boolean"},"blockedReason":{"type":["string","null"]},"nextSlotAt":{"type":["string","null"]},"lastPushAt":{"type":["string","null"]},"lastAppOpenedAt":{"type":["string","null"]},"unseenCardCount":{"type":"integer","minimum":0},"unansweredPushCount":{"type":"integer","minimum":0},"pushEveryDays":{"type":"integer","minimum":1},"card":{"type":["object","null"],"properties":{"id":{"type":"string"},"headline":{"type":"string"},"sourceKind":{"type":"string"}},"required":["id","headline","sourceKind"]},"previewTitle":{"type":["string","null"]},"previewBody":{"type":["string","null"]}},"required":["eligible","blockedReason","nextSlotAt","lastPushAt","lastAppOpenedAt","unseenCardCount","unansweredPushCount","pushEveryDays","card","previewTitle","previewBody"]},"pending":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"userId":{"type":"string"},"userName":{"type":["string","null"]},"userPhoneNumber":{"type":["string","null"]},"userTimezone":{"type":["string","null"]},"storyId":{"type":["string","null"]},"storyTitle":{"type":["string","null"]},"kind":{"type":"string"},"title":{"type":"string"},"body":{"type":"string"},"scheduledFor":{"type":"string"},"status":{"enum":["pending","sent","failed","expired","canceled"],"type":"string"},"attemptedAt":{"type":["string","null"]},"sentAt":{"type":["string","null"]},"failureReason":{"type":["string","null"]},"createdAt":{"type":"string"},"campaignId":{"type":["string","null"]},"campaignDay":{"type":["integer","null"],"minimum":1,"maximum":3}},"required":["id","userId","userName","userPhoneNumber","userTimezone","storyId","storyTitle","kind","title","body","scheduledFor","status","attemptedAt","sentAt","failureReason","createdAt","campaignId","campaignDay"]}},"recent":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"userId":{"type":"string"},"userName":{"type":["string","null"]},"userPhoneNumber":{"type":["string","null"]},"userTimezone":{"type":["string","null"]},"storyId":{"type":["string","null"]},"storyTitle":{"type":["string","null"]},"kind":{"type":"string"},"title":{"type":"string"},"body":{"type":"string"},"scheduledFor":{"type":"string"},"status":{"enum":["pending","sent","failed","expired","canceled"],"type":"string"},"attemptedAt":{"type":["string","null"]},"sentAt":{"type":["string","null"]},"failureReason":{"type":["string","null"]},"createdAt":{"type":"string"},"campaignId":{"type":["string","null"]},"campaignDay":{"type":["integer","null"],"minimum":1,"maximum":3}},"required":["id","userId","userName","userPhoneNumber","userTimezone","storyId","storyTitle","kind","title","body","scheduledFor","status","attemptedAt","sentAt","failureReason","createdAt","campaignId","campaignDay"]}}},"required":["userId","userName","timezone","notificationsEnabled","apnsConfigured","deviceCount","lastSeenAt","goodHourLocal","goodMinuteLocal","goodHourSampleSize","goodHourSource","activeCampaign","campaigns","personalStats","discoverPush","pending","recent"]}}}}}}},"/api/admin/notifications/send-test":{"post":{"operationId":"admin.notifications.sendTest","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"title":{"type":"string"},"body":{"type":"string"}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"userName":{"type":"string"},"attempted":{"type":"integer","minimum":0},"delivered":{"type":"integer","minimum":0},"invalidated":{"type":"integer","minimum":0},"failed":{"type":"array","items":{"type":"object","properties":{"token":{"type":"string"},"reason":{"type":"string"}},"required":["token","reason"]}}},"required":["userId","userName","attempted","delivered","invalidated","failed"]}}}}}}},"/api/admin/notifications/cancel-scheduled":{"post":{"operationId":"admin.notifications.cancelScheduled","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"enum":["pending","sent","failed","expired","canceled"],"type":"string"}},"required":["id","status"]}}}}}}},"/api/admin/notifications/send-scheduled-now":{"post":{"operationId":"admin.notifications.sendScheduledNow","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"enum":["pending","sent","failed","expired","canceled"],"type":"string"}},"required":["id","status"]}}}}}}},"/api/admin/notifications/metrics":{"post":{"operationId":"admin.notifications.metrics","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"days":{"default":14,"anyOf":[{"const":7},{"const":14},{"const":30}]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"kind":{"type":"string"},"sent":{"type":"integer","minimum":0},"opened":{"type":"integer","minimum":0}},"required":["date","kind","sent","opened"]}},"totals":{"type":"object","properties":{"sent":{"type":"integer","minimum":0},"opened":{"type":"integer","minimum":0},"openRate":{"type":"number","minimum":0,"maximum":1},"byKind":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"sent":{"type":"integer","minimum":0},"opened":{"type":"integer","minimum":0},"openRate":{"type":"number","minimum":0,"maximum":1}},"required":["kind","sent","opened","openRate"]}}},"required":["sent","opened","openRate","byKind"]},"campaigns":{"type":"object","properties":{"active":{"type":"integer","minimum":0},"startedInWindow":{"type":"integer","minimum":0},"stoppedEngaged":{"type":"integer","minimum":0},"stoppedExhausted":{"type":"integer","minimum":0},"stoppedSendFailed":{"type":"integer","minimum":0},"stoppedNewBatch":{"type":"integer","minimum":0},"stoppedAdminCanceled":{"type":"integer","minimum":0},"engagementRate":{"type":"number","minimum":0,"maximum":1}},"required":["active","startedInWindow","stoppedEngaged","stoppedExhausted","stoppedSendFailed","stoppedNewBatch","stoppedAdminCanceled","engagementRate"]}},"required":["daily","totals","campaigns"]}}}}}}},"/api/admin/notifications/stop-campaign":{"post":{"operationId":"admin.notifications.stopCampaign","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"stoppedAt":{"type":"string"},"stopReason":{"enum":["engaged","exhausted","send_failed","new_batch","admin_canceled"],"type":"string"}},"required":["id","stoppedAt","stopReason"]}}}}}}},"/api/admin/notifications/send-discover-now":{"post":{"operationId":"admin.notifications.sendDiscoverNow","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"status":{"enum":["sent","failed","skipped"],"type":"string"},"reason":{"type":["string","null"]},"cardId":{"type":["string","null"]},"title":{"type":["string","null"]},"body":{"type":["string","null"]},"attempted":{"type":"integer","minimum":0},"delivered":{"type":"integer","minimum":0}},"required":["userId","status","reason","cardId","title","body","attempted","delivered"]}}}}}}},"/api/admin/actions/create-user":{"post":{"operationId":"admin.actions.createUser","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"phoneNumber":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"onboardingSeedText":{"type":"string"},"onboardingCompleted":{"type":"boolean"}},"required":["phoneNumber","name"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"object","properties":{"id":{"type":"string"},"supermemoryContainerTag":{"type":"string"},"name":{"type":"string"},"phoneNumber":{"type":"string"},"onboardingCompleted":{"type":"boolean"},"onboardingStep":{"type":"string"},"onboardingSeedText":{"type":"string"},"onboardingPlanResponse":{"type":"string"},"storyCount":{"type":"integer","minimum":0},"queueStoryCount":{"default":0,"type":"integer","minimum":0},"shelfStoryCount":{"default":0,"type":"integer","minimum":0},"activeStoryCount":{"default":0,"type":"integer","minimum":0},"completedStoryCount":{"type":"integer","minimum":0},"todayViewed":{"default":0,"type":"integer","minimum":0},"todayStarted":{"default":0,"type":"integer","minimum":0},"todayDone":{"default":0,"type":"integer","minimum":0},"createdAt":{"type":"string"},"lastSeenAt":{"type":"string"},"lastTextedAt":{"type":"string"},"textsEnabled":{"type":"boolean"},"infiniteFeedEnabled":{"default":false,"type":"boolean"},"appVersion":{"type":"string"},"isOnPublishedAppVersion":{"type":"boolean"},"deletedAt":{"type":"string"}},"required":["id","supermemoryContainerTag","name","onboardingCompleted","onboardingStep","storyCount","completedStoryCount","createdAt"]}},"required":["user"]}}}}}}},"/api/admin/actions/update-user":{"post":{"operationId":"admin.actions.updateUser","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"name":{"type":"string","minLength":1},"phoneNumber":{"type":"string"},"onboardingCompleted":{"type":"boolean"},"onboardingSeedText":{"type":"string"},"interestProfile":{"type":"object","properties":{"narrative":{"default":"","type":"string"},"archetypes":{"default":[],"type":"array","items":{"type":"string"}},"attracts":{"default":[],"type":"array","items":{"type":"string"}},"repels":{"default":[],"type":"array","items":{"type":"string"}},"confidence":{"enum":["low","medium","high"],"type":"string"},"lanes":{"type":"array","items":{"type":"object","properties":{"laneId":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"cachedScore":{"type":["object","null"],"properties":{"heat":{"type":"number"},"depth":{"type":"number"},"boost":{"default":0,"type":"number"},"effective":{"type":"number"},"computedAt":{"type":"string"}},"required":["heat","depth","effective","computedAt"]},"searchQueries":{"default":[],"type":"array","items":{"type":"string"}},"recentAnchors":{"default":[],"type":"array","items":{"type":"string"}}},"required":["name","description"]}}},"required":["confidence","lanes"]},"textsEnabled":{"type":["boolean","null"]},"infiniteFeedEnabled":{"type":"boolean"}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"object","properties":{"id":{"type":"string"},"supermemoryContainerTag":{"type":"string"},"name":{"type":"string"},"phoneNumber":{"type":"string"},"onboardingCompleted":{"type":"boolean"},"onboardingStep":{"type":"string"},"onboardingSeedText":{"type":"string"},"onboardingPlanResponse":{"type":"string"},"storyCount":{"type":"integer","minimum":0},"queueStoryCount":{"default":0,"type":"integer","minimum":0},"shelfStoryCount":{"default":0,"type":"integer","minimum":0},"activeStoryCount":{"default":0,"type":"integer","minimum":0},"completedStoryCount":{"type":"integer","minimum":0},"todayViewed":{"default":0,"type":"integer","minimum":0},"todayStarted":{"default":0,"type":"integer","minimum":0},"todayDone":{"default":0,"type":"integer","minimum":0},"createdAt":{"type":"string"},"lastSeenAt":{"type":"string"},"lastTextedAt":{"type":"string"},"textsEnabled":{"type":"boolean"},"infiniteFeedEnabled":{"default":false,"type":"boolean"},"appVersion":{"type":"string"},"isOnPublishedAppVersion":{"type":"boolean"},"deletedAt":{"type":"string"}},"required":["id","supermemoryContainerTag","name","onboardingCompleted","onboardingStep","storyCount","completedStoryCount","createdAt"]}},"required":["user"]}}}}}}},"/api/admin/actions/re-onboard":{"post":{"operationId":"admin.actions.reOnboard","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"storyCount":{"type":"integer"}},"required":["storyCount"]}}}}}}},"/api/admin/actions/force-logout":{"post":{"operationId":"admin.actions.forceLogout","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"clearedSessionCount":{"type":"integer","minimum":0}},"required":["clearedSessionCount"]}}}}}}},"/api/admin/actions/generate-interest-profile":{"post":{"operationId":"admin.actions.generateInterestProfile","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"interestProfile":{"type":"object","properties":{"narrative":{"default":"","type":"string"},"archetypes":{"default":[],"type":"array","items":{"type":"string"}},"attracts":{"default":[],"type":"array","items":{"type":"string"}},"repels":{"default":[],"type":"array","items":{"type":"string"}},"confidence":{"enum":["low","medium","high"],"type":"string"},"lanes":{"type":"array","items":{"type":"object","properties":{"laneId":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"cachedScore":{"type":["object","null"],"properties":{"heat":{"type":"number"},"depth":{"type":"number"},"boost":{"default":0,"type":"number"},"effective":{"type":"number"},"computedAt":{"type":"string"}},"required":["heat","depth","effective","computedAt"]},"searchQueries":{"default":[],"type":"array","items":{"type":"string"}},"recentAnchors":{"default":[],"type":"array","items":{"type":"string"}}},"required":["name","description"]}}},"required":["confidence","lanes"]},"interestProfileGeneratedAt":{"type":"string"}},"required":["interestProfile","interestProfileGeneratedAt"]}}}}}}},"/api/admin/actions/forward-interest-content":{"post":{"operationId":"admin.actions.forwardInterestContent","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"text":{"type":"string","minLength":1}},"required":["userId","text"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"contentChars":{"type":"integer","minimum":0}},"required":["ok","contentChars"]}}}}}}},"/api/admin/actions/parse-url":{"post":{"operationId":"admin.actions.parseUrl","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":["string","null"]},"siteName":{"type":["string","null"]},"author":{"type":["string","null"]},"canonicalUrl":{"type":"string"},"wordCount":{"type":"integer","minimum":0},"readingTimeMinutes":{"type":"integer","minimum":0},"contentChars":{"type":"integer","minimum":0}},"required":["text","title","siteName","author","canonicalUrl","wordCount","readingTimeMinutes","contentChars"]}}}}}}},"/api/admin/actions/delete-story":{"post":{"operationId":"admin.actions.deleteStory","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"storyId":{"type":"string"}},"required":["userId","storyId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean"}},"required":["deleted"]}}}}}}},"/api/admin/actions/set-story-archived":{"post":{"operationId":"admin.actions.setStoryArchived","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"storyId":{"type":"string"},"archived":{"type":"boolean"}},"required":["userId","storyId","archived"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"archived":{"type":"boolean"}},"required":["archived"]}}}}}}},"/api/admin/actions/add-story-to-user-feed":{"post":{"operationId":"admin.actions.addStoryToUserFeed","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sourceStoryId":{"type":"string"},"targetUserId":{"type":"string"}},"required":["sourceStoryId","targetUserId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"story":{"type":"object","properties":{"id":{"type":"string"},"userId":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"},"status":{"$ref":"#/components/schemas/StoryStatus"},"archived":{"default":false,"type":"boolean"},"hiddenReason":{"enum":["expired","admin","completed","disliked","errored"],"type":"string"},"visible":{"default":true,"type":"boolean"},"reaction":{"enum":["not_for_me","love"],"type":"string"},"reviewedAs":{"enum":["saved","auto_saved","already_known","didnt_understand","not_interested","dismissed"],"type":["string","null"]},"segmentCount":{"type":"integer","minimum":0},"lastViewedSegmentIndex":{"type":"integer","minimum":0},"createdAt":{"type":"string"},"lastTouchedAt":{"type":"string"},"startedAt":{"type":"string"},"completedAt":{"type":"string"},"stickerImageUrl":{"type":"string"},"failureReason":{"type":"string"},"forDate":{"type":"string"},"tracesDashboardUrl":{"type":"string"},"errorDashboardUrl":{"type":"string"},"sourceKind":{"enum":["core","adjacent","wildcard"],"type":"string"},"sourceLane":{"type":"string"},"titleVariant":{"enum":["og","v1"],"type":"string"},"pickerMessages":{"type":["array","null"],"items":{"type":"string","minLength":1},"minItems":1,"maxItems":3},"dailyNotificationMessages":{"type":["array","null"],"items":{"type":"string","minLength":1,"maxLength":520},"maxItems":2,"minItems":2}},"required":["id","userId","title","subtitle","status","segmentCount","lastViewedSegmentIndex","createdAt","lastTouchedAt"]}},"required":["story"]}}}}}}},"/api/admin/actions/seed-picker-review-queue":{"post":{"operationId":"admin.actions.seedPickerReviewQueue","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"count":{"type":"integer","minimum":1,"maximum":20}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"storyIds":{"type":"array","items":{"type":"string"}},"reset":{"type":"integer","minimum":0},"cloned":{"type":"integer","minimum":0}},"required":["ok","storyIds","reset","cloned"]}}}}}}},"/api/admin/actions/regenerate-picker-pitches":{"post":{"operationId":"admin.actions.regeneratePickerPitches","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"storyIds":{"type":"array","items":{"type":"string"}},"regenerated":{"type":"integer","minimum":0},"failed":{"type":"array","items":{"type":"object","properties":{"storyId":{"type":"string"},"message":{"type":"string"}},"required":["storyId","message"]}}},"required":["ok","storyIds","regenerated","failed"]}}}}}}},"/api/admin/actions/hard-delete-user":{"post":{"operationId":"admin.actions.hardDeleteUser","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean"}},"required":["deleted"]}}}}}}},"/api/admin/actions/restore-user":{"post":{"operationId":"admin.actions.restoreUser","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"restored":{"type":"boolean"}},"required":["restored"]}}}}}}},"/api/admin/actions/port-user-from-prod":{"post":{"operationId":"admin.actions.portUserFromProd","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"copied":{"type":"object","properties":{"user":{"type":"integer","minimum":0},"accounts":{"type":"integer","minimum":0},"sessions":{"type":"integer","minimum":0},"interestLanes":{"type":"integer","minimum":0},"stories":{"type":"integer","minimum":0},"savedLines":{"type":"integer","minimum":0},"readerSearches":{"type":"integer","minimum":0},"storyFeedback":{"type":"integer","minimum":0},"thoughts":{"type":"integer","minimum":0},"analyticsEvents":{"type":"integer","minimum":0}},"required":["user","accounts","sessions","interestLanes","stories","savedLines","readerSearches","storyFeedback","thoughts","analyticsEvents"]}},"required":["ok","copied"]}}}}}}},"/api/admin/actions/sync-db-from-prod":{"post":{"operationId":"admin.actions.syncDbFromProd","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"copied":{"type":"object","properties":{"users":{"type":"integer","minimum":0},"accounts":{"type":"integer","minimum":0},"sessions":{"type":"integer","minimum":0},"verifications":{"type":"integer","minimum":0},"stories":{"type":"integer","minimum":0},"savedLines":{"type":"integer","minimum":0},"readerSearches":{"type":"integer","minimum":0},"storyFeedback":{"type":"integer","minimum":0},"thoughts":{"type":"integer","minimum":0},"analyticsEvents":{"type":"integer","minimum":0},"pushDevices":{"type":"integer","minimum":0},"linqInboundMessages":{"type":"integer","minimum":0}},"required":["users","accounts","sessions","verifications","stories","savedLines","readerSearches","storyFeedback","thoughts","analyticsEvents","pushDevices","linqInboundMessages"]},"durationMs":{"type":"integer","minimum":0}},"required":["ok","copied","durationMs"]}}}}}}},"/api/admin/actions/generate-more":{"post":{"operationId":"admin.actions.generateMore","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"count":{"type":"integer","minimum":1,"maximum":30},"additionalContext":{"type":"string"},"forDate":{"type":["string","null"]}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"count":{"type":"integer","minimum":0}},"required":["ok","count"]}}}}}}},"/api/admin/actions/impersonate":{"post":{"operationId":"admin.actions.impersonate","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"}},"required":["userId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"impersonating":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"phoneNumber":{"type":"string"}},"required":["id","name"]}},"required":["impersonating"]}}}}}}},"/api/admin/actions/unimpersonate":{"post":{"operationId":"admin.actions.unimpersonate","tags":["Admin"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true}},"required":["ok"]}}}}}}},"/api/admin/actions/update-story":{"post":{"operationId":"admin.actions.updateStory","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"storyId":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"},"segments":{"type":"array","items":{"$ref":"#/components/schemas/StorySegment"}},"followUps":{"type":"array","items":{"$ref":"#/components/schemas/StoryFollowUp"}},"dailyNotificationMessages":{"type":["array","null"],"items":{"type":"string","minLength":1,"maxLength":520},"maxItems":2,"minItems":2}},"required":["storyId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"story":{"type":"object","properties":{"id":{"type":"string"},"userId":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"},"status":{"$ref":"#/components/schemas/StoryStatus"},"archived":{"default":false,"type":"boolean"},"hiddenReason":{"enum":["expired","admin","completed","disliked","errored"],"type":"string"},"visible":{"default":true,"type":"boolean"},"reaction":{"enum":["not_for_me","love"],"type":"string"},"reviewedAs":{"enum":["saved","auto_saved","already_known","didnt_understand","not_interested","dismissed"],"type":["string","null"]},"segmentCount":{"type":"integer","minimum":0},"lastViewedSegmentIndex":{"type":"integer","minimum":0},"createdAt":{"type":"string"},"lastTouchedAt":{"type":"string"},"startedAt":{"type":"string"},"completedAt":{"type":"string"},"stickerImageUrl":{"type":"string"},"failureReason":{"type":"string"},"forDate":{"type":"string"},"tracesDashboardUrl":{"type":"string"},"errorDashboardUrl":{"type":"string"},"sourceKind":{"enum":["core","adjacent","wildcard"],"type":"string"},"sourceLane":{"type":"string"},"titleVariant":{"enum":["og","v1"],"type":"string"},"pickerMessages":{"type":["array","null"],"items":{"type":"string","minLength":1},"minItems":1,"maxItems":3},"dailyNotificationMessages":{"type":["array","null"],"items":{"type":"string","minLength":1,"maxLength":520},"maxItems":2,"minItems":2}},"required":["id","userId","title","subtitle","status","segmentCount","lastViewedSegmentIndex","createdAt","lastTouchedAt"]}},"required":["story"]}}}}}}},"/api/admin/actions/reorder-stories":{"post":{"operationId":"admin.actions.reorderStories","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"storyIds":{"type":"array","items":{"type":"string"},"minItems":1}},"required":["userId","storyIds"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"reordered":{"type":"integer","minimum":0}},"required":["ok","reordered"]}}}}}}},"/api/admin/services/status":{"get":{"operationId":"admin.services.status","tags":["Admin"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"configured":{"type":"boolean"},"fetchedAt":{"type":"string"},"services":{"type":"array","items":{"type":"object","properties":{"service":{"enum":["landing","api","admin"],"type":"string"},"configured":{"type":"boolean"},"status":{"enum":["BUILDING","DEPLOYING","SUCCESS","FAILED","CRASHED","REMOVED","SLEEPING","SKIPPED","WAITING","QUEUED","INITIALIZING","NEEDS_APPROVAL","UNKNOWN"],"type":["string","null"]},"staticUrl":{"type":["string","null"]},"deploymentId":{"type":["string","null"]},"updatedAt":{"type":["string","null"]},"error":{"type":["string","null"]}},"required":["service","configured","status","staticUrl","deploymentId","updatedAt","error"]}}},"required":["configured","fetchedAt","services"]}}}}}}},"/api/admin/releases/dashboard":{"get":{"operationId":"admin.releases.dashboard","tags":["Admin"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"configured":{"type":"boolean"},"appStore":{"type":["object","null"],"properties":{"versionString":{"type":"string"},"buildNumber":{"type":"string"},"state":{"type":"string"},"subState":{"type":["string","null"]},"uploadedDate":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"ascUrl":{"type":"string"},"buildId":{"type":["string","null"]},"versionId":{"type":["string","null"]}},"required":["versionString","buildNumber","state","subState","uploadedDate","expiresAt","ascUrl","buildId","versionId"]},"appStorePending":{"type":["object","null"],"properties":{"versionString":{"type":"string"},"buildNumber":{"type":"string"},"state":{"type":"string"},"subState":{"type":["string","null"]},"uploadedDate":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"ascUrl":{"type":"string"},"buildId":{"type":["string","null"]},"versionId":{"type":["string","null"]}},"required":["versionString","buildNumber","state","subState","uploadedDate","expiresAt","ascUrl","buildId","versionId"]},"appStoreActive":{"type":["object","null"],"properties":{"versionString":{"type":"string"},"buildNumber":{"type":"integer"},"status":{"type":"string"},"triggeredBy":{"type":["string","null"]},"runUrl":{"type":"string"},"correlationId":{"type":["string","null"]}},"required":["versionString","buildNumber","status","triggeredBy","runUrl","correlationId"]},"testflightInternal":{"type":["object","null"],"properties":{"versionString":{"type":"string"},"buildNumber":{"type":"string"},"state":{"type":"string"},"subState":{"type":["string","null"]},"uploadedDate":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"ascUrl":{"type":"string"},"buildId":{"type":["string","null"]},"versionId":{"type":["string","null"]}},"required":["versionString","buildNumber","state","subState","uploadedDate","expiresAt","ascUrl","buildId","versionId"]},"testflightInternalPending":{"type":["object","null"],"properties":{"versionString":{"type":"string"},"buildNumber":{"type":"string"},"state":{"type":"string"},"subState":{"type":["string","null"]},"uploadedDate":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"ascUrl":{"type":"string"},"buildId":{"type":["string","null"]},"versionId":{"type":["string","null"]}},"required":["versionString","buildNumber","state","subState","uploadedDate","expiresAt","ascUrl","buildId","versionId"]},"testflightInternalActive":{"type":["object","null"],"properties":{"versionString":{"type":"string"},"buildNumber":{"type":"integer"},"status":{"type":"string"},"triggeredBy":{"type":["string","null"]},"runUrl":{"type":"string"},"correlationId":{"type":["string","null"]}},"required":["versionString","buildNumber","status","triggeredBy","runUrl","correlationId"]},"testflightExternal":{"type":["object","null"],"properties":{"versionString":{"type":"string"},"buildNumber":{"type":"string"},"state":{"type":"string"},"subState":{"type":["string","null"]},"uploadedDate":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"ascUrl":{"type":"string"},"buildId":{"type":["string","null"]},"versionId":{"type":["string","null"]}},"required":["versionString","buildNumber","state","subState","uploadedDate","expiresAt","ascUrl","buildId","versionId"]},"testflightExternalPending":{"type":["object","null"],"properties":{"versionString":{"type":"string"},"buildNumber":{"type":"string"},"state":{"type":"string"},"subState":{"type":["string","null"]},"uploadedDate":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"ascUrl":{"type":"string"},"buildId":{"type":["string","null"]},"versionId":{"type":["string","null"]}},"required":["versionString","buildNumber","state","subState","uploadedDate","expiresAt","ascUrl","buildId","versionId"]},"testflightExternalActive":{"type":["object","null"],"properties":{"versionString":{"type":"string"},"buildNumber":{"type":"integer"},"status":{"type":"string"},"triggeredBy":{"type":["string","null"]},"runUrl":{"type":"string"},"correlationId":{"type":["string","null"]}},"required":["versionString","buildNumber","status","triggeredBy","runUrl","correlationId"]},"versionConfig":{"type":"object","properties":{"appStore":{"type":["object","null"],"properties":{"channel":{"enum":["appStore","testFlight"],"type":"string"},"latestVersion":{"type":"string"},"latestBuild":{"type":"integer"},"latestDetectedAt":{"type":["string","null"]},"minVersion":{"type":["string","null"]},"minBuild":{"type":["integer","null"]},"pendingMinVersion":{"type":["string","null"]},"pendingMinBuild":{"type":["integer","null"]},"updatedAt":{"type":"string"}},"required":["channel","latestVersion","latestBuild","minVersion","minBuild","pendingMinVersion","pendingMinBuild","updatedAt"]},"testFlight":{"type":["object","null"],"properties":{"channel":{"enum":["appStore","testFlight"],"type":"string"},"latestVersion":{"type":"string"},"latestBuild":{"type":"integer"},"latestDetectedAt":{"type":["string","null"]},"minVersion":{"type":["string","null"]},"minBuild":{"type":["integer","null"]},"pendingMinVersion":{"type":["string","null"]},"pendingMinBuild":{"type":["integer","null"]},"updatedAt":{"type":"string"}},"required":["channel","latestVersion","latestBuild","minVersion","minBuild","pendingMinVersion","pendingMinBuild","updatedAt"]}},"required":["appStore","testFlight"]},"fetchedAt":{"type":"string"}},"required":["configured","appStore","appStorePending","appStoreActive","testflightInternal","testflightInternalPending","testflightInternalActive","testflightExternal","testflightExternalPending","testflightExternalActive","versionConfig","fetchedAt"]}}}}}}},"/api/admin/releases/candidates":{"get":{"operationId":"admin.releases.candidates","tags":["Admin"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"configured":{"type":"boolean"},"latestCommit":{"type":["object","null"],"properties":{"sha":{"type":"string"},"message":{"type":"string"},"authorName":{"type":["string","null"]},"committedAt":{"type":"string"},"htmlUrl":{"type":"string"}},"required":["sha","message","authorName","committedAt","htmlUrl"]},"currentTestflight":{"type":["object","null"],"properties":{"versionString":{"type":"string"},"buildNumber":{"type":"integer"}},"required":["versionString","buildNumber"]},"currentAppStore":{"type":["object","null"],"properties":{"versionString":{"type":"string"}},"required":["versionString"]},"candidates":{"type":"array","items":{"type":"object","properties":{"bump":{"enum":["buildOnly","patch","minor","major"],"type":"string"},"version":{"type":"string"},"build":{"type":"integer"},"enabled":{"type":"boolean"},"disabledReason":{"type":["string","null"]}},"required":["bump","version","build","enabled","disabledReason"]}},"defaultBump":{"enum":["buildOnly","patch","minor","major"],"type":"string"},"pendingExternalReview":{"type":["object","null"],"properties":{"versionString":{"type":"string"},"buildNumber":{"type":"string"},"state":{"type":"string"},"buildId":{"type":"string"},"submissionId":{"type":["string","null"]}},"required":["versionString","buildNumber","state","buildId","submissionId"]},"pendingAppStore":{"type":["object","null"],"properties":{"versionString":{"type":"string"},"state":{"type":"string"},"versionId":{"type":"string"},"submissionId":{"type":["string","null"]}},"required":["versionString","state","versionId","submissionId"]}},"required":["configured","latestCommit","currentTestflight","currentAppStore","candidates","defaultBump","pendingExternalReview","pendingAppStore"]}}}}}}},"/api/admin/releases/history":{"get":{"operationId":"admin.releases.history","tags":["Admin"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"entries":{"type":"array","items":{"type":"object","properties":{"runId":{"type":"integer"},"runUrl":{"type":"string"},"correlationId":{"type":["string","null"]},"versionString":{"type":["string","null"]},"buildNumber":{"type":["integer","null"]},"sha":{"type":"string"},"shaShort":{"type":"string"},"shaUrl":{"type":"string"},"status":{"type":"string"},"conclusion":{"type":["string","null"]},"triggeredBy":{"type":["string","null"]},"actorLogin":{"type":["string","null"]},"targets":{"type":"array","items":{"enum":["int","ext","app"],"type":"string"}},"createdAt":{"type":"string"},"startedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"durationMs":{"type":["integer","null"]},"runnerName":{"type":["string","null"]},"steps":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"number":{"type":"integer"},"status":{"type":["string","null"]},"conclusion":{"type":["string","null"]},"startedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]}},"required":["name","number","status","conclusion","startedAt","completedAt"]}}},"required":["runId","runUrl","correlationId","versionString","buildNumber","sha","shaShort","shaUrl","status","conclusion","triggeredBy","actorLogin","targets","createdAt","startedAt","completedAt","durationMs","runnerName","steps"]}}},"required":["entries"]}}}}}}},"/api/admin/releases/trigger":{"post":{"operationId":"admin.releases.trigger","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"bumpType":{"enum":["buildOnly","patch","minor","major"],"type":"string"},"version":{"type":"string"},"build":{"type":"integer","minimum":0},"sha":{"type":"string"},"whatsNew":{"type":"string"},"sendToExternal":{"type":"boolean"},"sendToAppStore":{"type":"boolean"},"replacePendingExternal":{"type":"boolean"},"pendingExternalBuildId":{"type":["string","null"]},"replacePendingAppStore":{"type":"boolean"},"pendingAppStoreSubmissionId":{"type":["string","null"]},"markBreaking":{"type":"boolean"},"triggeredBy":{"type":"string"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"correlationId":{"type":"string"},"version":{"type":"string"},"build":{"type":"integer"},"sha":{"type":"string"},"runId":{"type":["integer","null"]},"runUrl":{"type":["string","null"]}},"required":["correlationId","version","build","sha","runId","runUrl"]}}}}}}},"/api/admin/releases/run-status":{"get":{"operationId":"admin.releases.runStatus","tags":["Admin"],"parameters":[{"name":"correlationId","in":"query","required":true,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true},{"name":"runId","in":"query","required":false,"schema":{"type":"integer"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"correlationId":{"type":"string"},"runId":{"type":["integer","null"]},"status":{"type":"string"},"conclusion":{"type":["string","null"]},"runUrl":{"type":["string","null"]},"headSha":{"type":["string","null"]},"createdAt":{"type":["string","null"]},"startedAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]},"jobName":{"type":["string","null"]},"runnerName":{"type":["string","null"]},"steps":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"number":{"type":"integer"},"status":{"type":["string","null"]},"conclusion":{"type":["string","null"]},"startedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]}},"required":["name","number","status","conclusion","startedAt","completedAt"]}}},"required":["correlationId","runId","status","conclusion","runUrl","headSha","createdAt","startedAt","updatedAt","jobName","runnerName","steps"]}}}}}}},"/api/admin/releases/set-min-version":{"post":{"operationId":"admin.releases.setMinVersion","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"channel":{"enum":["appStore","testFlight"],"type":"string"},"version":{"type":["string","null"]},"build":{"type":["integer","null"],"minimum":0}},"required":["channel","version","build"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"appStore":{"type":["object","null"],"properties":{"channel":{"enum":["appStore","testFlight"],"type":"string"},"latestVersion":{"type":"string"},"latestBuild":{"type":"integer"},"latestDetectedAt":{"type":["string","null"]},"minVersion":{"type":["string","null"]},"minBuild":{"type":["integer","null"]},"pendingMinVersion":{"type":["string","null"]},"pendingMinBuild":{"type":["integer","null"]},"updatedAt":{"type":"string"}},"required":["channel","latestVersion","latestBuild","minVersion","minBuild","pendingMinVersion","pendingMinBuild","updatedAt"]},"testFlight":{"type":["object","null"],"properties":{"channel":{"enum":["appStore","testFlight"],"type":"string"},"latestVersion":{"type":"string"},"latestBuild":{"type":"integer"},"latestDetectedAt":{"type":["string","null"]},"minVersion":{"type":["string","null"]},"minBuild":{"type":["integer","null"]},"pendingMinVersion":{"type":["string","null"]},"pendingMinBuild":{"type":["integer","null"]},"updatedAt":{"type":"string"}},"required":["channel","latestVersion","latestBuild","minVersion","minBuild","pendingMinVersion","pendingMinBuild","updatedAt"]}},"required":["appStore","testFlight"]}}}}}}},"/api/admin/releases/set-pending-min-version":{"post":{"operationId":"admin.releases.setPendingMinVersion","tags":["Admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"channel":{"enum":["appStore","testFlight"],"type":"string"},"version":{"type":["string","null"]},"build":{"type":["integer","null"],"minimum":0}},"required":["channel","version","build"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"appStore":{"type":["object","null"],"properties":{"channel":{"enum":["appStore","testFlight"],"type":"string"},"latestVersion":{"type":"string"},"latestBuild":{"type":"integer"},"latestDetectedAt":{"type":["string","null"]},"minVersion":{"type":["string","null"]},"minBuild":{"type":["integer","null"]},"pendingMinVersion":{"type":["string","null"]},"pendingMinBuild":{"type":["integer","null"]},"updatedAt":{"type":"string"}},"required":["channel","latestVersion","latestBuild","minVersion","minBuild","pendingMinVersion","pendingMinBuild","updatedAt"]},"testFlight":{"type":["object","null"],"properties":{"channel":{"enum":["appStore","testFlight"],"type":"string"},"latestVersion":{"type":"string"},"latestBuild":{"type":"integer"},"latestDetectedAt":{"type":["string","null"]},"minVersion":{"type":["string","null"]},"minBuild":{"type":["integer","null"]},"pendingMinVersion":{"type":["string","null"]},"pendingMinBuild":{"type":["integer","null"]},"updatedAt":{"type":"string"}},"required":["channel","latestVersion","latestBuild","minVersion","minBuild","pendingMinVersion","pendingMinBuild","updatedAt"]}},"required":["appStore","testFlight"]}}}}}}},"/api/auth/phone-number/send-otp":{"post":{"tags":["Phone-number"],"description":"Use this endpoint to send OTP to phone number","operationId":"auth.phoneNumber.sendOtp","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"phoneNumber":{"type":"string","description":"Phone number to send OTP. Eg: \"+1234567890\""}},"required":["phoneNumber"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}},"description":"Bad Request. Usually due to missing parameters, or invalid parameters."},"401":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}},"description":"Unauthorized. Due to missing or invalid authentication."},"403":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"description":"Forbidden. You do not have permission to access this resource or to perform this action."},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"description":"Not Found. The requested resource was not found."},"429":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"description":"Too Many Requests. You have exceeded the rate limit. Try again later."},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"description":"Internal Server Error. This is a problem with the server that you cannot fix."}}}},"/api/auth/phone-number/verify":{"post":{"tags":["Phone-number"],"description":"Use this endpoint to verify phone number","operationId":"auth.phoneNumber.verify","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"phoneNumber":{"type":"string","description":"Phone number to verify. Eg: \"+1234567890\""},"code":{"type":"string","description":"OTP code sent to the phone number"},"disableSession":{"type":"boolean","description":"Optional flag to skip session creation after verification"}},"required":["phoneNumber","code"]}}}},"responses":{"200":{"description":"Phone number verified successfully","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"Indicates if the verification was successful","enum":[true]},"token":{"type":["string","null"],"description":"Session token if session is created, null if disableSession is true or no session is created"},"user":{"type":["object","null"],"properties":{"id":{"type":"string","description":"Unique identifier of the user"},"email":{"type":["string","null"],"format":"email","description":"User's email address"},"emailVerified":{"type":["boolean","null"],"description":"Whether the email is verified"},"name":{"type":["string","null"],"description":"User's name"},"image":{"type":["string","null"],"format":"uri","description":"User's profile image URL"},"phoneNumber":{"type":"string","description":"User's phone number"},"phoneNumberVerified":{"type":"boolean","description":"Whether the phone number is verified"},"createdAt":{"type":"string","format":"date-time","description":"Timestamp when the user was created"},"updatedAt":{"type":"string","format":"date-time","description":"Timestamp when the user was last updated"}},"required":["id","phoneNumber","phoneNumberVerified","createdAt","updatedAt"],"description":"User object with phone number details, null if no user is created or found"}},"required":["status"]}}}},"400":{"description":"Invalid OTP"},"401":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}},"description":"Unauthorized. Due to missing or invalid authentication."},"403":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"description":"Forbidden. You do not have permission to access this resource or to perform this action."},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"description":"Not Found. The requested resource was not found."},"429":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"description":"Too Many Requests. You have exceeded the rate limit. Try again later."},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"description":"Internal Server Error. This is a problem with the server that you cannot fix."}}}},"/api/auth/sign-out":{"post":{"tags":["Default"],"description":"Sign out the current user","operationId":"auth.signOut","security":[],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}}}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}},"description":"Bad Request. Usually due to missing parameters, or invalid parameters."},"401":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}},"description":"Unauthorized. Due to missing or invalid authentication."},"403":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"description":"Forbidden. You do not have permission to access this resource or to perform this action."},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"description":"Not Found. The requested resource was not found."},"429":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"description":"Too Many Requests. You have exceeded the rate limit. Try again later."},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}},"description":"Internal Server Error. This is a problem with the server that you cannot fix."}}}}},"tags":[{"name":"Default","description":"Default endpoints that are included with Better Auth by default. These endpoints are not part of any plugin."}]}