{"openapi":"3.0.3","info":{"title":"AspectAvy Backend API","description":"Server-owned API contract for AspectAvy clients and operations tooling.","version":"0.2.0-staging.g3a055b4959a6"},"components":{"securitySchemes":{"sessionCookie":{"type":"apiKey","in":"cookie","name":"aspectavy_staging_session"}},"schemas":{}},"paths":{"/api/auth/sign-in":{"get":{"summary":"Get current auth session","tags":["identity"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["isLogged"],"properties":{"isLogged":{"type":"boolean"},"session":{"type":"object","required":["email","name","uid"],"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"uid":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["isLogged"],"properties":{"isLogged":{"type":"boolean","enum":[false]}}}}}}}},"post":{"summary":"Sign in with email and password","tags":["identity"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","password"],"properties":{"email":{"type":"string"},"password":{"type":"string"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["session"],"properties":{"session":{"type":"object","required":["email","name","uid"],"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"uid":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/auth/register":{"post":{"summary":"Register with email and password","tags":["identity"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","password"],"properties":{"displayName":{"type":"string"},"email":{"type":"string"},"password":{"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["session"],"properties":{"session":{"type":"object","required":["email","name","uid"],"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"uid":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/auth/sign-out":{"post":{"summary":"Sign out current session","tags":["identity"],"responses":{"200":{"description":"Default Response"}}}},"/api/auth/magic-link/{token}":{"get":{"summary":"Inspect a magic-link token","tags":["identity"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"token","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["magicLink"],"properties":{"magicLink":{"type":"object","required":["emailMasked","expiresAt","onboardingHint","referralCode"],"properties":{"emailMasked":{"type":"string"},"expiresAt":{"type":"string"},"onboardingHint":{"anyOf":[{"type":"string"},{"type":"null"}]},"referralCode":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/auth/magic-link/request":{"post":{"summary":"Request a magic sign-in link","tags":["identity"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string"},"onboardingHint":{"type":"string"},"redirectPath":{"type":"string"},"referralCode":{"type":"string"}}}}}},"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["accepted","delivery","expiresAt"],"properties":{"accepted":{"type":"boolean","enum":[true]},"delivery":{"type":"object","required":["maskedEmail","mode","previewURL"],"properties":{"maskedEmail":{"type":"string"},"mode":{"anyOf":[{"type":"string","enum":["email"]},{"type":"string","enum":["log"]},{"type":"string","enum":["preview"]}]},"previewURL":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"expiresAt":{"type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/auth/magic-link/consume":{"post":{"summary":"Consume a magic sign-in link","tags":["identity"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["token"],"properties":{"token":{"type":"string"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["continuation","session"],"properties":{"continuation":{"type":"object","required":["isNewUser","onboardingHint","redirectPath","referralCode"],"properties":{"isNewUser":{"type":"boolean"},"onboardingHint":{"anyOf":[{"type":"string"},{"type":"null"}]},"redirectPath":{"anyOf":[{"type":"string"},{"type":"null"}]},"referralCode":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"session":{"type":"object","required":["email","name","uid"],"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"uid":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/auth/password-reset/{token}":{"get":{"summary":"Inspect a password-reset token","tags":["identity"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"token","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["passwordReset"],"properties":{"passwordReset":{"type":"object","required":["emailMasked","expiresAt"],"properties":{"emailMasked":{"type":"string"},"expiresAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/auth/password-reset/request":{"post":{"summary":"Request a password-reset link","tags":["identity"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string"}}}}}},"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["accepted","delivery","expiresAt"],"properties":{"accepted":{"type":"boolean","enum":[true]},"delivery":{"type":"object","required":["maskedEmail","mode","previewURL"],"properties":{"maskedEmail":{"type":"string"},"mode":{"anyOf":[{"type":"string","enum":["email"]},{"type":"string","enum":["log"]},{"type":"string","enum":["preview"]}]},"previewURL":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"expiresAt":{"type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/auth/password-reset/consume":{"post":{"summary":"Consume a password-reset token","tags":["identity"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["password","token"],"properties":{"password":{"type":"string"},"token":{"type":"string"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["session"],"properties":{"session":{"type":"object","required":["email","name","uid"],"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"uid":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/user/auth/password":{"put":{"summary":"Update current user password","tags":["identity"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["newPassword"],"properties":{"currentPassword":{"anyOf":[{"type":"string"},{"type":"null"}]},"newPassword":{"type":"string"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["session"],"properties":{"session":{"type":"object","required":["email","name","uid"],"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"uid":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/legal/{type}/active":{"get":{"summary":"Get the active legal document","tags":["legal"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"type","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["document"],"properties":{"document":{"type":"object","required":["contentHash","contentMarkdown","createdByOperatorID","documentType","effectiveAt","id","publishedAt","version"],"properties":{"contentHash":{"type":"string"},"contentMarkdown":{"type":"string"},"createdByOperatorID":{"type":"string"},"documentType":{"type":"string"},"effectiveAt":{"type":"string"},"id":{"type":"string"},"publishedAt":{"type":"string"},"version":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/operator/legal/documents":{"post":{"summary":"Publish a legal document version","tags":["operator","legal"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["contentMarkdown","documentType","version"],"properties":{"contentMarkdown":{"type":"string"},"documentType":{"type":"string"},"effectiveAt":{"type":"string"},"version":{"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["document"],"properties":{"document":{"type":"object","required":["contentHash","contentMarkdown","createdByOperatorID","documentType","effectiveAt","id","publishedAt","version"],"properties":{"contentHash":{"type":"string"},"contentMarkdown":{"type":"string"},"createdByOperatorID":{"type":"string"},"documentType":{"type":"string"},"effectiveAt":{"type":"string"},"id":{"type":"string"},"publishedAt":{"type":"string"},"version":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/operator/legal/documents/{documentID}/retire":{"post":{"summary":"Retire a legal document version","tags":["operator","legal"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"documentID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["retirement"],"properties":{"retirement":{"type":"object","required":["documentID","id","reason","retiredAt","retiredByOperatorID"],"properties":{"documentID":{"type":"string"},"id":{"type":"string"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"retiredAt":{"type":"string"},"retiredByOperatorID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/user":{"get":{"summary":"Get current user profile","tags":["profiles"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["auth","user"],"properties":{"auth":{"type":"object","required":["availableMethods","emailMagicLinkEnabled","hasPassword","passwordSetupRequired","passwordSignInEnabled"],"properties":{"availableMethods":{"type":"array","items":{"anyOf":[{"type":"string","enum":["magic_link"]},{"type":"string","enum":["password"]}]}},"emailMagicLinkEnabled":{"type":"boolean"},"hasPassword":{"type":"boolean"},"passwordSetupRequired":{"type":"boolean"},"passwordSignInEnabled":{"type":"boolean"}}},"user":{"type":"object","required":["acceptedRisk","accountType","avatarUrl","buddyPasses","createdAt","email","hasSeenOptIn","id","lastViewedtermsDate","lifetimeCoupons","lifetimePromotionCodeIds","name","newsletterEnabled","onboarding","proCoupons","proPromotionCodeIds","researchEnabled","stripeCustomerId","subscriptionEndDate","subscriptionPlan","subscriptionStatus","updatedAt"],"properties":{"acceptedRisk":{"type":"boolean"},"accountType":{"type":"string"},"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"buddyPasses":{"type":"array","items":{}},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasSeenOptIn":{"type":"boolean"},"id":{"type":"string"},"lastViewedtermsDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"lifetimeCoupons":{"type":"array","items":{}},"lifetimePromotionCodeIds":{"type":"array","items":{"type":"string"}},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"newsletterEnabled":{"type":"boolean"},"onboarding":{"type":"object","required":["completedAt","hint","step"],"properties":{"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]},"step":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"proCoupons":{"type":"array","items":{}},"proPromotionCodeIds":{"type":"array","items":{"type":"string"}},"researchEnabled":{"type":"boolean"},"stripeCustomerId":{"anyOf":[{"type":"string"},{"type":"null"}]},"subscriptionEndDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"subscriptionPlan":{"type":"string"},"subscriptionStatus":{"type":"string"},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}},"patch":{"summary":"Update current user profile","tags":["profiles"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"acceptedRisk":{"type":"boolean"},"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasSeenOptIn":{"type":"boolean"},"lastViewedtermsDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"newsletterEnabled":{"type":"boolean"},"onboardingCompletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"onboardingHint":{"anyOf":[{"type":"string"},{"type":"null"}]},"onboardingStep":{"anyOf":[{"type":"string"},{"type":"null"}]},"researchEnabled":{"type":"boolean"},"termsLastViewedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["user"],"properties":{"user":{"type":"object","required":["acceptedRisk","accountType","avatarUrl","buddyPasses","createdAt","email","hasSeenOptIn","id","lastViewedtermsDate","lifetimeCoupons","lifetimePromotionCodeIds","name","newsletterEnabled","onboarding","proCoupons","proPromotionCodeIds","researchEnabled","stripeCustomerId","subscriptionEndDate","subscriptionPlan","subscriptionStatus","updatedAt"],"properties":{"acceptedRisk":{"type":"boolean"},"accountType":{"type":"string"},"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"buddyPasses":{"type":"array","items":{}},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasSeenOptIn":{"type":"boolean"},"id":{"type":"string"},"lastViewedtermsDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"lifetimeCoupons":{"type":"array","items":{}},"lifetimePromotionCodeIds":{"type":"array","items":{"type":"string"}},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"newsletterEnabled":{"type":"boolean"},"onboarding":{"type":"object","required":["completedAt","hint","step"],"properties":{"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"hint":{"anyOf":[{"type":"string"},{"type":"null"}]},"step":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"proCoupons":{"type":"array","items":{}},"proPromotionCodeIds":{"type":"array","items":{"type":"string"}},"researchEnabled":{"type":"boolean"},"stripeCustomerId":{"anyOf":[{"type":"string"},{"type":"null"}]},"subscriptionEndDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"subscriptionPlan":{"type":"string"},"subscriptionStatus":{"type":"string"},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/user/settings":{"get":{"summary":"Get current user settings","tags":["profiles"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["metadata","settings"],"properties":{"metadata":{"type":"object","required":["groups","schemaVersion","updatedAt"],"properties":{"groups":{"type":"array","items":{"type":"object","required":["id","keys","title"],"properties":{"id":{"type":"string"},"keys":{"type":"array","items":{"type":"string"}},"title":{"type":"string"}}}},"schemaVersion":{"type":"number"},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"settings":{"type":"object","required":["appUpdatePromptsEnabled","anonymousAnalyticsEnabled","cameraModePreference","forecastPolygonOpacityPreset","ignoredRecommendedVersion","layerVisibility","mapStylePreference","newsletterEnabled","researchEnabled"],"properties":{"appUpdatePromptsEnabled":{"type":"boolean"},"anonymousAnalyticsEnabled":{"type":"boolean"},"cameraModePreference":{"anyOf":[{"type":"string","enum":["three_d"]},{"type":"string","enum":["two_d"]}]},"forecastPolygonOpacityPreset":{"anyOf":[{"type":"string","enum":["standard"]},{"type":"string","enum":["strong"]},{"type":"string","enum":["subdued"]}]},"ignoredRecommendedVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"layerVisibility":{"type":"object","additionalProperties":{"type":"boolean"}},"mapStylePreference":{"anyOf":[{"type":"string","enum":["satellite"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["winter"]}]},"newsletterEnabled":{"type":"boolean"},"researchEnabled":{"type":"boolean"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}},"put":{"summary":"Update current user settings","tags":["profiles"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appUpdatePromptsEnabled":{"type":"boolean"},"anonymousAnalyticsEnabled":{"type":"boolean"},"cameraModePreference":{"anyOf":[{"type":"string","enum":["three_d"]},{"type":"string","enum":["two_d"]}]},"forecastPolygonOpacityPreset":{"anyOf":[{"type":"string","enum":["standard"]},{"type":"string","enum":["strong"]},{"type":"string","enum":["subdued"]}]},"ignoredRecommendedVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"layerVisibility":{"type":"object","additionalProperties":{"type":"boolean"}},"mapStylePreference":{"anyOf":[{"type":"string","enum":["satellite"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["winter"]}]},"newsletterEnabled":{"type":"boolean"},"researchEnabled":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["metadata","settings"],"properties":{"metadata":{"type":"object","required":["groups","schemaVersion","updatedAt"],"properties":{"groups":{"type":"array","items":{"type":"object","required":["id","keys","title"],"properties":{"id":{"type":"string"},"keys":{"type":"array","items":{"type":"string"}},"title":{"type":"string"}}}},"schemaVersion":{"type":"number"},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"settings":{"type":"object","required":["appUpdatePromptsEnabled","anonymousAnalyticsEnabled","cameraModePreference","forecastPolygonOpacityPreset","ignoredRecommendedVersion","layerVisibility","mapStylePreference","newsletterEnabled","researchEnabled"],"properties":{"appUpdatePromptsEnabled":{"type":"boolean"},"anonymousAnalyticsEnabled":{"type":"boolean"},"cameraModePreference":{"anyOf":[{"type":"string","enum":["three_d"]},{"type":"string","enum":["two_d"]}]},"forecastPolygonOpacityPreset":{"anyOf":[{"type":"string","enum":["standard"]},{"type":"string","enum":["strong"]},{"type":"string","enum":["subdued"]}]},"ignoredRecommendedVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"layerVisibility":{"type":"object","additionalProperties":{"type":"boolean"}},"mapStylePreference":{"anyOf":[{"type":"string","enum":["satellite"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["winter"]}]},"newsletterEnabled":{"type":"boolean"},"researchEnabled":{"type":"boolean"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/user/questionnaires":{"get":{"summary":"List current user questionnaires","tags":["profiles"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["questionnaires"],"properties":{"questionnaires":{"type":"array","items":{"type":"object","required":["answers","definition","latestResponse","response","status","version"],"properties":{"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]}},"definition":{"type":"object","required":["activeVersionID","createdAt","questionnaireKey","summary","title","updatedAt"],"properties":{"activeVersionID":{"type":"string"},"createdAt":{"type":"string"},"questionnaireKey":{"type":"string"},"summary":{"type":"string"},"title":{"type":"string"},"updatedAt":{"type":"string"}}},"latestResponse":{"anyOf":[{"type":"object","required":["answers","id","questionnaireKey","questionnaireVersionID","submittedAt","updatedAt","userID"],"properties":{"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]}},"id":{"type":"string"},"questionnaireKey":{"type":"string"},"questionnaireVersionID":{"type":"string"},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}},{"type":"null"}]},"response":{"anyOf":[{"type":"object","required":["answers","id","questionnaireKey","questionnaireVersionID","submittedAt","updatedAt","userID"],"properties":{"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]}},"id":{"type":"string"},"questionnaireKey":{"type":"string"},"questionnaireVersionID":{"type":"string"},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["complete"]},{"type":"string","enum":["incomplete"]},{"type":"string","enum":["needs_review"]}]},"version":{"type":"object","required":["changeSummary","createdAt","createdByOperatorID","id","publishedAt","questionnaireKey","schema","sourceOrigin","status","summary","title","versionNumber"],"properties":{"changeSummary":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"questionnaireKey":{"type":"string"},"schema":{"type":"object","required":["questions"],"properties":{"questions":{"type":"array","items":{"type":"object","required":["helpText","key","kind","legacyQuestionID","options","placeholder","prompt","required","sortOrder"],"properties":{"helpText":{"anyOf":[{"type":"string"},{"type":"null"}]},"key":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["long_text"]},{"type":"string","enum":["number"]},{"type":"string","enum":["single_select"]},{"type":"string","enum":["text"]}]},"legacyQuestionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"options":{"type":"array","items":{"type":"object","required":["key","label","legacyAnswerID","sortOrder"],"properties":{"key":{"type":"string"},"label":{"type":"string"},"legacyAnswerID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sortOrder":{"type":"number"}}}},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}]},"prompt":{"type":"string"},"required":{"type":"boolean"},"sortOrder":{"type":"number"}}}}}},"sourceOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string"},"summary":{"type":"string"},"title":{"type":"string"},"versionNumber":{"type":"number"}}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/user/questionnaires/{questionnaireKey}":{"get":{"summary":"Get a current user questionnaire","tags":["profiles"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"questionnaireKey","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["questionnaire"],"properties":{"questionnaire":{"type":"object","required":["answers","definition","latestResponse","response","status","version"],"properties":{"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]}},"definition":{"type":"object","required":["activeVersionID","createdAt","questionnaireKey","summary","title","updatedAt"],"properties":{"activeVersionID":{"type":"string"},"createdAt":{"type":"string"},"questionnaireKey":{"type":"string"},"summary":{"type":"string"},"title":{"type":"string"},"updatedAt":{"type":"string"}}},"latestResponse":{"anyOf":[{"type":"object","required":["answers","id","questionnaireKey","questionnaireVersionID","submittedAt","updatedAt","userID"],"properties":{"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]}},"id":{"type":"string"},"questionnaireKey":{"type":"string"},"questionnaireVersionID":{"type":"string"},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}},{"type":"null"}]},"response":{"anyOf":[{"type":"object","required":["answers","id","questionnaireKey","questionnaireVersionID","submittedAt","updatedAt","userID"],"properties":{"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]}},"id":{"type":"string"},"questionnaireKey":{"type":"string"},"questionnaireVersionID":{"type":"string"},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["complete"]},{"type":"string","enum":["incomplete"]},{"type":"string","enum":["needs_review"]}]},"version":{"type":"object","required":["changeSummary","createdAt","createdByOperatorID","id","publishedAt","questionnaireKey","schema","sourceOrigin","status","summary","title","versionNumber"],"properties":{"changeSummary":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"questionnaireKey":{"type":"string"},"schema":{"type":"object","required":["questions"],"properties":{"questions":{"type":"array","items":{"type":"object","required":["helpText","key","kind","legacyQuestionID","options","placeholder","prompt","required","sortOrder"],"properties":{"helpText":{"anyOf":[{"type":"string"},{"type":"null"}]},"key":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["long_text"]},{"type":"string","enum":["number"]},{"type":"string","enum":["single_select"]},{"type":"string","enum":["text"]}]},"legacyQuestionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"options":{"type":"array","items":{"type":"object","required":["key","label","legacyAnswerID","sortOrder"],"properties":{"key":{"type":"string"},"label":{"type":"string"},"legacyAnswerID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sortOrder":{"type":"number"}}}},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}]},"prompt":{"type":"string"},"required":{"type":"boolean"},"sortOrder":{"type":"number"}}}}}},"sourceOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string"},"summary":{"type":"string"},"title":{"type":"string"},"versionNumber":{"type":"number"}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/user/questionnaires/{questionnaireKey}/response":{"patch":{"summary":"Patch a current user questionnaire response","tags":["profiles"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["answers"],"properties":{"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"questionnaireKey","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["questionnaire"],"properties":{"questionnaire":{"type":"object","required":["answers","definition","latestResponse","response","status","version"],"properties":{"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]}},"definition":{"type":"object","required":["activeVersionID","createdAt","questionnaireKey","summary","title","updatedAt"],"properties":{"activeVersionID":{"type":"string"},"createdAt":{"type":"string"},"questionnaireKey":{"type":"string"},"summary":{"type":"string"},"title":{"type":"string"},"updatedAt":{"type":"string"}}},"latestResponse":{"anyOf":[{"type":"object","required":["answers","id","questionnaireKey","questionnaireVersionID","submittedAt","updatedAt","userID"],"properties":{"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]}},"id":{"type":"string"},"questionnaireKey":{"type":"string"},"questionnaireVersionID":{"type":"string"},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}},{"type":"null"}]},"response":{"anyOf":[{"type":"object","required":["answers","id","questionnaireKey","questionnaireVersionID","submittedAt","updatedAt","userID"],"properties":{"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]}},"id":{"type":"string"},"questionnaireKey":{"type":"string"},"questionnaireVersionID":{"type":"string"},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["complete"]},{"type":"string","enum":["incomplete"]},{"type":"string","enum":["needs_review"]}]},"version":{"type":"object","required":["changeSummary","createdAt","createdByOperatorID","id","publishedAt","questionnaireKey","schema","sourceOrigin","status","summary","title","versionNumber"],"properties":{"changeSummary":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"questionnaireKey":{"type":"string"},"schema":{"type":"object","required":["questions"],"properties":{"questions":{"type":"array","items":{"type":"object","required":["helpText","key","kind","legacyQuestionID","options","placeholder","prompt","required","sortOrder"],"properties":{"helpText":{"anyOf":[{"type":"string"},{"type":"null"}]},"key":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["long_text"]},{"type":"string","enum":["number"]},{"type":"string","enum":["single_select"]},{"type":"string","enum":["text"]}]},"legacyQuestionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"options":{"type":"array","items":{"type":"object","required":["key","label","legacyAnswerID","sortOrder"],"properties":{"key":{"type":"string"},"label":{"type":"string"},"legacyAnswerID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sortOrder":{"type":"number"}}}},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}]},"prompt":{"type":"string"},"required":{"type":"boolean"},"sortOrder":{"type":"number"}}}}}},"sourceOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string"},"summary":{"type":"string"},"title":{"type":"string"},"versionNumber":{"type":"number"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}},"put":{"summary":"Save a current user questionnaire response","tags":["profiles"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["answers"],"properties":{"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"questionnaireKey","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["questionnaire"],"properties":{"questionnaire":{"type":"object","required":["answers","definition","latestResponse","response","status","version"],"properties":{"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]}},"definition":{"type":"object","required":["activeVersionID","createdAt","questionnaireKey","summary","title","updatedAt"],"properties":{"activeVersionID":{"type":"string"},"createdAt":{"type":"string"},"questionnaireKey":{"type":"string"},"summary":{"type":"string"},"title":{"type":"string"},"updatedAt":{"type":"string"}}},"latestResponse":{"anyOf":[{"type":"object","required":["answers","id","questionnaireKey","questionnaireVersionID","submittedAt","updatedAt","userID"],"properties":{"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]}},"id":{"type":"string"},"questionnaireKey":{"type":"string"},"questionnaireVersionID":{"type":"string"},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}},{"type":"null"}]},"response":{"anyOf":[{"type":"object","required":["answers","id","questionnaireKey","questionnaireVersionID","submittedAt","updatedAt","userID"],"properties":{"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]}},"id":{"type":"string"},"questionnaireKey":{"type":"string"},"questionnaireVersionID":{"type":"string"},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["complete"]},{"type":"string","enum":["incomplete"]},{"type":"string","enum":["needs_review"]}]},"version":{"type":"object","required":["changeSummary","createdAt","createdByOperatorID","id","publishedAt","questionnaireKey","schema","sourceOrigin","status","summary","title","versionNumber"],"properties":{"changeSummary":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"questionnaireKey":{"type":"string"},"schema":{"type":"object","required":["questions"],"properties":{"questions":{"type":"array","items":{"type":"object","required":["helpText","key","kind","legacyQuestionID","options","placeholder","prompt","required","sortOrder"],"properties":{"helpText":{"anyOf":[{"type":"string"},{"type":"null"}]},"key":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["long_text"]},{"type":"string","enum":["number"]},{"type":"string","enum":["single_select"]},{"type":"string","enum":["text"]}]},"legacyQuestionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"options":{"type":"array","items":{"type":"object","required":["key","label","legacyAnswerID","sortOrder"],"properties":{"key":{"type":"string"},"label":{"type":"string"},"legacyAnswerID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sortOrder":{"type":"number"}}}},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}]},"prompt":{"type":"string"},"required":{"type":"boolean"},"sortOrder":{"type":"number"}}}}}},"sourceOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string"},"summary":{"type":"string"},"title":{"type":"string"},"versionNumber":{"type":"number"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/profile/summary":{"get":{"summary":"Get current profile summary","tags":["profiles"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["summary"],"properties":{"summary":{"type":"object","required":["identity","membership","sharing","support"],"properties":{"identity":{"type":"object","required":["avatar","avatarURL","email","legacyAccountType","name","userID"],"properties":{"avatar":{"type":"null"},"avatarURL":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"legacyAccountType":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"userID":{"type":"string"}}},"membership":{"type":"object","required":["endAt","plan","status"],"properties":{"endAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"plan":{"type":"string"},"status":{"type":"string"}}},"sharing":{"type":"object","required":["availableBuddyPassCount","redeemedBuddyPassCount","sharedBuddyPassCount"],"properties":{"availableBuddyPassCount":{"type":"number"},"redeemedBuddyPassCount":{"type":"number"},"sharedBuddyPassCount":{"type":"number"}}},"support":{"type":"object","required":["activeForecastOverrideCount","debugToolsEnabled","favoriteZoneCount","primaryFavoriteZoneID","settingsUpdatedAt"],"properties":{"activeForecastOverrideCount":{"type":"number"},"debugToolsEnabled":{"type":"boolean"},"favoriteZoneCount":{"type":"number"},"primaryFavoriteZoneID":{"anyOf":[{"type":"string"},{"type":"null"}]},"settingsUpdatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/user/runtime":{"get":{"summary":"Get current user runtime state","tags":["profiles"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["capabilities","content","entitlements","experiments","features","flags","links","surfaces"],"properties":{"capabilities":{"type":"object","required":["feedbackReporting"],"properties":{"feedbackReporting":{"type":"object","required":["allowed","allowedSlots","expiresAt","maxTotalBytes","mode"],"properties":{"allowed":{"type":"boolean"},"allowedSlots":{"type":"number"},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxTotalBytes":{"type":"number"},"mode":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["standard"]}]}}}}},"content":{"type":"object","required":["launchCampaign"],"properties":{"launchCampaign":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]}}},"entitlements":{"type":"object","required":["activeUntil","features","plan","source","status","updatedAt"],"properties":{"activeUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"features":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"source":{"type":"string"},"status":{"type":"string"},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"experiments":{"type":"object","additionalProperties":{"type":"string"}},"features":{"type":"object","additionalProperties":{}},"flags":{"type":"object","additionalProperties":{"type":"boolean"}},"links":{"type":"object","required":["universalLinkBaseUrl"],"properties":{"universalLinkBaseUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"surfaces":{"type":"array","items":{"type":"object","additionalProperties":{}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/profile/avatar/upload-session":{"post":{"summary":"Create a profile avatar upload session","tags":["profiles"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["contentType"],"properties":{"contentType":{"type":"string"},"maxBytes":{"type":"number"},"metadata":{"type":"object","additionalProperties":{}}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["uploadSession"],"properties":{"uploadSession":{"type":"object","required":["byteSize","checksum","contentType","createdAt","directUpload","expiresAt","id","maxBytes","metadata","status","storageKey","updatedAt","uploadURL"],"properties":{"byteSize":{"anyOf":[{"type":"number"},{"type":"null"}]},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentType":{"type":"string"},"createdAt":{"type":"string"},"directUpload":{"anyOf":[{"type":"object","required":["expiresAt","headers","method","url"],"properties":{"expiresAt":{"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"method":{"type":"string","enum":["PUT"]},"url":{"type":"string"}}},{"type":"null"}]},"expiresAt":{"type":"string"},"id":{"type":"string"},"maxBytes":{"type":"number"},"metadata":{"type":"object","additionalProperties":{}},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["uploaded"]}]},"storageKey":{"type":"string"},"updatedAt":{"type":"string"},"uploadURL":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/profile/avatar/uploads/{sessionID}":{"put":{"summary":"Mark a profile avatar upload as received","tags":["profiles"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["byteSize"],"properties":{"byteSize":{"type":"number"},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"sessionID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["receipt"],"properties":{"receipt":{"type":"object","required":["asset","uploadSession"],"properties":{"asset":{"type":"object","required":["byteSize","checksum","contentType","createdAt","id","metadata","publicURL","status","storageKey","updatedAt","uploadSessionID"],"properties":{"byteSize":{"anyOf":[{"type":"number"},{"type":"null"}]},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentType":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"publicURL":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["deleted"]},{"type":"string","enum":["pending"]}]},"storageKey":{"type":"string"},"updatedAt":{"type":"string"},"uploadSessionID":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"uploadSession":{"type":"object","required":["byteSize","checksum","contentType","createdAt","directUpload","expiresAt","id","maxBytes","metadata","status","storageKey","updatedAt","uploadURL"],"properties":{"byteSize":{"anyOf":[{"type":"number"},{"type":"null"}]},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentType":{"type":"string"},"createdAt":{"type":"string"},"directUpload":{"anyOf":[{"type":"object","required":["expiresAt","headers","method","url"],"properties":{"expiresAt":{"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"method":{"type":"string","enum":["PUT"]},"url":{"type":"string"}}},{"type":"null"}]},"expiresAt":{"type":"string"},"id":{"type":"string"},"maxBytes":{"type":"number"},"metadata":{"type":"object","additionalProperties":{}},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["uploaded"]}]},"storageKey":{"type":"string"},"updatedAt":{"type":"string"},"uploadURL":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/profile/avatar/complete":{"post":{"summary":"Activate a received profile avatar upload","tags":["profiles"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["sessionID"],"properties":{"sessionID":{"type":"string"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["asset"],"properties":{"asset":{"type":"object","required":["byteSize","checksum","contentType","createdAt","id","metadata","publicURL","status","storageKey","updatedAt","uploadSessionID"],"properties":{"byteSize":{"anyOf":[{"type":"number"},{"type":"null"}]},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentType":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"publicURL":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["deleted"]},{"type":"string","enum":["pending"]}]},"storageKey":{"type":"string"},"updatedAt":{"type":"string"},"uploadSessionID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/profile/avatar":{"delete":{"summary":"Delete current profile avatar","tags":["profiles"],"responses":{"204":{"description":"Default Response"},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/profile/avatar/assets/{assetID}":{"get":{"summary":"Get profile avatar asset metadata","tags":["profiles"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"assetID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["asset"],"properties":{"asset":{"type":"object","required":["byteSize","checksum","contentType","createdAt","id","metadata","publicURL","status","storageKey","updatedAt","uploadSessionID"],"properties":{"byteSize":{"anyOf":[{"type":"number"},{"type":"null"}]},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentType":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"publicURL":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["deleted"]},{"type":"string","enum":["pending"]}]},"storageKey":{"type":"string"},"updatedAt":{"type":"string"},"uploadSessionID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/profile/avatar/assets/{assetID}/download":{"get":{"summary":"Download profile avatar asset bytes","tags":["profiles"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"assetID","required":true}],"responses":{"304":{"description":"Default Response"},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"416":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/user/device-capabilities":{"put":{"summary":"Update current user device capabilities","tags":["profiles"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["deviceID","platform"],"properties":{"appBuild":{"anyOf":[{"type":"string"},{"type":"null"}]},"appVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"backgroundLocationSupported":{"type":"boolean"},"capabilities":{"type":"object","additionalProperties":{}},"deviceID":{"type":"string"},"deviceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"locationSupported":{"type":"boolean"},"platform":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["web"]}]},"pushSupported":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["capabilities"],"properties":{"capabilities":{"type":"object","required":["appBuild","appVersion","backgroundLocationSupported","capabilities","createdAt","deviceID","deviceName","locationSupported","platform","pushSupported","updatedAt"],"properties":{"appBuild":{"anyOf":[{"type":"string"},{"type":"null"}]},"appVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"backgroundLocationSupported":{"type":"boolean"},"capabilities":{"type":"object","additionalProperties":{}},"createdAt":{"type":"string"},"deviceID":{"type":"string"},"deviceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"locationSupported":{"type":"boolean"},"platform":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["web"]}]},"pushSupported":{"type":"boolean"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/user/legal/acceptance":{"post":{"summary":"Record current user legal acceptance evidence","tags":["profiles"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["documentType","documentVersion"],"properties":{"acceptedAt":{"type":"string"},"documentType":{"type":"string"},"documentVersion":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["acceptance"],"properties":{"acceptance":{"type":"object","required":["acceptedAt","createdAt","documentID","documentType","documentVersion","id","metadata"],"properties":{"acceptedAt":{"type":"string"},"createdAt":{"type":"string"},"documentID":{"anyOf":[{"type":"string"},{"type":"null"}]},"documentType":{"type":"string"},"documentVersion":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/user/delete":{"post":{"summary":"Request current account deletion","tags":["profiles"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{}},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["deletionRequest"],"properties":{"deletionRequest":{"type":"object","required":["createdAt","id","metadata","reason","requestedAt","scheduledDeletionAt","status","updatedAt"],"properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"requestedAt":{"type":"string"},"scheduledDeletionAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["processed"]},{"type":"string","enum":["requested"]}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/user/support-summary":{"get":{"summary":"Get current user support summary","tags":["profiles"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["summary"],"properties":{"summary":{"type":"object","required":["account","avatar","device","legal","profile"],"properties":{"account":{"type":"object","required":["deletionRequest","status","userID"],"properties":{"deletionRequest":{"anyOf":[{"type":"object","required":["createdAt","id","metadata","reason","requestedAt","scheduledDeletionAt","status","updatedAt"],"properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"requestedAt":{"type":"string"},"scheduledDeletionAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["processed"]},{"type":"string","enum":["requested"]}]},"updatedAt":{"type":"string"}}},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]},{"type":"string","enum":["pending_deletion"]}]},"userID":{"type":"string"}}},"avatar":{"type":"object","required":["activeAsset","avatarURL"],"properties":{"activeAsset":{"anyOf":[{"type":"object","required":["byteSize","checksum","contentType","createdAt","id","metadata","publicURL","status","storageKey","updatedAt","uploadSessionID"],"properties":{"byteSize":{"anyOf":[{"type":"number"},{"type":"null"}]},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentType":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"publicURL":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["deleted"]},{"type":"string","enum":["pending"]}]},"storageKey":{"type":"string"},"updatedAt":{"type":"string"},"uploadSessionID":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null"}]},"avatarURL":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"device":{"type":"object","required":["latestCapabilities"],"properties":{"latestCapabilities":{"anyOf":[{"type":"object","required":["appBuild","appVersion","backgroundLocationSupported","capabilities","createdAt","deviceID","deviceName","locationSupported","platform","pushSupported","updatedAt"],"properties":{"appBuild":{"anyOf":[{"type":"string"},{"type":"null"}]},"appVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"backgroundLocationSupported":{"type":"boolean"},"capabilities":{"type":"object","additionalProperties":{}},"createdAt":{"type":"string"},"deviceID":{"type":"string"},"deviceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"locationSupported":{"type":"boolean"},"platform":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["web"]}]},"pushSupported":{"type":"boolean"},"updatedAt":{"type":"string"}}},{"type":"null"}]}}},"legal":{"type":"object","required":["latestAcceptances"],"properties":{"latestAcceptances":{"type":"array","items":{"type":"object","required":["acceptedAt","createdAt","documentID","documentType","documentVersion","id","metadata"],"properties":{"acceptedAt":{"type":"string"},"createdAt":{"type":"string"},"documentID":{"anyOf":[{"type":"string"},{"type":"null"}]},"documentType":{"type":"string"},"documentVersion":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}}}}}}},"profile":{"type":"object","required":["email","name"],"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/analytics/events":{"post":{"summary":"Record current-user product analytics event","tags":["analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","required":["eventName"],"properties":{"anonymousID":{"anyOf":[{"type":"string"},{"type":"null"}]},"appVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"context":{"type":"object","additionalProperties":{}},"deviceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"domain":{"anyOf":[{"type":"string"},{"type":"null"}]},"eventName":{"type":"string"},"occurredAt":{"type":"string"},"payloadClass":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["operational"]},{"type":"string","enum":["product"]},{"type":"string","enum":["personal"]},{"type":"string","enum":["sensitive"]}]},"platform":{"anyOf":[{"type":"string"},{"type":"null"}]},"privacyClass":{"anyOf":[{"type":"string","enum":["public"]},{"type":"string","enum":["internal"]},{"type":"string","enum":["personal"]},{"type":"string","enum":["sensitive"]},{"type":"string","enum":["restricted"]}]},"properties":{"type":"object","additionalProperties":{}},"sessionID":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"object","required":["events","schemaVersion"],"properties":{"events":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"object","required":["eventName"],"properties":{"anonymousID":{"anyOf":[{"type":"string"},{"type":"null"}]},"appVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"context":{"type":"object","additionalProperties":{}},"deviceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"domain":{"anyOf":[{"type":"string"},{"type":"null"}]},"eventName":{"type":"string"},"occurredAt":{"type":"string"},"payloadClass":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["operational"]},{"type":"string","enum":["product"]},{"type":"string","enum":["personal"]},{"type":"string","enum":["sensitive"]}]},"platform":{"anyOf":[{"type":"string"},{"type":"null"}]},"privacyClass":{"anyOf":[{"type":"string","enum":["public"]},{"type":"string","enum":["internal"]},{"type":"string","enum":["personal"]},{"type":"string","enum":["sensitive"]},{"type":"string","enum":["restricted"]}]},"properties":{"type":"object","additionalProperties":{}},"sessionID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"schemaVersion":{"type":"number","enum":[1]}}}]}}}},"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["acceptedCount","events","sinkMode","skippedCount"],"properties":{"acceptedCount":{"type":"number"},"events":{"type":"array","items":{"type":"object","required":["anonymousID","appVersion","context","deviceID","domain","eventName","id","occurredAt","payloadClass","platform","privacyClass","properties","receivedAt","requestID","sessionID"],"properties":{"anonymousID":{"anyOf":[{"type":"string"},{"type":"null"}]},"appVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"context":{"type":"object","additionalProperties":{}},"deviceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"domain":{"anyOf":[{"type":"string"},{"type":"null"}]},"eventName":{"type":"string"},"id":{"type":"string"},"occurredAt":{"type":"string"},"payloadClass":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["operational"]},{"type":"string","enum":["product"]},{"type":"string","enum":["personal"]},{"type":"string","enum":["sensitive"]}]},"platform":{"anyOf":[{"type":"string"},{"type":"null"}]},"privacyClass":{"anyOf":[{"type":"string","enum":["public"]},{"type":"string","enum":["internal"]},{"type":"string","enum":["personal"]},{"type":"string","enum":["sensitive"]},{"type":"string","enum":["restricted"]}]},"properties":{"type":"object","additionalProperties":{}},"receivedAt":{"type":"string"},"requestID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sessionID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"sinkMode":{"type":"string","enum":["database"]},"skippedCount":{"type":"number"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"413":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/diagnostics/reports":{"post":{"summary":"Record current-user client diagnostic report","tags":["diagnostics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["kind","message"],"properties":{"anonymousID":{"anyOf":[{"type":"string"},{"type":"null"}]},"appVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"breadcrumbs":{"type":"array","items":{"type":"object","additionalProperties":{}}},"context":{"type":"object","additionalProperties":{}},"deviceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"fingerprint":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"anyOf":[{"type":"string","enum":["crash"]},{"type":"string","enum":["error"]},{"type":"string","enum":["log"]},{"type":"string","enum":["performance"]}]},"message":{"type":"string"},"occurredAt":{"type":"string"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}]},"release":{"anyOf":[{"type":"string"},{"type":"null"}]},"severity":{"anyOf":[{"type":"string","enum":["debug"]},{"type":"string","enum":["error"]},{"type":"string","enum":["fatal"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"sessionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"stackTrace":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["report"],"properties":{"report":{"type":"object","required":["actorUserID","anonymousID","appVersion","breadcrumbs","context","deviceID","fingerprint","id","kind","message","occurredAt","payloadSizeBytes","platform","receivedAt","redactionApplied","release","requestID","sessionID","severity","stackTrace"],"properties":{"actorUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"anonymousID":{"anyOf":[{"type":"string"},{"type":"null"}]},"appVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"breadcrumbs":{"type":"array","items":{"type":"object","additionalProperties":{}}},"context":{"type":"object","additionalProperties":{}},"deviceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"fingerprint":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["crash"]},{"type":"string","enum":["error"]},{"type":"string","enum":["log"]},{"type":"string","enum":["performance"]}]},"message":{"type":"string"},"occurredAt":{"type":"string"},"payloadSizeBytes":{"type":"number"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}]},"receivedAt":{"type":"string"},"redactionApplied":{"type":"boolean"},"release":{"anyOf":[{"type":"string"},{"type":"null"}]},"requestID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sessionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"severity":{"anyOf":[{"type":"string","enum":["debug"]},{"type":"string","enum":["error"]},{"type":"string","enum":["fatal"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"stackTrace":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"413":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/analytics/summary":{"get":{"summary":"Operator analytics and diagnostics summary","tags":["operator","analytics"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"domain","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"windowEnd","required":false},{"schema":{"type":"string"},"in":"query","name":"windowStart","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["diagnostics","events"],"properties":{"diagnostics":{"type":"array","items":{"type":"object","required":["count","kind","severity"],"properties":{"count":{"type":"number"},"kind":{"anyOf":[{"type":"string","enum":["crash"]},{"type":"string","enum":["error"]},{"type":"string","enum":["log"]},{"type":"string","enum":["performance"]}]},"severity":{"anyOf":[{"type":"string","enum":["debug"]},{"type":"string","enum":["error"]},{"type":"string","enum":["fatal"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]}}}},"events":{"type":"array","items":{"type":"object","required":["bucketDay","count","domain","eventName","privacyClass"],"properties":{"bucketDay":{"type":"string"},"count":{"type":"number"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}]},"eventName":{"type":"string"},"privacyClass":{"anyOf":[{"type":"string","enum":["public"]},{"type":"string","enum":["internal"]},{"type":"string","enum":["personal"]},{"type":"string","enum":["sensitive"]},{"type":"string","enum":["restricted"]}]}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/diagnostics/reports":{"get":{"summary":"Operator list client diagnostic reports","tags":["operator","diagnostics"],"parameters":[{"schema":{"anyOf":[{"type":"string","enum":["crash"]},{"type":"string","enum":["error"]},{"type":"string","enum":["log"]},{"type":"string","enum":["performance"]}]},"in":"query","name":"kind","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"anyOf":[{"type":"string","enum":["debug"]},{"type":"string","enum":["error"]},{"type":"string","enum":["fatal"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"in":"query","name":"severity","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["reports"],"properties":{"reports":{"type":"array","items":{"type":"object","required":["actorUserID","anonymousID","appVersion","breadcrumbs","context","deviceID","fingerprint","id","kind","message","occurredAt","payloadSizeBytes","platform","receivedAt","redactionApplied","release","requestID","sessionID","severity","stackTrace"],"properties":{"actorUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"anonymousID":{"anyOf":[{"type":"string"},{"type":"null"}]},"appVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"breadcrumbs":{"type":"array","items":{"type":"object","additionalProperties":{}}},"context":{"type":"object","additionalProperties":{}},"deviceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"fingerprint":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["crash"]},{"type":"string","enum":["error"]},{"type":"string","enum":["log"]},{"type":"string","enum":["performance"]}]},"message":{"type":"string"},"occurredAt":{"type":"string"},"payloadSizeBytes":{"type":"number"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}]},"receivedAt":{"type":"string"},"redactionApplied":{"type":"boolean"},"release":{"anyOf":[{"type":"string"},{"type":"null"}]},"requestID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sessionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"severity":{"anyOf":[{"type":"string","enum":["debug"]},{"type":"string","enum":["error"]},{"type":"string","enum":["fatal"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"stackTrace":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/content/documents":{"get":{"summary":"List published content documents","tags":["content"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"contentKey","required":false},{"schema":{"type":"string"},"in":"query","name":"includeExpired","required":false},{"schema":{"anyOf":[{"type":"string","enum":["education"]},{"type":"string","enum":["launch_campaign"]},{"type":"string","enum":["legal"]},{"type":"string","enum":["managed"]},{"type":"string","enum":["support"]},{"type":"string","enum":["surface"]}]},"in":"query","name":"kind","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"anyOf":[{"type":"string","enum":["draft"]},{"type":"string","enum":["published"]},{"type":"string","enum":["retired"]}]},"in":"query","name":"status","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["documents"],"properties":{"documents":{"type":"array","items":{"type":"object","required":["audience","bodyJson","bodyMarkdown","contentHash","contentKey","createdAt","createdByOperatorID","effectiveAt","expiresAt","id","kind","metadata","publishedAt","retiredAt","retiredByOperatorID","slug","status","summary","title","updatedAt","updatedByOperatorID","version"],"properties":{"audience":{"type":"object","properties":{"plans":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"userIDs":{"type":"array","items":{"type":"string"}}}},"bodyJson":{"type":"object","additionalProperties":{}},"bodyMarkdown":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentHash":{"type":"string"},"contentKey":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"effectiveAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["education"]},{"type":"string","enum":["launch_campaign"]},{"type":"string","enum":["legal"]},{"type":"string","enum":["managed"]},{"type":"string","enum":["support"]},{"type":"string","enum":["surface"]}]},"metadata":{"type":"object","additionalProperties":{}},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"retiredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"retiredByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["draft"]},{"type":"string","enum":["published"]},{"type":"string","enum":["retired"]}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"},"version":{"type":"number"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/content/documents/{contentKey}":{"get":{"summary":"Get a published content document by key","tags":["content"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"contentKey","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["document"],"properties":{"document":{"type":"object","required":["audience","bodyJson","bodyMarkdown","contentHash","contentKey","createdAt","createdByOperatorID","effectiveAt","expiresAt","id","kind","metadata","publishedAt","retiredAt","retiredByOperatorID","slug","status","summary","title","updatedAt","updatedByOperatorID","version"],"properties":{"audience":{"type":"object","properties":{"plans":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"userIDs":{"type":"array","items":{"type":"string"}}}},"bodyJson":{"type":"object","additionalProperties":{}},"bodyMarkdown":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentHash":{"type":"string"},"contentKey":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"effectiveAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["education"]},{"type":"string","enum":["launch_campaign"]},{"type":"string","enum":["legal"]},{"type":"string","enum":["managed"]},{"type":"string","enum":["support"]},{"type":"string","enum":["surface"]}]},"metadata":{"type":"object","additionalProperties":{}},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"retiredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"retiredByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["draft"]},{"type":"string","enum":["published"]},{"type":"string","enum":["retired"]}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"},"version":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/content/runtime":{"get":{"summary":"Get current user runtime content","tags":["content"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["launchCampaign","surfaces"],"properties":{"launchCampaign":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"surfaces":{"type":"array","items":{"type":"object","additionalProperties":{}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/content/documents":{"get":{"summary":"Operator list content documents","tags":["operator","content"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"contentKey","required":false},{"schema":{"type":"string"},"in":"query","name":"includeExpired","required":false},{"schema":{"anyOf":[{"type":"string","enum":["education"]},{"type":"string","enum":["launch_campaign"]},{"type":"string","enum":["legal"]},{"type":"string","enum":["managed"]},{"type":"string","enum":["support"]},{"type":"string","enum":["surface"]}]},"in":"query","name":"kind","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"anyOf":[{"type":"string","enum":["draft"]},{"type":"string","enum":["published"]},{"type":"string","enum":["retired"]}]},"in":"query","name":"status","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["documents"],"properties":{"documents":{"type":"array","items":{"type":"object","required":["audience","bodyJson","bodyMarkdown","contentHash","contentKey","createdAt","createdByOperatorID","effectiveAt","expiresAt","id","kind","metadata","publishedAt","retiredAt","retiredByOperatorID","slug","status","summary","title","updatedAt","updatedByOperatorID","version"],"properties":{"audience":{"type":"object","properties":{"plans":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"userIDs":{"type":"array","items":{"type":"string"}}}},"bodyJson":{"type":"object","additionalProperties":{}},"bodyMarkdown":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentHash":{"type":"string"},"contentKey":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"effectiveAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["education"]},{"type":"string","enum":["launch_campaign"]},{"type":"string","enum":["legal"]},{"type":"string","enum":["managed"]},{"type":"string","enum":["support"]},{"type":"string","enum":["surface"]}]},"metadata":{"type":"object","additionalProperties":{}},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"retiredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"retiredByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["draft"]},{"type":"string","enum":["published"]},{"type":"string","enum":["retired"]}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"},"version":{"type":"number"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Operator create draft content document version","tags":["operator","content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["contentKey","kind","title"],"properties":{"audience":{"type":"object","properties":{"plans":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"userIDs":{"type":"array","items":{"type":"string"}}}},"bodyJson":{"type":"object","additionalProperties":{}},"bodyMarkdown":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentKey":{"type":"string"},"effectiveAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"anyOf":[{"type":"string","enum":["education"]},{"type":"string","enum":["launch_campaign"]},{"type":"string","enum":["legal"]},{"type":"string","enum":["managed"]},{"type":"string","enum":["support"]},{"type":"string","enum":["surface"]}]},"metadata":{"type":"object","additionalProperties":{}},"slug":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["document"],"properties":{"document":{"type":"object","required":["audience","bodyJson","bodyMarkdown","contentHash","contentKey","createdAt","createdByOperatorID","effectiveAt","expiresAt","id","kind","metadata","publishedAt","retiredAt","retiredByOperatorID","slug","status","summary","title","updatedAt","updatedByOperatorID","version"],"properties":{"audience":{"type":"object","properties":{"plans":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"userIDs":{"type":"array","items":{"type":"string"}}}},"bodyJson":{"type":"object","additionalProperties":{}},"bodyMarkdown":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentHash":{"type":"string"},"contentKey":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"effectiveAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["education"]},{"type":"string","enum":["launch_campaign"]},{"type":"string","enum":["legal"]},{"type":"string","enum":["managed"]},{"type":"string","enum":["support"]},{"type":"string","enum":["surface"]}]},"metadata":{"type":"object","additionalProperties":{}},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"retiredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"retiredByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["draft"]},{"type":"string","enum":["published"]},{"type":"string","enum":["retired"]}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"},"version":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/content/documents/{documentID}/preview":{"get":{"summary":"Operator preview content document version","tags":["operator","content"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"documentID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["document"],"properties":{"document":{"type":"object","required":["audience","bodyJson","bodyMarkdown","contentHash","contentKey","createdAt","createdByOperatorID","effectiveAt","expiresAt","id","kind","metadata","publishedAt","retiredAt","retiredByOperatorID","slug","status","summary","title","updatedAt","updatedByOperatorID","version"],"properties":{"audience":{"type":"object","properties":{"plans":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"userIDs":{"type":"array","items":{"type":"string"}}}},"bodyJson":{"type":"object","additionalProperties":{}},"bodyMarkdown":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentHash":{"type":"string"},"contentKey":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"effectiveAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["education"]},{"type":"string","enum":["launch_campaign"]},{"type":"string","enum":["legal"]},{"type":"string","enum":["managed"]},{"type":"string","enum":["support"]},{"type":"string","enum":["surface"]}]},"metadata":{"type":"object","additionalProperties":{}},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"retiredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"retiredByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["draft"]},{"type":"string","enum":["published"]},{"type":"string","enum":["retired"]}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"},"version":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/content/documents/{documentID}/publish":{"post":{"summary":"Operator publish content document version","tags":["operator","content"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"documentID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["document"],"properties":{"document":{"type":"object","required":["audience","bodyJson","bodyMarkdown","contentHash","contentKey","createdAt","createdByOperatorID","effectiveAt","expiresAt","id","kind","metadata","publishedAt","retiredAt","retiredByOperatorID","slug","status","summary","title","updatedAt","updatedByOperatorID","version"],"properties":{"audience":{"type":"object","properties":{"plans":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"userIDs":{"type":"array","items":{"type":"string"}}}},"bodyJson":{"type":"object","additionalProperties":{}},"bodyMarkdown":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentHash":{"type":"string"},"contentKey":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"effectiveAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["education"]},{"type":"string","enum":["launch_campaign"]},{"type":"string","enum":["legal"]},{"type":"string","enum":["managed"]},{"type":"string","enum":["support"]},{"type":"string","enum":["surface"]}]},"metadata":{"type":"object","additionalProperties":{}},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"retiredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"retiredByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["draft"]},{"type":"string","enum":["published"]},{"type":"string","enum":["retired"]}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"},"version":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/content/documents/{documentID}/retire":{"post":{"summary":"Operator retire content document version","tags":["operator","content"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"documentID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["document"],"properties":{"document":{"type":"object","required":["audience","bodyJson","bodyMarkdown","contentHash","contentKey","createdAt","createdByOperatorID","effectiveAt","expiresAt","id","kind","metadata","publishedAt","retiredAt","retiredByOperatorID","slug","status","summary","title","updatedAt","updatedByOperatorID","version"],"properties":{"audience":{"type":"object","properties":{"plans":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"userIDs":{"type":"array","items":{"type":"string"}}}},"bodyJson":{"type":"object","additionalProperties":{}},"bodyMarkdown":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentHash":{"type":"string"},"contentKey":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"effectiveAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["education"]},{"type":"string","enum":["launch_campaign"]},{"type":"string","enum":["legal"]},{"type":"string","enum":["managed"]},{"type":"string","enum":["support"]},{"type":"string","enum":["surface"]}]},"metadata":{"type":"object","additionalProperties":{}},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"retiredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"retiredByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["draft"]},{"type":"string","enum":["published"]},{"type":"string","enum":["retired"]}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"},"version":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/sync/changes":{"get":{"summary":"List current user resource changes","tags":["sync"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"domain","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"resourceID","required":false},{"schema":{"type":"string"},"in":"query","name":"resourceKind","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["changes","pageInfo"],"properties":{"changes":{"type":"array","items":{"type":"object","required":["actorOperatorID","actorUserID","changeType","createdAt","domain","id","idempotencyKey","occurredAt","ownerUserID","payload","requestID","resourceID","resourceKind","revision","sequence","subjectUserID"],"properties":{"actorOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"actorUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"changeType":{"anyOf":[{"type":"string","enum":["created"]},{"type":"string","enum":["updated"]},{"type":"string","enum":["deleted"]},{"type":"string","enum":["touched"]}]},"createdAt":{"type":"string"},"domain":{"type":"string"},"id":{"type":"string"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"occurredAt":{"type":"string"},"ownerUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"payload":{"type":"object","additionalProperties":{}},"requestID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"type":"string"},"resourceKind":{"type":"string"},"revision":{"type":"number"},"sequence":{"type":"number"},"subjectUserID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"pageInfo":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/sync/changes":{"get":{"summary":"Operator list resource changes","tags":["operator","sync"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"domain","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"resourceID","required":false},{"schema":{"type":"string"},"in":"query","name":"resourceKind","required":false},{"schema":{"type":"string"},"in":"query","name":"ownerUserID","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["changes","pageInfo"],"properties":{"changes":{"type":"array","items":{"type":"object","required":["actorOperatorID","actorUserID","changeType","createdAt","domain","id","idempotencyKey","occurredAt","ownerUserID","payload","requestID","resourceID","resourceKind","revision","sequence","subjectUserID"],"properties":{"actorOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"actorUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"changeType":{"anyOf":[{"type":"string","enum":["created"]},{"type":"string","enum":["updated"]},{"type":"string","enum":["deleted"]},{"type":"string","enum":["touched"]}]},"createdAt":{"type":"string"},"domain":{"type":"string"},"id":{"type":"string"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"occurredAt":{"type":"string"},"ownerUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"payload":{"type":"object","additionalProperties":{}},"requestID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"type":"string"},"resourceKind":{"type":"string"},"revision":{"type":"number"},"sequence":{"type":"number"},"subjectUserID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"pageInfo":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/search/public":{"get":{"summary":"Search public command-palette documents","tags":["search"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"kinds","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["generatedAt","page","query","results","scope"],"properties":{"generatedAt":{"type":"string"},"page":{"type":"object","required":["hasMore","limit","nextCursor"],"properties":{"hasMore":{"type":"boolean"},"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"query":{"anyOf":[{"type":"string"},{"type":"null"}]},"results":{"type":"array","items":{"type":"object","required":["actions","audience","href","highlights","icon","id","indexedAt","kind","metadata","ownerUserID","personalization","resourceID","score","section","snippet","source","subtitle","summary","title","updatedAt"],"properties":{"actions":{"type":"array","items":{"type":"object","required":["href","id","label","method"],"properties":{"href":{"type":"string"},"id":{"type":"string"},"label":{"type":"string"},"method":{"type":"string","enum":["GET"]}}}},"audience":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]},{"type":"string","enum":["user"]}]},"href":{"type":"string"},"highlights":{"type":"array","items":{"type":"object","required":["field","ranges","text"],"properties":{"field":{"anyOf":[{"type":"string","enum":["body"]},{"type":"string","enum":["subtitle"]},{"type":"string","enum":["summary"]},{"type":"string","enum":["title"]}]},"ranges":{"type":"array","items":{"type":"object","required":["end","start"],"properties":{"end":{"type":"number"},"start":{"type":"number"}}}},"text":{"type":"string"}}}},"icon":{"type":"string"},"id":{"type":"string"},"indexedAt":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["admin_user"]},{"type":"string","enum":["command"]},{"type":"string","enum":["content_document"]},{"type":"string","enum":["conversation"]},{"type":"string","enum":["experiment"]},{"type":"string","enum":["feature_flag"]},{"type":"string","enum":["feedback_item"]},{"type":"string","enum":["forecast_incident"]},{"type":"string","enum":["forecast_zone"]},{"type":"string","enum":["maintenance_window"]},{"type":"string","enum":["note"]},{"type":"string","enum":["payment_product"]},{"type":"string","enum":["recommendation"]},{"type":"string","enum":["route_analysis"]},{"type":"string","enum":["route_plan"]},{"type":"string","enum":["route_readiness"]},{"type":"string","enum":["saved_route"]},{"type":"string","enum":["support_case"]},{"type":"string","enum":["trip_contact"]},{"type":"string","enum":["trip_session"]},{"type":"string","enum":["workflow_run"]}]},"metadata":{"type":"object","additionalProperties":{}},"ownerUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"personalization":{"type":"object","required":["lastDismissedAt","lastSelectedAt","pinned","selectedCount"],"properties":{"lastDismissedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSelectedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"pinned":{"type":"boolean"},"selectedCount":{"type":"number"}}},"resourceID":{"type":"string"},"score":{"type":"number"},"section":{"type":"string"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string"},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"scope":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]},{"type":"string","enum":["user"]}]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/search/public/events":{"post":{"summary":"Record public search result interaction","tags":["search"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["eventType","resultID"],"properties":{"eventType":{"anyOf":[{"type":"string","enum":["dismissed"]},{"type":"string","enum":["pinned"]},{"type":"string","enum":["selected"]},{"type":"string","enum":["unpinned"]}]},"kind":{"anyOf":[{"type":"string","enum":["admin_user"]},{"type":"string","enum":["command"]},{"type":"string","enum":["content_document"]},{"type":"string","enum":["conversation"]},{"type":"string","enum":["experiment"]},{"type":"string","enum":["feature_flag"]},{"type":"string","enum":["feedback_item"]},{"type":"string","enum":["forecast_incident"]},{"type":"string","enum":["forecast_zone"]},{"type":"string","enum":["maintenance_window"]},{"type":"string","enum":["note"]},{"type":"string","enum":["payment_product"]},{"type":"string","enum":["recommendation"]},{"type":"string","enum":["route_analysis"]},{"type":"string","enum":["route_plan"]},{"type":"string","enum":["route_readiness"]},{"type":"string","enum":["saved_route"]},{"type":"string","enum":["support_case"]},{"type":"string","enum":["trip_contact"]},{"type":"string","enum":["trip_session"]},{"type":"string","enum":["workflow_run"]}]},"metadata":{"type":"object","additionalProperties":{}},"position":{"minimum":0,"type":"integer"},"queryFingerprint":{"maxLength":128,"minLength":8,"type":"string"},"queryLength":{"maximum":120,"minimum":0,"type":"integer"},"resourceID":{"maxLength":240,"minLength":1,"type":"string"},"resultID":{"maxLength":240,"minLength":1,"type":"string"},"source":{"maxLength":160,"minLength":1,"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["eventID"],"properties":{"eventID":{"type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/me/search":{"get":{"summary":"Search current-user command-palette documents","tags":["search"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"kinds","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["generatedAt","page","query","results","scope"],"properties":{"generatedAt":{"type":"string"},"page":{"type":"object","required":["hasMore","limit","nextCursor"],"properties":{"hasMore":{"type":"boolean"},"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"query":{"anyOf":[{"type":"string"},{"type":"null"}]},"results":{"type":"array","items":{"type":"object","required":["actions","audience","href","highlights","icon","id","indexedAt","kind","metadata","ownerUserID","personalization","resourceID","score","section","snippet","source","subtitle","summary","title","updatedAt"],"properties":{"actions":{"type":"array","items":{"type":"object","required":["href","id","label","method"],"properties":{"href":{"type":"string"},"id":{"type":"string"},"label":{"type":"string"},"method":{"type":"string","enum":["GET"]}}}},"audience":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]},{"type":"string","enum":["user"]}]},"href":{"type":"string"},"highlights":{"type":"array","items":{"type":"object","required":["field","ranges","text"],"properties":{"field":{"anyOf":[{"type":"string","enum":["body"]},{"type":"string","enum":["subtitle"]},{"type":"string","enum":["summary"]},{"type":"string","enum":["title"]}]},"ranges":{"type":"array","items":{"type":"object","required":["end","start"],"properties":{"end":{"type":"number"},"start":{"type":"number"}}}},"text":{"type":"string"}}}},"icon":{"type":"string"},"id":{"type":"string"},"indexedAt":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["admin_user"]},{"type":"string","enum":["command"]},{"type":"string","enum":["content_document"]},{"type":"string","enum":["conversation"]},{"type":"string","enum":["experiment"]},{"type":"string","enum":["feature_flag"]},{"type":"string","enum":["feedback_item"]},{"type":"string","enum":["forecast_incident"]},{"type":"string","enum":["forecast_zone"]},{"type":"string","enum":["maintenance_window"]},{"type":"string","enum":["note"]},{"type":"string","enum":["payment_product"]},{"type":"string","enum":["recommendation"]},{"type":"string","enum":["route_analysis"]},{"type":"string","enum":["route_plan"]},{"type":"string","enum":["route_readiness"]},{"type":"string","enum":["saved_route"]},{"type":"string","enum":["support_case"]},{"type":"string","enum":["trip_contact"]},{"type":"string","enum":["trip_session"]},{"type":"string","enum":["workflow_run"]}]},"metadata":{"type":"object","additionalProperties":{}},"ownerUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"personalization":{"type":"object","required":["lastDismissedAt","lastSelectedAt","pinned","selectedCount"],"properties":{"lastDismissedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSelectedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"pinned":{"type":"boolean"},"selectedCount":{"type":"number"}}},"resourceID":{"type":"string"},"score":{"type":"number"},"section":{"type":"string"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string"},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"scope":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]},{"type":"string","enum":["user"]}]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/me/search/events":{"post":{"summary":"Record current-user search result interaction","tags":["search"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["eventType","resultID"],"properties":{"eventType":{"anyOf":[{"type":"string","enum":["dismissed"]},{"type":"string","enum":["pinned"]},{"type":"string","enum":["selected"]},{"type":"string","enum":["unpinned"]}]},"kind":{"anyOf":[{"type":"string","enum":["admin_user"]},{"type":"string","enum":["command"]},{"type":"string","enum":["content_document"]},{"type":"string","enum":["conversation"]},{"type":"string","enum":["experiment"]},{"type":"string","enum":["feature_flag"]},{"type":"string","enum":["feedback_item"]},{"type":"string","enum":["forecast_incident"]},{"type":"string","enum":["forecast_zone"]},{"type":"string","enum":["maintenance_window"]},{"type":"string","enum":["note"]},{"type":"string","enum":["payment_product"]},{"type":"string","enum":["recommendation"]},{"type":"string","enum":["route_analysis"]},{"type":"string","enum":["route_plan"]},{"type":"string","enum":["route_readiness"]},{"type":"string","enum":["saved_route"]},{"type":"string","enum":["support_case"]},{"type":"string","enum":["trip_contact"]},{"type":"string","enum":["trip_session"]},{"type":"string","enum":["workflow_run"]}]},"metadata":{"type":"object","additionalProperties":{}},"position":{"minimum":0,"type":"integer"},"queryFingerprint":{"maxLength":128,"minLength":8,"type":"string"},"queryLength":{"maximum":120,"minimum":0,"type":"integer"},"resourceID":{"maxLength":240,"minLength":1,"type":"string"},"resultID":{"maxLength":240,"minLength":1,"type":"string"},"source":{"maxLength":160,"minLength":1,"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["eventID"],"properties":{"eventID":{"type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/search":{"get":{"summary":"Operator command-palette search","tags":["search"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"kinds","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["generatedAt","page","query","results","scope"],"properties":{"generatedAt":{"type":"string"},"page":{"type":"object","required":["hasMore","limit","nextCursor"],"properties":{"hasMore":{"type":"boolean"},"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"query":{"anyOf":[{"type":"string"},{"type":"null"}]},"results":{"type":"array","items":{"type":"object","required":["actions","audience","href","highlights","icon","id","indexedAt","kind","metadata","ownerUserID","personalization","resourceID","score","section","snippet","source","subtitle","summary","title","updatedAt"],"properties":{"actions":{"type":"array","items":{"type":"object","required":["href","id","label","method"],"properties":{"href":{"type":"string"},"id":{"type":"string"},"label":{"type":"string"},"method":{"type":"string","enum":["GET"]}}}},"audience":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]},{"type":"string","enum":["user"]}]},"href":{"type":"string"},"highlights":{"type":"array","items":{"type":"object","required":["field","ranges","text"],"properties":{"field":{"anyOf":[{"type":"string","enum":["body"]},{"type":"string","enum":["subtitle"]},{"type":"string","enum":["summary"]},{"type":"string","enum":["title"]}]},"ranges":{"type":"array","items":{"type":"object","required":["end","start"],"properties":{"end":{"type":"number"},"start":{"type":"number"}}}},"text":{"type":"string"}}}},"icon":{"type":"string"},"id":{"type":"string"},"indexedAt":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["admin_user"]},{"type":"string","enum":["command"]},{"type":"string","enum":["content_document"]},{"type":"string","enum":["conversation"]},{"type":"string","enum":["experiment"]},{"type":"string","enum":["feature_flag"]},{"type":"string","enum":["feedback_item"]},{"type":"string","enum":["forecast_incident"]},{"type":"string","enum":["forecast_zone"]},{"type":"string","enum":["maintenance_window"]},{"type":"string","enum":["note"]},{"type":"string","enum":["payment_product"]},{"type":"string","enum":["recommendation"]},{"type":"string","enum":["route_analysis"]},{"type":"string","enum":["route_plan"]},{"type":"string","enum":["route_readiness"]},{"type":"string","enum":["saved_route"]},{"type":"string","enum":["support_case"]},{"type":"string","enum":["trip_contact"]},{"type":"string","enum":["trip_session"]},{"type":"string","enum":["workflow_run"]}]},"metadata":{"type":"object","additionalProperties":{}},"ownerUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"personalization":{"type":"object","required":["lastDismissedAt","lastSelectedAt","pinned","selectedCount"],"properties":{"lastDismissedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSelectedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"pinned":{"type":"boolean"},"selectedCount":{"type":"number"}}},"resourceID":{"type":"string"},"score":{"type":"number"},"section":{"type":"string"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string"},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"scope":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]},{"type":"string","enum":["user"]}]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/search/events":{"post":{"summary":"Record operator search result interaction","tags":["search"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["eventType","resultID"],"properties":{"eventType":{"anyOf":[{"type":"string","enum":["dismissed"]},{"type":"string","enum":["pinned"]},{"type":"string","enum":["selected"]},{"type":"string","enum":["unpinned"]}]},"kind":{"anyOf":[{"type":"string","enum":["admin_user"]},{"type":"string","enum":["command"]},{"type":"string","enum":["content_document"]},{"type":"string","enum":["conversation"]},{"type":"string","enum":["experiment"]},{"type":"string","enum":["feature_flag"]},{"type":"string","enum":["feedback_item"]},{"type":"string","enum":["forecast_incident"]},{"type":"string","enum":["forecast_zone"]},{"type":"string","enum":["maintenance_window"]},{"type":"string","enum":["note"]},{"type":"string","enum":["payment_product"]},{"type":"string","enum":["recommendation"]},{"type":"string","enum":["route_analysis"]},{"type":"string","enum":["route_plan"]},{"type":"string","enum":["route_readiness"]},{"type":"string","enum":["saved_route"]},{"type":"string","enum":["support_case"]},{"type":"string","enum":["trip_contact"]},{"type":"string","enum":["trip_session"]},{"type":"string","enum":["workflow_run"]}]},"metadata":{"type":"object","additionalProperties":{}},"position":{"minimum":0,"type":"integer"},"queryFingerprint":{"maxLength":128,"minLength":8,"type":"string"},"queryLength":{"maximum":120,"minimum":0,"type":"integer"},"resourceID":{"maxLength":240,"minLength":1,"type":"string"},"resultID":{"maxLength":240,"minLength":1,"type":"string"},"source":{"maxLength":160,"minLength":1,"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["eventID"],"properties":{"eventID":{"type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/search/reindex":{"post":{"summary":"Operator refresh search index","tags":["operator","search"],"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["run"],"properties":{"run":{"type":"object","required":["completedAt","documentCount","error","id","mode","requestedByOperatorEmail","requestedByOperatorID","startedAt","status","stats"],"properties":{"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"documentCount":{"type":"number"},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"mode":{"anyOf":[{"type":"string","enum":["full"]},{"type":"string","enum":["manual"]},{"type":"string","enum":["scheduled"]}]},"requestedByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"requestedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["running"]}]},"stats":{"type":"object","additionalProperties":{}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/search/status":{"get":{"summary":"Operator get search index status","tags":["operator","search"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["status"],"properties":{"status":{"type":"object","required":["documentCount","generatedAt","latestRun","refreshIntervalMs","sourceCounts","stale"],"properties":{"documentCount":{"type":"number"},"generatedAt":{"type":"string"},"latestRun":{"anyOf":[{"type":"object","required":["completedAt","documentCount","error","id","mode","requestedByOperatorEmail","requestedByOperatorID","startedAt","status","stats"],"properties":{"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"documentCount":{"type":"number"},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"mode":{"anyOf":[{"type":"string","enum":["full"]},{"type":"string","enum":["manual"]},{"type":"string","enum":["scheduled"]}]},"requestedByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"requestedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["running"]}]},"stats":{"type":"object","additionalProperties":{}}}},{"type":"null"}]},"refreshIntervalMs":{"type":"number"},"sourceCounts":{"type":"object","additionalProperties":{"type":"number"}},"stale":{"type":"boolean"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/search/index-runs":{"get":{"summary":"Operator list search index runs","tags":["operator","search"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["runs"],"properties":{"runs":{"type":"array","items":{"type":"object","required":["completedAt","documentCount","error","id","mode","requestedByOperatorEmail","requestedByOperatorID","startedAt","status","stats"],"properties":{"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"documentCount":{"type":"number"},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"mode":{"anyOf":[{"type":"string","enum":["full"]},{"type":"string","enum":["manual"]},{"type":"string","enum":["scheduled"]}]},"requestedByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"requestedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["running"]}]},"stats":{"type":"object","additionalProperties":{}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/ai/prompts":{"get":{"summary":"Operator list AI prompt templates","tags":["operator","ai"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"promptKey","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"taskKind","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["prompts"],"properties":{"prompts":{"type":"array","items":{"type":"object","required":["createdAt","createdByOperatorID","description","evalFixtureIDs","id","key","metadata","modelPolicy","name","requiresReview","safetyLevel","status","systemPrompt","taskKind","updatedAt","updatedByOperatorID","userPromptTemplate","variables","version"],"properties":{"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"evalFixtureIDs":{"type":"array","items":{"type":"string"}},"id":{"type":"string"},"key":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"modelPolicy":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"requiresReview":{"type":"boolean"},"safetyLevel":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["restricted"]},{"type":"string","enum":["standard"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["retired"]}]},"systemPrompt":{"type":"string"},"taskKind":{"type":"string"},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"},"userPromptTemplate":{"type":"string"},"variables":{"type":"array","items":{"type":"string"}},"version":{"type":"number"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/ai/prompts/{promptKey}/versions/{version}":{"put":{"summary":"Operator upsert AI prompt template version","tags":["operator","ai"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","systemPrompt","taskKind","userPromptTemplate"],"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"evalFixtureIDs":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":{}},"modelPolicy":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"requiresReview":{"type":"boolean"},"safetyLevel":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["restricted"]},{"type":"string","enum":["standard"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["retired"]}]},"systemPrompt":{"type":"string"},"taskKind":{"type":"string"},"userPromptTemplate":{"type":"string"},"variables":{"type":"array","items":{"type":"string"}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"promptKey","required":true},{"schema":{"type":"string"},"in":"path","name":"version","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"object","required":["createdAt","createdByOperatorID","description","evalFixtureIDs","id","key","metadata","modelPolicy","name","requiresReview","safetyLevel","status","systemPrompt","taskKind","updatedAt","updatedByOperatorID","userPromptTemplate","variables","version"],"properties":{"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"evalFixtureIDs":{"type":"array","items":{"type":"string"}},"id":{"type":"string"},"key":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"modelPolicy":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"requiresReview":{"type":"boolean"},"safetyLevel":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["restricted"]},{"type":"string","enum":["standard"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["retired"]}]},"systemPrompt":{"type":"string"},"taskKind":{"type":"string"},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"},"userPromptTemplate":{"type":"string"},"variables":{"type":"array","items":{"type":"string"}},"version":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/ai/eval-fixtures":{"get":{"summary":"Operator list AI eval fixtures","tags":["operator","ai"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"promptKey","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"taskKind","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["fixtures"],"properties":{"fixtures":{"type":"array","items":{"type":"object","required":["createdAt","createdByOperatorID","expectedOutput","id","input","metadata","name","promptKey","tags","updatedAt"],"properties":{"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"expectedOutput":{"type":"object","additionalProperties":{}},"id":{"type":"string"},"input":{"type":"object","additionalProperties":{}},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"promptKey":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"updatedAt":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Operator create AI eval fixture","tags":["operator","ai"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input","name","promptKey"],"properties":{"expectedOutput":{"type":"object","additionalProperties":{}},"input":{"type":"object","additionalProperties":{}},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"promptKey":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["fixture"],"properties":{"fixture":{"type":"object","required":["createdAt","createdByOperatorID","expectedOutput","id","input","metadata","name","promptKey","tags","updatedAt"],"properties":{"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"expectedOutput":{"type":"object","additionalProperties":{}},"id":{"type":"string"},"input":{"type":"object","additionalProperties":{}},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"promptKey":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/ai/request-plans":{"get":{"summary":"Operator list AI request plans","tags":["operator","ai"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"promptKey","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"taskKind","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["plans"],"properties":{"plans":{"type":"array","items":{"type":"object","required":["actual","createdAt","createdByOperatorID","createdByUserID","estimatedCostMicros","estimatedInputTokens","estimatedOutputTokens","id","input","metadata","model","promptKey","promptTemplateID","promptVersion","provider","replayFixtureID","resourceID","resourceKind","safetyFlags","safetyReviewRequired","safetyReviewedAt","safetyReviewedByOperatorID","status","taskKind","updatedAt"],"properties":{"actual":{"type":"object","required":["costMicros","currency","inputTokens","outputTokens","providerRequestID"],"properties":{"costMicros":{"anyOf":[{"type":"number"},{"type":"null"}]},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"inputTokens":{"anyOf":[{"type":"number"},{"type":"null"}]},"outputTokens":{"anyOf":[{"type":"number"},{"type":"null"}]},"providerRequestID":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"createdAt":{"type":"string"},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"estimatedCostMicros":{"anyOf":[{"type":"number"},{"type":"null"}]},"estimatedInputTokens":{"anyOf":[{"type":"number"},{"type":"null"}]},"estimatedOutputTokens":{"anyOf":[{"type":"number"},{"type":"null"}]},"id":{"type":"string"},"input":{"type":"object","additionalProperties":{}},"metadata":{"type":"object","additionalProperties":{}},"model":{"anyOf":[{"type":"string"},{"type":"null"}]},"promptKey":{"type":"string"},"promptTemplateID":{"anyOf":[{"type":"string"},{"type":"null"}]},"promptVersion":{"type":"number"},"provider":{"anyOf":[{"anyOf":[{"type":"string","enum":["anthropic"]},{"type":"string","enum":["deepseek"]},{"type":"string","enum":["openai"]}]},{"type":"null"}]},"replayFixtureID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"safetyFlags":{"type":"array","items":{"type":"string"}},"safetyReviewRequired":{"type":"boolean"},"safetyReviewedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"safetyReviewedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["approved"]},{"type":"string","enum":["blocked"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["planned"]}]},"taskKind":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Operator create AI request plan","tags":["operator","ai"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["promptKey","promptVersion","taskKind"],"properties":{"estimatedCostMicros":{"anyOf":[{"type":"number"},{"type":"null"}]},"estimatedInputTokens":{"anyOf":[{"type":"number"},{"type":"null"}]},"estimatedOutputTokens":{"anyOf":[{"type":"number"},{"type":"null"}]},"input":{"type":"object","additionalProperties":{}},"metadata":{"type":"object","additionalProperties":{}},"model":{"anyOf":[{"type":"string"},{"type":"null"}]},"promptKey":{"type":"string"},"promptVersion":{"type":"number"},"provider":{"anyOf":[{"anyOf":[{"type":"string","enum":["anthropic"]},{"type":"string","enum":["deepseek"]},{"type":"string","enum":["openai"]}]},{"type":"null"}]},"replayFixtureID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"safetyFlags":{"type":"array","items":{"type":"string"}},"safetyReviewRequired":{"type":"boolean"},"status":{"anyOf":[{"type":"string","enum":["approved"]},{"type":"string","enum":["blocked"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["planned"]}]},"taskKind":{"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["plan"],"properties":{"plan":{"type":"object","required":["actual","createdAt","createdByOperatorID","createdByUserID","estimatedCostMicros","estimatedInputTokens","estimatedOutputTokens","id","input","metadata","model","promptKey","promptTemplateID","promptVersion","provider","replayFixtureID","resourceID","resourceKind","safetyFlags","safetyReviewRequired","safetyReviewedAt","safetyReviewedByOperatorID","status","taskKind","updatedAt"],"properties":{"actual":{"type":"object","required":["costMicros","currency","inputTokens","outputTokens","providerRequestID"],"properties":{"costMicros":{"anyOf":[{"type":"number"},{"type":"null"}]},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"inputTokens":{"anyOf":[{"type":"number"},{"type":"null"}]},"outputTokens":{"anyOf":[{"type":"number"},{"type":"null"}]},"providerRequestID":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"createdAt":{"type":"string"},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"estimatedCostMicros":{"anyOf":[{"type":"number"},{"type":"null"}]},"estimatedInputTokens":{"anyOf":[{"type":"number"},{"type":"null"}]},"estimatedOutputTokens":{"anyOf":[{"type":"number"},{"type":"null"}]},"id":{"type":"string"},"input":{"type":"object","additionalProperties":{}},"metadata":{"type":"object","additionalProperties":{}},"model":{"anyOf":[{"type":"string"},{"type":"null"}]},"promptKey":{"type":"string"},"promptTemplateID":{"anyOf":[{"type":"string"},{"type":"null"}]},"promptVersion":{"type":"number"},"provider":{"anyOf":[{"anyOf":[{"type":"string","enum":["anthropic"]},{"type":"string","enum":["deepseek"]},{"type":"string","enum":["openai"]}]},{"type":"null"}]},"replayFixtureID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"safetyFlags":{"type":"array","items":{"type":"string"}},"safetyReviewRequired":{"type":"boolean"},"safetyReviewedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"safetyReviewedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["approved"]},{"type":"string","enum":["blocked"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["planned"]}]},"taskKind":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/ai/request-plans/{planID}":{"patch":{"summary":"Operator update AI request plan governance state","tags":["operator","ai"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actual":{"type":"object","properties":{"costMicros":{"anyOf":[{"type":"number"},{"type":"null"}]},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"inputTokens":{"anyOf":[{"type":"number"},{"type":"null"}]},"outputTokens":{"anyOf":[{"type":"number"},{"type":"null"}]},"providerRequestID":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"metadata":{"type":"object","additionalProperties":{}},"safetyFlags":{"type":"array","items":{"type":"string"}},"safetyReviewRequired":{"type":"boolean"},"status":{"anyOf":[{"type":"string","enum":["approved"]},{"type":"string","enum":["blocked"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["planned"]}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"planID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["plan"],"properties":{"plan":{"type":"object","required":["actual","createdAt","createdByOperatorID","createdByUserID","estimatedCostMicros","estimatedInputTokens","estimatedOutputTokens","id","input","metadata","model","promptKey","promptTemplateID","promptVersion","provider","replayFixtureID","resourceID","resourceKind","safetyFlags","safetyReviewRequired","safetyReviewedAt","safetyReviewedByOperatorID","status","taskKind","updatedAt"],"properties":{"actual":{"type":"object","required":["costMicros","currency","inputTokens","outputTokens","providerRequestID"],"properties":{"costMicros":{"anyOf":[{"type":"number"},{"type":"null"}]},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"inputTokens":{"anyOf":[{"type":"number"},{"type":"null"}]},"outputTokens":{"anyOf":[{"type":"number"},{"type":"null"}]},"providerRequestID":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"createdAt":{"type":"string"},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"estimatedCostMicros":{"anyOf":[{"type":"number"},{"type":"null"}]},"estimatedInputTokens":{"anyOf":[{"type":"number"},{"type":"null"}]},"estimatedOutputTokens":{"anyOf":[{"type":"number"},{"type":"null"}]},"id":{"type":"string"},"input":{"type":"object","additionalProperties":{}},"metadata":{"type":"object","additionalProperties":{}},"model":{"anyOf":[{"type":"string"},{"type":"null"}]},"promptKey":{"type":"string"},"promptTemplateID":{"anyOf":[{"type":"string"},{"type":"null"}]},"promptVersion":{"type":"number"},"provider":{"anyOf":[{"anyOf":[{"type":"string","enum":["anthropic"]},{"type":"string","enum":["deepseek"]},{"type":"string","enum":["openai"]}]},{"type":"null"}]},"replayFixtureID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"safetyFlags":{"type":"array","items":{"type":"string"}},"safetyReviewRequired":{"type":"boolean"},"safetyReviewedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"safetyReviewedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["approved"]},{"type":"string","enum":["blocked"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["planned"]}]},"taskKind":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/public-links/{token}":{"get":{"summary":"Resolve public hosted-surface token","tags":["public-links"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"token","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["surface"],"properties":{"surface":{"type":"object","required":["disclosureLevel","expiresAt","linkID","payload","resourceID","resourceKind","scope","title"],"properties":{"disclosureLevel":{"anyOf":[{"type":"string","enum":["minimal"]},{"type":"string","enum":["sensitive"]},{"type":"string","enum":["standard"]}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"linkID":{"type":"string"},"payload":{"type":"object","additionalProperties":{}},"resourceID":{"type":"string"},"resourceKind":{"type":"string"},"scope":{"anyOf":[{"type":"string","enum":["buddy_membership_claim"]},{"type":"string","enum":["gift_membership_claim"]},{"type":"string","enum":["membership_handoff"]},{"type":"string","enum":["route_share"]},{"type":"string","enum":["trip_rescue"]},{"type":"string","enum":["trip_status"]}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/me/public-links":{"get":{"summary":"List current-user public links","tags":["public-links"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"ownerUserID","required":false},{"schema":{"anyOf":[{"type":"string","enum":["buddy_membership_claim"]},{"type":"string","enum":["gift_membership_claim"]},{"type":"string","enum":["membership_handoff"]},{"type":"string","enum":["route_share"]},{"type":"string","enum":["trip_rescue"]},{"type":"string","enum":["trip_status"]}]},"in":"query","name":"scope","required":false},{"schema":{"anyOf":[{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]}]},{"type":"string","enum":["expired"]}]},"in":"query","name":"status","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["links","pageInfo"],"properties":{"links":{"type":"array","items":{"type":"object","required":["accessCount","createdAt","createdByOperatorEmail","createdByOperatorID","disclosureLevel","effectiveStatus","expiresAt","id","lastAccessedAt","maxAccessCount","ownerUserID","payload","resourceID","resourceKind","revokedAt","revokedByOperatorID","revokedByUserID","scope","status","title","updatedAt"],"properties":{"accessCount":{"type":"number"},"createdAt":{"type":"string"},"createdByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"disclosureLevel":{"anyOf":[{"type":"string","enum":["minimal"]},{"type":"string","enum":["sensitive"]},{"type":"string","enum":["standard"]}]},"effectiveStatus":{"anyOf":[{"type":"string","enum":["access_exhausted"]},{"type":"string","enum":["active"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["revoked"]}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"lastAccessedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxAccessCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"ownerUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"payload":{"type":"object","additionalProperties":{}},"resourceID":{"type":"string"},"resourceKind":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string","enum":["buddy_membership_claim"]},{"type":"string","enum":["gift_membership_claim"]},{"type":"string","enum":["membership_handoff"]},{"type":"string","enum":["route_share"]},{"type":"string","enum":["trip_rescue"]},{"type":"string","enum":["trip_status"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"}}}},"pageInfo":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Create current-user public link","tags":["public-links"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["resourceID","resourceKind","scope"],"properties":{"disclosureLevel":{"anyOf":[{"type":"string","enum":["minimal"]},{"type":"string","enum":["sensitive"]},{"type":"string","enum":["standard"]}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxAccessCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"payload":{"type":"object","additionalProperties":{}},"resourceID":{"type":"string"},"resourceKind":{"type":"string"},"scope":{"anyOf":[{"type":"string","enum":["buddy_membership_claim"]},{"type":"string","enum":["gift_membership_claim"]},{"type":"string","enum":["membership_handoff"]},{"type":"string","enum":["route_share"]},{"type":"string","enum":["trip_rescue"]},{"type":"string","enum":["trip_status"]}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["link","token"],"properties":{"link":{"type":"object","required":["accessCount","createdAt","createdByOperatorEmail","createdByOperatorID","disclosureLevel","effectiveStatus","expiresAt","id","lastAccessedAt","maxAccessCount","ownerUserID","payload","resourceID","resourceKind","revokedAt","revokedByOperatorID","revokedByUserID","scope","status","title","updatedAt"],"properties":{"accessCount":{"type":"number"},"createdAt":{"type":"string"},"createdByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"disclosureLevel":{"anyOf":[{"type":"string","enum":["minimal"]},{"type":"string","enum":["sensitive"]},{"type":"string","enum":["standard"]}]},"effectiveStatus":{"anyOf":[{"type":"string","enum":["access_exhausted"]},{"type":"string","enum":["active"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["revoked"]}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"lastAccessedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxAccessCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"ownerUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"payload":{"type":"object","additionalProperties":{}},"resourceID":{"type":"string"},"resourceKind":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string","enum":["buddy_membership_claim"]},{"type":"string","enum":["gift_membership_claim"]},{"type":"string","enum":["membership_handoff"]},{"type":"string","enum":["route_share"]},{"type":"string","enum":["trip_rescue"]},{"type":"string","enum":["trip_status"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"}}},"token":{"type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/me/public-links/{linkID}/revoke":{"post":{"summary":"Revoke current-user public link","tags":["public-links"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"linkID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["link"],"properties":{"link":{"type":"object","required":["accessCount","createdAt","createdByOperatorEmail","createdByOperatorID","disclosureLevel","effectiveStatus","expiresAt","id","lastAccessedAt","maxAccessCount","ownerUserID","payload","resourceID","resourceKind","revokedAt","revokedByOperatorID","revokedByUserID","scope","status","title","updatedAt"],"properties":{"accessCount":{"type":"number"},"createdAt":{"type":"string"},"createdByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"disclosureLevel":{"anyOf":[{"type":"string","enum":["minimal"]},{"type":"string","enum":["sensitive"]},{"type":"string","enum":["standard"]}]},"effectiveStatus":{"anyOf":[{"type":"string","enum":["access_exhausted"]},{"type":"string","enum":["active"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["revoked"]}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"lastAccessedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxAccessCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"ownerUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"payload":{"type":"object","additionalProperties":{}},"resourceID":{"type":"string"},"resourceKind":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string","enum":["buddy_membership_claim"]},{"type":"string","enum":["gift_membership_claim"]},{"type":"string","enum":["membership_handoff"]},{"type":"string","enum":["route_share"]},{"type":"string","enum":["trip_rescue"]},{"type":"string","enum":["trip_status"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/public-links":{"get":{"summary":"Operator list public links","tags":["operator","public-links"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"ownerUserID","required":false},{"schema":{"anyOf":[{"type":"string","enum":["buddy_membership_claim"]},{"type":"string","enum":["gift_membership_claim"]},{"type":"string","enum":["membership_handoff"]},{"type":"string","enum":["route_share"]},{"type":"string","enum":["trip_rescue"]},{"type":"string","enum":["trip_status"]}]},"in":"query","name":"scope","required":false},{"schema":{"anyOf":[{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]}]},{"type":"string","enum":["expired"]}]},"in":"query","name":"status","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["links","pageInfo"],"properties":{"links":{"type":"array","items":{"type":"object","required":["accessCount","createdAt","createdByOperatorEmail","createdByOperatorID","disclosureLevel","effectiveStatus","expiresAt","id","lastAccessedAt","maxAccessCount","ownerUserID","payload","resourceID","resourceKind","revokedAt","revokedByOperatorID","revokedByUserID","scope","status","title","updatedAt"],"properties":{"accessCount":{"type":"number"},"createdAt":{"type":"string"},"createdByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"disclosureLevel":{"anyOf":[{"type":"string","enum":["minimal"]},{"type":"string","enum":["sensitive"]},{"type":"string","enum":["standard"]}]},"effectiveStatus":{"anyOf":[{"type":"string","enum":["access_exhausted"]},{"type":"string","enum":["active"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["revoked"]}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"lastAccessedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxAccessCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"ownerUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"payload":{"type":"object","additionalProperties":{}},"resourceID":{"type":"string"},"resourceKind":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string","enum":["buddy_membership_claim"]},{"type":"string","enum":["gift_membership_claim"]},{"type":"string","enum":["membership_handoff"]},{"type":"string","enum":["route_share"]},{"type":"string","enum":["trip_rescue"]},{"type":"string","enum":["trip_status"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"}}}},"pageInfo":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Operator create public link","tags":["public-links"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["resourceID","resourceKind","scope"],"properties":{"disclosureLevel":{"anyOf":[{"type":"string","enum":["minimal"]},{"type":"string","enum":["sensitive"]},{"type":"string","enum":["standard"]}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxAccessCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"payload":{"type":"object","additionalProperties":{}},"resourceID":{"type":"string"},"resourceKind":{"type":"string"},"scope":{"anyOf":[{"type":"string","enum":["buddy_membership_claim"]},{"type":"string","enum":["gift_membership_claim"]},{"type":"string","enum":["membership_handoff"]},{"type":"string","enum":["route_share"]},{"type":"string","enum":["trip_rescue"]},{"type":"string","enum":["trip_status"]}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["link","token"],"properties":{"link":{"type":"object","required":["accessCount","createdAt","createdByOperatorEmail","createdByOperatorID","disclosureLevel","effectiveStatus","expiresAt","id","lastAccessedAt","maxAccessCount","ownerUserID","payload","resourceID","resourceKind","revokedAt","revokedByOperatorID","revokedByUserID","scope","status","title","updatedAt"],"properties":{"accessCount":{"type":"number"},"createdAt":{"type":"string"},"createdByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"disclosureLevel":{"anyOf":[{"type":"string","enum":["minimal"]},{"type":"string","enum":["sensitive"]},{"type":"string","enum":["standard"]}]},"effectiveStatus":{"anyOf":[{"type":"string","enum":["access_exhausted"]},{"type":"string","enum":["active"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["revoked"]}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"lastAccessedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxAccessCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"ownerUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"payload":{"type":"object","additionalProperties":{}},"resourceID":{"type":"string"},"resourceKind":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string","enum":["buddy_membership_claim"]},{"type":"string","enum":["gift_membership_claim"]},{"type":"string","enum":["membership_handoff"]},{"type":"string","enum":["route_share"]},{"type":"string","enum":["trip_rescue"]},{"type":"string","enum":["trip_status"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"}}},"token":{"type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/public-links/{linkID}/revoke":{"post":{"summary":"Operator revoke public link","tags":["public-links"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"linkID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["link"],"properties":{"link":{"type":"object","required":["accessCount","createdAt","createdByOperatorEmail","createdByOperatorID","disclosureLevel","effectiveStatus","expiresAt","id","lastAccessedAt","maxAccessCount","ownerUserID","payload","resourceID","resourceKind","revokedAt","revokedByOperatorID","revokedByUserID","scope","status","title","updatedAt"],"properties":{"accessCount":{"type":"number"},"createdAt":{"type":"string"},"createdByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"disclosureLevel":{"anyOf":[{"type":"string","enum":["minimal"]},{"type":"string","enum":["sensitive"]},{"type":"string","enum":["standard"]}]},"effectiveStatus":{"anyOf":[{"type":"string","enum":["access_exhausted"]},{"type":"string","enum":["active"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["revoked"]}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"lastAccessedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxAccessCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"ownerUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"payload":{"type":"object","additionalProperties":{}},"resourceID":{"type":"string"},"resourceKind":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string","enum":["buddy_membership_claim"]},{"type":"string","enum":["gift_membership_claim"]},{"type":"string","enum":["membership_handoff"]},{"type":"string","enum":["route_share"]},{"type":"string","enum":["trip_rescue"]},{"type":"string","enum":["trip_status"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["revoked"]}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/workflows/summary":{"get":{"summary":"Operator workflow run summaries","tags":["operator","jobs"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["summaries"],"properties":{"summaries":{"type":"array","items":{"type":"object","required":["completedCount","failedCount","latestFinishedAt","latestStartedAt","runningCount","taskName","totalCount"],"properties":{"completedCount":{"type":"number"},"failedCount":{"type":"number"},"latestFinishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestStartedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"runningCount":{"type":"number"},"taskName":{"type":"string"},"totalCount":{"type":"number"}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/workflows/runs":{"get":{"summary":"Operator list workflow runs","tags":["operator","jobs"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"anyOf":[{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["running"]}]},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"taskName","required":false},{"schema":{"type":"string"},"in":"query","name":"workerInstanceID","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["runs"],"properties":{"runs":{"type":"array","items":{"type":"object","required":["createdAt","durationMs","errorMessage","finishedAt","id","metadata","startedAt","status","taskName","updatedAt","workerInstanceID"],"properties":{"createdAt":{"type":"string"},"durationMs":{"anyOf":[{"type":"number"},{"type":"null"}]},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"finishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"startedAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["running"]}]},"taskName":{"type":"string"},"updatedAt":{"type":"string"},"workerInstanceID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/availability/windows":{"get":{"summary":"List current user availability windows","tags":["availability"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["windows"],"properties":{"windows":{"type":"array","items":{"type":"object","required":["createdAt","endsAt","id","label","metadata","notes","source","startsAt","status","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"endsAt":{"type":"string"},"id":{"type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string"},"startsAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["busy"]},{"type":"string","enum":["tentative"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Create an availability window","tags":["availability"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["endsAt","startsAt"],"properties":{"endsAt":{"type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string"},"startsAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["busy"]},{"type":"string","enum":["tentative"]}]},"timezone":{"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["window"],"properties":{"window":{"type":"object","required":["createdAt","endsAt","id","label","metadata","notes","source","startsAt","status","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"endsAt":{"type":"string"},"id":{"type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string"},"startsAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["busy"]},{"type":"string","enum":["tentative"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/availability/windows/{windowID}":{"patch":{"summary":"Update an availability window","tags":["availability"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"endsAt":{"type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string"},"startsAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["busy"]},{"type":"string","enum":["tentative"]}]},"timezone":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"windowID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["window"],"properties":{"window":{"type":"object","required":["createdAt","endsAt","id","label","metadata","notes","source","startsAt","status","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"endsAt":{"type":"string"},"id":{"type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string"},"startsAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["busy"]},{"type":"string","enum":["tentative"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"delete":{"summary":"Delete an availability window","tags":["availability"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"windowID","required":true}],"responses":{"204":{"description":"Default Response"},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/availability/constraints":{"get":{"summary":"List current user availability constraints","tags":["availability"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["constraints"],"properties":{"constraints":{"type":"array","items":{"type":"object","required":["createdAt","dayOfWeek","endsOn","endTime","id","kind","label","metadata","startsOn","startTime","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"dayOfWeek":{"anyOf":[{"type":"number"},{"type":"null"}]},"endsOn":{"anyOf":[{"type":"string"},{"type":"null"}]},"endTime":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["blackout"]},{"type":"string","enum":["preferred"]},{"type":"string","enum":["recurring"]}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"startsOn":{"anyOf":[{"type":"string"},{"type":"null"}]},"startTime":{"anyOf":[{"type":"string"},{"type":"null"}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Create an availability constraint","tags":["availability"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["kind"],"properties":{"dayOfWeek":{"anyOf":[{"type":"number"},{"type":"null"}]},"endsOn":{"anyOf":[{"type":"string"},{"type":"null"}]},"endTime":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"anyOf":[{"type":"string","enum":["blackout"]},{"type":"string","enum":["preferred"]},{"type":"string","enum":["recurring"]}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"startsOn":{"anyOf":[{"type":"string"},{"type":"null"}]},"startTime":{"anyOf":[{"type":"string"},{"type":"null"}]},"timezone":{"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["constraint"],"properties":{"constraint":{"type":"object","required":["createdAt","dayOfWeek","endsOn","endTime","id","kind","label","metadata","startsOn","startTime","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"dayOfWeek":{"anyOf":[{"type":"number"},{"type":"null"}]},"endsOn":{"anyOf":[{"type":"string"},{"type":"null"}]},"endTime":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["blackout"]},{"type":"string","enum":["preferred"]},{"type":"string","enum":["recurring"]}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"startsOn":{"anyOf":[{"type":"string"},{"type":"null"}]},"startTime":{"anyOf":[{"type":"string"},{"type":"null"}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/availability/constraints/{constraintID}":{"patch":{"summary":"Update an availability constraint","tags":["availability"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dayOfWeek":{"anyOf":[{"type":"number"},{"type":"null"}]},"endsOn":{"anyOf":[{"type":"string"},{"type":"null"}]},"endTime":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"anyOf":[{"type":"string","enum":["blackout"]},{"type":"string","enum":["preferred"]},{"type":"string","enum":["recurring"]}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"startsOn":{"anyOf":[{"type":"string"},{"type":"null"}]},"startTime":{"anyOf":[{"type":"string"},{"type":"null"}]},"timezone":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"constraintID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["constraint"],"properties":{"constraint":{"type":"object","required":["createdAt","dayOfWeek","endsOn","endTime","id","kind","label","metadata","startsOn","startTime","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"dayOfWeek":{"anyOf":[{"type":"number"},{"type":"null"}]},"endsOn":{"anyOf":[{"type":"string"},{"type":"null"}]},"endTime":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["blackout"]},{"type":"string","enum":["preferred"]},{"type":"string","enum":["recurring"]}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"startsOn":{"anyOf":[{"type":"string"},{"type":"null"}]},"startTime":{"anyOf":[{"type":"string"},{"type":"null"}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"delete":{"summary":"Delete an availability constraint","tags":["availability"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"constraintID","required":true}],"responses":{"204":{"description":"Default Response"},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/availability/summary":{"get":{"summary":"Get current user availability summary","tags":["availability"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["summary"],"properties":{"summary":{"type":"object","required":["busyWindowCount","constraintCount","from","nextAvailableWindow","tentativeWindowCount","to","windowCount"],"properties":{"busyWindowCount":{"type":"number"},"constraintCount":{"type":"number"},"from":{"anyOf":[{"type":"string"},{"type":"null"}]},"nextAvailableWindow":{"anyOf":[{"type":"object","required":["createdAt","endsAt","id","label","metadata","notes","source","startsAt","status","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"endsAt":{"type":"string"},"id":{"type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string"},"startsAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["busy"]},{"type":"string","enum":["tentative"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}},{"type":"null"}]},"tentativeWindowCount":{"type":"number"},"to":{"anyOf":[{"type":"string"},{"type":"null"}]},"windowCount":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/forecast/zones":{"get":{"summary":"List forecast zones","tags":["forecasts"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["zones"],"properties":{"zones":{"type":"array","items":{"type":"object","required":["boundary","createdAt","elevationBand","id","latitude","longitude","metadata","name","region","slug","status","updatedAt"],"properties":{"boundary":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"createdAt":{"type":"string"},"elevationBand":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["retired"]}]},"updatedAt":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/forecast/zones/{zoneID}":{"get":{"summary":"Get forecast zone","tags":["forecasts"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"zoneID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["zone"],"properties":{"zone":{"type":"object","required":["boundary","createdAt","elevationBand","id","latitude","longitude","metadata","name","region","slug","status","updatedAt"],"properties":{"boundary":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"createdAt":{"type":"string"},"elevationBand":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["retired"]}]},"updatedAt":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/forecast/aggregate":{"get":{"summary":"Get aggregate forecast valid now or at a validAt timestamp","tags":["forecasts"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["aggregate","serving"],"properties":{"aggregate":{"type":"object","required":["dangerIndex","featureCount","features","generatedAt","sourceCount","sources","validUntil","zoneCount"],"properties":{"dangerIndex":{"type":"number"},"featureCount":{"type":"number"},"features":{"type":"array","items":{"type":"object","required":["provenance","snapshot","zone"],"properties":{"provenance":{"type":"object","required":["source","sourceAreaID","sourceArtifactID","sourceRunID","sourceURL"],"properties":{"source":{"type":"string"},"sourceAreaID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceArtifactID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceRunID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceURL":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"snapshot":{"type":"object","required":["createdAt","dangerRating","headline","id","issuedAt","problems","rawPayload","source","sourceAreaID","sourceArtifactID","sourceRunID","sourceURL","summary","validFrom","validUntil","weather","zoneID"],"properties":{"createdAt":{"type":"string"},"dangerRating":{"anyOf":[{"type":"string","enum":["considerable"]},{"type":"string","enum":["extreme"]},{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["moderate"]},{"type":"string","enum":["none"]},{"type":"string","enum":["scary_moderate"]},{"type":"string","enum":["unknown"]}]},"headline":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"issuedAt":{"type":"string"},"problems":{"type":"object","additionalProperties":{}},"rawPayload":{"type":"object","additionalProperties":{}},"source":{"type":"string"},"sourceAreaID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceArtifactID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceRunID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceURL":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"validFrom":{"type":"string"},"validUntil":{"type":"string"},"weather":{"type":"object","additionalProperties":{}},"zoneID":{"type":"string"}}},"zone":{"type":"object","required":["boundary","createdAt","elevationBand","id","latitude","longitude","metadata","name","region","slug","status","updatedAt"],"properties":{"boundary":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"createdAt":{"type":"string"},"elevationBand":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["retired"]}]},"updatedAt":{"type":"string"}}}}}},"generatedAt":{"type":"string"},"sourceCount":{"type":"number"},"sources":{"type":"array","items":{"type":"object","required":["freshSnapshotCount","latestIssuedAt","snapshotCount","source"],"properties":{"freshSnapshotCount":{"type":"number"},"latestIssuedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"snapshotCount":{"type":"number"},"source":{"type":"string"}}}},"validUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"zoneCount":{"type":"number"}}},"serving":{"type":"object","required":["effectiveValidAt","isTestData","mode","policyRevision","referenceValidAt","requestedValidAt","warningMessage"],"properties":{"effectiveValidAt":{"type":"string"},"isTestData":{"type":"boolean"},"mode":{"anyOf":[{"type":"string","enum":["historical_test"]},{"type":"string","enum":["live"]}]},"policyRevision":{"type":"number"},"referenceValidAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"requestedValidAt":{"type":"string"},"warningMessage":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/forecast":{"get":{"summary":"List forecasts valid now or at a validAt timestamp","tags":["forecasts"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["forecasts","origin","queriedAt","revisionID","serving"],"properties":{"forecasts":{"type":"array","items":{"type":"object","required":["AreaId","EffectiveDangerLevel","Geometry","Id","OfficialDangerLevel","ProblemTypes","Properties","RevisionID","SlopeGuidance","Type","UserOverride","snapshot","zone"],"properties":{"AreaId":{"type":"string"},"EffectiveDangerLevel":{"anyOf":[{"type":"number"},{"type":"null"}]},"Geometry":{"type":"object","required":["Coordinates","Type"],"properties":{"Coordinates":{},"Type":{"type":"string"}}},"Id":{"type":"string"},"OfficialDangerLevel":{"anyOf":[{"type":"number"},{"type":"null"}]},"ProblemTypes":{"type":"array","items":{}},"Properties":{"type":"object","required":["Center","CenterId","CenterLink","CurrentConditions","Danger","DangerLevel","Discussion","EndDate","Link","Name","OffSeason","RegionalDiscussionMessage","StartDate","State","Timezone","TravelAdvice"],"properties":{"Center":{"type":"string"},"CenterId":{"type":"string"},"CenterLink":{"type":"string"},"CurrentConditions":{"type":"string"},"Danger":{"type":"string"},"DangerLevel":{"type":"number"},"Discussion":{"type":"string"},"EndDate":{"type":"string"},"Link":{"type":"string"},"Name":{"type":"string"},"OffSeason":{"type":"boolean"},"RegionalDiscussionMessage":{"type":"string"},"StartDate":{"type":"string"},"State":{"type":"string"},"Timezone":{"type":"string"},"TravelAdvice":{"type":"string"}}},"RevisionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"SlopeGuidance":{"type":"object","required":["cautionRange","dangerAngleDegrees","dangerLevel","dangerThresholdDegrees","headline","noGoAboveDegrees","presentation","safeMaximumDegrees","shadingBands"],"properties":{"cautionRange":{"anyOf":[{"type":"object","required":["maximumDegrees","minimumDegrees"],"properties":{"maximumDegrees":{"type":"number"},"minimumDegrees":{"type":"number"}}},{"type":"null"}]},"dangerAngleDegrees":{"anyOf":[{"type":"number"},{"type":"null"}]},"dangerLevel":{"type":"number"},"dangerThresholdDegrees":{"anyOf":[{"type":"number"},{"type":"null"}]},"headline":{"anyOf":[{"type":"string"},{"type":"null"}]},"noGoAboveDegrees":{"anyOf":[{"type":"number"},{"type":"null"}]},"presentation":{"anyOf":[{"type":"string","enum":["stay_out"]},{"type":"string","enum":["thresholds"]}]},"safeMaximumDegrees":{"anyOf":[{"type":"number"},{"type":"null"}]},"shadingBands":{"type":"array","items":{"type":"object","required":["endHex","key","maximumDegrees","minimumDegrees","startHex"],"properties":{"endHex":{"type":"string"},"key":{"anyOf":[{"type":"string","enum":["danger"]},{"type":"string","enum":["extreme"]},{"type":"string","enum":["safe"]},{"type":"string","enum":["verify"]}]},"maximumDegrees":{"anyOf":[{"type":"number"},{"type":"null"}]},"minimumDegrees":{"type":"number"},"startHex":{"type":"string"}}}}}},"Type":{"type":"string","enum":["Feature"]},"UserOverride":{"type":"null"},"snapshot":{"anyOf":[{"type":"object","required":["createdAt","dangerRating","headline","id","issuedAt","problems","rawPayload","source","sourceAreaID","sourceArtifactID","sourceRunID","sourceURL","summary","validFrom","validUntil","weather","zoneID"],"properties":{"createdAt":{"type":"string"},"dangerRating":{"anyOf":[{"type":"string","enum":["considerable"]},{"type":"string","enum":["extreme"]},{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["moderate"]},{"type":"string","enum":["none"]},{"type":"string","enum":["scary_moderate"]},{"type":"string","enum":["unknown"]}]},"headline":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"issuedAt":{"type":"string"},"problems":{"type":"object","additionalProperties":{}},"rawPayload":{"type":"object","additionalProperties":{}},"source":{"type":"string"},"sourceAreaID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceArtifactID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceRunID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceURL":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"validFrom":{"type":"string"},"validUntil":{"type":"string"},"weather":{"type":"object","additionalProperties":{}},"zoneID":{"type":"string"}}},{"type":"null"}]},"zone":{"type":"object","required":["boundary","createdAt","elevationBand","id","latitude","longitude","metadata","name","region","slug","status","updatedAt"],"properties":{"boundary":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"createdAt":{"type":"string"},"elevationBand":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["retired"]}]},"updatedAt":{"type":"string"}}}}}},"origin":{"type":"string","enum":["normalized"]},"queriedAt":{"type":"string"},"revisionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"serving":{"type":"object","required":["effectiveValidAt","isTestData","mode","policyRevision","referenceValidAt","requestedValidAt","warningMessage"],"properties":{"effectiveValidAt":{"type":"string"},"isTestData":{"type":"boolean"},"mode":{"anyOf":[{"type":"string","enum":["historical_test"]},{"type":"string","enum":["live"]}]},"policyRevision":{"type":"number"},"referenceValidAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"requestedValidAt":{"type":"string"},"warningMessage":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/forecast/briefs":{"get":{"summary":"List authenticated forecast briefs for requested zones","tags":["forecasts"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["briefs","serving"],"properties":{"briefs":{"type":"array","items":{"type":"object","required":["dangerLabel","dangerLevel","effectiveDangerLevel","highlights","officialDangerLevel","problemTypes","queriedAt","revisionID","subtitle","title","userOverride","weather","zoneID"],"properties":{"dangerLabel":{"type":"string"},"dangerLevel":{"type":"number"},"effectiveDangerLevel":{"type":"number"},"highlights":{"type":"array","items":{"type":"string"}},"officialDangerLevel":{"type":"number"},"problemTypes":{"type":"array","items":{"type":"string"}},"queriedAt":{"type":"string"},"revisionID":{"type":"string"},"subtitle":{"type":"string"},"title":{"type":"string"},"userOverride":{"anyOf":[{"type":"object","required":["acknowledgedAt","createdAt","dangerRating","effectiveDangerLevel","forecastRevisionID","metadata","note","officialDangerLevel","overrideID","reasons","source","updatedAt","validUntil","zoneID"],"properties":{"acknowledgedAt":{"type":"string"},"createdAt":{"type":"string"},"dangerRating":{"anyOf":[{"type":"string","enum":["considerable"]},{"type":"string","enum":["extreme"]},{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["moderate"]},{"type":"string","enum":["none"]},{"type":"string","enum":["scary_moderate"]},{"type":"string","enum":["unknown"]}]},"effectiveDangerLevel":{"type":"number"},"forecastRevisionID":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"note":{"anyOf":[{"type":"string"},{"type":"null"}]},"officialDangerLevel":{"anyOf":[{"type":"number"},{"type":"null"}]},"overrideID":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"source":{"anyOf":[{"type":"string","enum":["pro_tools"]},{"type":"string","enum":["update_forecast"]}]},"updatedAt":{"type":"string"},"validUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"zoneID":{"type":"string"}}},{"type":"null"}]},"weather":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"zoneID":{"type":"string"}}}},"serving":{"type":"object","required":["effectiveValidAt","isTestData","mode","policyRevision","referenceValidAt","requestedValidAt","warningMessage"],"properties":{"effectiveValidAt":{"type":"string"},"isTestData":{"type":"boolean"},"mode":{"anyOf":[{"type":"string","enum":["historical_test"]},{"type":"string","enum":["live"]}]},"policyRevision":{"type":"number"},"referenceValidAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"requestedValidAt":{"type":"string"},"warningMessage":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/forecast/revisions/{revisionID}/diff":{"get":{"summary":"Get forecast revision diff","tags":["forecasts"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"revisionID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["diff"],"properties":{"diff":{"type":"object","required":["changes","createdAt","fromSnapshotID","id","summary","toSnapshotID","zoneID"],"properties":{"changes":{"type":"object","additionalProperties":{}},"createdAt":{"type":"string"},"fromSnapshotID":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"toSnapshotID":{"anyOf":[{"type":"string"},{"type":"null"}]},"zoneID":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/forecast/incidents":{"get":{"summary":"List forecast incidents","tags":["forecasts"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["incidents"],"properties":{"incidents":{"type":"array","items":{"type":"object","required":["createdAt","id","incidentType","latitude","locationName","longitude","metadata","occurredAt","rawPayload","reportedAt","severity","source","sourceIncidentID","status","summary","title","updatedAt","url","zoneID"],"properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"incidentType":{"anyOf":[{"type":"string","enum":["avalanche"]},{"type":"string","enum":["closure"]},{"type":"string","enum":["near_miss"]},{"type":"string","enum":["observation"]},{"type":"string","enum":["other"]}]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"locationName":{"anyOf":[{"type":"string"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"occurredAt":{"type":"string"},"rawPayload":{"type":"object","additionalProperties":{}},"reportedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"severity":{"anyOf":[{"type":"string","enum":["fatal"]},{"type":"string","enum":["minor"]},{"type":"string","enum":["moderate"]},{"type":"string","enum":["serious"]},{"type":"string","enum":["unknown"]}]},"source":{"type":"string"},"sourceIncidentID":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"zoneID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/forecast/incidents/{incidentID}":{"get":{"summary":"Get forecast incident","tags":["forecasts"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"incidentID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["incident"],"properties":{"incident":{"type":"object","required":["createdAt","id","incidentType","latitude","locationName","longitude","metadata","occurredAt","rawPayload","reportedAt","severity","source","sourceIncidentID","status","summary","title","updatedAt","url","zoneID"],"properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"incidentType":{"anyOf":[{"type":"string","enum":["avalanche"]},{"type":"string","enum":["closure"]},{"type":"string","enum":["near_miss"]},{"type":"string","enum":["observation"]},{"type":"string","enum":["other"]}]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"locationName":{"anyOf":[{"type":"string"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"occurredAt":{"type":"string"},"rawPayload":{"type":"object","additionalProperties":{}},"reportedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"severity":{"anyOf":[{"type":"string","enum":["fatal"]},{"type":"string","enum":["minor"]},{"type":"string","enum":["moderate"]},{"type":"string","enum":["serious"]},{"type":"string","enum":["unknown"]}]},"source":{"type":"string"},"sourceIncidentID":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"zoneID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/user/forecast-overrides":{"get":{"summary":"List current user forecast overrides","tags":["forecasts"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["overrides"],"properties":{"overrides":{"type":"array","items":{"type":"object","required":["acknowledgedAt","createdAt","dangerRating","effectiveDangerLevel","forecastRevisionID","metadata","note","officialDangerLevel","overrideID","reasons","source","updatedAt","validUntil","zoneID"],"properties":{"acknowledgedAt":{"type":"string"},"createdAt":{"type":"string"},"dangerRating":{"anyOf":[{"type":"string","enum":["considerable"]},{"type":"string","enum":["extreme"]},{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["moderate"]},{"type":"string","enum":["none"]},{"type":"string","enum":["scary_moderate"]},{"type":"string","enum":["unknown"]}]},"effectiveDangerLevel":{"type":"number"},"forecastRevisionID":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"note":{"anyOf":[{"type":"string"},{"type":"null"}]},"officialDangerLevel":{"anyOf":[{"type":"number"},{"type":"null"}]},"overrideID":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"source":{"anyOf":[{"type":"string","enum":["pro_tools"]},{"type":"string","enum":["update_forecast"]}]},"updatedAt":{"type":"string"},"validUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"zoneID":{"type":"string"}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/user/forecast-override-history":{"get":{"summary":"List current user forecast override history","tags":["forecasts"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["history"],"properties":{"history":{"type":"array","items":{"type":"object","required":["action","dangerRating","effectiveDangerLevel","forecastRevisionID","historyID","isCurrentActive","occurredAt","officialDangerLevel","overrideID","reasons","source","zoneID","zoneName"],"properties":{"action":{"anyOf":[{"type":"string","enum":["applied"]},{"type":"string","enum":["cleared"]}]},"dangerRating":{"anyOf":[{"type":"string","enum":["considerable"]},{"type":"string","enum":["extreme"]},{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["moderate"]},{"type":"string","enum":["none"]},{"type":"string","enum":["scary_moderate"]},{"type":"string","enum":["unknown"]}]},"effectiveDangerLevel":{"type":"number"},"forecastRevisionID":{"type":"string"},"historyID":{"type":"string"},"isCurrentActive":{"type":"boolean"},"occurredAt":{"type":"string"},"officialDangerLevel":{"anyOf":[{"type":"number"},{"type":"null"}]},"overrideID":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"source":{"anyOf":[{"type":"string","enum":["pro_tools"]},{"type":"string","enum":["update_forecast"]}]},"zoneID":{"type":"string"},"zoneName":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/user/forecast-overrides/{zoneID}":{"put":{"summary":"Upsert current user forecast override","tags":["forecasts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","required":["dangerRating"],"properties":{"dangerRating":{"anyOf":[{"type":"string","enum":["considerable"]},{"type":"string","enum":["extreme"]},{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["moderate"]},{"type":"string","enum":["none"]},{"type":"string","enum":["scary_moderate"]},{"type":"string","enum":["unknown"]}]},"metadata":{"type":"object","additionalProperties":{}},"note":{"anyOf":[{"type":"string"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"object","required":["effectiveDangerLevel","forecastRevisionID","source"],"properties":{"acknowledged":{"type":"boolean"},"effectiveDangerLevel":{"type":"number"},"forecastRevisionID":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"source":{"anyOf":[{"type":"string","enum":["pro_tools"]},{"type":"string","enum":["update_forecast"]}]}}}]}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"zoneID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["override"],"properties":{"override":{"type":"object","required":["acknowledgedAt","createdAt","dangerRating","effectiveDangerLevel","forecastRevisionID","metadata","note","officialDangerLevel","overrideID","reasons","source","updatedAt","validUntil","zoneID"],"properties":{"acknowledgedAt":{"type":"string"},"createdAt":{"type":"string"},"dangerRating":{"anyOf":[{"type":"string","enum":["considerable"]},{"type":"string","enum":["extreme"]},{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["moderate"]},{"type":"string","enum":["none"]},{"type":"string","enum":["scary_moderate"]},{"type":"string","enum":["unknown"]}]},"effectiveDangerLevel":{"type":"number"},"forecastRevisionID":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"note":{"anyOf":[{"type":"string"},{"type":"null"}]},"officialDangerLevel":{"anyOf":[{"type":"number"},{"type":"null"}]},"overrideID":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"source":{"anyOf":[{"type":"string","enum":["pro_tools"]},{"type":"string","enum":["update_forecast"]}]},"updatedAt":{"type":"string"},"validUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"zoneID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"delete":{"summary":"Delete current user forecast override","tags":["forecasts"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"zoneID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["deleted"],"properties":{"deleted":{"type":"boolean"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/user/forecast-favorites":{"get":{"summary":"List current user forecast favorites","tags":["forecasts"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["favorites"],"properties":{"favorites":{"type":"array","items":{"type":"object","required":["createdAt","metadata","zone","zoneID"],"properties":{"createdAt":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"zone":{"type":"object","required":["boundary","createdAt","elevationBand","id","latitude","longitude","metadata","name","region","slug","status","updatedAt"],"properties":{"boundary":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"createdAt":{"type":"string"},"elevationBand":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["retired"]}]},"updatedAt":{"type":"string"}}},"zoneID":{"type":"string"}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/user/forecast-favorites/{zoneID}":{"put":{"summary":"Upsert current user forecast favorite","tags":["forecasts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"zoneID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["favorite"],"properties":{"favorite":{"type":"object","required":["createdAt","metadata","zone","zoneID"],"properties":{"createdAt":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"zone":{"type":"object","required":["boundary","createdAt","elevationBand","id","latitude","longitude","metadata","name","region","slug","status","updatedAt"],"properties":{"boundary":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"createdAt":{"type":"string"},"elevationBand":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["retired"]}]},"updatedAt":{"type":"string"}}},"zoneID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"delete":{"summary":"Delete current user forecast favorite","tags":["forecasts"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"zoneID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["deleted"],"properties":{"deleted":{"type":"boolean"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/forecast/zones":{"post":{"summary":"Operator upsert forecast zone","tags":["operator","forecasts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","slug"],"properties":{"boundary":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"elevationBand":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["retired"]}]}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["zone"],"properties":{"zone":{"type":"object","required":["boundary","createdAt","elevationBand","id","latitude","longitude","metadata","name","region","slug","status","updatedAt"],"properties":{"boundary":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"createdAt":{"type":"string"},"elevationBand":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["retired"]}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/forecast/snapshots":{"post":{"summary":"Operator create forecast snapshot","tags":["operator","forecasts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["issuedAt","source","validFrom","validUntil","zoneID"],"properties":{"dangerRating":{"anyOf":[{"type":"string","enum":["considerable"]},{"type":"string","enum":["extreme"]},{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["moderate"]},{"type":"string","enum":["none"]},{"type":"string","enum":["scary_moderate"]},{"type":"string","enum":["unknown"]}]},"headline":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"issuedAt":{"type":"string"},"problems":{"type":"object","additionalProperties":{}},"rawPayload":{"type":"object","additionalProperties":{}},"source":{"type":"string"},"sourceAreaID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceURL":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"validFrom":{"type":"string"},"validUntil":{"type":"string"},"weather":{"type":"object","additionalProperties":{}},"zoneID":{"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["snapshot"],"properties":{"snapshot":{"type":"object","required":["createdAt","dangerRating","headline","id","issuedAt","problems","rawPayload","source","sourceAreaID","sourceArtifactID","sourceRunID","sourceURL","summary","validFrom","validUntil","weather","zoneID"],"properties":{"createdAt":{"type":"string"},"dangerRating":{"anyOf":[{"type":"string","enum":["considerable"]},{"type":"string","enum":["extreme"]},{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["moderate"]},{"type":"string","enum":["none"]},{"type":"string","enum":["scary_moderate"]},{"type":"string","enum":["unknown"]}]},"headline":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"issuedAt":{"type":"string"},"problems":{"type":"object","additionalProperties":{}},"rawPayload":{"type":"object","additionalProperties":{}},"source":{"type":"string"},"sourceAreaID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceArtifactID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceRunID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceURL":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"validFrom":{"type":"string"},"validUntil":{"type":"string"},"weather":{"type":"object","additionalProperties":{}},"zoneID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/forecast/revision-diffs":{"post":{"summary":"Operator create forecast revision diff","tags":["operator","forecasts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["zoneID"],"properties":{"changes":{"type":"object","additionalProperties":{}},"fromSnapshotID":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"toSnapshotID":{"anyOf":[{"type":"string"},{"type":"null"}]},"zoneID":{"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["diff"],"properties":{"diff":{"type":"object","required":["changes","createdAt","fromSnapshotID","id","summary","toSnapshotID","zoneID"],"properties":{"changes":{"type":"object","additionalProperties":{}},"createdAt":{"type":"string"},"fromSnapshotID":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"toSnapshotID":{"anyOf":[{"type":"string"},{"type":"null"}]},"zoneID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/forecast/incidents":{"post":{"summary":"Operator upsert forecast incident","tags":["operator","forecasts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["occurredAt","source","sourceIncidentID","title"],"properties":{"id":{"type":"string"},"incidentType":{"anyOf":[{"type":"string","enum":["avalanche"]},{"type":"string","enum":["closure"]},{"type":"string","enum":["near_miss"]},{"type":"string","enum":["observation"]},{"type":"string","enum":["other"]}]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"locationName":{"anyOf":[{"type":"string"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"occurredAt":{"type":"string"},"rawPayload":{"type":"object","additionalProperties":{}},"reportedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"severity":{"anyOf":[{"type":"string","enum":["fatal"]},{"type":"string","enum":["minor"]},{"type":"string","enum":["moderate"]},{"type":"string","enum":["serious"]},{"type":"string","enum":["unknown"]}]},"source":{"type":"string"},"sourceIncidentID":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"zoneID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["incident"],"properties":{"incident":{"type":"object","required":["createdAt","id","incidentType","latitude","locationName","longitude","metadata","occurredAt","rawPayload","reportedAt","severity","source","sourceIncidentID","status","summary","title","updatedAt","url","zoneID"],"properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"incidentType":{"anyOf":[{"type":"string","enum":["avalanche"]},{"type":"string","enum":["closure"]},{"type":"string","enum":["near_miss"]},{"type":"string","enum":["observation"]},{"type":"string","enum":["other"]}]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"locationName":{"anyOf":[{"type":"string"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"occurredAt":{"type":"string"},"rawPayload":{"type":"object","additionalProperties":{}},"reportedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"severity":{"anyOf":[{"type":"string","enum":["fatal"]},{"type":"string","enum":["minor"]},{"type":"string","enum":["moderate"]},{"type":"string","enum":["serious"]},{"type":"string","enum":["unknown"]}]},"source":{"type":"string"},"sourceIncidentID":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"zoneID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/forecast/sync-jobs":{"get":{"summary":"Operator list forecast sync jobs","tags":["operator","forecasts"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["jobs","summary"],"properties":{"jobs":{"type":"array","items":{"type":"object","required":["attemptCount","completedAt","createdAt","id","kind","lastError","metadata","result","scheduledFor","source","startedAt","status","updatedAt"],"properties":{"attemptCount":{"type":"number"},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["incident_sync"]},{"type":"string","enum":["source_sync"]},{"type":"string","enum":["stale_check"]}]},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"result":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"scheduledFor":{"type":"string"},"source":{"type":"string"},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"updatedAt":{"type":"string"}}}},"summary":{"type":"object","required":["cancelledCount","completedCount","dueQueuedCount","failedCount","queuedCount","runningCount"],"properties":{"cancelledCount":{"type":"number"},"completedCount":{"type":"number"},"dueQueuedCount":{"type":"number"},"failedCount":{"type":"number"},"queuedCount":{"type":"number"},"runningCount":{"type":"number"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Operator create forecast sync job","tags":["operator","forecasts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["kind","source"],"properties":{"kind":{"anyOf":[{"type":"string","enum":["incident_sync"]},{"type":"string","enum":["source_sync"]},{"type":"string","enum":["stale_check"]}]},"metadata":{"type":"object","additionalProperties":{}},"scheduledFor":{"type":"string"},"source":{"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["job"],"properties":{"job":{"type":"object","required":["attemptCount","completedAt","createdAt","id","kind","lastError","metadata","result","scheduledFor","source","startedAt","status","updatedAt"],"properties":{"attemptCount":{"type":"number"},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["incident_sync"]},{"type":"string","enum":["source_sync"]},{"type":"string","enum":["stale_check"]}]},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"result":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"scheduledFor":{"type":"string"},"source":{"type":"string"},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/forecast/staleness":{"get":{"summary":"Operator get forecast staleness summary","tags":["operator","forecasts"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["summary"],"properties":{"summary":{"type":"object","required":["activeZoneCount","checkedAt","freshZoneCount","missingSnapshotCount","oldestValidUntil","staleZoneCount"],"properties":{"activeZoneCount":{"type":"number"},"checkedAt":{"type":"string"},"freshZoneCount":{"type":"number"},"missingSnapshotCount":{"type":"number"},"oldestValidUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"staleZoneCount":{"type":"number"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/forecast/serving-policy":{"get":{"summary":"Operator get forecast serving policy","tags":["operator","forecasts"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["policy"],"properties":{"policy":{"type":"object","required":["changeReason","enabled","endsAt","isActive","referenceValidAt","revision","startsAt","updatedAt","updatedByOperatorID","warningMessage"],"properties":{"changeReason":{"type":"string"},"enabled":{"type":"boolean"},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"isActive":{"type":"boolean"},"referenceValidAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"revision":{"type":"number"},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"},"updatedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"warningMessage":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"put":{"summary":"Operator update forecast serving policy","tags":["operator","forecasts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["changeReason","enabled","endsAt","expectedRevision","referenceValidAt","startsAt","warningMessage"],"properties":{"changeReason":{"maxLength":1000,"minLength":1,"type":"string"},"enabled":{"type":"boolean"},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expectedRevision":{"minimum":1,"type":"integer"},"referenceValidAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"warningMessage":{"maxLength":500,"minLength":1,"type":"string"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["policy"],"properties":{"policy":{"type":"object","required":["changeReason","enabled","endsAt","isActive","referenceValidAt","revision","startsAt","updatedAt","updatedByOperatorID","warningMessage"],"properties":{"changeReason":{"type":"string"},"enabled":{"type":"boolean"},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"isActive":{"type":"boolean"},"referenceValidAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"revision":{"type":"number"},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"},"updatedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"warningMessage":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/me/feedback":{"get":{"summary":"List current-user feedback reports","tags":["feedback"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"assignedOperatorID","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"kind","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"priority","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["feedback","pageInfo"],"properties":{"feedback":{"type":"array","items":{"type":"object","required":["assignedOperatorID","attachments","body","closedAt","createdAt","id","kind","metadata","priority","reporterUserID","resourceID","resourceKind","status","subject","supportCaseID","tags","updatedAt"],"properties":{"assignedOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"attachments":{"type":"array","items":{"type":"object","properties":{"assetID":{"type":"string"},"filename":{"type":"string"},"mediaType":{"type":"string"},"url":{"type":"string"}}}},"body":{"type":"string"},"closedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["bug"]},{"type":"string","enum":["content_report"]},{"type":"string","enum":["feature_request"]},{"type":"string","enum":["general"]},{"type":"string","enum":["moderation_report"]},{"type":"string","enum":["safety_report"]}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"reporterUserID":{"type":"string"},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["escalated"]},{"type":"string","enum":["in_review"]},{"type":"string","enum":["new"]},{"type":"string","enum":["resolved"]},{"type":"string","enum":["triaged"]}]},"subject":{"type":"string"},"supportCaseID":{"anyOf":[{"type":"string"},{"type":"null"}]},"tags":{"type":"array","items":{"type":"string"}},"updatedAt":{"type":"string"}}}},"pageInfo":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Create a current-user feedback report","tags":["feedback"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body","kind","subject"],"properties":{"attachments":{"type":"array","items":{"type":"object","properties":{"assetID":{"type":"string"},"filename":{"type":"string"},"mediaType":{"type":"string"},"url":{"type":"string"}}}},"body":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["bug"]},{"type":"string","enum":["content_report"]},{"type":"string","enum":["feature_request"]},{"type":"string","enum":["general"]},{"type":"string","enum":["moderation_report"]},{"type":"string","enum":["safety_report"]}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"subject":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["feedback"],"properties":{"feedback":{"type":"object","required":["assignedOperatorID","attachments","body","closedAt","createdAt","id","kind","metadata","priority","reporterUserID","resourceID","resourceKind","status","subject","supportCaseID","tags","updatedAt"],"properties":{"assignedOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"attachments":{"type":"array","items":{"type":"object","properties":{"assetID":{"type":"string"},"filename":{"type":"string"},"mediaType":{"type":"string"},"url":{"type":"string"}}}},"body":{"type":"string"},"closedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["bug"]},{"type":"string","enum":["content_report"]},{"type":"string","enum":["feature_request"]},{"type":"string","enum":["general"]},{"type":"string","enum":["moderation_report"]},{"type":"string","enum":["safety_report"]}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"reporterUserID":{"type":"string"},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["escalated"]},{"type":"string","enum":["in_review"]},{"type":"string","enum":["new"]},{"type":"string","enum":["resolved"]},{"type":"string","enum":["triaged"]}]},"subject":{"type":"string"},"supportCaseID":{"anyOf":[{"type":"string"},{"type":"null"}]},"tags":{"type":"array","items":{"type":"string"}},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/me/feedback/{feedbackID}":{"get":{"summary":"Get current-user feedback report","tags":["feedback"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"feedbackID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["feedback","notes"],"properties":{"feedback":{"type":"object","required":["assignedOperatorID","attachments","body","closedAt","createdAt","id","kind","metadata","priority","reporterUserID","resourceID","resourceKind","status","subject","supportCaseID","tags","updatedAt"],"properties":{"assignedOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"attachments":{"type":"array","items":{"type":"object","properties":{"assetID":{"type":"string"},"filename":{"type":"string"},"mediaType":{"type":"string"},"url":{"type":"string"}}}},"body":{"type":"string"},"closedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["bug"]},{"type":"string","enum":["content_report"]},{"type":"string","enum":["feature_request"]},{"type":"string","enum":["general"]},{"type":"string","enum":["moderation_report"]},{"type":"string","enum":["safety_report"]}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"reporterUserID":{"type":"string"},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["escalated"]},{"type":"string","enum":["in_review"]},{"type":"string","enum":["new"]},{"type":"string","enum":["resolved"]},{"type":"string","enum":["triaged"]}]},"subject":{"type":"string"},"supportCaseID":{"anyOf":[{"type":"string"},{"type":"null"}]},"tags":{"type":"array","items":{"type":"string"}},"updatedAt":{"type":"string"}}},"notes":{"type":"array","items":{"type":"object","required":["body","createdAt","feedbackID","id","metadata","operatorID","visibility"],"properties":{"body":{"type":"string"},"createdAt":{"type":"string"},"feedbackID":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"operatorID":{"type":"string"},"visibility":{"anyOf":[{"type":"string","enum":["customer"]},{"type":"string","enum":["internal"]}]}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/feedback":{"get":{"summary":"Operator list feedback review queue","tags":["feedback"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"assignedOperatorID","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"kind","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"priority","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["feedback","pageInfo"],"properties":{"feedback":{"type":"array","items":{"type":"object","required":["assignedOperatorID","attachments","body","closedAt","createdAt","id","kind","metadata","priority","reporterUserID","resourceID","resourceKind","status","subject","supportCaseID","tags","updatedAt"],"properties":{"assignedOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"attachments":{"type":"array","items":{"type":"object","properties":{"assetID":{"type":"string"},"filename":{"type":"string"},"mediaType":{"type":"string"},"url":{"type":"string"}}}},"body":{"type":"string"},"closedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["bug"]},{"type":"string","enum":["content_report"]},{"type":"string","enum":["feature_request"]},{"type":"string","enum":["general"]},{"type":"string","enum":["moderation_report"]},{"type":"string","enum":["safety_report"]}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"reporterUserID":{"type":"string"},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["escalated"]},{"type":"string","enum":["in_review"]},{"type":"string","enum":["new"]},{"type":"string","enum":["resolved"]},{"type":"string","enum":["triaged"]}]},"subject":{"type":"string"},"supportCaseID":{"anyOf":[{"type":"string"},{"type":"null"}]},"tags":{"type":"array","items":{"type":"string"}},"updatedAt":{"type":"string"}}}},"pageInfo":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/feedback/{feedbackID}":{"get":{"summary":"Operator get feedback report and notes","tags":["feedback"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"feedbackID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["feedback","notes"],"properties":{"feedback":{"type":"object","required":["assignedOperatorID","attachments","body","closedAt","createdAt","id","kind","metadata","priority","reporterUserID","resourceID","resourceKind","status","subject","supportCaseID","tags","updatedAt"],"properties":{"assignedOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"attachments":{"type":"array","items":{"type":"object","properties":{"assetID":{"type":"string"},"filename":{"type":"string"},"mediaType":{"type":"string"},"url":{"type":"string"}}}},"body":{"type":"string"},"closedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["bug"]},{"type":"string","enum":["content_report"]},{"type":"string","enum":["feature_request"]},{"type":"string","enum":["general"]},{"type":"string","enum":["moderation_report"]},{"type":"string","enum":["safety_report"]}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"reporterUserID":{"type":"string"},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["escalated"]},{"type":"string","enum":["in_review"]},{"type":"string","enum":["new"]},{"type":"string","enum":["resolved"]},{"type":"string","enum":["triaged"]}]},"subject":{"type":"string"},"supportCaseID":{"anyOf":[{"type":"string"},{"type":"null"}]},"tags":{"type":"array","items":{"type":"string"}},"updatedAt":{"type":"string"}}},"notes":{"type":"array","items":{"type":"object","required":["body","createdAt","feedbackID","id","metadata","operatorID","visibility"],"properties":{"body":{"type":"string"},"createdAt":{"type":"string"},"feedbackID":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"operatorID":{"type":"string"},"visibility":{"anyOf":[{"type":"string","enum":["customer"]},{"type":"string","enum":["internal"]}]}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"patch":{"summary":"Operator update feedback review state","tags":["operator","feedback"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"assignedOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["escalated"]},{"type":"string","enum":["in_review"]},{"type":"string","enum":["new"]},{"type":"string","enum":["resolved"]},{"type":"string","enum":["triaged"]}]},"supportCaseID":{"anyOf":[{"type":"string"},{"type":"null"}]},"tags":{"type":"array","items":{"type":"string"}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"feedbackID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["feedback"],"properties":{"feedback":{"type":"object","required":["assignedOperatorID","attachments","body","closedAt","createdAt","id","kind","metadata","priority","reporterUserID","resourceID","resourceKind","status","subject","supportCaseID","tags","updatedAt"],"properties":{"assignedOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"attachments":{"type":"array","items":{"type":"object","properties":{"assetID":{"type":"string"},"filename":{"type":"string"},"mediaType":{"type":"string"},"url":{"type":"string"}}}},"body":{"type":"string"},"closedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["bug"]},{"type":"string","enum":["content_report"]},{"type":"string","enum":["feature_request"]},{"type":"string","enum":["general"]},{"type":"string","enum":["moderation_report"]},{"type":"string","enum":["safety_report"]}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"reporterUserID":{"type":"string"},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["escalated"]},{"type":"string","enum":["in_review"]},{"type":"string","enum":["new"]},{"type":"string","enum":["resolved"]},{"type":"string","enum":["triaged"]}]},"subject":{"type":"string"},"supportCaseID":{"anyOf":[{"type":"string"},{"type":"null"}]},"tags":{"type":"array","items":{"type":"string"}},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/feedback/{feedbackID}/notes":{"post":{"summary":"Operator add feedback note","tags":["operator","feedback"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body"],"properties":{"body":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"visibility":{"anyOf":[{"type":"string","enum":["customer"]},{"type":"string","enum":["internal"]}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"feedbackID","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["note"],"properties":{"note":{"type":"object","required":["body","createdAt","feedbackID","id","metadata","operatorID","visibility"],"properties":{"body":{"type":"string"},"createdAt":{"type":"string"},"feedbackID":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"operatorID":{"type":"string"},"visibility":{"anyOf":[{"type":"string","enum":["customer"]},{"type":"string","enum":["internal"]}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/feedback/{feedbackID}/support-case":{"post":{"summary":"Operator escalate feedback into a support case","tags":["operator","feedback"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"body":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"subject":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"feedbackID","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["feedback","supportCase"],"properties":{"feedback":{"type":"object","required":["assignedOperatorID","attachments","body","closedAt","createdAt","id","kind","metadata","priority","reporterUserID","resourceID","resourceKind","status","subject","supportCaseID","tags","updatedAt"],"properties":{"assignedOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"attachments":{"type":"array","items":{"type":"object","properties":{"assetID":{"type":"string"},"filename":{"type":"string"},"mediaType":{"type":"string"},"url":{"type":"string"}}}},"body":{"type":"string"},"closedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["bug"]},{"type":"string","enum":["content_report"]},{"type":"string","enum":["feature_request"]},{"type":"string","enum":["general"]},{"type":"string","enum":["moderation_report"]},{"type":"string","enum":["safety_report"]}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"reporterUserID":{"type":"string"},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["escalated"]},{"type":"string","enum":["in_review"]},{"type":"string","enum":["new"]},{"type":"string","enum":["resolved"]},{"type":"string","enum":["triaged"]}]},"subject":{"type":"string"},"supportCaseID":{"anyOf":[{"type":"string"},{"type":"null"}]},"tags":{"type":"array","items":{"type":"string"}},"updatedAt":{"type":"string"}}},"supportCase":{"type":"object","required":["assignedOperatorID","body","createdAt","displayID","hasUnread","id","lastCustomerMessageAt","lastMessageAt","lastOperatorMessageAt","metadata","priority","status","subject","tags","unreadCount","updatedAt","userID"],"properties":{"assignedOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"createdAt":{"type":"string"},"displayID":{"type":"string"},"hasUnread":{"type":"boolean"},"id":{"type":"string"},"lastCustomerMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastOperatorMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["open"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["resolved"]}]},"subject":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"unreadCount":{"type":"number"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"501":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/matching/preferences":{"get":{"summary":"Get current user matching preferences","tags":["matching"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["preferences"],"properties":{"preferences":{"type":"object","required":["createdAt","intent","maxDistanceKm","metadata","minimumScore","updatedAt","visibility"],"properties":{"createdAt":{"type":"string"},"intent":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxDistanceKm":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"minimumScore":{"type":"number"},"updatedAt":{"type":"string"},"visibility":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["hidden"]},{"type":"string","enum":["paused"]}]}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"put":{"summary":"Update current user matching preferences","tags":["matching"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"intent":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxDistanceKm":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"minimumScore":{"type":"number"},"visibility":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["hidden"]},{"type":"string","enum":["paused"]}]}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["preferences"],"properties":{"preferences":{"type":"object","required":["createdAt","intent","maxDistanceKm","metadata","minimumScore","updatedAt","visibility"],"properties":{"createdAt":{"type":"string"},"intent":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxDistanceKm":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"minimumScore":{"type":"number"},"updatedAt":{"type":"string"},"visibility":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["hidden"]},{"type":"string","enum":["paused"]}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/matching/candidates":{"get":{"summary":"List current user matching candidates","tags":["matching"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["candidates"],"properties":{"candidates":{"type":"array","items":{"type":"object","required":["candidateRef","candidateUserID","createdAt","id","metadata","reasons","score","source","status","updatedAt"],"properties":{"candidateRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"candidateUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"reasons":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["blocked"]},{"type":"string","enum":["dismissed"]},{"type":"string","enum":["matched"]},{"type":"string","enum":["shortlisted"]},{"type":"string","enum":["suggested"]}]},"updatedAt":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Create a matching candidate","tags":["matching"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"candidateRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"candidateUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"reasons":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["blocked"]},{"type":"string","enum":["dismissed"]},{"type":"string","enum":["matched"]},{"type":"string","enum":["shortlisted"]},{"type":"string","enum":["suggested"]}]}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["candidate"],"properties":{"candidate":{"type":"object","required":["candidateRef","candidateUserID","createdAt","id","metadata","reasons","score","source","status","updatedAt"],"properties":{"candidateRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"candidateUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"reasons":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["blocked"]},{"type":"string","enum":["dismissed"]},{"type":"string","enum":["matched"]},{"type":"string","enum":["shortlisted"]},{"type":"string","enum":["suggested"]}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/matching/candidates/{candidateID}/decision":{"post":{"summary":"Record a matching candidate decision","tags":["matching"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["decision"],"properties":{"decision":{"anyOf":[{"type":"string","enum":["block"]},{"type":"string","enum":["like"]},{"type":"string","enum":["pass"]},{"type":"string","enum":["superlike"]},{"type":"string","enum":["undo"]}]},"metadata":{"type":"object","additionalProperties":{}},"note":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"candidateID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["candidate","decision"],"properties":{"candidate":{"type":"object","required":["candidateRef","candidateUserID","createdAt","id","metadata","reasons","score","source","status","updatedAt"],"properties":{"candidateRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"candidateUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"reasons":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["blocked"]},{"type":"string","enum":["dismissed"]},{"type":"string","enum":["matched"]},{"type":"string","enum":["shortlisted"]},{"type":"string","enum":["suggested"]}]},"updatedAt":{"type":"string"}}},"decision":{"type":"object","required":["candidateID","createdAt","decision","id","metadata","note"],"properties":{"candidateID":{"type":"string"},"createdAt":{"type":"string"},"decision":{"anyOf":[{"type":"string","enum":["block"]},{"type":"string","enum":["like"]},{"type":"string","enum":["pass"]},{"type":"string","enum":["superlike"]},{"type":"string","enum":["undo"]}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"note":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/matching/summary":{"get":{"summary":"Get current user matching summary","tags":["matching"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["summary"],"properties":{"summary":{"type":"object","required":["blockedCount","dismissedCount","matchedCount","shortlistedCount","suggestedCount","totalCandidateCount","visibility"],"properties":{"blockedCount":{"type":"number"},"dismissedCount":{"type":"number"},"matchedCount":{"type":"number"},"shortlistedCount":{"type":"number"},"suggestedCount":{"type":"number"},"totalCandidateCount":{"type":"number"},"visibility":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["hidden"]},{"type":"string","enum":["paused"]}]}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/recommendations/jobs":{"get":{"summary":"List recommendation jobs","tags":["recommendations"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["jobs"],"properties":{"jobs":{"type":"array","items":{"type":"object","required":["attemptCount","createdAt","id","input","kind","lastError","metadata","modelName","modelProvider","output","scheduledFor","status","updatedAt"],"properties":{"attemptCount":{"type":"number"},"createdAt":{"type":"string"},"id":{"type":"string"},"input":{"type":"object","additionalProperties":{}},"kind":{"anyOf":[{"type":"string","enum":["matching_candidates"]},{"type":"string","enum":["route_suggestions"]},{"type":"string","enum":["trip_safety_review"]}]},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"modelName":{"anyOf":[{"type":"string"},{"type":"null"}]},"modelProvider":{"anyOf":[{"anyOf":[{"type":"string","enum":["anthropic"]},{"type":"string","enum":["deepseek"]},{"type":"string","enum":["openai"]}]},{"type":"null"}]},"output":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"scheduledFor":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"updatedAt":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Queue a recommendation job","tags":["recommendations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["kind"],"properties":{"input":{"type":"object","additionalProperties":{}},"kind":{"anyOf":[{"type":"string","enum":["matching_candidates"]},{"type":"string","enum":["route_suggestions"]},{"type":"string","enum":["trip_safety_review"]}]},"metadata":{"type":"object","additionalProperties":{}},"modelName":{"anyOf":[{"type":"string"},{"type":"null"}]},"modelProvider":{"anyOf":[{"anyOf":[{"type":"string","enum":["anthropic"]},{"type":"string","enum":["deepseek"]},{"type":"string","enum":["openai"]}]},{"type":"null"}]},"scheduledFor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["job"],"properties":{"job":{"type":"object","required":["attemptCount","createdAt","id","input","kind","lastError","metadata","modelName","modelProvider","output","scheduledFor","status","updatedAt"],"properties":{"attemptCount":{"type":"number"},"createdAt":{"type":"string"},"id":{"type":"string"},"input":{"type":"object","additionalProperties":{}},"kind":{"anyOf":[{"type":"string","enum":["matching_candidates"]},{"type":"string","enum":["route_suggestions"]},{"type":"string","enum":["trip_safety_review"]}]},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"modelName":{"anyOf":[{"type":"string"},{"type":"null"}]},"modelProvider":{"anyOf":[{"anyOf":[{"type":"string","enum":["anthropic"]},{"type":"string","enum":["deepseek"]},{"type":"string","enum":["openai"]}]},{"type":"null"}]},"output":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"scheduledFor":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/recommendations/items":{"get":{"summary":"List recommendation items","tags":["recommendations"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"type":"object","required":["createdAt","explanation","id","jobID","metadata","rank","resourceID","resourceKind","score"],"properties":{"createdAt":{"type":"string"},"explanation":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"jobID":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"rank":{"type":"number"},"resourceID":{"type":"string"},"resourceKind":{"anyOf":[{"type":"string","enum":["matching_candidate"]},{"type":"string","enum":["profile"]},{"type":"string","enum":["route"]},{"type":"string","enum":["route_plan"]},{"type":"string","enum":["trip_session"]}]},"score":{"type":"number"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/recommendations/feedback":{"post":{"summary":"Record recommendation feedback","tags":["recommendations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["feedback","resourceID","resourceKind"],"properties":{"feedback":{"anyOf":[{"type":"string","enum":["accepted"]},{"type":"string","enum":["dismissed"]},{"type":"string","enum":["hidden"]},{"type":"string","enum":["reported"]}]},"itemID":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"note":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"type":"string"},"resourceKind":{"anyOf":[{"type":"string","enum":["matching_candidate"]},{"type":"string","enum":["profile"]},{"type":"string","enum":["route"]},{"type":"string","enum":["route_plan"]},{"type":"string","enum":["trip_session"]}]}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["feedback"],"properties":{"feedback":{"type":"object","required":["createdAt","feedback","id","itemID","metadata","note","resourceID","resourceKind"],"properties":{"createdAt":{"type":"string"},"feedback":{"anyOf":[{"type":"string","enum":["accepted"]},{"type":"string","enum":["dismissed"]},{"type":"string","enum":["hidden"]},{"type":"string","enum":["reported"]}]},"id":{"type":"string"},"itemID":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"note":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"type":"string"},"resourceKind":{"anyOf":[{"type":"string","enum":["matching_candidate"]},{"type":"string","enum":["profile"]},{"type":"string","enum":["route"]},{"type":"string","enum":["route_plan"]},{"type":"string","enum":["trip_session"]}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/media/upload-session":{"post":{"summary":"Create media direct-upload session","tags":["media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["contentType","sourceID","sourceKind"],"properties":{"contentType":{"type":"string"},"maxBytes":{"type":"number"},"metadata":{"type":"object","additionalProperties":{}},"sourceID":{"type":"string"},"sourceKind":{"anyOf":[{"type":"string","enum":["message_attachment"]},{"type":"string","enum":["note_attachment"]},{"type":"string","enum":["profile_avatar"]},{"type":"string","enum":["support_attachment"]}]}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["uploadSession"],"properties":{"uploadSession":{"type":"object","required":["byteSize","checksum","contentType","createdAt","directUpload","expiresAt","id","maxBytes","metadata","sourceID","sourceKind","status","storageKey","updatedAt","uploadURL"],"properties":{"byteSize":{"anyOf":[{"type":"number"},{"type":"null"}]},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentType":{"type":"string"},"createdAt":{"type":"string"},"directUpload":{"anyOf":[{"type":"object","required":["expiresAt","headers","method","url"],"properties":{"expiresAt":{"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"method":{"type":"string","enum":["PUT"]},"url":{"type":"string"}}},{"type":"null"}]},"expiresAt":{"type":"string"},"id":{"type":"string"},"maxBytes":{"type":"number"},"metadata":{"type":"object","additionalProperties":{}},"sourceID":{"type":"string"},"sourceKind":{"anyOf":[{"type":"string","enum":["message_attachment"]},{"type":"string","enum":["note_attachment"]},{"type":"string","enum":["profile_avatar"]},{"type":"string","enum":["support_attachment"]}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["pending"]}]},"storageKey":{"type":"string"},"updatedAt":{"type":"string"},"uploadURL":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/media/upload-sessions/{sessionID}/complete":{"put":{"summary":"Complete media direct-upload session","tags":["media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["byteSize"],"properties":{"byteSize":{"type":"number"},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"sessionID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["receipt"],"properties":{"receipt":{"type":"object","required":["asset","uploadSession"],"properties":{"asset":{"type":"object","required":["byteSize","checksum","contentType","createdAt","id","metadata","sourceID","sourceKind","status","storageKey","updatedAt"],"properties":{"byteSize":{"type":"number"},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentType":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"sourceID":{"type":"string"},"sourceKind":{"anyOf":[{"type":"string","enum":["message_attachment"]},{"type":"string","enum":["note_attachment"]},{"type":"string","enum":["profile_avatar"]},{"type":"string","enum":["support_attachment"]}]},"status":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["deleted"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["quarantined"]}]},"storageKey":{"type":"string"},"updatedAt":{"type":"string"}}},"uploadSession":{"type":"object","required":["byteSize","checksum","contentType","createdAt","directUpload","expiresAt","id","maxBytes","metadata","sourceID","sourceKind","status","storageKey","updatedAt","uploadURL"],"properties":{"byteSize":{"anyOf":[{"type":"number"},{"type":"null"}]},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentType":{"type":"string"},"createdAt":{"type":"string"},"directUpload":{"anyOf":[{"type":"object","required":["expiresAt","headers","method","url"],"properties":{"expiresAt":{"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"method":{"type":"string","enum":["PUT"]},"url":{"type":"string"}}},{"type":"null"}]},"expiresAt":{"type":"string"},"id":{"type":"string"},"maxBytes":{"type":"number"},"metadata":{"type":"object","additionalProperties":{}},"sourceID":{"type":"string"},"sourceKind":{"anyOf":[{"type":"string","enum":["message_attachment"]},{"type":"string","enum":["note_attachment"]},{"type":"string","enum":["profile_avatar"]},{"type":"string","enum":["support_attachment"]}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["pending"]}]},"storageKey":{"type":"string"},"updatedAt":{"type":"string"},"uploadURL":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/media/assets":{"get":{"summary":"List media assets","tags":["media"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["assets"],"properties":{"assets":{"type":"array","items":{"type":"object","required":["byteSize","checksum","contentType","createdAt","id","metadata","sourceID","sourceKind","status","storageKey","updatedAt"],"properties":{"byteSize":{"type":"number"},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentType":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"sourceID":{"type":"string"},"sourceKind":{"anyOf":[{"type":"string","enum":["message_attachment"]},{"type":"string","enum":["note_attachment"]},{"type":"string","enum":["profile_avatar"]},{"type":"string","enum":["support_attachment"]}]},"status":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["deleted"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["quarantined"]}]},"storageKey":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Register a media asset","tags":["media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["byteSize","contentType","sourceID","sourceKind","storageKey"],"properties":{"byteSize":{"type":"number"},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentType":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"sourceID":{"type":"string"},"sourceKind":{"anyOf":[{"type":"string","enum":["message_attachment"]},{"type":"string","enum":["note_attachment"]},{"type":"string","enum":["profile_avatar"]},{"type":"string","enum":["support_attachment"]}]},"status":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["deleted"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["quarantined"]}]},"storageKey":{"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["asset"],"properties":{"asset":{"type":"object","required":["byteSize","checksum","contentType","createdAt","id","metadata","sourceID","sourceKind","status","storageKey","updatedAt"],"properties":{"byteSize":{"type":"number"},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentType":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"sourceID":{"type":"string"},"sourceKind":{"anyOf":[{"type":"string","enum":["message_attachment"]},{"type":"string","enum":["note_attachment"]},{"type":"string","enum":["profile_avatar"]},{"type":"string","enum":["support_attachment"]}]},"status":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["deleted"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["quarantined"]}]},"storageKey":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/media/assets/{assetID}":{"get":{"summary":"Get media asset metadata","tags":["media"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"assetID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["asset"],"properties":{"asset":{"type":"object","required":["byteSize","checksum","contentType","createdAt","id","metadata","sourceID","sourceKind","status","storageKey","updatedAt"],"properties":{"byteSize":{"type":"number"},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentType":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"sourceID":{"type":"string"},"sourceKind":{"anyOf":[{"type":"string","enum":["message_attachment"]},{"type":"string","enum":["note_attachment"]},{"type":"string","enum":["profile_avatar"]},{"type":"string","enum":["support_attachment"]}]},"status":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["deleted"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["quarantined"]}]},"storageKey":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/media/assets/{assetID}/download":{"get":{"summary":"Download media asset bytes","tags":["media"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"assetID","required":true}],"responses":{"304":{"description":"Default Response"},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"416":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/media/assets/{assetID}/status":{"patch":{"summary":"Update media asset status","tags":["media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["status"],"properties":{"metadata":{"type":"object","additionalProperties":{}},"status":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["deleted"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["quarantined"]}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"assetID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["asset"],"properties":{"asset":{"type":"object","required":["byteSize","checksum","contentType","createdAt","id","metadata","sourceID","sourceKind","status","storageKey","updatedAt"],"properties":{"byteSize":{"type":"number"},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentType":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"sourceID":{"type":"string"},"sourceKind":{"anyOf":[{"type":"string","enum":["message_attachment"]},{"type":"string","enum":["note_attachment"]},{"type":"string","enum":["profile_avatar"]},{"type":"string","enum":["support_attachment"]}]},"status":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["deleted"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["quarantined"]}]},"storageKey":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/media/assets/{assetID}/jobs":{"get":{"summary":"List media processing jobs","tags":["media"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"assetID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["jobs"],"properties":{"jobs":{"type":"array","items":{"type":"object","required":["assetID","attemptCount","createdAt","id","jobType","lastError","metadata","scheduledFor","status","updatedAt"],"properties":{"assetID":{"type":"string"},"attemptCount":{"type":"number"},"createdAt":{"type":"string"},"id":{"type":"string"},"jobType":{"anyOf":[{"type":"string","enum":["metadata"]},{"type":"string","enum":["moderation"]},{"type":"string","enum":["scan"]},{"type":"string","enum":["thumbnail"]}]},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"scheduledFor":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"updatedAt":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Queue a media processing job","tags":["media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jobType"],"properties":{"jobType":{"anyOf":[{"type":"string","enum":["metadata"]},{"type":"string","enum":["moderation"]},{"type":"string","enum":["scan"]},{"type":"string","enum":["thumbnail"]}]},"metadata":{"type":"object","additionalProperties":{}},"scheduledFor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"assetID","required":true}],"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["job"],"properties":{"job":{"type":"object","required":["assetID","attemptCount","createdAt","id","jobType","lastError","metadata","scheduledFor","status","updatedAt"],"properties":{"assetID":{"type":"string"},"attemptCount":{"type":"number"},"createdAt":{"type":"string"},"id":{"type":"string"},"jobType":{"anyOf":[{"type":"string","enum":["metadata"]},{"type":"string","enum":["moderation"]},{"type":"string","enum":["scan"]},{"type":"string","enum":["thumbnail"]}]},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"scheduledFor":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/media/assets/{assetID}/renditions":{"get":{"summary":"List media renditions","tags":["media"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"assetID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["renditions"],"properties":{"renditions":{"type":"array","items":{"type":"object","required":["assetID","byteSize","contentType","createdAt","height","id","kind","metadata","storageKey","width"],"properties":{"assetID":{"type":"string"},"byteSize":{"type":"number"},"contentType":{"type":"string"},"createdAt":{"type":"string"},"height":{"anyOf":[{"type":"number"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["optimized"]},{"type":"string","enum":["preview"]},{"type":"string","enum":["thumbnail"]}]},"metadata":{"type":"object","additionalProperties":{}},"storageKey":{"type":"string"},"width":{"anyOf":[{"type":"number"},{"type":"null"}]}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/messaging/conversations":{"get":{"summary":"List current user conversations","tags":["messaging"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["conversations"],"properties":{"conversations":{"type":"array","items":{"type":"object","required":["createdAt","id","kind","lastMessageAt","metadata","participants","status","subjectRef","title","updatedAt"],"properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["direct"]},{"type":"string","enum":["match"]},{"type":"string","enum":["support"]},{"type":"string","enum":["system"]}]},"lastMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"participants":{"type":"array","items":{"type":"object","required":["joinedAt","lastReadAt","role","userID"],"properties":{"joinedAt":{"type":"string"},"lastReadAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"role":{"anyOf":[{"type":"string","enum":["member"]},{"type":"string","enum":["moderator"]},{"type":"string","enum":["operator"]},{"type":"string","enum":["system"]}]},"userID":{"type":"string"}}}},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["closed"]}]},"subjectRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Create a conversation","tags":["messaging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"anyOf":[{"type":"string","enum":["direct"]},{"type":"string","enum":["match"]},{"type":"string","enum":["support"]},{"type":"string","enum":["system"]}]},"metadata":{"type":"object","additionalProperties":{}},"participantUserIDs":{"type":"array","items":{"type":"string"}},"subjectRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["conversation"],"properties":{"conversation":{"type":"object","required":["createdAt","id","kind","lastMessageAt","metadata","participants","status","subjectRef","title","updatedAt"],"properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["direct"]},{"type":"string","enum":["match"]},{"type":"string","enum":["support"]},{"type":"string","enum":["system"]}]},"lastMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"participants":{"type":"array","items":{"type":"object","required":["joinedAt","lastReadAt","role","userID"],"properties":{"joinedAt":{"type":"string"},"lastReadAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"role":{"anyOf":[{"type":"string","enum":["member"]},{"type":"string","enum":["moderator"]},{"type":"string","enum":["operator"]},{"type":"string","enum":["system"]}]},"userID":{"type":"string"}}}},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["closed"]}]},"subjectRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/messaging/conversations/{conversationID}/messages":{"get":{"summary":"List conversation messages","tags":["messaging"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"conversationID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["messages"],"properties":{"messages":{"type":"array","items":{"type":"object","required":["body","bodyFormat","conversationID","createdAt","id","metadata","senderUserID","status","updatedAt"],"properties":{"body":{"type":"string"},"bodyFormat":{"type":"string","enum":["plain_text"]},"conversationID":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"senderUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["deleted"]},{"type":"string","enum":["moderated"]},{"type":"string","enum":["sent"]}]},"updatedAt":{"type":"string"}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Send a conversation message","tags":["messaging"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body"],"properties":{"body":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"conversationID","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["message","queuedNotificationCount"],"properties":{"message":{"type":"object","required":["body","bodyFormat","conversationID","createdAt","id","metadata","senderUserID","status","updatedAt"],"properties":{"body":{"type":"string"},"bodyFormat":{"type":"string","enum":["plain_text"]},"conversationID":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"senderUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["deleted"]},{"type":"string","enum":["moderated"]},{"type":"string","enum":["sent"]}]},"updatedAt":{"type":"string"}}},"queuedNotificationCount":{"type":"number"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/notifications/preferences":{"get":{"summary":"Get current user notification preferences","tags":["notifications"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["preferences"],"properties":{"preferences":{"type":"object","required":["createdAt","emailLevel","inAppLevel","marketingEnabled","metadata","pushLevel","quietHoursEnd","quietHoursStart","smsLevel","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"emailLevel":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["muted"]}]},"inAppLevel":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["muted"]}]},"marketingEnabled":{"type":"boolean"},"metadata":{"type":"object","additionalProperties":{}},"pushLevel":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["muted"]}]},"quietHoursEnd":{"anyOf":[{"type":"string"},{"type":"null"}]},"quietHoursStart":{"anyOf":[{"type":"string"},{"type":"null"}]},"smsLevel":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["muted"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"put":{"summary":"Update current user notification preferences","tags":["notifications"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"emailLevel":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["muted"]}]},"inAppLevel":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["muted"]}]},"marketingEnabled":{"type":"boolean"},"metadata":{"type":"object","additionalProperties":{}},"pushLevel":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["muted"]}]},"quietHoursEnd":{"anyOf":[{"type":"string"},{"type":"null"}]},"quietHoursStart":{"anyOf":[{"type":"string"},{"type":"null"}]},"smsLevel":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["muted"]}]},"timezone":{"type":"string"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["preferences"],"properties":{"preferences":{"type":"object","required":["createdAt","emailLevel","inAppLevel","marketingEnabled","metadata","pushLevel","quietHoursEnd","quietHoursStart","smsLevel","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"emailLevel":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["muted"]}]},"inAppLevel":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["muted"]}]},"marketingEnabled":{"type":"boolean"},"metadata":{"type":"object","additionalProperties":{}},"pushLevel":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["muted"]}]},"quietHoursEnd":{"anyOf":[{"type":"string"},{"type":"null"}]},"quietHoursStart":{"anyOf":[{"type":"string"},{"type":"null"}]},"smsLevel":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["muted"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/notifications/devices":{"post":{"summary":"Register or refresh a push device","tags":["notifications"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["platform","token"],"properties":{"deviceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["web"]}]},"token":{"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["device"],"properties":{"device":{"type":"object","required":["createdAt","deviceName","enabled","id","lastSeenAt","platform","tokenPreview","updatedAt"],"properties":{"createdAt":{"type":"string"},"deviceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"enabled":{"type":"boolean"},"id":{"type":"string"},"lastSeenAt":{"type":"string"},"platform":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["web"]}]},"tokenPreview":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/notifications/devices/{deviceID}":{"delete":{"summary":"Disable a push device","tags":["notifications"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"deviceID","required":true}],"responses":{"204":{"description":"Default Response"},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/notifications/inbox":{"get":{"summary":"List current user notification inbox items","tags":["notifications"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["notifications"],"properties":{"notifications":{"type":"array","items":{"type":"object","required":["body","createdAt","data","id","readAt","title","type"],"properties":{"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"data":{"type":"object","additionalProperties":{}},"id":{"type":"string"},"readAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"type":{"type":"string"}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/notifications/inbox/{notificationID}/read":{"post":{"summary":"Mark a notification as read","tags":["notifications"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"notificationID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["notification"],"properties":{"notification":{"type":"object","required":["body","createdAt","data","id","readAt","title","type"],"properties":{"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"data":{"type":"object","additionalProperties":{}},"id":{"type":"string"},"readAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"type":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/notification-delivery/summary":{"get":{"summary":"Operator notification delivery summary","tags":["operator","notifications"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["summary"],"properties":{"summary":{"type":"object","required":["attempts","messagingOutbox","tripSafetyJobs"],"properties":{"attempts":{"type":"object","required":["deferredCount","failedCount","sentCount","skippedCount","terminalFailedCount"],"properties":{"deferredCount":{"type":"number"},"failedCount":{"type":"number"},"sentCount":{"type":"number"},"skippedCount":{"type":"number"},"terminalFailedCount":{"type":"number"}}},"messagingOutbox":{"type":"object","required":["failedCount","nextScheduledFor","queuedCount","retryQueuedCount"],"properties":{"failedCount":{"type":"number"},"nextScheduledFor":{"anyOf":[{"type":"string"},{"type":"null"}]},"queuedCount":{"type":"number"},"retryQueuedCount":{"type":"number"}}},"tripSafetyJobs":{"type":"object","required":["failedCount","nextScheduledFor","queuedCount","retryQueuedCount"],"properties":{"failedCount":{"type":"number"},"nextScheduledFor":{"anyOf":[{"type":"string"},{"type":"null"}]},"queuedCount":{"type":"number"},"retryQueuedCount":{"type":"number"}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/notification-delivery/attempts":{"get":{"summary":"Operator list notification delivery attempts","tags":["operator","notifications"],"parameters":[{"schema":{"anyOf":[{"type":"string","enum":["email"]},{"type":"string","enum":["in_app"]},{"type":"string","enum":["push"]},{"type":"string","enum":["sms"]}]},"in":"query","name":"channel","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"anyOf":[{"type":"string","enum":["messaging_outbox"]},{"type":"string","enum":["trip_safety_contact_job"]}]},"in":"query","name":"sourceKind","required":false},{"schema":{"anyOf":[{"type":"string","enum":["deferred"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["sent"]},{"type":"string","enum":["skipped"]}]},"in":"query","name":"status","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["attempts"],"properties":{"attempts":{"type":"array","items":{"type":"object","required":["channel","createdAt","deadLetteredAt","error","id","payload","provider","providerMessageID","providerStatus","providerStatusReceivedAt","reason","receipt","recipientRef","retryAt","sourceID","sourceKind","status","terminal"],"properties":{"channel":{"anyOf":[{"type":"string","enum":["email"]},{"type":"string","enum":["in_app"]},{"type":"string","enum":["push"]},{"type":"string","enum":["sms"]}]},"createdAt":{"type":"string"},"deadLetteredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"payload":{"type":"object","additionalProperties":{}},"provider":{"type":"string"},"providerMessageID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerStatusReceivedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"receipt":{"type":"object","additionalProperties":{}},"recipientRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"retryAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceID":{"type":"string"},"sourceKind":{"anyOf":[{"type":"string","enum":["messaging_outbox"]},{"type":"string","enum":["trip_safety_contact_job"]}]},"status":{"anyOf":[{"type":"string","enum":["deferred"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["sent"]},{"type":"string","enum":["skipped"]}]},"terminal":{"type":"boolean"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/notification-delivery/provider-receipts":{"get":{"summary":"Operator list notification provider receipts","tags":["operator","notifications"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"matched","required":false},{"schema":{"type":"string"},"in":"query","name":"provider","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["receipts"],"properties":{"receipts":{"type":"array","items":{"type":"object","required":["channel","createdAt","id","matchedAttemptID","payload","provider","providerMessageID","providerStatus","receivedAt","signatureVerified","sourceID","sourceKind"],"properties":{"channel":{"anyOf":[{"anyOf":[{"type":"string","enum":["email"]},{"type":"string","enum":["in_app"]},{"type":"string","enum":["push"]},{"type":"string","enum":["sms"]}]},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"matchedAttemptID":{"anyOf":[{"type":"string"},{"type":"null"}]},"payload":{"type":"object","additionalProperties":{}},"provider":{"type":"string"},"providerMessageID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"receivedAt":{"type":"string"},"signatureVerified":{"type":"boolean"},"sourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceKind":{"anyOf":[{"anyOf":[{"type":"string","enum":["messaging_outbox"]},{"type":"string","enum":["trip_safety_contact_job"]}]},{"type":"null"}]}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/notification-delivery/provider-receipts/{provider}":{"post":{"summary":"Capture notification provider receipt","tags":["notifications"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"channel":{"anyOf":[{"anyOf":[{"type":"string","enum":["email"]},{"type":"string","enum":["in_app"]},{"type":"string","enum":["push"]},{"type":"string","enum":["sms"]}]},{"type":"null"}]},"payload":{"type":"object","additionalProperties":{}},"providerMessageID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"receivedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceKind":{"anyOf":[{"anyOf":[{"type":"string","enum":["messaging_outbox"]},{"type":"string","enum":["trip_safety_contact_job"]}]},{"type":"null"}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"provider","required":true}],"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["receipt"],"properties":{"receipt":{"type":"object","required":["channel","createdAt","id","matchedAttemptID","payload","provider","providerMessageID","providerStatus","receivedAt","signatureVerified","sourceID","sourceKind"],"properties":{"channel":{"anyOf":[{"anyOf":[{"type":"string","enum":["email"]},{"type":"string","enum":["in_app"]},{"type":"string","enum":["push"]},{"type":"string","enum":["sms"]}]},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"matchedAttemptID":{"anyOf":[{"type":"string"},{"type":"null"}]},"payload":{"type":"object","additionalProperties":{}},"provider":{"type":"string"},"providerMessageID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"receivedAt":{"type":"string"},"signatureVerified":{"type":"boolean"},"sourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceKind":{"anyOf":[{"anyOf":[{"type":"string","enum":["messaging_outbox"]},{"type":"string","enum":["trip_safety_contact_job"]}]},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/notes":{"get":{"summary":"List current user notes","tags":["notes"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["notes"],"properties":{"notes":{"type":"array","items":{"type":"object","required":["body","createdAt","id","latitude","longitude","metadata","occurredAt","resourceID","resourceKind","status","title","type","updatedAt","visibility"],"properties":{"body":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"occurredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string","enum":["forecast_zone"]},{"type":"string","enum":["none"]},{"type":"string","enum":["route"]},{"type":"string","enum":["route_plan"]},{"type":"string","enum":["trip_session"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","enum":["field_log"]},{"type":"string","enum":["forecast_note"]},{"type":"string","enum":["general"]},{"type":"string","enum":["route_note"]},{"type":"string","enum":["trip_note"]}]},"updatedAt":{"type":"string"},"visibility":{"anyOf":[{"type":"string","enum":["private"]},{"type":"string","enum":["shared"]}]}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Create note","tags":["notes"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body"],"properties":{"body":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"occurredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string","enum":["forecast_zone"]},{"type":"string","enum":["none"]},{"type":"string","enum":["route"]},{"type":"string","enum":["route_plan"]},{"type":"string","enum":["trip_session"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","enum":["field_log"]},{"type":"string","enum":["forecast_note"]},{"type":"string","enum":["general"]},{"type":"string","enum":["route_note"]},{"type":"string","enum":["trip_note"]}]},"visibility":{"anyOf":[{"type":"string","enum":["private"]},{"type":"string","enum":["shared"]}]}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["note"],"properties":{"note":{"type":"object","required":["body","createdAt","id","latitude","longitude","metadata","occurredAt","resourceID","resourceKind","status","title","type","updatedAt","visibility"],"properties":{"body":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"occurredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string","enum":["forecast_zone"]},{"type":"string","enum":["none"]},{"type":"string","enum":["route"]},{"type":"string","enum":["route_plan"]},{"type":"string","enum":["trip_session"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","enum":["field_log"]},{"type":"string","enum":["forecast_note"]},{"type":"string","enum":["general"]},{"type":"string","enum":["route_note"]},{"type":"string","enum":["trip_note"]}]},"updatedAt":{"type":"string"},"visibility":{"anyOf":[{"type":"string","enum":["private"]},{"type":"string","enum":["shared"]}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/notes/{noteID}":{"get":{"summary":"Get note","tags":["notes"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"noteID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["attachments","note"],"properties":{"attachments":{"type":"array","items":{"type":"object","required":["caption","createdAt","id","kind","mediaAssetID","metadata","noteID","sortOrder","storageURL"],"properties":{"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["audio"]},{"type":"string","enum":["file"]},{"type":"string","enum":["image"]},{"type":"string","enum":["video"]}]},"mediaAssetID":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"noteID":{"type":"string"},"sortOrder":{"type":"number"},"storageURL":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"note":{"type":"object","required":["body","createdAt","id","latitude","longitude","metadata","occurredAt","resourceID","resourceKind","status","title","type","updatedAt","visibility"],"properties":{"body":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"occurredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string","enum":["forecast_zone"]},{"type":"string","enum":["none"]},{"type":"string","enum":["route"]},{"type":"string","enum":["route_plan"]},{"type":"string","enum":["trip_session"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","enum":["field_log"]},{"type":"string","enum":["forecast_note"]},{"type":"string","enum":["general"]},{"type":"string","enum":["route_note"]},{"type":"string","enum":["trip_note"]}]},"updatedAt":{"type":"string"},"visibility":{"anyOf":[{"type":"string","enum":["private"]},{"type":"string","enum":["shared"]}]}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"patch":{"summary":"Update note","tags":["notes"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"body":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"occurredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string","enum":["forecast_zone"]},{"type":"string","enum":["none"]},{"type":"string","enum":["route"]},{"type":"string","enum":["route_plan"]},{"type":"string","enum":["trip_session"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","enum":["field_log"]},{"type":"string","enum":["forecast_note"]},{"type":"string","enum":["general"]},{"type":"string","enum":["route_note"]},{"type":"string","enum":["trip_note"]}]},"visibility":{"anyOf":[{"type":"string","enum":["private"]},{"type":"string","enum":["shared"]}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"noteID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["note"],"properties":{"note":{"type":"object","required":["body","createdAt","id","latitude","longitude","metadata","occurredAt","resourceID","resourceKind","status","title","type","updatedAt","visibility"],"properties":{"body":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"occurredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string","enum":["forecast_zone"]},{"type":"string","enum":["none"]},{"type":"string","enum":["route"]},{"type":"string","enum":["route_plan"]},{"type":"string","enum":["trip_session"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","enum":["field_log"]},{"type":"string","enum":["forecast_note"]},{"type":"string","enum":["general"]},{"type":"string","enum":["route_note"]},{"type":"string","enum":["trip_note"]}]},"updatedAt":{"type":"string"},"visibility":{"anyOf":[{"type":"string","enum":["private"]},{"type":"string","enum":["shared"]}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"delete":{"summary":"Delete note","tags":["notes"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"noteID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["deleted"],"properties":{"deleted":{"type":"boolean"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/notes/{noteID}/attachments":{"post":{"summary":"Create note attachment link","tags":["notes"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["kind"],"properties":{"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"anyOf":[{"type":"string","enum":["audio"]},{"type":"string","enum":["file"]},{"type":"string","enum":["image"]},{"type":"string","enum":["video"]}]},"mediaAssetID":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"sortOrder":{"type":"number"},"storageURL":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"noteID","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["attachment"],"properties":{"attachment":{"type":"object","required":["caption","createdAt","id","kind","mediaAssetID","metadata","noteID","sortOrder","storageURL"],"properties":{"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["audio"]},{"type":"string","enum":["file"]},{"type":"string","enum":["image"]},{"type":"string","enum":["video"]}]},"mediaAssetID":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"noteID":{"type":"string"},"sortOrder":{"type":"number"},"storageURL":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/notes/{noteID}/attachments/{attachmentID}":{"delete":{"summary":"Delete note attachment link","tags":["notes"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"noteID","required":true},{"schema":{"type":"string"},"in":"path","name":"attachmentID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["deleted"],"properties":{"deleted":{"type":"boolean"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/product/bootstrap":{"get":{"summary":"Get cross-domain client bootstrap state","tags":["product"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["availability","matching","notifications","profile"],"properties":{"availability":{"type":"object","required":["busyWindowCount","constraintCount","from","nextAvailableWindow","tentativeWindowCount","to","windowCount"],"properties":{"busyWindowCount":{"type":"number"},"constraintCount":{"type":"number"},"from":{"anyOf":[{"type":"string"},{"type":"null"}]},"nextAvailableWindow":{"anyOf":[{},{"type":"null"}]},"tentativeWindowCount":{"type":"number"},"to":{"anyOf":[{"type":"string"},{"type":"null"}]},"windowCount":{"type":"number"}}},"matching":{"type":"object","required":["blockedCount","dismissedCount","matchedCount","shortlistedCount","suggestedCount","totalCandidateCount","visibility"],"properties":{"blockedCount":{"type":"number"},"dismissedCount":{"type":"number"},"matchedCount":{"type":"number"},"shortlistedCount":{"type":"number"},"suggestedCount":{"type":"number"},"totalCandidateCount":{"type":"number"},"visibility":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["hidden"]},{"type":"string","enum":["paused"]}]}}},"notifications":{"type":"object","required":["preferences"],"properties":{"preferences":{"type":"object","required":["createdAt","emailLevel","inAppLevel","marketingEnabled","metadata","pushLevel","quietHoursEnd","quietHoursStart","smsLevel","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"emailLevel":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["muted"]}]},"inAppLevel":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["muted"]}]},"marketingEnabled":{"type":"boolean"},"metadata":{"type":"object","additionalProperties":{}},"pushLevel":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["muted"]}]},"quietHoursEnd":{"anyOf":[{"type":"string"},{"type":"null"}]},"quietHoursStart":{"anyOf":[{"type":"string"},{"type":"null"}]},"smsLevel":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["muted"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}}}},"profile":{"type":"object","required":["authentication","settings","settingsMetadata","summary","user"],"properties":{"authentication":{},"settings":{},"settingsMetadata":{},"summary":{},"user":{}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/product/matching/candidates/{candidateID}/decision":{"post":{"summary":"Record a matching decision and optionally create a message handoff","tags":["product"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["decision"],"properties":{"decision":{"anyOf":[{"type":"string","enum":["block"]},{"type":"string","enum":["like"]},{"type":"string","enum":["pass"]},{"type":"string","enum":["superlike"]},{"type":"string","enum":["undo"]}]},"handoff":{"type":"boolean"},"metadata":{"type":"object","additionalProperties":{}},"note":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"candidateID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["candidate","conversation","decision","handoff"],"properties":{"candidate":{"type":"object","required":["candidateRef","candidateUserID","createdAt","id","metadata","reasons","score","source","status","updatedAt"],"properties":{"candidateRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"candidateUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"reasons":{"type":"array","items":{"type":"string"}},"score":{"type":"number"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["blocked"]},{"type":"string","enum":["dismissed"]},{"type":"string","enum":["matched"]},{"type":"string","enum":["shortlisted"]},{"type":"string","enum":["suggested"]}]},"updatedAt":{"type":"string"}}},"conversation":{"anyOf":[{"type":"object","required":["createdAt","id","kind","lastMessageAt","metadata","participants","status","subjectRef","title","updatedAt"],"properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["direct"]},{"type":"string","enum":["match"]},{"type":"string","enum":["support"]},{"type":"string","enum":["system"]}]},"lastMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"participants":{"type":"array","items":{}},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["closed"]}]},"subjectRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"}}},{"type":"null"}]},"decision":{"type":"object","required":["candidateID","createdAt","decision","id","metadata","note"],"properties":{"candidateID":{"type":"string"},"createdAt":{"type":"string"},"decision":{"anyOf":[{"type":"string","enum":["block"]},{"type":"string","enum":["like"]},{"type":"string","enum":["pass"]},{"type":"string","enum":["superlike"]},{"type":"string","enum":["undo"]}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"note":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"handoff":{"type":"object","required":["created","reason"],"properties":{"created":{"type":"boolean"},"reason":{"anyOf":[{"type":"string","enum":["candidate_is_external"]},{"type":"string","enum":["conversation_created"]},{"type":"string","enum":["decision_not_handoff_eligible"]},{"type":"string","enum":["handoff_disabled"]}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/bootstrap":{"get":{"summary":"Get public launch bootstrap state","tags":["bootstrap"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"appBuild","required":false},{"schema":{"type":"string"},"in":"query","name":"appVersion","required":false},{"schema":{"type":"string"},"in":"query","name":"locale","required":false},{"schema":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["server"]},{"type":"string","enum":["web"]}]},"in":"query","name":"platform","required":false},{"schema":{"type":"string"},"in":"query","name":"sections","required":false},{"schema":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["app"]},{"type":"string","enum":["docs"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["public_web"]},{"type":"string","enum":["website"]}]},"in":"query","name":"surface","required":false},{"schema":{"type":"string"},"in":"query","name":"timezone","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["cache","configVersion","environment","generatedAt","request","schemaVersion","sectionMetadata","sections","server"],"properties":{"cache":{"type":"object","required":["maxAgeSeconds","scope","staleWhileRevalidateSeconds"],"properties":{"maxAgeSeconds":{"type":"number"},"scope":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]},{"type":"string","enum":["user"]}]},"staleWhileRevalidateSeconds":{"type":"number"}}},"configVersion":{"type":"string"},"environment":{"type":"string"},"generatedAt":{"type":"string"},"request":{"type":"object","required":["appBuild","appVersion","deviceId","locale","platform","requestedSections","surface","timezone"],"properties":{"appBuild":{"anyOf":[{"type":"string"},{"type":"null"}]},"appVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"deviceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"locale":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["server"]},{"type":"string","enum":["web"]}]},"requestedSections":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"surface":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["app"]},{"type":"string","enum":["docs"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["public_web"]},{"type":"string","enum":["website"]}]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"schemaVersion":{"type":"number"},"sectionMetadata":{"type":"object","additionalProperties":{"type":"object","required":["cache","generatedAt","owner","schemaVersion","status"],"properties":{"cache":{"type":"object","required":["maxAgeSeconds","scope","staleWhileRevalidateSeconds"],"properties":{"maxAgeSeconds":{"type":"number"},"scope":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]},{"type":"string","enum":["user"]}]},"staleWhileRevalidateSeconds":{"type":"number"}}},"generatedAt":{"type":"string"},"owner":{"type":"string"},"schemaVersion":{"type":"number"},"status":{"anyOf":[{"type":"string","enum":["degraded"]},{"type":"string","enum":["ok"]}]}}}},"sections":{"type":"object","additionalProperties":{}},"server":{"type":"object","required":["commitSha","generatedAt","service","time","version"],"properties":{"commitSha":{"anyOf":[{"type":"string"},{"type":"null"}]},"generatedAt":{"type":"string"},"service":{"type":"string"},"time":{"type":"string"},"version":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/me/bootstrap":{"get":{"summary":"Get current-user launch bootstrap state","tags":["bootstrap"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"appBuild","required":false},{"schema":{"type":"string"},"in":"query","name":"appVersion","required":false},{"schema":{"type":"string"},"in":"query","name":"locale","required":false},{"schema":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["server"]},{"type":"string","enum":["web"]}]},"in":"query","name":"platform","required":false},{"schema":{"type":"string"},"in":"query","name":"sections","required":false},{"schema":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["app"]},{"type":"string","enum":["docs"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["public_web"]},{"type":"string","enum":["website"]}]},"in":"query","name":"surface","required":false},{"schema":{"type":"string"},"in":"query","name":"timezone","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["cache","configVersion","environment","generatedAt","request","schemaVersion","sectionMetadata","sections","server"],"properties":{"cache":{"type":"object","required":["maxAgeSeconds","scope","staleWhileRevalidateSeconds"],"properties":{"maxAgeSeconds":{"type":"number"},"scope":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]},{"type":"string","enum":["user"]}]},"staleWhileRevalidateSeconds":{"type":"number"}}},"configVersion":{"type":"string"},"environment":{"type":"string"},"generatedAt":{"type":"string"},"request":{"type":"object","required":["appBuild","appVersion","deviceId","locale","platform","requestedSections","surface","timezone"],"properties":{"appBuild":{"anyOf":[{"type":"string"},{"type":"null"}]},"appVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"deviceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"locale":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["server"]},{"type":"string","enum":["web"]}]},"requestedSections":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"surface":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["app"]},{"type":"string","enum":["docs"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["public_web"]},{"type":"string","enum":["website"]}]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"schemaVersion":{"type":"number"},"sectionMetadata":{"type":"object","additionalProperties":{"type":"object","required":["cache","generatedAt","owner","schemaVersion","status"],"properties":{"cache":{"type":"object","required":["maxAgeSeconds","scope","staleWhileRevalidateSeconds"],"properties":{"maxAgeSeconds":{"type":"number"},"scope":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]},{"type":"string","enum":["user"]}]},"staleWhileRevalidateSeconds":{"type":"number"}}},"generatedAt":{"type":"string"},"owner":{"type":"string"},"schemaVersion":{"type":"number"},"status":{"anyOf":[{"type":"string","enum":["degraded"]},{"type":"string","enum":["ok"]}]}}}},"sections":{"type":"object","additionalProperties":{}},"server":{"type":"object","required":["commitSha","generatedAt","service","time","version"],"properties":{"commitSha":{"anyOf":[{"type":"string"},{"type":"null"}]},"generatedAt":{"type":"string"},"service":{"type":"string"},"time":{"type":"string"},"version":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/bootstrap":{"get":{"summary":"Get operator launch bootstrap state","tags":["bootstrap"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"appBuild","required":false},{"schema":{"type":"string"},"in":"query","name":"appVersion","required":false},{"schema":{"type":"string"},"in":"query","name":"locale","required":false},{"schema":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["server"]},{"type":"string","enum":["web"]}]},"in":"query","name":"platform","required":false},{"schema":{"type":"string"},"in":"query","name":"sections","required":false},{"schema":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["app"]},{"type":"string","enum":["docs"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["public_web"]},{"type":"string","enum":["website"]}]},"in":"query","name":"surface","required":false},{"schema":{"type":"string"},"in":"query","name":"timezone","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["cache","configVersion","environment","generatedAt","request","schemaVersion","sectionMetadata","sections","server"],"properties":{"cache":{"type":"object","required":["maxAgeSeconds","scope","staleWhileRevalidateSeconds"],"properties":{"maxAgeSeconds":{"type":"number"},"scope":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]},{"type":"string","enum":["user"]}]},"staleWhileRevalidateSeconds":{"type":"number"}}},"configVersion":{"type":"string"},"environment":{"type":"string"},"generatedAt":{"type":"string"},"request":{"type":"object","required":["appBuild","appVersion","deviceId","locale","platform","requestedSections","surface","timezone"],"properties":{"appBuild":{"anyOf":[{"type":"string"},{"type":"null"}]},"appVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"deviceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"locale":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["server"]},{"type":"string","enum":["web"]}]},"requestedSections":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"surface":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["app"]},{"type":"string","enum":["docs"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["public_web"]},{"type":"string","enum":["website"]}]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"schemaVersion":{"type":"number"},"sectionMetadata":{"type":"object","additionalProperties":{"type":"object","required":["cache","generatedAt","owner","schemaVersion","status"],"properties":{"cache":{"type":"object","required":["maxAgeSeconds","scope","staleWhileRevalidateSeconds"],"properties":{"maxAgeSeconds":{"type":"number"},"scope":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]},{"type":"string","enum":["user"]}]},"staleWhileRevalidateSeconds":{"type":"number"}}},"generatedAt":{"type":"string"},"owner":{"type":"string"},"schemaVersion":{"type":"number"},"status":{"anyOf":[{"type":"string","enum":["degraded"]},{"type":"string","enum":["ok"]}]}}}},"sections":{"type":"object","additionalProperties":{}},"server":{"type":"object","required":["commitSha","generatedAt","service","time","version"],"properties":{"commitSha":{"anyOf":[{"type":"string"},{"type":"null"}]},"generatedAt":{"type":"string"},"service":{"type":"string"},"time":{"type":"string"},"version":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/users":{"get":{"summary":"Operator list users","tags":["operator","admin-users"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"entitlementPlan","required":false},{"schema":{"type":"string"},"in":"query","name":"entitlementStatus","required":false},{"schema":{"type":"string"},"in":"query","name":"hasLegalHold","required":false},{"schema":{"type":"string"},"in":"query","name":"hasOpenSupport","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"pendingDeletion","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false},{"schema":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]},{"type":"string","enum":["pending_deletion"]}]},"in":"query","name":"status","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["pageInfo","users"],"properties":{"pageInfo":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"users":{"type":"array","items":{"type":"object","required":["compliance","diagnostics","entitlements","latestActivityAt","notifications","operations","safety","support","user"],"properties":{"compliance":{"type":"object","required":["latestLegalAcceptanceAt","openLegalHoldCount","pendingDeletionRequest","releasedLegalHoldCount","totalLegalAcceptanceCount"],"properties":{"latestLegalAcceptanceAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"openLegalHoldCount":{"type":"number"},"pendingDeletionRequest":{"type":"boolean"},"releasedLegalHoldCount":{"type":"number"},"totalLegalAcceptanceCount":{"type":"number"}}},"diagnostics":{"type":"object","required":["crashCount","errorCount","latestDiagnosticAt","totalDiagnosticCount"],"properties":{"crashCount":{"type":"number"},"errorCount":{"type":"number"},"latestDiagnosticAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalDiagnosticCount":{"type":"number"}}},"entitlements":{"type":"object","required":["activeUntil","features","plan","source","status","updatedAt"],"properties":{"activeUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"features":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["inactive"]},{"type":"string","enum":["past_due"]},{"type":"string","enum":["trialing"]}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"latestActivityAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"notifications":{"type":"object","required":["deferredCount","failedCount","latestAttemptAt","sentCount","skippedCount","terminalFailedCount","totalAttemptCount"],"properties":{"deferredCount":{"type":"number"},"failedCount":{"type":"number"},"latestAttemptAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"sentCount":{"type":"number"},"skippedCount":{"type":"number"},"terminalFailedCount":{"type":"number"},"totalAttemptCount":{"type":"number"}}},"operations":{"type":"object","required":["cancelledJobCount","completedJobCount","failedJobCount","latestJobAt","queuedJobCount","runningJobCount","totalJobCount"],"properties":{"cancelledJobCount":{"type":"number"},"completedJobCount":{"type":"number"},"failedJobCount":{"type":"number"},"latestJobAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"queuedJobCount":{"type":"number"},"runningJobCount":{"type":"number"},"totalJobCount":{"type":"number"}}},"safety":{"type":"object","required":["activeTripCount","completedTripCount","latestSessionAt","overdueTripCount","plannedTripCount","totalTripCount"],"properties":{"activeTripCount":{"type":"number"},"completedTripCount":{"type":"number"},"latestSessionAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"overdueTripCount":{"type":"number"},"plannedTripCount":{"type":"number"},"totalTripCount":{"type":"number"}}},"support":{"type":"object","required":["closedCaseCount","highPriorityCaseCount","latestCaseAt","openCaseCount","pendingCaseCount","resolvedCaseCount","totalCaseCount","urgentCaseCount"],"properties":{"closedCaseCount":{"type":"number"},"highPriorityCaseCount":{"type":"number"},"latestCaseAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"openCaseCount":{"type":"number"},"pendingCaseCount":{"type":"number"},"resolvedCaseCount":{"type":"number"},"totalCaseCount":{"type":"number"},"urgentCaseCount":{"type":"number"}}},"user":{"type":"object","required":["avatarURL","createdAt","email","name","passwordSetupRequired","sessionVersion","status","updatedAt","userID"],"properties":{"avatarURL":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"passwordSetupRequired":{"type":"boolean"},"sessionVersion":{"type":"number"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]},{"type":"string","enum":["pending_deletion"]}]},"updatedAt":{"type":"string"},"userID":{"type":"string"}}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/users/{userID}":{"get":{"summary":"Operator get user detail","tags":["operator","admin-users"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"userID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["membership","profile","summary"],"properties":{"membership":{"type":"object","required":["actions","buddyPasses","entitlements","giftMemberships","grants","providerSyncEvents"],"properties":{"actions":{"type":"object","required":["grant","revoke"],"properties":{"grant":{"type":"object","required":["description","method","path","reasonRequired","status"],"properties":{"description":{"type":"string"},"method":{"type":"string","enum":["POST"]},"path":{"type":"string"},"reasonRequired":{"type":"boolean"},"status":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["planned"]}]}}},"revoke":{"type":"object","required":["description","method","path","reasonRequired","status"],"properties":{"description":{"type":"string"},"method":{"type":"string","enum":["POST"]},"path":{"type":"string"},"reasonRequired":{"type":"boolean"},"status":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["planned"]}]}}}}},"buddyPasses":{"type":"array","items":{"type":"object","required":["benefitDurationDays","benefitPlan","createdAt","expiresAt","id","ownerUserID","recipientEmail","recipientUserID","revokedAt","sharedAt","status","updatedAt"],"properties":{"benefitDurationDays":{"anyOf":[{"type":"number"},{"type":"null"}]},"benefitPlan":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"ownerUserID":{"type":"string"},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"sharedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string"},"updatedAt":{"type":"string"}}}},"entitlements":{"type":"object","required":["activeUntil","features","plan","source","status","updatedAt"],"properties":{"activeUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"features":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["inactive"]},{"type":"string","enum":["past_due"]},{"type":"string","enum":["trialing"]}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"giftMemberships":{"type":"array","items":{"type":"object","required":["claimedAt","createdAt","endsAt","id","plan","purchaserUserID","recipientEmail","recipientName","recipientUserID","startsAt","status","updatedAt"],"properties":{"claimedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"plan":{"type":"string"},"purchaserUserID":{"type":"string"},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientName":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string"},"updatedAt":{"type":"string"}}}},"grants":{"type":"array","items":{"type":"object","required":["buddyPassID","createdAt","endsAt","giftMembershipID","grantedByUserID","id","kind","metadata","plan","provider","providerCustomerID","providerSubscriptionID","providerTransactionID","sourcePlatform","startsAt","status","updatedAt"],"properties":{"buddyPassID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"giftMembershipID":{"anyOf":[{"type":"string"},{"type":"null"}]},"grantedByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["buddy_pass"]},{"type":"string","enum":["gift_membership"]},{"type":"string","enum":["lifetime_purchase"]},{"type":"string","enum":["manual"]},{"type":"string","enum":["provider_snapshot"]},{"type":"string","enum":["subscription"]}]},"metadata":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"provider":{"type":"string"},"providerCustomerID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerSubscriptionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerTransactionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourcePlatform":{"type":"string"},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["inactive"]},{"type":"string","enum":["past_due"]},{"type":"string","enum":["trialing"]}]},"updatedAt":{"type":"string"}}}},"providerSyncEvents":{"type":"array","items":{"type":"object","required":["createdAt","eventType","id","provider","providerEventID","status"],"properties":{"createdAt":{"type":"string"},"eventType":{"type":"string"},"id":{"type":"string"},"provider":{"type":"string"},"providerEventID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string"}}}}}},"profile":{"type":"object","required":["activeAvatarAsset","deletionRequest","latestDeviceCapabilities","legalAcceptances","questionnaires"],"properties":{"activeAvatarAsset":{"anyOf":[{"type":"object","required":["byteSize","checksum","contentType","createdAt","id","publicURL","status","updatedAt"],"properties":{"byteSize":{"anyOf":[{"type":"number"},{"type":"null"}]},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentType":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"publicURL":{"type":"string"},"status":{"type":"string"},"updatedAt":{"type":"string"}}},{"type":"null"}]},"deletionRequest":{"anyOf":[{"type":"object","required":["createdAt","id","metadata","reason","requestedAt","scheduledDeletionAt","status","updatedAt"],"properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"requestedAt":{"type":"string"},"scheduledDeletionAt":{"type":"string"},"status":{"type":"string"},"updatedAt":{"type":"string"}}},{"type":"null"}]},"latestDeviceCapabilities":{"anyOf":[{"type":"object","required":["appBuild","appVersion","backgroundLocationSupported","capabilities","createdAt","deviceID","deviceName","locationSupported","platform","pushSupported","updatedAt"],"properties":{"appBuild":{"anyOf":[{"type":"string"},{"type":"null"}]},"appVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"backgroundLocationSupported":{"type":"boolean"},"capabilities":{"type":"object","additionalProperties":{}},"createdAt":{"type":"string"},"deviceID":{"type":"string"},"deviceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"locationSupported":{"type":"boolean"},"platform":{"type":"string"},"pushSupported":{"type":"boolean"},"updatedAt":{"type":"string"}}},{"type":"null"}]},"legalAcceptances":{"type":"array","items":{"type":"object","required":["acceptedAt","createdAt","documentID","documentType","documentVersion","id","metadata"],"properties":{"acceptedAt":{"type":"string"},"createdAt":{"type":"string"},"documentID":{"anyOf":[{"type":"string"},{"type":"null"}]},"documentType":{"type":"string"},"documentVersion":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}}}}},"questionnaires":{"type":"array","items":{"type":"object","required":["answers","definition","latestResponse","response","status","version"],"properties":{"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]}},"definition":{"type":"object","required":["activeVersionID","createdAt","questionnaireKey","summary","title","updatedAt"],"properties":{"activeVersionID":{"type":"string"},"createdAt":{"type":"string"},"questionnaireKey":{"type":"string"},"summary":{"type":"string"},"title":{"type":"string"},"updatedAt":{"type":"string"}}},"latestResponse":{"anyOf":[{"type":"object","required":["answers","id","questionnaireKey","questionnaireVersionID","submittedAt","updatedAt","userID"],"properties":{"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]}},"id":{"type":"string"},"questionnaireKey":{"type":"string"},"questionnaireVersionID":{"type":"string"},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}},{"type":"null"}]},"response":{"anyOf":[{"type":"object","required":["answers","id","questionnaireKey","questionnaireVersionID","submittedAt","updatedAt","userID"],"properties":{"answers":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}]}},"id":{"type":"string"},"questionnaireKey":{"type":"string"},"questionnaireVersionID":{"type":"string"},"submittedAt":{"type":"string"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["complete"]},{"type":"string","enum":["incomplete"]},{"type":"string","enum":["needs_review"]}]},"version":{"type":"object","required":["changeSummary","createdAt","createdByOperatorID","id","publishedAt","questionnaireKey","schema","sourceOrigin","status","summary","title","versionNumber"],"properties":{"changeSummary":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"questionnaireKey":{"type":"string"},"schema":{"type":"object","required":["questions"],"properties":{"questions":{"type":"array","items":{"type":"object","required":["helpText","key","kind","legacyQuestionID","options","placeholder","prompt","required","sortOrder"],"properties":{"helpText":{"anyOf":[{"type":"string"},{"type":"null"}]},"key":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["long_text"]},{"type":"string","enum":["number"]},{"type":"string","enum":["single_select"]},{"type":"string","enum":["text"]}]},"legacyQuestionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"options":{"type":"array","items":{"type":"object","required":["key","label","legacyAnswerID","sortOrder"],"properties":{"key":{"type":"string"},"label":{"type":"string"},"legacyAnswerID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sortOrder":{"type":"number"}}}},"placeholder":{"anyOf":[{"type":"string"},{"type":"null"}]},"prompt":{"type":"string"},"required":{"type":"boolean"},"sortOrder":{"type":"number"}}}}}},"sourceOrigin":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string"},"summary":{"type":"string"},"title":{"type":"string"},"versionNumber":{"type":"number"}}}}}}}},"summary":{"type":"object","required":["compliance","diagnostics","entitlements","latestActivityAt","notifications","operations","safety","support","user"],"properties":{"compliance":{"type":"object","required":["latestLegalAcceptanceAt","openLegalHoldCount","pendingDeletionRequest","releasedLegalHoldCount","totalLegalAcceptanceCount"],"properties":{"latestLegalAcceptanceAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"openLegalHoldCount":{"type":"number"},"pendingDeletionRequest":{"type":"boolean"},"releasedLegalHoldCount":{"type":"number"},"totalLegalAcceptanceCount":{"type":"number"}}},"diagnostics":{"type":"object","required":["crashCount","errorCount","latestDiagnosticAt","totalDiagnosticCount"],"properties":{"crashCount":{"type":"number"},"errorCount":{"type":"number"},"latestDiagnosticAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalDiagnosticCount":{"type":"number"}}},"entitlements":{"type":"object","required":["activeUntil","features","plan","source","status","updatedAt"],"properties":{"activeUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"features":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["inactive"]},{"type":"string","enum":["past_due"]},{"type":"string","enum":["trialing"]}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"latestActivityAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"notifications":{"type":"object","required":["deferredCount","failedCount","latestAttemptAt","sentCount","skippedCount","terminalFailedCount","totalAttemptCount"],"properties":{"deferredCount":{"type":"number"},"failedCount":{"type":"number"},"latestAttemptAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"sentCount":{"type":"number"},"skippedCount":{"type":"number"},"terminalFailedCount":{"type":"number"},"totalAttemptCount":{"type":"number"}}},"operations":{"type":"object","required":["cancelledJobCount","completedJobCount","failedJobCount","latestJobAt","queuedJobCount","runningJobCount","totalJobCount"],"properties":{"cancelledJobCount":{"type":"number"},"completedJobCount":{"type":"number"},"failedJobCount":{"type":"number"},"latestJobAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"queuedJobCount":{"type":"number"},"runningJobCount":{"type":"number"},"totalJobCount":{"type":"number"}}},"safety":{"type":"object","required":["activeTripCount","completedTripCount","latestSessionAt","overdueTripCount","plannedTripCount","totalTripCount"],"properties":{"activeTripCount":{"type":"number"},"completedTripCount":{"type":"number"},"latestSessionAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"overdueTripCount":{"type":"number"},"plannedTripCount":{"type":"number"},"totalTripCount":{"type":"number"}}},"support":{"type":"object","required":["closedCaseCount","highPriorityCaseCount","latestCaseAt","openCaseCount","pendingCaseCount","resolvedCaseCount","totalCaseCount","urgentCaseCount"],"properties":{"closedCaseCount":{"type":"number"},"highPriorityCaseCount":{"type":"number"},"latestCaseAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"openCaseCount":{"type":"number"},"pendingCaseCount":{"type":"number"},"resolvedCaseCount":{"type":"number"},"totalCaseCount":{"type":"number"},"urgentCaseCount":{"type":"number"}}},"user":{"type":"object","required":["avatarURL","createdAt","email","name","passwordSetupRequired","sessionVersion","status","updatedAt","userID"],"properties":{"avatarURL":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"passwordSetupRequired":{"type":"boolean"},"sessionVersion":{"type":"number"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]},{"type":"string","enum":["pending_deletion"]}]},"updatedAt":{"type":"string"},"userID":{"type":"string"}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/users/{userID}/support-cases":{"get":{"summary":"Operator list user support cases","tags":["operator","admin-users"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"path","name":"userID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["cases","pageInfo"],"properties":{"cases":{"type":"array","items":{"type":"object","required":["body","createdAt","id","metadata","priority","status","subject","updatedAt","userID"],"properties":{"body":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["open"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["resolved"]}]},"subject":{"type":"string"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}}},"pageInfo":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/users/{userID}/jobs":{"get":{"summary":"Operator list user jobs","tags":["operator","admin-users"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"anyOf":[{"type":"string","enum":["forecast_sync"]},{"type":"string","enum":["identity_auth_delivery"]},{"type":"string","enum":["media_processing"]},{"type":"string","enum":["messaging_notification"]},{"type":"string","enum":["recommendation"]},{"type":"string","enum":["route_export"]},{"type":"string","enum":["route_import"]},{"type":"string","enum":["route_intelligence"]},{"type":"string","enum":["trip_safety_notification"]}]},"in":"query","name":"kind","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"path","name":"userID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["jobs","pageInfo"],"properties":{"jobs":{"type":"array","items":{"type":"object","required":["attemptCount","createdAt","id","kind","lastError","metadata","ownerUserID","resourceID","resourceKind","result","scheduledFor","source","status","type","updatedAt"],"properties":{"attemptCount":{"type":"number"},"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["forecast_sync"]},{"type":"string","enum":["identity_auth_delivery"]},{"type":"string","enum":["media_processing"]},{"type":"string","enum":["messaging_notification"]},{"type":"string","enum":["recommendation"]},{"type":"string","enum":["route_export"]},{"type":"string","enum":["route_import"]},{"type":"string","enum":["route_intelligence"]},{"type":"string","enum":["trip_safety_notification"]}]},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"ownerUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"result":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"scheduledFor":{"type":"string"},"source":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"type":{"type":"string"},"updatedAt":{"type":"string"}}}},"pageInfo":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/users/{userID}/legal-holds":{"get":{"summary":"Operator list user legal holds","tags":["operator","admin-users"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"includeReleased","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"path","name":"userID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["holds","pageInfo"],"properties":{"holds":{"type":"array","items":{"type":"object","required":["createdAt","createdByOperatorID","id","incidentID","reason","releasedAt","releasedByOperatorID","subjectUserID","windowEnd","windowStart"],"properties":{"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"id":{"type":"string"},"incidentID":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"type":"string"},"releasedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"releasedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"subjectUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"windowEnd":{"anyOf":[{"type":"string"},{"type":"null"}]},"windowStart":{"anyOf":[{"type":"string"},{"type":"null"}]}}}},"pageInfo":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/users/{userID}/trip-safety/sessions":{"get":{"summary":"Operator list user trip safety sessions","tags":["operator","admin-users"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"path","name":"userID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["pageInfo","sessions"],"properties":{"pageInfo":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"sessions":{"type":"array","items":{"type":"object","required":["contactIDs","createdAt","endedAt","expectedEndAt","id","lastHeartbeatAt","metadata","routePlanID","startedAt","startsAt","status","title","updatedAt"],"properties":{"contactIDs":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"endedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expectedEndAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"lastHeartbeatAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"routePlanID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["overdue"]},{"type":"string","enum":["planned"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/users/{userID}/diagnostics":{"get":{"summary":"Operator list user diagnostics","tags":["operator","admin-users"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"anyOf":[{"type":"string","enum":["crash"]},{"type":"string","enum":["error"]},{"type":"string","enum":["log"]},{"type":"string","enum":["performance"]}]},"in":"query","name":"kind","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"anyOf":[{"type":"string","enum":["debug"]},{"type":"string","enum":["error"]},{"type":"string","enum":["fatal"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"in":"query","name":"severity","required":false},{"schema":{"type":"string"},"in":"path","name":"userID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["pageInfo","reports"],"properties":{"pageInfo":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"reports":{"type":"array","items":{"type":"object","required":["actorUserID","anonymousID","appVersion","breadcrumbs","context","deviceID","fingerprint","id","kind","message","occurredAt","platform","receivedAt","redactionApplied","release","requestID","sessionID","severity","stackTrace"],"properties":{"actorUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"anonymousID":{"anyOf":[{"type":"string"},{"type":"null"}]},"appVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"breadcrumbs":{"type":"array","items":{"type":"object","additionalProperties":{}}},"context":{"type":"object","additionalProperties":{}},"deviceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"fingerprint":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["crash"]},{"type":"string","enum":["error"]},{"type":"string","enum":["log"]},{"type":"string","enum":["performance"]}]},"message":{"type":"string"},"occurredAt":{"type":"string"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}]},"receivedAt":{"type":"string"},"redactionApplied":{"type":"boolean"},"release":{"anyOf":[{"type":"string"},{"type":"null"}]},"requestID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sessionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"severity":{"anyOf":[{"type":"string","enum":["debug"]},{"type":"string","enum":["error"]},{"type":"string","enum":["fatal"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"stackTrace":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/users/{userID}/notifications":{"get":{"summary":"Operator list user notification attempts","tags":["operator","admin-users"],"parameters":[{"schema":{"anyOf":[{"type":"string","enum":["email"]},{"type":"string","enum":["in_app"]},{"type":"string","enum":["push"]},{"type":"string","enum":["sms"]}]},"in":"query","name":"channel","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"anyOf":[{"type":"string","enum":["deferred"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["sent"]},{"type":"string","enum":["skipped"]}]},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"path","name":"userID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["attempts","pageInfo"],"properties":{"attempts":{"type":"array","items":{"type":"object","required":["channel","createdAt","deadLetteredAt","error","id","provider","providerMessageID","providerStatus","providerStatusReceivedAt","reason","recipientRef","retryAt","sourceID","sourceKind","status","terminal"],"properties":{"channel":{"anyOf":[{"type":"string","enum":["email"]},{"type":"string","enum":["in_app"]},{"type":"string","enum":["push"]},{"type":"string","enum":["sms"]}]},"createdAt":{"type":"string"},"deadLetteredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"provider":{"type":"string"},"providerMessageID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerStatusReceivedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"retryAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceID":{"type":"string"},"sourceKind":{"anyOf":[{"type":"string","enum":["messaging_outbox"]},{"type":"string","enum":["trip_safety_contact_job"]}]},"status":{"anyOf":[{"type":"string","enum":["deferred"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["sent"]},{"type":"string","enum":["skipped"]}]},"terminal":{"type":"boolean"}}}},"pageInfo":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/users/{userID}/timeline":{"get":{"summary":"Operator get user timeline","tags":["operator","admin-users"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"anyOf":[{"type":"string","enum":["audit_event"]},{"type":"string","enum":["diagnostic"]},{"type":"string","enum":["job"]},{"type":"string","enum":["legal_hold"]},{"type":"string","enum":["notification"]},{"type":"string","enum":["support_case"]},{"type":"string","enum":["sync_change"]},{"type":"string","enum":["trip_safety_session"]}]},"in":"query","name":"kind","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"path","name":"userID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["items","pageInfo"],"properties":{"items":{"type":"array","items":{"type":"object","required":["actor","createdAt","id","kind","payload","resource","severity","source","title"],"properties":{"actor":{"type":"object","required":["id","kind"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["system"]},{"type":"string","enum":["user"]},{"type":"string","enum":["unknown"]}]}}},"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["audit_event"]},{"type":"string","enum":["diagnostic"]},{"type":"string","enum":["job"]},{"type":"string","enum":["legal_hold"]},{"type":"string","enum":["notification"]},{"type":"string","enum":["support_case"]},{"type":"string","enum":["sync_change"]},{"type":"string","enum":["trip_safety_session"]}]},"payload":{"type":"object","additionalProperties":{}},"resource":{"type":"object","required":["id","kind"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"type":"string"}}},"severity":{"anyOf":[{"type":"string","enum":["danger"]},{"type":"string","enum":["info"]},{"type":"string","enum":["success"]},{"type":"string","enum":["warning"]}]},"source":{"type":"string"},"title":{"type":"string"}}}},"pageInfo":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/users/{userID}/entitlements":{"get":{"summary":"Operator get user membership and entitlement state","tags":["operator","admin-users"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"userID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["membership"],"properties":{"membership":{"type":"object","required":["actions","buddyPasses","entitlements","giftMemberships","grants","providerSyncEvents"],"properties":{"actions":{"type":"object","required":["grant","revoke"],"properties":{"grant":{"type":"object","required":["description","method","path","reasonRequired","status"],"properties":{"description":{"type":"string"},"method":{"type":"string","enum":["POST"]},"path":{"type":"string"},"reasonRequired":{"type":"boolean"},"status":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["planned"]}]}}},"revoke":{"type":"object","required":["description","method","path","reasonRequired","status"],"properties":{"description":{"type":"string"},"method":{"type":"string","enum":["POST"]},"path":{"type":"string"},"reasonRequired":{"type":"boolean"},"status":{"anyOf":[{"type":"string","enum":["disabled"]},{"type":"string","enum":["enabled"]},{"type":"string","enum":["planned"]}]}}}}},"buddyPasses":{"type":"array","items":{"type":"object","required":["benefitDurationDays","benefitPlan","createdAt","expiresAt","id","ownerUserID","recipientEmail","recipientUserID","revokedAt","sharedAt","status","updatedAt"],"properties":{"benefitDurationDays":{"anyOf":[{"type":"number"},{"type":"null"}]},"benefitPlan":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"ownerUserID":{"type":"string"},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"sharedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string"},"updatedAt":{"type":"string"}}}},"entitlements":{"type":"object","required":["activeUntil","features","plan","source","status","updatedAt"],"properties":{"activeUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"features":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["inactive"]},{"type":"string","enum":["past_due"]},{"type":"string","enum":["trialing"]}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"giftMemberships":{"type":"array","items":{"type":"object","required":["claimedAt","createdAt","endsAt","id","plan","purchaserUserID","recipientEmail","recipientName","recipientUserID","startsAt","status","updatedAt"],"properties":{"claimedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"plan":{"type":"string"},"purchaserUserID":{"type":"string"},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientName":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string"},"updatedAt":{"type":"string"}}}},"grants":{"type":"array","items":{"type":"object","required":["buddyPassID","createdAt","endsAt","giftMembershipID","grantedByUserID","id","kind","metadata","plan","provider","providerCustomerID","providerSubscriptionID","providerTransactionID","sourcePlatform","startsAt","status","updatedAt"],"properties":{"buddyPassID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"giftMembershipID":{"anyOf":[{"type":"string"},{"type":"null"}]},"grantedByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["buddy_pass"]},{"type":"string","enum":["gift_membership"]},{"type":"string","enum":["lifetime_purchase"]},{"type":"string","enum":["manual"]},{"type":"string","enum":["provider_snapshot"]},{"type":"string","enum":["subscription"]}]},"metadata":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"provider":{"type":"string"},"providerCustomerID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerSubscriptionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerTransactionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourcePlatform":{"type":"string"},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["inactive"]},{"type":"string","enum":["past_due"]},{"type":"string","enum":["trialing"]}]},"updatedAt":{"type":"string"}}}},"providerSyncEvents":{"type":"array","items":{"type":"object","required":["createdAt","eventType","id","provider","providerEventID","status"],"properties":{"createdAt":{"type":"string"},"eventType":{"type":"string"},"id":{"type":"string"},"provider":{"type":"string"},"providerEventID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string"}}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/users/{userID}/entitlement-grants":{"post":{"summary":"Operator planned grant entitlement","tags":["operator","admin-users"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["plan","reason","source"],"properties":{"activeUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"reason":{"type":"string"},"source":{"type":"string","enum":["manual"]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["inactive"]},{"type":"string","enum":["past_due"]},{"type":"string","enum":["trialing"]}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"userID","required":true}],"responses":{"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"501":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/users/{userID}/entitlement-grants/{grantID}/revoke":{"post":{"summary":"Operator planned revoke entitlement grant","tags":["operator","admin-users"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["reason"],"properties":{"metadata":{"type":"object","additionalProperties":{}},"reason":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"userID","required":true},{"schema":{"type":"string"},"in":"path","name":"grantID","required":true}],"responses":{"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"501":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/access/me":{"get":{"summary":"Get current operator access snapshot","tags":["operator","operator-access"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["access"],"properties":{"access":{"type":"object","required":["capabilities","overrides","policies","reasonRequiredCapabilities","role","roleCapabilities"],"properties":{"capabilities":{"type":"array","items":{"type":"string"}},"overrides":{"type":"array","items":{"type":"object","required":["capability","createdAt","createdByOperatorID","effect","operatorID","reason","updatedAt"],"properties":{"capability":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"effect":{"anyOf":[{"type":"string","enum":["deny"]},{"type":"string","enum":["grant"]}]},"operatorID":{"type":"string"},"reason":{"type":"string"},"updatedAt":{"type":"string"}}}},"policies":{"type":"array","items":{"type":"object","required":["capability","category","description","reasonRequired"],"properties":{"capability":{"type":"string"},"category":{"type":"string"},"description":{"type":"string"},"reasonRequired":{"type":"boolean"}}}},"reasonRequiredCapabilities":{"type":"array","items":{"type":"string"}},"role":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["support"]}]},"roleCapabilities":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/access/capabilities":{"get":{"summary":"List operator capability catalog","tags":["operator","operator-access"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["catalog"],"properties":{"catalog":{"type":"object","required":["capabilities","policies","reasonHeader","reasonRequiredCapabilities"],"properties":{"capabilities":{"type":"array","items":{"type":"string"}},"policies":{"type":"array","items":{"type":"object","required":["capability","category","description","reasonRequired"],"properties":{"capability":{"type":"string"},"category":{"type":"string"},"description":{"type":"string"},"reasonRequired":{"type":"boolean"}}}},"reasonHeader":{"type":"string"},"reasonRequiredCapabilities":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/access/operators/{operatorID}":{"get":{"summary":"Get operator access snapshot","tags":["operator","operator-access"],"parameters":[{"schema":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["support"]}]},"in":"query","name":"role","required":false},{"schema":{"type":"string"},"in":"path","name":"operatorID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["access"],"properties":{"access":{"type":"object","required":["capabilities","overrides","policies","reasonRequiredCapabilities","role","roleCapabilities"],"properties":{"capabilities":{"type":"array","items":{"type":"string"}},"overrides":{"type":"array","items":{"type":"object","required":["capability","createdAt","createdByOperatorID","effect","operatorID","reason","updatedAt"],"properties":{"capability":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"effect":{"anyOf":[{"type":"string","enum":["deny"]},{"type":"string","enum":["grant"]}]},"operatorID":{"type":"string"},"reason":{"type":"string"},"updatedAt":{"type":"string"}}}},"policies":{"type":"array","items":{"type":"object","required":["capability","category","description","reasonRequired"],"properties":{"capability":{"type":"string"},"category":{"type":"string"},"description":{"type":"string"},"reasonRequired":{"type":"boolean"}}}},"reasonRequiredCapabilities":{"type":"array","items":{"type":"string"}},"role":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["support"]}]},"roleCapabilities":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/access/operators/{operatorID}/capabilities/{capability}":{"put":{"summary":"Upsert operator capability override","tags":["operator","operator-access"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["effect","reason","role"],"properties":{"effect":{"anyOf":[{"type":"string","enum":["deny"]},{"type":"string","enum":["grant"]}]},"reason":{"type":"string"},"role":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["support"]}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"operatorID","required":true},{"schema":{"type":"string"},"in":"path","name":"capability","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["access"],"properties":{"access":{"type":"object","required":["capabilities","overrides","policies","reasonRequiredCapabilities","role","roleCapabilities"],"properties":{"capabilities":{"type":"array","items":{"type":"string"}},"overrides":{"type":"array","items":{"type":"object","required":["capability","createdAt","createdByOperatorID","effect","operatorID","reason","updatedAt"],"properties":{"capability":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"effect":{"anyOf":[{"type":"string","enum":["deny"]},{"type":"string","enum":["grant"]}]},"operatorID":{"type":"string"},"reason":{"type":"string"},"updatedAt":{"type":"string"}}}},"policies":{"type":"array","items":{"type":"object","required":["capability","category","description","reasonRequired"],"properties":{"capability":{"type":"string"},"category":{"type":"string"},"description":{"type":"string"},"reasonRequired":{"type":"boolean"}}}},"reasonRequiredCapabilities":{"type":"array","items":{"type":"string"}},"role":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["support"]}]},"roleCapabilities":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"delete":{"summary":"Delete operator capability override","tags":["operator","operator-access"],"parameters":[{"schema":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["support"]}]},"in":"query","name":"role","required":false},{"schema":{"type":"string"},"in":"path","name":"operatorID","required":true},{"schema":{"type":"string"},"in":"path","name":"capability","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["access"],"properties":{"access":{"type":"object","required":["capabilities","overrides","policies","reasonRequiredCapabilities","role","roleCapabilities"],"properties":{"capabilities":{"type":"array","items":{"type":"string"}},"overrides":{"type":"array","items":{"type":"object","required":["capability","createdAt","createdByOperatorID","effect","operatorID","reason","updatedAt"],"properties":{"capability":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"effect":{"anyOf":[{"type":"string","enum":["deny"]},{"type":"string","enum":["grant"]}]},"operatorID":{"type":"string"},"reason":{"type":"string"},"updatedAt":{"type":"string"}}}},"policies":{"type":"array","items":{"type":"object","required":["capability","category","description","reasonRequired"],"properties":{"capability":{"type":"string"},"category":{"type":"string"},"description":{"type":"string"},"reasonRequired":{"type":"boolean"}}}},"reasonRequiredCapabilities":{"type":"array","items":{"type":"string"}},"role":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["support"]}]},"roleCapabilities":{"type":"array","items":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/secrets":{"get":{"summary":"Operator list redacted secret resources","tags":["operator","secrets"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"provider","required":false},{"schema":{"type":"string"},"in":"query","name":"scopeID","required":false},{"schema":{"type":"string"},"in":"query","name":"scopeKind","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["secrets"],"properties":{"secrets":{"type":"array","items":{"type":"object","required":["activeVersionID","createdAt","createdByOperatorID","id","metadata","name","provider","scopeID","scopeKind","status","updatedAt","updatedByOperatorID","versionCount"],"properties":{"activeVersionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"provider":{"anyOf":[{"type":"string","enum":["jira"]},{"type":"string","enum":["ai"]},{"type":"string","enum":["email"]},{"type":"string","enum":["analytics"]},{"type":"string","enum":["maps"]},{"type":"string","enum":["other"]},{"type":"null"}]},"scopeID":{"type":"string"},"scopeKind":{"anyOf":[{"type":"string","enum":["integration"]},{"type":"string","enum":["system"]},{"type":"string","enum":["provider"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]},{"type":"string","enum":["archived"]}]},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"},"versionCount":{"type":"number"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/secrets/{secretID}":{"get":{"summary":"Operator get redacted secret resource","tags":["operator","secrets"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"secretID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["secret"],"properties":{"secret":{"type":"object","allOf":[{"type":"object","required":["activeVersionID","createdAt","createdByOperatorID","id","metadata","name","provider","scopeID","scopeKind","status","updatedAt","updatedByOperatorID","versionCount"],"properties":{"activeVersionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"provider":{"anyOf":[{"type":"string","enum":["jira"]},{"type":"string","enum":["ai"]},{"type":"string","enum":["email"]},{"type":"string","enum":["analytics"]},{"type":"string","enum":["maps"]},{"type":"string","enum":["other"]},{"type":"null"}]},"scopeID":{"type":"string"},"scopeKind":{"anyOf":[{"type":"string","enum":["integration"]},{"type":"string","enum":["system"]},{"type":"string","enum":["provider"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]},{"type":"string","enum":["archived"]}]},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"},"versionCount":{"type":"number"}}},{"type":"object","required":["activeVersion"],"properties":{"activeVersion":{"anyOf":[{"type":"object","required":["createdAt","createdByOperatorID","id","keyVersion","reason","revokedAt","revokedByOperatorID","secretID","status","supersededAt","valueFingerprint","valueHint","versionNumber"],"properties":{"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"id":{"type":"string"},"keyVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"secretID":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["superseded"]},{"type":"string","enum":["revoked"]}]},"supersededAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"valueFingerprint":{"type":"string"},"valueHint":{"anyOf":[{"type":"string"},{"type":"null"}]},"versionNumber":{"type":"number"}}},{"type":"null"}]}}}]}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/secrets/{secretID}/versions":{"get":{"summary":"Operator list redacted secret versions","tags":["operator","secrets"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"secretID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["versions"],"properties":{"versions":{"type":"array","items":{"type":"object","required":["createdAt","createdByOperatorID","id","keyVersion","reason","revokedAt","revokedByOperatorID","secretID","status","supersededAt","valueFingerprint","valueHint","versionNumber"],"properties":{"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"id":{"type":"string"},"keyVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"secretID":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["superseded"]},{"type":"string","enum":["revoked"]}]},"supersededAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"valueFingerprint":{"type":"string"},"valueHint":{"anyOf":[{"type":"string"},{"type":"null"}]},"versionNumber":{"type":"number"}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/secrets/{secretID}/revoke":{"post":{"summary":"Operator revoke active secret version","tags":["operator","secrets"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["reason"],"properties":{"reason":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"secretID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["secret"],"properties":{"secret":{"type":"object","allOf":[{"type":"object","required":["activeVersionID","createdAt","createdByOperatorID","id","metadata","name","provider","scopeID","scopeKind","status","updatedAt","updatedByOperatorID","versionCount"],"properties":{"activeVersionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"provider":{"anyOf":[{"type":"string","enum":["jira"]},{"type":"string","enum":["ai"]},{"type":"string","enum":["email"]},{"type":"string","enum":["analytics"]},{"type":"string","enum":["maps"]},{"type":"string","enum":["other"]},{"type":"null"}]},"scopeID":{"type":"string"},"scopeKind":{"anyOf":[{"type":"string","enum":["integration"]},{"type":"string","enum":["system"]},{"type":"string","enum":["provider"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]},{"type":"string","enum":["archived"]}]},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"},"versionCount":{"type":"number"}}},{"type":"object","required":["activeVersion"],"properties":{"activeVersion":{"anyOf":[{"type":"object","required":["createdAt","createdByOperatorID","id","keyVersion","reason","revokedAt","revokedByOperatorID","secretID","status","supersededAt","valueFingerprint","valueHint","versionNumber"],"properties":{"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"id":{"type":"string"},"keyVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"secretID":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["superseded"]},{"type":"string","enum":["revoked"]}]},"supersededAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"valueFingerprint":{"type":"string"},"valueHint":{"anyOf":[{"type":"string"},{"type":"null"}]},"versionNumber":{"type":"number"}}},{"type":"null"}]}}}]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/work-sessions/active":{"get":{"summary":"Get active work session by kind","tags":["work-sessions"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"kind","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["session"],"properties":{"session":{"anyOf":[{"type":"object","required":["createdAt","finalArtifactID","finalArtifactType","finalizedAt","id","kind","lastCheckpointAt","lastEditedDeviceName","lastEditedPlatform","payload","payloadVersion","revision","startedAt","status","updatedAt","userID"],"properties":{"createdAt":{"type":"string"},"finalArtifactID":{"anyOf":[{"type":"string"},{"type":"null"}]},"finalArtifactType":{"anyOf":[{"anyOf":[{"type":"string","enum":["route"]},{"type":"string","enum":["route-plan"]}]},{"type":"null"}]},"finalizedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["plan-editing"]},{"type":"string","enum":["route-draft"]},{"type":"string","enum":["track-recording"]}]},"lastCheckpointAt":{"type":"string"},"lastEditedDeviceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastEditedPlatform":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["backend"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["web"]}]},"payload":{"type":"object","additionalProperties":{}},"payloadVersion":{"type":"number"},"revision":{"type":"number"},"startedAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["finalizing"]},{"type":"string","enum":["paused"]}]},"updatedAt":{"type":"string"},"userID":{"type":"string"}}},{"type":"null"}]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/work-sessions/start":{"post":{"summary":"Start or resume a work session","tags":["work-sessions"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["kind"],"properties":{"deviceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"anyOf":[{"type":"string","enum":["plan-editing"]},{"type":"string","enum":["route-draft"]},{"type":"string","enum":["track-recording"]}]},"payload":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"platform":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["backend"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["web"]}]},"resumeExisting":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["resumedExisting","session"],"properties":{"resumedExisting":{"type":"boolean"},"session":{"type":"object","required":["createdAt","finalArtifactID","finalArtifactType","finalizedAt","id","kind","lastCheckpointAt","lastEditedDeviceName","lastEditedPlatform","payload","payloadVersion","revision","startedAt","status","updatedAt","userID"],"properties":{"createdAt":{"type":"string"},"finalArtifactID":{"anyOf":[{"type":"string"},{"type":"null"}]},"finalArtifactType":{"anyOf":[{"anyOf":[{"type":"string","enum":["route"]},{"type":"string","enum":["route-plan"]}]},{"type":"null"}]},"finalizedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["plan-editing"]},{"type":"string","enum":["route-draft"]},{"type":"string","enum":["track-recording"]}]},"lastCheckpointAt":{"type":"string"},"lastEditedDeviceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastEditedPlatform":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["backend"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["web"]}]},"payload":{"type":"object","additionalProperties":{}},"payloadVersion":{"type":"number"},"revision":{"type":"number"},"startedAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["finalizing"]},{"type":"string","enum":["paused"]}]},"updatedAt":{"type":"string"},"userID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/work-sessions/{sessionID}":{"get":{"summary":"Get a work session","tags":["work-sessions"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"sessionID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["session"],"properties":{"session":{"type":"object","required":["createdAt","finalArtifactID","finalArtifactType","finalizedAt","id","kind","lastCheckpointAt","lastEditedDeviceName","lastEditedPlatform","payload","payloadVersion","revision","startedAt","status","updatedAt","userID"],"properties":{"createdAt":{"type":"string"},"finalArtifactID":{"anyOf":[{"type":"string"},{"type":"null"}]},"finalArtifactType":{"anyOf":[{"anyOf":[{"type":"string","enum":["route"]},{"type":"string","enum":["route-plan"]}]},{"type":"null"}]},"finalizedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["plan-editing"]},{"type":"string","enum":["route-draft"]},{"type":"string","enum":["track-recording"]}]},"lastCheckpointAt":{"type":"string"},"lastEditedDeviceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastEditedPlatform":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["backend"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["web"]}]},"payload":{"type":"object","additionalProperties":{}},"payloadVersion":{"type":"number"},"revision":{"type":"number"},"startedAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["finalizing"]},{"type":"string","enum":["paused"]}]},"updatedAt":{"type":"string"},"userID":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/work-sessions/{sessionID}/checkpoint":{"put":{"summary":"Checkpoint a work session","tags":["work-sessions"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"deviceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"payload":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"platform":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["backend"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["web"]}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"sessionID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["session"],"properties":{"session":{"type":"object","required":["createdAt","finalArtifactID","finalArtifactType","finalizedAt","id","kind","lastCheckpointAt","lastEditedDeviceName","lastEditedPlatform","payload","payloadVersion","revision","startedAt","status","updatedAt","userID"],"properties":{"createdAt":{"type":"string"},"finalArtifactID":{"anyOf":[{"type":"string"},{"type":"null"}]},"finalArtifactType":{"anyOf":[{"anyOf":[{"type":"string","enum":["route"]},{"type":"string","enum":["route-plan"]}]},{"type":"null"}]},"finalizedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["plan-editing"]},{"type":"string","enum":["route-draft"]},{"type":"string","enum":["track-recording"]}]},"lastCheckpointAt":{"type":"string"},"lastEditedDeviceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastEditedPlatform":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["backend"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["web"]}]},"payload":{"type":"object","additionalProperties":{}},"payloadVersion":{"type":"number"},"revision":{"type":"number"},"startedAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["finalizing"]},{"type":"string","enum":["paused"]}]},"updatedAt":{"type":"string"},"userID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/work-sessions/{sessionID}/finalize":{"post":{"summary":"Finalize a work session","tags":["work-sessions"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"deviceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"payload":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"platform":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["backend"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["web"]}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"sessionID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["session"],"properties":{"session":{"type":"object","required":["createdAt","finalArtifactID","finalArtifactType","finalizedAt","id","kind","lastCheckpointAt","lastEditedDeviceName","lastEditedPlatform","payload","payloadVersion","revision","startedAt","status","updatedAt","userID"],"properties":{"createdAt":{"type":"string"},"finalArtifactID":{"anyOf":[{"type":"string"},{"type":"null"}]},"finalArtifactType":{"anyOf":[{"anyOf":[{"type":"string","enum":["route"]},{"type":"string","enum":["route-plan"]}]},{"type":"null"}]},"finalizedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["plan-editing"]},{"type":"string","enum":["route-draft"]},{"type":"string","enum":["track-recording"]}]},"lastCheckpointAt":{"type":"string"},"lastEditedDeviceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastEditedPlatform":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["backend"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["web"]}]},"payload":{"type":"object","additionalProperties":{}},"payloadVersion":{"type":"number"},"revision":{"type":"number"},"startedAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["finalizing"]},{"type":"string","enum":["paused"]}]},"updatedAt":{"type":"string"},"userID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/work-sessions/{sessionID}/cancel":{"post":{"summary":"Cancel a work session","tags":["work-sessions"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"deviceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["backend"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["web"]}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"sessionID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["session"],"properties":{"session":{"type":"object","required":["createdAt","finalArtifactID","finalArtifactType","finalizedAt","id","kind","lastCheckpointAt","lastEditedDeviceName","lastEditedPlatform","payload","payloadVersion","revision","startedAt","status","updatedAt","userID"],"properties":{"createdAt":{"type":"string"},"finalArtifactID":{"anyOf":[{"type":"string"},{"type":"null"}]},"finalArtifactType":{"anyOf":[{"anyOf":[{"type":"string","enum":["route"]},{"type":"string","enum":["route-plan"]}]},{"type":"null"}]},"finalizedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["plan-editing"]},{"type":"string","enum":["route-draft"]},{"type":"string","enum":["track-recording"]}]},"lastCheckpointAt":{"type":"string"},"lastEditedDeviceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastEditedPlatform":{"anyOf":[{"type":"string","enum":["android"]},{"type":"string","enum":["backend"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["web"]}]},"payload":{"type":"object","additionalProperties":{}},"payloadVersion":{"type":"number"},"revision":{"type":"number"},"startedAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["finalizing"]},{"type":"string","enum":["paused"]}]},"updatedAt":{"type":"string"},"userID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/routes":{"get":{"summary":"List current user routes","tags":["routes"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["routes"],"properties":{"routes":{"type":"array","items":{"type":"object","required":["createdAt","description","distanceMeters","elevationGainMeters","geometry","id","metadata","name","source","status","updatedAt"],"properties":{"createdAt":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"distanceMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"elevationGainMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"geometry":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"updatedAt":{"type":"string"}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Create a saved route","tags":["routes"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"distanceMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"elevationGainMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"geometry":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"source":{"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["route"],"properties":{"route":{"type":"object","required":["createdAt","description","distanceMeters","elevationGainMeters","geometry","id","metadata","name","source","status","updatedAt"],"properties":{"createdAt":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"distanceMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"elevationGainMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"geometry":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/routes/{routeID}":{"get":{"summary":"Get a saved route","tags":["routes"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"routeID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["route"],"properties":{"route":{"type":"object","required":["createdAt","description","distanceMeters","elevationGainMeters","geometry","id","metadata","name","source","status","updatedAt"],"properties":{"createdAt":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"distanceMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"elevationGainMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"geometry":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"updatedAt":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"patch":{"summary":"Update a saved route","tags":["routes"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"distanceMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"elevationGainMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"geometry":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"routeID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["route"],"properties":{"route":{"type":"object","required":["createdAt","description","distanceMeters","elevationGainMeters","geometry","id","metadata","name","source","status","updatedAt"],"properties":{"createdAt":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"distanceMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"elevationGainMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"geometry":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"delete":{"summary":"Soft delete a saved route","tags":["routes"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"routeID","required":true}],"responses":{"204":{"description":"Default Response"},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/routes/{routeID}/share":{"post":{"summary":"Create a saved route share token","tags":["routes"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"targetUserID":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"routeID","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["share"],"properties":{"emailQueued":{"type":"boolean"},"notificationID":{"anyOf":[{"type":"string"},{"type":"null"}]},"share":{"type":"object","required":["createdAt","expiresAt","id","resourceID","resourceKind","revokedAt","token"],"properties":{"createdAt":{"type":"string"},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"resourceID":{"type":"string"},"resourceKind":{"anyOf":[{"type":"string","enum":["route"]},{"type":"string","enum":["route_plan"]}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"token":{"type":"string"}}},"shareURL":{"type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/routes/shared/{shareToken}":{"get":{"summary":"Get a shared route","tags":["routes"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"shareToken","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["route","share"],"properties":{"route":{"type":"object","required":["createdAt","description","distanceMeters","elevationGainMeters","geometry","id","metadata","name","source","status","updatedAt"],"properties":{"createdAt":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"distanceMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"elevationGainMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"geometry":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"updatedAt":{"type":"string"}}},"share":{"type":"object","required":["createdAt","expiresAt","id","resourceID","resourceKind","revokedAt","token"],"properties":{"createdAt":{"type":"string"},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"resourceID":{"type":"string"},"resourceKind":{"anyOf":[{"type":"string","enum":["route"]},{"type":"string","enum":["route_plan"]}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"token":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/route-plans":{"get":{"summary":"List current user route plans","tags":["route-plans"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["plans"],"properties":{"plans":{"type":"array","items":{"type":"object","required":["createdAt","description","id","metadata","name","routeID","startsAt","status","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"routeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Create a route plan","tags":["route-plans"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"routeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"timezone":{"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["plan"],"properties":{"plan":{"type":"object","required":["createdAt","description","id","metadata","name","routeID","startsAt","status","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"routeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/route-plans/{planID}":{"get":{"summary":"Get a route plan","tags":["route-plans"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"planID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["plan"],"properties":{"plan":{"type":"object","required":["createdAt","description","id","metadata","name","routeID","startsAt","status","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"routeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"patch":{"summary":"Update a route plan","tags":["route-plans"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"routeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"timezone":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"planID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["plan"],"properties":{"plan":{"type":"object","required":["createdAt","description","id","metadata","name","routeID","startsAt","status","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"routeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"delete":{"summary":"Soft delete a route plan","tags":["route-plans"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"planID","required":true}],"responses":{"204":{"description":"Default Response"},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/route-plans/{planID}/share":{"post":{"summary":"Create a route plan share token","tags":["route-plans"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"targetUserID":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"planID","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["share"],"properties":{"emailQueued":{"type":"boolean"},"notificationID":{"anyOf":[{"type":"string"},{"type":"null"}]},"share":{"type":"object","required":["createdAt","expiresAt","id","resourceID","resourceKind","revokedAt","token"],"properties":{"createdAt":{"type":"string"},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"resourceID":{"type":"string"},"resourceKind":{"anyOf":[{"type":"string","enum":["route"]},{"type":"string","enum":["route_plan"]}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"token":{"type":"string"}}},"shareURL":{"type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/route-plans/shared/{shareToken}":{"get":{"summary":"Get a shared route plan","tags":["route-plans"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"shareToken","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["plan","share"],"properties":{"plan":{"type":"object","required":["createdAt","description","id","metadata","name","routeID","startsAt","status","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"routeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}},"share":{"type":"object","required":["createdAt","expiresAt","id","resourceID","resourceKind","revokedAt","token"],"properties":{"createdAt":{"type":"string"},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"resourceID":{"type":"string"},"resourceKind":{"anyOf":[{"type":"string","enum":["route"]},{"type":"string","enum":["route_plan"]}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"token":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/route-plans/shared/{shareToken}/context":{"get":{"summary":"Get shared route plan context for current user","tags":["route-plans"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"shareToken","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["context"],"properties":{"context":{"type":"object","required":["availableActions","copyCount","preferredCopy","sourcePlan","sourceRevisionID","sourceState"],"properties":{"availableActions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["make_new_copy"]},{"type":"string","enum":["open_preferred_copy"]},{"type":"string","enum":["view_original"]}]}},"copyCount":{"type":"number"},"preferredCopy":{"anyOf":[{"type":"object","required":["createdAt","description","id","metadata","name","routeID","startsAt","status","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"routeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}},{"type":"null"}]},"sourcePlan":{"anyOf":[{"type":"object","required":["createdAt","description","id","metadata","name","routeID","startsAt","status","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"routeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}},{"type":"null"}]},"sourceRevisionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceState":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["missing"]},{"type":"string","enum":["unchanged"]},{"type":"string","enum":["updated"]}]}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/route-plans/shared/{shareToken}/copies":{"post":{"summary":"Create a current-user copy of a shared route plan","tags":["route-plans"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"makePreferred":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"shareToken","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["context","plan"],"properties":{"context":{"type":"object","required":["availableActions","copyCount","preferredCopy","sourcePlan","sourceRevisionID","sourceState"],"properties":{"availableActions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["make_new_copy"]},{"type":"string","enum":["open_preferred_copy"]},{"type":"string","enum":["view_original"]}]}},"copyCount":{"type":"number"},"preferredCopy":{"anyOf":[{"type":"object","required":["createdAt","description","id","metadata","name","routeID","startsAt","status","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"routeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}},{"type":"null"}]},"sourcePlan":{"anyOf":[{"type":"object","required":["createdAt","description","id","metadata","name","routeID","startsAt","status","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"routeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}},{"type":"null"}]},"sourceRevisionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceState":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["missing"]},{"type":"string","enum":["unchanged"]},{"type":"string","enum":["updated"]}]}}},"plan":{"type":"object","required":["createdAt","description","id","metadata","name","routeID","startsAt","status","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"routeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/route-plans/shared/{shareToken}/preferred-copy":{"post":{"summary":"Set preferred current-user copy for a shared route plan","tags":["route-plans"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["planID"],"properties":{"planID":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"shareToken","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["context"],"properties":{"context":{"type":"object","required":["availableActions","copyCount","preferredCopy","sourcePlan","sourceRevisionID","sourceState"],"properties":{"availableActions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["make_new_copy"]},{"type":"string","enum":["open_preferred_copy"]},{"type":"string","enum":["view_original"]}]}},"copyCount":{"type":"number"},"preferredCopy":{"anyOf":[{"type":"object","required":["createdAt","description","id","metadata","name","routeID","startsAt","status","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"routeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}},{"type":"null"}]},"sourcePlan":{"anyOf":[{"type":"object","required":["createdAt","description","id","metadata","name","routeID","startsAt","status","timezone","updatedAt"],"properties":{"createdAt":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"routeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]},{"type":"string","enum":["deleted"]}]},"timezone":{"type":"string"},"updatedAt":{"type":"string"}}},{"type":"null"}]},"sourceRevisionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceState":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["missing"]},{"type":"string","enum":["unchanged"]},{"type":"string","enum":["updated"]}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/import/routes":{"post":{"summary":"Queue a route import job","tags":["routes"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["contentText","source"],"properties":{"contentText":{"type":"string"},"filename":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"source":{"type":"string"}}}}}},"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["job"],"properties":{"job":{"type":"object","required":["createdAt","filename","format","id","lastError","metadata","result","scheduledFor","source","status","updatedAt"],"properties":{"createdAt":{"type":"string"},"filename":{"anyOf":[{"type":"string"},{"type":"null"}]},"format":{"anyOf":[{"type":"string","enum":["geojson"]},{"type":"string","enum":["gpx"]},{"type":"null"}]},"id":{"type":"string"},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"result":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"scheduledFor":{"type":"string"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/import/routes/jobs/{jobID}":{"get":{"summary":"Get a route import job","tags":["routes"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"jobID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["job"],"properties":{"job":{"type":"object","required":["createdAt","filename","format","id","lastError","metadata","result","scheduledFor","source","status","updatedAt"],"properties":{"createdAt":{"type":"string"},"filename":{"anyOf":[{"type":"string"},{"type":"null"}]},"format":{"anyOf":[{"type":"string","enum":["geojson"]},{"type":"string","enum":["gpx"]},{"type":"null"}]},"id":{"type":"string"},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"result":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"scheduledFor":{"type":"string"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"updatedAt":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/export/routes/{routeID}":{"post":{"summary":"Queue a route export job","tags":["routes"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["format"],"properties":{"format":{"anyOf":[{"type":"string","enum":["geojson"]},{"type":"string","enum":["gpx"]}]},"metadata":{"type":"object","additionalProperties":{}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"routeID","required":true}],"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["job"],"properties":{"job":{"type":"object","required":["artifact","createdAt","format","id","lastError","metadata","routeID","scheduledFor","status","updatedAt"],"properties":{"artifact":{"anyOf":[{"type":"object","required":["byteSize","checksumSHA256","contentType","downloadPath","filename","id"],"properties":{"byteSize":{"type":"number"},"checksumSHA256":{"type":"string"},"contentType":{"type":"string"},"downloadPath":{"type":"string"},"filename":{"type":"string"},"id":{"type":"string"}}},{"type":"null"}]},"createdAt":{"type":"string"},"format":{"anyOf":[{"type":"string","enum":["geojson"]},{"type":"string","enum":["gpx"]}]},"id":{"type":"string"},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"routeID":{"type":"string"},"scheduledFor":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/export/routes/jobs/{jobID}":{"get":{"summary":"Get a route export job","tags":["routes"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"jobID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["job"],"properties":{"job":{"type":"object","required":["artifact","createdAt","format","id","lastError","metadata","routeID","scheduledFor","status","updatedAt"],"properties":{"artifact":{"anyOf":[{"type":"object","required":["byteSize","checksumSHA256","contentType","downloadPath","filename","id"],"properties":{"byteSize":{"type":"number"},"checksumSHA256":{"type":"string"},"contentType":{"type":"string"},"downloadPath":{"type":"string"},"filename":{"type":"string"},"id":{"type":"string"}}},{"type":"null"}]},"createdAt":{"type":"string"},"format":{"anyOf":[{"type":"string","enum":["geojson"]},{"type":"string","enum":["gpx"]}]},"id":{"type":"string"},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"routeID":{"type":"string"},"scheduledFor":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"updatedAt":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/export/routes/jobs/{jobID}/download":{"get":{"summary":"Download a completed route export artifact","tags":["routes"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"jobID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"string"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/route-intelligence/routes/{routeID}/analysis":{"get":{"summary":"Get route analysis","tags":["route-intelligence"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"routeID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["analysis"],"properties":{"analysis":{"type":"object","required":["createdAt","distanceMeters","endLatitude","endLongitude","elevationGainMeters","exposureLevel","id","maxLatitude","maxLongitude","metadata","minLatitude","minLongitude","pointCount","readinessScore","routeID","safetySummary","startLatitude","startLongitude","status","terrainSummary","updatedAt"],"properties":{"createdAt":{"type":"string"},"distanceMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"endLatitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"endLongitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"elevationGainMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"exposureLevel":{"anyOf":[{"type":"string","enum":["extreme"]},{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["moderate"]},{"type":"string","enum":["unknown"]}]},"id":{"type":"string"},"maxLatitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"maxLongitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"minLatitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"minLongitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"pointCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"readinessScore":{"anyOf":[{"type":"number"},{"type":"null"}]},"routeID":{"type":"string"},"safetySummary":{"anyOf":[{"type":"string"},{"type":"null"}]},"startLatitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"startLongitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"terrainSummary":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Create or update route analysis","tags":["route-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"distanceMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"elevationGainMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"exposureLevel":{"anyOf":[{"type":"string","enum":["extreme"]},{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["moderate"]},{"type":"string","enum":["unknown"]}]},"metadata":{"type":"object","additionalProperties":{}},"readinessScore":{"anyOf":[{"type":"number"},{"type":"null"}]},"safetySummary":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"terrainSummary":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"routeID","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["analysis"],"properties":{"analysis":{"type":"object","required":["createdAt","distanceMeters","endLatitude","endLongitude","elevationGainMeters","exposureLevel","id","maxLatitude","maxLongitude","metadata","minLatitude","minLongitude","pointCount","readinessScore","routeID","safetySummary","startLatitude","startLongitude","status","terrainSummary","updatedAt"],"properties":{"createdAt":{"type":"string"},"distanceMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"endLatitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"endLongitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"elevationGainMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"exposureLevel":{"anyOf":[{"type":"string","enum":["extreme"]},{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["moderate"]},{"type":"string","enum":["unknown"]}]},"id":{"type":"string"},"maxLatitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"maxLongitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"minLatitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"minLongitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"pointCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"readinessScore":{"anyOf":[{"type":"number"},{"type":"null"}]},"routeID":{"type":"string"},"safetySummary":{"anyOf":[{"type":"string"},{"type":"null"}]},"startLatitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"startLongitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"terrainSummary":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/route-intelligence/route-plans/{planID}/readiness":{"get":{"summary":"Get route-plan readiness","tags":["route-intelligence"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"planID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["readiness"],"properties":{"readiness":{"type":"object","required":["blockers","createdAt","id","metadata","planID","readinessScore","status","updatedAt","warnings"],"properties":{"blockers":{"type":"array","items":{"type":"object","additionalProperties":{}}},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"planID":{"type":"string"},"readinessScore":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["blocked"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["needs_review"]},{"type":"string","enum":["ready"]}]},"updatedAt":{"type":"string"},"warnings":{"type":"array","items":{"type":"object","additionalProperties":{}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Create or update route-plan readiness","tags":["route-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"blockers":{"type":"array","items":{"type":"object","additionalProperties":{}}},"metadata":{"type":"object","additionalProperties":{}},"readinessScore":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["blocked"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["needs_review"]},{"type":"string","enum":["ready"]}]},"warnings":{"type":"array","items":{"type":"object","additionalProperties":{}}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"planID","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["readiness"],"properties":{"readiness":{"type":"object","required":["blockers","createdAt","id","metadata","planID","readinessScore","status","updatedAt","warnings"],"properties":{"blockers":{"type":"array","items":{"type":"object","additionalProperties":{}}},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"planID":{"type":"string"},"readinessScore":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["blocked"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["needs_review"]},{"type":"string","enum":["ready"]}]},"updatedAt":{"type":"string"},"warnings":{"type":"array","items":{"type":"object","additionalProperties":{}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/route-intelligence/jobs":{"get":{"summary":"List route-intelligence jobs","tags":["route-intelligence"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["jobs"],"properties":{"jobs":{"type":"array","items":{"type":"object","required":["attemptCount","createdAt","id","jobType","lastError","metadata","resourceID","resourceKind","scheduledFor","status","updatedAt"],"properties":{"attemptCount":{"type":"number"},"createdAt":{"type":"string"},"id":{"type":"string"},"jobType":{"anyOf":[{"type":"string","enum":["analysis"]},{"type":"string","enum":["readiness"]}]},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"resourceID":{"type":"string"},"resourceKind":{"anyOf":[{"type":"string","enum":["route"]},{"type":"string","enum":["route_plan"]}]},"scheduledFor":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"updatedAt":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Queue a route-intelligence job","tags":["route-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jobType","resourceID","resourceKind"],"properties":{"jobType":{"anyOf":[{"type":"string","enum":["analysis"]},{"type":"string","enum":["readiness"]}]},"metadata":{"type":"object","additionalProperties":{}},"resourceID":{"type":"string"},"resourceKind":{"anyOf":[{"type":"string","enum":["route"]},{"type":"string","enum":["route_plan"]}]},"scheduledFor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["job"],"properties":{"job":{"type":"object","required":["attemptCount","createdAt","id","jobType","lastError","metadata","resourceID","resourceKind","scheduledFor","status","updatedAt"],"properties":{"attemptCount":{"type":"number"},"createdAt":{"type":"string"},"id":{"type":"string"},"jobType":{"anyOf":[{"type":"string","enum":["analysis"]},{"type":"string","enum":["readiness"]}]},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"resourceID":{"type":"string"},"resourceKind":{"anyOf":[{"type":"string","enum":["route"]},{"type":"string","enum":["route_plan"]}]},"scheduledFor":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/route-intelligence/summary":{"get":{"summary":"Operator route-intelligence summary","tags":["operator","route-intelligence"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["summary"],"properties":{"summary":{"type":"object","required":["analyses","catalogs","jobs","readiness"],"properties":{"analyses":{"type":"object","required":["completedCount","failedCount","indexedCount","queuedCount","runningCount"],"properties":{"completedCount":{"type":"number"},"failedCount":{"type":"number"},"indexedCount":{"type":"number"},"queuedCount":{"type":"number"},"runningCount":{"type":"number"}}},"catalogs":{"type":"object","required":["popularRouteCount","skiAreaCount"],"properties":{"popularRouteCount":{"type":"number"},"skiAreaCount":{"type":"number"}}},"jobs":{"type":"object","required":["cancelledCount","completedCount","dueQueuedCount","failedCount","queuedCount","runningCount"],"properties":{"cancelledCount":{"type":"number"},"completedCount":{"type":"number"},"dueQueuedCount":{"type":"number"},"failedCount":{"type":"number"},"queuedCount":{"type":"number"},"runningCount":{"type":"number"}}},"readiness":{"type":"object","required":["blockedCount","needsReviewCount","readyCount"],"properties":{"blockedCount":{"type":"number"},"needsReviewCount":{"type":"number"},"readyCount":{"type":"number"}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/route-intelligence/catalog/ski-areas":{"get":{"summary":"Operator list route-intelligence ski areas","tags":["operator","route-intelligence"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"skiAreaID","required":false},{"schema":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["inactive"]}]},"in":"query","name":"status","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["skiAreas"],"properties":{"skiAreas":{"type":"array","items":{"type":"object","required":["country","createdAt","id","maxLatitude","maxLongitude","metadata","minLatitude","minLongitude","name","region","slug","status","updatedAt"],"properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"maxLatitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"maxLongitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"minLatitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"minLongitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"name":{"type":"string"},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"slug":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["inactive"]}]},"updatedAt":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/route-intelligence/catalog/popular-routes":{"get":{"summary":"Operator list route-intelligence popular routes","tags":["operator","route-intelligence"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"skiAreaID","required":false},{"schema":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["inactive"]}]},"in":"query","name":"status","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["popularRoutes"],"properties":{"popularRoutes":{"type":"array","items":{"type":"object","required":["createdAt","id","label","metadata","rank","routeID","skiAreaID","source","status","updatedAt"],"properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"label":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"rank":{"type":"number"},"routeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"skiAreaID":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["inactive"]}]},"updatedAt":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/user/friends":{"get":{"summary":"List current user social connections","tags":["social"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["connections"],"properties":{"connections":{"type":"array","items":{"type":"object","required":["addresseeUserID","createdAt","id","metadata","requesterUserID","sourceInviteID","status","updatedAt"],"properties":{"addresseeUserID":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"requesterUserID":{"type":"string"},"sourceInviteID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["accepted"]},{"type":"string","enum":["blocked"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["declined"]},{"type":"string","enum":["pending"]}]},"updatedAt":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/user/friends/requests":{"post":{"summary":"Create social connection request","tags":["social"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["addresseeUserID"],"properties":{"addresseeUserID":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["connection"],"properties":{"connection":{"type":"object","required":["addresseeUserID","createdAt","id","metadata","requesterUserID","sourceInviteID","status","updatedAt"],"properties":{"addresseeUserID":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"requesterUserID":{"type":"string"},"sourceInviteID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["accepted"]},{"type":"string","enum":["blocked"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["declined"]},{"type":"string","enum":["pending"]}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/user/friends/requests/{connectionID}":{"patch":{"summary":"Update social connection request","tags":["social"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["status"],"properties":{"metadata":{"type":"object","additionalProperties":{}},"status":{"anyOf":[{"type":"string","enum":["accepted"]},{"type":"string","enum":["blocked"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["declined"]},{"type":"string","enum":["pending"]}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"connectionID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["connection"],"properties":{"connection":{"type":"object","required":["addresseeUserID","createdAt","id","metadata","requesterUserID","sourceInviteID","status","updatedAt"],"properties":{"addresseeUserID":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"requesterUserID":{"type":"string"},"sourceInviteID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["accepted"]},{"type":"string","enum":["blocked"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["declined"]},{"type":"string","enum":["pending"]}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/user/friends/invites":{"get":{"summary":"List current user social invites","tags":["social"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["invites"],"properties":{"invites":{"type":"array","items":{"type":"object","required":["claimToken","claimedAt","claimedByUserID","createdAt","expiresAt","id","inviterUserID","metadata","recipientEmail","status","tokenPreview","updatedAt"],"properties":{"claimToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"expiresAt":{"type":"string"},"id":{"type":"string"},"inviterUserID":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["claimed"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["pending"]}]},"tokenPreview":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Create social invite","tags":["social"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expiresAt":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["invite"],"properties":{"invite":{"type":"object","required":["claimToken","claimedAt","claimedByUserID","createdAt","expiresAt","id","inviterUserID","metadata","recipientEmail","status","tokenPreview","updatedAt"],"properties":{"claimToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"expiresAt":{"type":"string"},"id":{"type":"string"},"inviterUserID":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["claimed"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["pending"]}]},"tokenPreview":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/user/friends/invites/{token}":{"get":{"summary":"Peek social invite","tags":["social"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"token","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["invite"],"properties":{"invite":{"type":"object","required":["claimToken","claimedAt","claimedByUserID","createdAt","expiresAt","id","inviterUserID","metadata","recipientEmail","status","tokenPreview","updatedAt"],"properties":{"claimToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"expiresAt":{"type":"string"},"id":{"type":"string"},"inviterUserID":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["claimed"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["pending"]}]},"tokenPreview":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/user/friends/invites/{token}/claim":{"post":{"summary":"Claim social invite","tags":["social"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["token"],"properties":{"token":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"token","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["connection","invite"],"properties":{"connection":{"type":"object","required":["addresseeUserID","createdAt","id","metadata","requesterUserID","sourceInviteID","status","updatedAt"],"properties":{"addresseeUserID":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"requesterUserID":{"type":"string"},"sourceInviteID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["accepted"]},{"type":"string","enum":["blocked"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["declined"]},{"type":"string","enum":["pending"]}]},"updatedAt":{"type":"string"}}},"invite":{"type":"object","required":["claimToken","claimedAt","claimedByUserID","createdAt","expiresAt","id","inviterUserID","metadata","recipientEmail","status","tokenPreview","updatedAt"],"properties":{"claimToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"expiresAt":{"type":"string"},"id":{"type":"string"},"inviterUserID":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["claimed"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["pending"]}]},"tokenPreview":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/user/friends/invites/claim":{"post":{"summary":"Claim social invite","tags":["social"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["token"],"properties":{"token":{"type":"string"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["connection","invite"],"properties":{"connection":{"type":"object","required":["addresseeUserID","createdAt","id","metadata","requesterUserID","sourceInviteID","status","updatedAt"],"properties":{"addresseeUserID":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"requesterUserID":{"type":"string"},"sourceInviteID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["accepted"]},{"type":"string","enum":["blocked"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["declined"]},{"type":"string","enum":["pending"]}]},"updatedAt":{"type":"string"}}},"invite":{"type":"object","required":["claimToken","claimedAt","claimedByUserID","createdAt","expiresAt","id","inviterUserID","metadata","recipientEmail","status","tokenPreview","updatedAt"],"properties":{"claimToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"expiresAt":{"type":"string"},"id":{"type":"string"},"inviterUserID":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["claimed"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["pending"]}]},"tokenPreview":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/user/friends/invites/{inviteID}":{"delete":{"summary":"Cancel social invite","tags":["social"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"inviteID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["cancelled"],"properties":{"cancelled":{"type":"boolean"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/trip-safety/sessions/{sessionID}":{"get":{"summary":"Get an operator trip safety session","tags":["operator","trip-safety"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"sessionID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["session"],"properties":{"session":{"type":"object","required":["contactIDs","createdAt","endedAt","expectedEndAt","id","lastHeartbeatAt","metadata","routePlanID","startedAt","startsAt","startForecastSnapshotID","status","title","updatedAt"],"properties":{"contactIDs":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"endedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expectedEndAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"lastHeartbeatAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"routePlanID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startForecastSnapshotID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["overdue"]},{"type":"string","enum":["planned"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/trip-safety/sessions/{sessionID}/evidence":{"get":{"summary":"Get operator trip safety evidence","tags":["operator","trip-safety"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"sessionID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["evidence"],"properties":{"evidence":{"type":"object","required":["decisions","debrief","escalationState","observations","rescuePackets"],"properties":{"decisions":{"type":"array","items":{"type":"object","required":["actorID","actorKind","createdAt","decidedAt","decisionType","id","metadata","reason","sessionID"],"properties":{"actorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"actorKind":{"anyOf":[{"type":"string","enum":["guardian"]},{"type":"string","enum":["operator"]},{"type":"string","enum":["system"]},{"type":"string","enum":["user"]}]},"createdAt":{"type":"string"},"decidedAt":{"type":"string"},"decisionType":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"reason":{"type":"string"},"sessionID":{"type":"string"}}}},"debrief":{"anyOf":[{"type":"object","required":["createdAt","id","metadata","notes","outcome","sessionID","updatedAt"],"properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"outcome":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["false_alarm"]},{"type":"string","enum":["incident"]},{"type":"string","enum":["safe"]},{"type":"string","enum":["unknown"]}]},"sessionID":{"type":"string"},"updatedAt":{"type":"string"}}},{"type":"null"}]},"escalationState":{"anyOf":[{"type":"object","required":["createdAt","lastEvaluatedAt","metadata","nextEvaluationAt","notificationCount","policy","sessionID","stage","updatedAt"],"properties":{"createdAt":{"type":"string"},"lastEvaluatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"nextEvaluationAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"notificationCount":{"type":"number"},"policy":{"type":"object","additionalProperties":{}},"sessionID":{"type":"string"},"stage":{"anyOf":[{"type":"string","enum":["contacted"]},{"type":"string","enum":["monitoring"]},{"type":"string","enum":["overdue"]},{"type":"string","enum":["resolved"]}]},"updatedAt":{"type":"string"}}},{"type":"null"}]},"observations":{"type":"array","items":{"type":"object","required":["createdAt","heartbeatID","id","latitude","longitude","message","metadata","observedAt","observationType","sessionID","severity","source"],"properties":{"createdAt":{"type":"string"},"heartbeatID":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"message":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"observedAt":{"type":"string"},"observationType":{"type":"string"},"sessionID":{"type":"string"},"severity":{"anyOf":[{"type":"string","enum":["critical"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"source":{"type":"string"}}}},"rescuePackets":{"type":"array","items":{"type":"object","required":["contentSHA256","createdAt","generatedAt","id","metadata","packetVersion","sessionID","snapshot","status","storageBucket","storageKey","summary"],"properties":{"contentSHA256":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"generatedAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"packetVersion":{"type":"number"},"sessionID":{"type":"string"},"snapshot":{"type":"object","additionalProperties":{}},"status":{"anyOf":[{"type":"string","enum":["generated"]},{"type":"string","enum":["superseded"]},{"type":"string","enum":["voided"]}]},"storageBucket":{"anyOf":[{"type":"string"},{"type":"null"}]},"storageKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"type":"string"}}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/trip-safety/contacts":{"get":{"summary":"List safety contacts","tags":["trip-safety"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["contacts"],"properties":{"contacts":{"type":"array","items":{"type":"object","required":["createdAt","email","id","metadata","name","phone","status","updatedAt"],"properties":{"createdAt":{"type":"string"},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]},{"type":"string","enum":["pending"]}]},"updatedAt":{"type":"string"}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Create a safety contact","tags":["trip-safety"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]},{"type":"string","enum":["pending"]}]}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["contact"],"properties":{"contact":{"type":"object","required":["createdAt","email","id","metadata","name","phone","status","updatedAt"],"properties":{"createdAt":{"type":"string"},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]},{"type":"string","enum":["pending"]}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/trip-safety/contacts/{contactID}":{"patch":{"summary":"Update a safety contact","tags":["trip-safety"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]},{"type":"string","enum":["pending"]}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"contactID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["contact"],"properties":{"contact":{"type":"object","required":["createdAt","email","id","metadata","name","phone","status","updatedAt"],"properties":{"createdAt":{"type":"string"},"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]},{"type":"string","enum":["pending"]}]},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"delete":{"summary":"Disable a safety contact","tags":["trip-safety"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"contactID","required":true}],"responses":{"204":{"description":"Default Response"},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/trip-safety/sessions":{"get":{"summary":"List trip safety sessions","tags":["trip-safety"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["sessions"],"properties":{"sessions":{"type":"array","items":{"type":"object","required":["contactIDs","createdAt","endedAt","expectedEndAt","id","lastHeartbeatAt","metadata","routePlanID","startedAt","startsAt","startForecastSnapshotID","status","title","updatedAt"],"properties":{"contactIDs":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"endedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expectedEndAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"lastHeartbeatAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"routePlanID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startForecastSnapshotID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["overdue"]},{"type":"string","enum":["planned"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Create a trip safety session","tags":["trip-safety"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title"],"properties":{"contactIDs":{"type":"array","items":{"type":"string"}},"expectedEndAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"routePlanID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["session"],"properties":{"session":{"type":"object","required":["contactIDs","createdAt","endedAt","expectedEndAt","id","lastHeartbeatAt","metadata","routePlanID","startedAt","startsAt","startForecastSnapshotID","status","title","updatedAt"],"properties":{"contactIDs":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"endedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expectedEndAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"lastHeartbeatAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"routePlanID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startForecastSnapshotID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["overdue"]},{"type":"string","enum":["planned"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/trip-safety/sessions/{sessionID}":{"get":{"summary":"Get a trip safety session","tags":["trip-safety"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"sessionID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["session"],"properties":{"session":{"type":"object","required":["contactIDs","createdAt","endedAt","expectedEndAt","id","lastHeartbeatAt","metadata","routePlanID","startedAt","startsAt","startForecastSnapshotID","status","title","updatedAt"],"properties":{"contactIDs":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"endedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expectedEndAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"lastHeartbeatAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"routePlanID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startForecastSnapshotID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["overdue"]},{"type":"string","enum":["planned"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/trip-safety/sessions/{sessionID}/start":{"post":{"summary":"Start a trip safety session","tags":["trip-safety"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"sessionID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["session"],"properties":{"session":{"type":"object","required":["contactIDs","createdAt","endedAt","expectedEndAt","id","lastHeartbeatAt","metadata","routePlanID","startedAt","startsAt","startForecastSnapshotID","status","title","updatedAt"],"properties":{"contactIDs":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"endedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expectedEndAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"lastHeartbeatAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"routePlanID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startForecastSnapshotID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["overdue"]},{"type":"string","enum":["planned"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/trip-safety/sessions/{sessionID}/heartbeat":{"post":{"summary":"Record a trip safety heartbeat","tags":["trip-safety"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accuracyMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"altitudeMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"batteryPercent":{"anyOf":[{"type":"number"},{"type":"null"}]},"headingDegrees":{"anyOf":[{"type":"number"},{"type":"null"}]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"message":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"recordedAt":{"type":"string"},"speedMetersPerSecond":{"anyOf":[{"type":"number"},{"type":"null"}]},"telemetryKind":{"type":"string"},"telemetrySource":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"sessionID","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["heartbeat"],"properties":{"heartbeat":{"type":"object","required":["accuracyMeters","altitudeMeters","batteryPercent","createdAt","headingDegrees","id","latitude","longitude","message","metadata","recordedAt","receivedAt","sessionID","speedMetersPerSecond","telemetryKind","telemetrySource"],"properties":{"accuracyMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"altitudeMeters":{"anyOf":[{"type":"number"},{"type":"null"}]},"batteryPercent":{"anyOf":[{"type":"number"},{"type":"null"}]},"createdAt":{"type":"string"},"headingDegrees":{"anyOf":[{"type":"number"},{"type":"null"}]},"id":{"type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"message":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"recordedAt":{"type":"string"},"receivedAt":{"type":"string"},"sessionID":{"type":"string"},"speedMetersPerSecond":{"anyOf":[{"type":"number"},{"type":"null"}]},"telemetryKind":{"type":"string"},"telemetrySource":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/trip-safety/sessions/{sessionID}/complete":{"post":{"summary":"Complete a trip safety session","tags":["trip-safety"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"sessionID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["session"],"properties":{"session":{"type":"object","required":["contactIDs","createdAt","endedAt","expectedEndAt","id","lastHeartbeatAt","metadata","routePlanID","startedAt","startsAt","startForecastSnapshotID","status","title","updatedAt"],"properties":{"contactIDs":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"endedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expectedEndAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"lastHeartbeatAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"routePlanID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startForecastSnapshotID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["overdue"]},{"type":"string","enum":["planned"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/trip-safety/sessions/{sessionID}/cancel":{"post":{"summary":"Cancel a trip safety session","tags":["trip-safety"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"sessionID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["session"],"properties":{"session":{"type":"object","required":["contactIDs","createdAt","endedAt","expectedEndAt","id","lastHeartbeatAt","metadata","routePlanID","startedAt","startsAt","startForecastSnapshotID","status","title","updatedAt"],"properties":{"contactIDs":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"endedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expectedEndAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"lastHeartbeatAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"routePlanID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startForecastSnapshotID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["overdue"]},{"type":"string","enum":["planned"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/trip-safety/sessions/{sessionID}/debrief":{"post":{"summary":"Create or update a trip safety debrief","tags":["trip-safety"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["outcome"],"properties":{"metadata":{"type":"object","additionalProperties":{}},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"outcome":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["false_alarm"]},{"type":"string","enum":["incident"]},{"type":"string","enum":["safe"]},{"type":"string","enum":["unknown"]}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"sessionID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["debrief"],"properties":{"debrief":{"type":"object","required":["createdAt","id","metadata","notes","outcome","sessionID","updatedAt"],"properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"outcome":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["false_alarm"]},{"type":"string","enum":["incident"]},{"type":"string","enum":["safe"]},{"type":"string","enum":["unknown"]}]},"sessionID":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/trip-safety/sessions/{sessionID}/guardian-token":{"post":{"summary":"Create a guardian status token","tags":["trip-safety"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"contactID":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"scopes":{"type":"array","items":{"type":"string"}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"sessionID","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["guardianToken"],"properties":{"guardianToken":{"type":"object","required":["contactID","createdAt","expiresAt","id","label","revokedAt","scopes","sessionID","token"],"properties":{"contactID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"scopes":{"type":"array","items":{"type":"string"}},"sessionID":{"type":"string"},"token":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/trip-safety/sessions/{sessionID}/share/resend":{"post":{"summary":"Resend trip status to attached safety contacts","tags":["trip-safety"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"sessionID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["deliveredContacts","guardianToken","notificationJobsQueued","shareURL","trip"],"properties":{"deliveredContacts":{"type":"number"},"guardianToken":{"type":"object","required":["contactID","createdAt","expiresAt","id","label","revokedAt","scopes","sessionID","token"],"properties":{"contactID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"scopes":{"type":"array","items":{"type":"string"}},"sessionID":{"type":"string"},"token":{"type":"string"}}},"notificationJobsQueued":{"type":"number"},"shareURL":{"type":"string"},"trip":{"type":"object","required":["contactIDs","createdAt","endedAt","expectedEndAt","id","lastHeartbeatAt","metadata","routePlanID","startedAt","startsAt","startForecastSnapshotID","status","title","updatedAt"],"properties":{"contactIDs":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"endedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expectedEndAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"lastHeartbeatAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"routePlanID":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startForecastSnapshotID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["overdue"]},{"type":"string","enum":["planned"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/trip-safety/public/{token}":{"get":{"summary":"Get public guardian trip status","tags":["trip-safety"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"token","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["trip"],"properties":{"trip":{"type":"object","required":["lastHeartbeatAt","sessionID","status","title"],"properties":{"lastHeartbeatAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"sessionID":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["overdue"]},{"type":"string","enum":["planned"]}]},"title":{"type":"string"}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/payments/catalog":{"get":{"summary":"List active payment catalog","tags":["payments"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["catalog"],"properties":{"catalog":{"type":"object","required":["prices","products"],"properties":{"prices":{"type":"array","items":{"type":"object","required":["createdAt","currency","id","interval","lookupKey","metadata","productID","status","unitAmountCents","updatedAt"],"properties":{"createdAt":{"type":"string"},"currency":{"type":"string"},"id":{"type":"string"},"interval":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["month"]},{"type":"string","enum":["year"]}]},"lookupKey":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"productID":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]}]},"unitAmountCents":{"type":"number"},"updatedAt":{"type":"string"}}}},"products":{"type":"array","items":{"type":"object","required":["createdAt","description","id","metadata","name","status","updatedAt"],"properties":{"createdAt":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]}]},"updatedAt":{"type":"string"}}}}}}}}}}}}}},"/api/user/entitlements":{"get":{"summary":"Get current user entitlements","tags":["payments"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["entitlements"],"properties":{"entitlements":{"type":"object","required":["activeUntil","features","plan","source","status","updatedAt","userID"],"properties":{"activeUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"features":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["inactive"]},{"type":"string","enum":["past_due"]},{"type":"string","enum":["trialing"]}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"userID":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/payments/membership":{"get":{"summary":"Get current user membership summary","tags":["payments"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["membership"],"properties":{"membership":{"type":"object","required":["buddyPasses","entitlements","giftMemberships","grants","providerSyncEvents"],"properties":{"buddyPasses":{"type":"array","items":{"type":"object","required":["benefitDurationDays","benefitPlan","createdAt","expiresAt","id","inviteTokenPreview","maxRedemptions","metadata","ownerUserID","promotionCodeID","providerCouponID","recipientEmail","recipientUserID","redeemCode","redeemedGrantID","revokedAt","sharedAt","source","sourceKey","status","timesRedeemed","updatedAt","valid"],"properties":{"benefitDurationDays":{"anyOf":[{"type":"number"},{"type":"null"}]},"benefitPlan":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"inviteTokenPreview":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxRedemptions":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"ownerUserID":{"type":"string"},"promotionCodeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerCouponID":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"redeemCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"redeemedGrantID":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"sharedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string"},"sourceKey":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["revoked"]},{"type":"string","enum":["shared"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["used"]}]},"timesRedeemed":{"anyOf":[{"type":"number"},{"type":"null"}]},"updatedAt":{"type":"string"},"valid":{"anyOf":[{"type":"boolean"},{"type":"null"}]}}}},"entitlements":{"type":"object","required":["activeUntil","features","plan","source","status","updatedAt","userID"],"properties":{"activeUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"features":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["inactive"]},{"type":"string","enum":["past_due"]},{"type":"string","enum":["trialing"]}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"userID":{"type":"string"}}},"giftMemberships":{"type":"array","items":{"type":"object","required":["claimedAt","createdAt","endsAt","fulfilledAt","id","inviteTokenPreview","metadata","plan","provider","providerCheckoutSessionID","providerCustomerID","providerSubscriptionID","providerTransactionID","purchaserNote","purchaserUserID","recipientEmail","recipientName","recipientUserID","redeemedGrantID","revokedAt","startsAt","status","updatedAt"],"properties":{"claimedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"fulfilledAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"inviteTokenPreview":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerCheckoutSessionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerCustomerID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerSubscriptionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerTransactionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"purchaserNote":{"anyOf":[{"type":"string"},{"type":"null"}]},"purchaserUserID":{"type":"string"},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientName":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"redeemedGrantID":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["claimed"]},{"type":"string","enum":["pending_payment"]},{"type":"string","enum":["revoked"]}]},"updatedAt":{"type":"string"}}}},"grants":{"type":"array","items":{"type":"object","required":["buddyPassID","createdAt","endsAt","giftMembershipID","grantedByUserID","id","kind","metadata","plan","provider","providerCustomerID","providerSubscriptionID","providerTransactionID","sourcePlatform","startsAt","status","updatedAt","userID"],"properties":{"buddyPassID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"giftMembershipID":{"anyOf":[{"type":"string"},{"type":"null"}]},"grantedByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["buddy_pass"]},{"type":"string","enum":["gift_membership"]},{"type":"string","enum":["lifetime_purchase"]},{"type":"string","enum":["manual"]},{"type":"string","enum":["provider_snapshot"]},{"type":"string","enum":["subscription"]}]},"metadata":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"provider":{"type":"string"},"providerCustomerID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerSubscriptionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerTransactionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourcePlatform":{"type":"string"},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["inactive"]},{"type":"string","enum":["past_due"]},{"type":"string","enum":["trialing"]}]},"updatedAt":{"type":"string"},"userID":{"type":"string"}}}},"providerSyncEvents":{"type":"array","items":{"type":"object","required":["createdAt","eventType","id","metadata","payload","processedAt","provider","providerEventID","status","userID"],"properties":{"createdAt":{"type":"string"},"eventType":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"payload":{"type":"object","additionalProperties":{}},"processedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider":{"type":"string"},"providerEventID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["applied"]},{"type":"string","enum":["received"]},{"type":"string","enum":["rejected"]},{"type":"string","enum":["skipped"]},{"type":"string","enum":["verified"]}]},"userID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/payments/checkout/session":{"post":{"summary":"Create payment checkout session intent","tags":["payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["priceID"],"properties":{"cancelURL":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"priceID":{"type":"string"},"successURL":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["checkoutSession"],"properties":{"checkoutSession":{"type":"object","required":["cancelURL","createdAt","id","metadata","mode","priceID","provider","providerSessionID","status","successURL","updatedAt","url","userID"],"properties":{"cancelURL":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"mode":{"anyOf":[{"type":"string","enum":["record_only"]},{"type":"string","enum":["stripe"]}]},"priceID":{"type":"string"},"provider":{"type":"string"},"providerSessionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["created"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["used"]}]},"successURL":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"userID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/payments/customer-portal/session":{"post":{"summary":"Create payment customer portal session intent","tags":["payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{}},"returnURL":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["portalSession"],"properties":{"portalSession":{"type":"object","required":["createdAt","id","metadata","provider","providerSessionID","returnURL","status","updatedAt","url","userID"],"properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"provider":{"type":"string"},"providerSessionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"returnURL":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["created"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["used"]}]},"updatedAt":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"userID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/payments/buddy-passes/{passID}/share":{"post":{"summary":"Share a buddy pass","tags":["payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"passID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["invite"],"properties":{"invite":{"type":"object","required":["inviteToken","pass"],"properties":{"inviteToken":{"type":"string"},"pass":{"type":"object","required":["benefitDurationDays","benefitPlan","createdAt","expiresAt","id","inviteTokenPreview","maxRedemptions","metadata","ownerUserID","promotionCodeID","providerCouponID","recipientEmail","recipientUserID","redeemCode","redeemedGrantID","revokedAt","sharedAt","source","sourceKey","status","timesRedeemed","updatedAt","valid"],"properties":{"benefitDurationDays":{"anyOf":[{"type":"number"},{"type":"null"}]},"benefitPlan":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"inviteTokenPreview":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxRedemptions":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"ownerUserID":{"type":"string"},"promotionCodeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerCouponID":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"redeemCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"redeemedGrantID":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"sharedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string"},"sourceKey":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["revoked"]},{"type":"string","enum":["shared"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["used"]}]},"timesRedeemed":{"anyOf":[{"type":"number"},{"type":"null"}]},"updatedAt":{"type":"string"},"valid":{"anyOf":[{"type":"boolean"},{"type":"null"}]}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/payments/buddy-passes/redeem":{"post":{"summary":"Redeem a buddy pass","tags":["payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["inviteToken"],"properties":{"inviteToken":{"type":"string"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["redemption"],"properties":{"redemption":{"type":"object","required":["entitlements","pass"],"properties":{"entitlements":{"type":"object","required":["activeUntil","features","plan","source","status","updatedAt","userID"],"properties":{"activeUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"features":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["inactive"]},{"type":"string","enum":["past_due"]},{"type":"string","enum":["trialing"]}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"userID":{"type":"string"}}},"pass":{"type":"object","required":["benefitDurationDays","benefitPlan","createdAt","expiresAt","id","inviteTokenPreview","maxRedemptions","metadata","ownerUserID","promotionCodeID","providerCouponID","recipientEmail","recipientUserID","redeemCode","redeemedGrantID","revokedAt","sharedAt","source","sourceKey","status","timesRedeemed","updatedAt","valid"],"properties":{"benefitDurationDays":{"anyOf":[{"type":"number"},{"type":"null"}]},"benefitPlan":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"inviteTokenPreview":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxRedemptions":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"ownerUserID":{"type":"string"},"promotionCodeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerCouponID":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"redeemCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"redeemedGrantID":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"sharedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string"},"sourceKey":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["revoked"]},{"type":"string","enum":["shared"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["used"]}]},"timesRedeemed":{"anyOf":[{"type":"number"},{"type":"null"}]},"updatedAt":{"type":"string"},"valid":{"anyOf":[{"type":"boolean"},{"type":"null"}]}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/payments/buddy-passes/{passID}/revoke":{"post":{"summary":"Revoke a buddy pass","tags":["payments"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"passID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["buddyPass"],"properties":{"buddyPass":{"type":"object","required":["benefitDurationDays","benefitPlan","createdAt","expiresAt","id","inviteTokenPreview","maxRedemptions","metadata","ownerUserID","promotionCodeID","providerCouponID","recipientEmail","recipientUserID","redeemCode","redeemedGrantID","revokedAt","sharedAt","source","sourceKey","status","timesRedeemed","updatedAt","valid"],"properties":{"benefitDurationDays":{"anyOf":[{"type":"number"},{"type":"null"}]},"benefitPlan":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"inviteTokenPreview":{"anyOf":[{"type":"string"},{"type":"null"}]},"maxRedemptions":{"anyOf":[{"type":"number"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"ownerUserID":{"type":"string"},"promotionCodeID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerCouponID":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"redeemCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"redeemedGrantID":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"sharedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string"},"sourceKey":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["revoked"]},{"type":"string","enum":["shared"]},{"type":"string","enum":["unknown"]},{"type":"string","enum":["used"]}]},"timesRedeemed":{"anyOf":[{"type":"number"},{"type":"null"}]},"updatedAt":{"type":"string"},"valid":{"anyOf":[{"type":"boolean"},{"type":"null"}]}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/payments/gift-memberships":{"post":{"summary":"Create a gift membership intent","tags":["payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["plan"],"properties":{"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"purchaserNote":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientName":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["giftMembership"],"properties":{"giftMembership":{"type":"object","required":["giftMembership","inviteToken"],"properties":{"giftMembership":{"type":"object","required":["claimedAt","createdAt","endsAt","fulfilledAt","id","inviteTokenPreview","metadata","plan","provider","providerCheckoutSessionID","providerCustomerID","providerSubscriptionID","providerTransactionID","purchaserNote","purchaserUserID","recipientEmail","recipientName","recipientUserID","redeemedGrantID","revokedAt","startsAt","status","updatedAt"],"properties":{"claimedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"fulfilledAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"inviteTokenPreview":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerCheckoutSessionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerCustomerID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerSubscriptionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerTransactionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"purchaserNote":{"anyOf":[{"type":"string"},{"type":"null"}]},"purchaserUserID":{"type":"string"},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientName":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"redeemedGrantID":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["claimed"]},{"type":"string","enum":["pending_payment"]},{"type":"string","enum":["revoked"]}]},"updatedAt":{"type":"string"}}},"inviteToken":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/payments/gift-memberships/claim":{"post":{"summary":"Claim a gift membership","tags":["payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["inviteToken"],"properties":{"inviteToken":{"type":"string"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["claim"],"properties":{"claim":{"type":"object","required":["entitlements","giftMembership"],"properties":{"entitlements":{"type":"object","required":["activeUntil","features","plan","source","status","updatedAt","userID"],"properties":{"activeUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"features":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["inactive"]},{"type":"string","enum":["past_due"]},{"type":"string","enum":["trialing"]}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"userID":{"type":"string"}}},"giftMembership":{"type":"object","required":["claimedAt","createdAt","endsAt","fulfilledAt","id","inviteTokenPreview","metadata","plan","provider","providerCheckoutSessionID","providerCustomerID","providerSubscriptionID","providerTransactionID","purchaserNote","purchaserUserID","recipientEmail","recipientName","recipientUserID","redeemedGrantID","revokedAt","startsAt","status","updatedAt"],"properties":{"claimedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"fulfilledAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"inviteTokenPreview":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerCheckoutSessionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerCustomerID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerSubscriptionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerTransactionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"purchaserNote":{"anyOf":[{"type":"string"},{"type":"null"}]},"purchaserUserID":{"type":"string"},"recipientEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientName":{"anyOf":[{"type":"string"},{"type":"null"}]},"recipientUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"redeemedGrantID":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["available"]},{"type":"string","enum":["claimed"]},{"type":"string","enum":["pending_payment"]},{"type":"string","enum":["revoked"]}]},"updatedAt":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/payments/app-store/account-token":{"post":{"summary":"Issue the current user's StoreKit app account token","tags":["payments"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["appStoreAccountToken"],"properties":{"appStoreAccountToken":{"type":"object","required":["createdAt","metadata","token","updatedAt","userID"],"properties":{"createdAt":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"token":{"type":"string"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/payments/app-store/transactions":{"post":{"summary":"Sync a verified App Store transaction","tags":["payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["signedTransactionInfo"],"properties":{"signedRenewalInfo":{"anyOf":[{"type":"string"},{"type":"null"}]},"signedTransactionInfo":{"type":"string"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["appStoreTransaction"],"properties":{"appStoreTransaction":{"type":"object","required":["entitlements","event","grant"],"properties":{"entitlements":{"type":"object","required":["activeUntil","features","plan","source","status","updatedAt","userID"],"properties":{"activeUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"features":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["inactive"]},{"type":"string","enum":["past_due"]},{"type":"string","enum":["trialing"]}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"userID":{"type":"string"}}},"event":{"type":"object","required":["createdAt","eventType","id","metadata","payload","processedAt","provider","providerEventID","status","userID"],"properties":{"createdAt":{"type":"string"},"eventType":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"payload":{"type":"object","additionalProperties":{}},"processedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider":{"type":"string"},"providerEventID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["applied"]},{"type":"string","enum":["received"]},{"type":"string","enum":["rejected"]},{"type":"string","enum":["skipped"]},{"type":"string","enum":["verified"]}]},"userID":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"grant":{"type":"object","required":["buddyPassID","createdAt","endsAt","giftMembershipID","grantedByUserID","id","kind","metadata","plan","provider","providerCustomerID","providerSubscriptionID","providerTransactionID","sourcePlatform","startsAt","status","updatedAt","userID"],"properties":{"buddyPassID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"giftMembershipID":{"anyOf":[{"type":"string"},{"type":"null"}]},"grantedByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["buddy_pass"]},{"type":"string","enum":["gift_membership"]},{"type":"string","enum":["lifetime_purchase"]},{"type":"string","enum":["manual"]},{"type":"string","enum":["provider_snapshot"]},{"type":"string","enum":["subscription"]}]},"metadata":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"provider":{"type":"string"},"providerCustomerID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerSubscriptionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerTransactionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourcePlatform":{"type":"string"},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["inactive"]},{"type":"string","enum":["past_due"]},{"type":"string","enum":["trialing"]}]},"updatedAt":{"type":"string"},"userID":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/payments/provider-sync/events":{"post":{"summary":"Record a payment provider sync event","tags":["payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["eventType","provider"],"properties":{"eventType":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"payload":{"type":"object","additionalProperties":{}},"provider":{"type":"string"},"providerEventID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["event"],"properties":{"event":{"type":"object","required":["createdAt","eventType","id","metadata","payload","processedAt","provider","providerEventID","status","userID"],"properties":{"createdAt":{"type":"string"},"eventType":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"payload":{"type":"object","additionalProperties":{}},"processedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider":{"type":"string"},"providerEventID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["applied"]},{"type":"string","enum":["received"]},{"type":"string","enum":["rejected"]},{"type":"string","enum":["skipped"]},{"type":"string","enum":["verified"]}]},"userID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/payments/webhooks/stripe":{"post":{"summary":"Capture Stripe webhook event","tags":["payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id","type"],"properties":{"data":{"type":"object","additionalProperties":{}},"id":{"type":"string"},"type":{"type":"string"}}}}}},"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["event"],"properties":{"event":{"type":"object","required":["createdAt","eventType","id","payload","processedAt","provider","providerEventID","status"],"properties":{"createdAt":{"type":"string"},"eventType":{"type":"string"},"id":{"type":"string"},"payload":{"type":"object","additionalProperties":{}},"processedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider":{"type":"string"},"providerEventID":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["processed"]},{"type":"string","enum":["received"]},{"type":"string","enum":["skipped"]}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/payments/webhooks/app-store":{"post":{"summary":"Capture App Store Server Notification","tags":["payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["signedPayload"],"properties":{"signedPayload":{"type":"string"}}}}}},"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["notification"],"properties":{"notification":{"type":"object","required":["entitlements","event","grant","notificationType","notificationUUID"],"properties":{"entitlements":{"anyOf":[{"type":"object","required":["activeUntil","features","plan","source","status","updatedAt","userID"],"properties":{"activeUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"features":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["inactive"]},{"type":"string","enum":["past_due"]},{"type":"string","enum":["trialing"]}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"userID":{"type":"string"}}},{"type":"null"}]},"event":{"type":"object","required":["createdAt","eventType","id","metadata","payload","processedAt","provider","providerEventID","status","userID"],"properties":{"createdAt":{"type":"string"},"eventType":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"payload":{"type":"object","additionalProperties":{}},"processedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider":{"type":"string"},"providerEventID":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["applied"]},{"type":"string","enum":["received"]},{"type":"string","enum":["rejected"]},{"type":"string","enum":["skipped"]},{"type":"string","enum":["verified"]}]},"userID":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"grant":{"anyOf":[{"type":"object","required":["buddyPassID","createdAt","endsAt","giftMembershipID","grantedByUserID","id","kind","metadata","plan","provider","providerCustomerID","providerSubscriptionID","providerTransactionID","sourcePlatform","startsAt","status","updatedAt","userID"],"properties":{"buddyPassID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"giftMembershipID":{"anyOf":[{"type":"string"},{"type":"null"}]},"grantedByUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["buddy_pass"]},{"type":"string","enum":["gift_membership"]},{"type":"string","enum":["lifetime_purchase"]},{"type":"string","enum":["manual"]},{"type":"string","enum":["provider_snapshot"]},{"type":"string","enum":["subscription"]}]},"metadata":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"provider":{"type":"string"},"providerCustomerID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerSubscriptionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerTransactionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourcePlatform":{"type":"string"},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["inactive"]},{"type":"string","enum":["past_due"]},{"type":"string","enum":["trialing"]}]},"updatedAt":{"type":"string"},"userID":{"type":"string"}}},{"type":"null"}]},"notificationType":{"type":"string"},"notificationUUID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/policy/runtime":{"get":{"summary":"Get current user policy runtime state","tags":["policy"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["entitlements","experiments","features","flags","surfaces"],"properties":{"entitlements":{"type":"object","required":["activeUntil","features","plan","source","status","updatedAt"],"properties":{"activeUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"features":{"type":"object","additionalProperties":{}},"plan":{"type":"string"},"source":{"type":"string"},"status":{"type":"string"},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"experiments":{"type":"object","additionalProperties":{"type":"string"}},"features":{"type":"object","additionalProperties":{}},"flags":{"type":"object","additionalProperties":{"type":"boolean"}},"surfaces":{"type":"array","items":{"type":"object","additionalProperties":{}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/policy/flags":{"get":{"summary":"Operator list feature flags","tags":["operator","policy"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"includeDisabled","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"prefix","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["flags"],"properties":{"flags":{"type":"array","items":{"type":"object","required":["audience","createdAt","createdByOperatorID","description","enabled","key","metadata","rolloutPercent","updatedAt","updatedByOperatorID"],"properties":{"audience":{"type":"object","properties":{"entitlementFeatures":{"type":"object","additionalProperties":{}},"plans":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"userIDs":{"type":"array","items":{"type":"string"}}}},"createdAt":{"type":"string"},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"enabled":{"type":"boolean"},"key":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"rolloutPercent":{"type":"number"},"updatedAt":{"type":"string"},"updatedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/policy/flags/{flagKey}":{"put":{"summary":"Operator upsert feature flag","tags":["operator","policy"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["enabled"],"properties":{"audience":{"type":"object","properties":{"entitlementFeatures":{"type":"object","additionalProperties":{}},"plans":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"userIDs":{"type":"array","items":{"type":"string"}}}},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"enabled":{"type":"boolean"},"metadata":{"type":"object","additionalProperties":{}},"rolloutPercent":{"type":"number"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"flagKey","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["flag"],"properties":{"flag":{"type":"object","required":["audience","createdAt","createdByOperatorID","description","enabled","key","metadata","rolloutPercent","updatedAt","updatedByOperatorID"],"properties":{"audience":{"type":"object","properties":{"entitlementFeatures":{"type":"object","additionalProperties":{}},"plans":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"userIDs":{"type":"array","items":{"type":"string"}}}},"createdAt":{"type":"string"},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"enabled":{"type":"boolean"},"key":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"rolloutPercent":{"type":"number"},"updatedAt":{"type":"string"},"updatedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/policy/experiments":{"get":{"summary":"Operator list experiments","tags":["operator","policy"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"includeCompleted","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"prefix","required":false},{"schema":{"anyOf":[{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["paused"]},{"type":"string","enum":["running"]}]},"in":"query","name":"status","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["experiments"],"properties":{"experiments":{"type":"array","items":{"type":"object","required":["allocationPercent","audience","createdAt","createdByOperatorID","key","metadata","status","updatedAt","updatedByOperatorID","variants"],"properties":{"allocationPercent":{"type":"number"},"audience":{"type":"object","properties":{"entitlementFeatures":{"type":"object","additionalProperties":{}},"plans":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"userIDs":{"type":"array","items":{"type":"string"}}}},"createdAt":{"type":"string"},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"key":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"status":{"anyOf":[{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["paused"]},{"type":"string","enum":["running"]}]},"updatedAt":{"type":"string"},"updatedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"variants":{"type":"array","items":{"type":"object","required":["key","metadata","weight"],"properties":{"key":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"weight":{"type":"number"}}}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/policy/experiments/{experimentKey}":{"put":{"summary":"Operator upsert experiment","tags":["operator","policy"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["status","variants"],"properties":{"allocationPercent":{"type":"number"},"audience":{"type":"object","properties":{"entitlementFeatures":{"type":"object","additionalProperties":{}},"plans":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"userIDs":{"type":"array","items":{"type":"string"}}}},"metadata":{"type":"object","additionalProperties":{}},"status":{"anyOf":[{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["paused"]},{"type":"string","enum":["running"]}]},"variants":{"type":"array","items":{"type":"object","required":["key","metadata","weight"],"properties":{"key":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"weight":{"type":"number"}}}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"experimentKey","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["experiment"],"properties":{"experiment":{"type":"object","required":["allocationPercent","audience","createdAt","createdByOperatorID","key","metadata","status","updatedAt","updatedByOperatorID","variants"],"properties":{"allocationPercent":{"type":"number"},"audience":{"type":"object","properties":{"entitlementFeatures":{"type":"object","additionalProperties":{}},"plans":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}},"userIDs":{"type":"array","items":{"type":"string"}}}},"createdAt":{"type":"string"},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"key":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"status":{"anyOf":[{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["paused"]},{"type":"string","enum":["running"]}]},"updatedAt":{"type":"string"},"updatedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"variants":{"type":"array","items":{"type":"object","required":["key","metadata","weight"],"properties":{"key":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"weight":{"type":"number"}}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/auth/session":{"get":{"summary":"Get current operator session","tags":["operator"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["isLogged"],"properties":{"isLogged":{"type":"boolean"},"operator":{"type":"object","required":["email","operatorID","role"],"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"operatorID":{"type":"string"},"role":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["support"]}]}}}}}}}}}}},"/api/operator/auth/sign-in":{"post":{"summary":"Sign in operator","tags":["operator"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","password"],"properties":{"email":{"type":"string"},"password":{"type":"string"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["expiresAt","operator"],"properties":{"expiresAt":{"type":"string"},"operator":{"type":"object","required":["email","operatorID","role"],"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"operatorID":{"type":"string"},"role":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["support"]}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/auth/sign-out":{"post":{"summary":"Sign out operator","tags":["operator"],"responses":{"204":{"description":"Default Response"}}}},"/api/support/cases":{"get":{"summary":"List current user support cases","tags":["support"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"assignedOperatorID","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"hasUnread","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"priority","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"userID","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["cases","pageInfo"],"properties":{"cases":{"type":"array","items":{"type":"object","required":["assignedOperatorID","body","createdAt","displayID","hasUnread","id","lastCustomerMessageAt","lastMessageAt","lastOperatorMessageAt","metadata","priority","status","subject","tags","unreadCount","updatedAt","userID"],"properties":{"assignedOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"createdAt":{"type":"string"},"displayID":{"type":"string"},"hasUnread":{"type":"boolean"},"id":{"type":"string"},"lastCustomerMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastOperatorMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["open"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["resolved"]}]},"subject":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"unreadCount":{"type":"number"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}}},"pageInfo":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Create support case","tags":["support"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body","subject"],"properties":{"body":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"subject":{"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["case"],"properties":{"case":{"type":"object","required":["assignedOperatorID","body","createdAt","displayID","hasUnread","id","lastCustomerMessageAt","lastMessageAt","lastOperatorMessageAt","metadata","priority","status","subject","tags","unreadCount","updatedAt","userID"],"properties":{"assignedOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"createdAt":{"type":"string"},"displayID":{"type":"string"},"hasUnread":{"type":"boolean"},"id":{"type":"string"},"lastCustomerMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastOperatorMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["open"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["resolved"]}]},"subject":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"unreadCount":{"type":"number"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/support/cases/{caseID}":{"get":{"summary":"Get support case","tags":["support"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"caseID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["case","messages"],"properties":{"case":{"type":"object","required":["assignedOperatorID","body","createdAt","displayID","hasUnread","id","lastCustomerMessageAt","lastMessageAt","lastOperatorMessageAt","metadata","priority","status","subject","tags","unreadCount","updatedAt","userID"],"properties":{"assignedOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"createdAt":{"type":"string"},"displayID":{"type":"string"},"hasUnread":{"type":"boolean"},"id":{"type":"string"},"lastCustomerMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastOperatorMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["open"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["resolved"]}]},"subject":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"unreadCount":{"type":"number"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}},"messages":{"type":"array","items":{"type":"object","required":["authorKind","authorUserID","body","caseID","createdAt","id","metadata","operatorID"],"properties":{"authorKind":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["system"]},{"type":"string","enum":["user"]}]},"authorUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"caseID":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"operatorID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/support/cases/{caseID}/messages":{"post":{"summary":"Add support case message","tags":["support"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body"],"properties":{"body":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"caseID","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"object","required":["authorKind","authorUserID","body","caseID","createdAt","id","metadata","operatorID"],"properties":{"authorKind":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["system"]},{"type":"string","enum":["user"]}]},"authorUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"caseID":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"operatorID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/support/cases/{caseID}/read":{"post":{"summary":"Mark current-user support case read","tags":["support"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"caseID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["readState"],"properties":{"readState":{"type":"object","required":["caseID","lastReadAt","lastReadMessageID","subjectID","subjectKind","updatedAt"],"properties":{"caseID":{"type":"string"},"lastReadAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastReadMessageID":{"anyOf":[{"type":"string"},{"type":"null"}]},"subjectID":{"type":"string"},"subjectKind":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["user"]}]},"updatedAt":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/support/cases":{"get":{"summary":"Operator list support cases","tags":["operator"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"assignedOperatorID","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"hasUnread","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"priority","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"userID","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["cases","pageInfo"],"properties":{"cases":{"type":"array","items":{"type":"object","required":["assignedOperatorID","body","createdAt","displayID","hasUnread","id","lastCustomerMessageAt","lastMessageAt","lastOperatorMessageAt","metadata","priority","status","subject","tags","unreadCount","updatedAt","userID"],"properties":{"assignedOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"createdAt":{"type":"string"},"displayID":{"type":"string"},"hasUnread":{"type":"boolean"},"id":{"type":"string"},"lastCustomerMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastOperatorMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["open"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["resolved"]}]},"subject":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"unreadCount":{"type":"number"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}}},"pageInfo":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Operator create support case for a user","tags":["operator"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body","subject","userID"],"properties":{"body":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"subject":{"type":"string"},"userID":{"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["case"],"properties":{"case":{"type":"object","required":["assignedOperatorID","body","createdAt","displayID","hasUnread","id","lastCustomerMessageAt","lastMessageAt","lastOperatorMessageAt","metadata","priority","status","subject","tags","unreadCount","updatedAt","userID"],"properties":{"assignedOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"createdAt":{"type":"string"},"displayID":{"type":"string"},"hasUnread":{"type":"boolean"},"id":{"type":"string"},"lastCustomerMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastOperatorMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["open"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["resolved"]}]},"subject":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"unreadCount":{"type":"number"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/support/cases/{caseID}":{"get":{"summary":"Operator get support case","tags":["operator"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"caseID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["case","messages"],"properties":{"case":{"type":"object","required":["assignedOperatorID","body","createdAt","displayID","hasUnread","id","lastCustomerMessageAt","lastMessageAt","lastOperatorMessageAt","metadata","priority","status","subject","tags","unreadCount","updatedAt","userID"],"properties":{"assignedOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"createdAt":{"type":"string"},"displayID":{"type":"string"},"hasUnread":{"type":"boolean"},"id":{"type":"string"},"lastCustomerMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastOperatorMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["open"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["resolved"]}]},"subject":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"unreadCount":{"type":"number"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}},"messages":{"type":"array","items":{"type":"object","required":["authorKind","authorUserID","body","caseID","createdAt","id","metadata","operatorID"],"properties":{"authorKind":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["system"]},{"type":"string","enum":["user"]}]},"authorUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"caseID":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"operatorID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"patch":{"summary":"Operator update support case","tags":["operator"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"assignedOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["open"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["resolved"]}]},"tags":{"type":"array","items":{"type":"string"}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"caseID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["case"],"properties":{"case":{"type":"object","required":["assignedOperatorID","body","createdAt","displayID","hasUnread","id","lastCustomerMessageAt","lastMessageAt","lastOperatorMessageAt","metadata","priority","status","subject","tags","unreadCount","updatedAt","userID"],"properties":{"assignedOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"createdAt":{"type":"string"},"displayID":{"type":"string"},"hasUnread":{"type":"boolean"},"id":{"type":"string"},"lastCustomerMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastOperatorMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["open"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["resolved"]}]},"subject":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"unreadCount":{"type":"number"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/support/cases/{caseID}/read":{"post":{"summary":"Operator mark support case read","tags":["operator"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"caseID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["readState"],"properties":{"readState":{"type":"object","required":["caseID","lastReadAt","lastReadMessageID","subjectID","subjectKind","updatedAt"],"properties":{"caseID":{"type":"string"},"lastReadAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastReadMessageID":{"anyOf":[{"type":"string"},{"type":"null"}]},"subjectID":{"type":"string"},"subjectKind":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["user"]}]},"updatedAt":{"type":"string"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/support/cases/{caseID}/actions":{"get":{"summary":"Operator list support case actions","tags":["operator"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"caseID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["actions"],"properties":{"actions":{"type":"array","items":{"type":"object","required":["actionType","createdAt","id","metadata","operatorID","resourceID","resourceKind","subjectUserID"],"properties":{"actionType":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"operatorID":{"type":"string"},"resourceID":{"type":"string"},"resourceKind":{"type":"string"},"subjectUserID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/support/cases/{caseID}/timeline":{"get":{"summary":"Operator get support case timeline","tags":["operator"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"caseID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["timeline"],"properties":{"timeline":{"type":"array","items":{"anyOf":[{"type":"object","required":["createdAt","id","kind","message"],"properties":{"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"type":"string","enum":["message"]},"message":{"type":"object","required":["authorKind","authorUserID","body","caseID","createdAt","id","metadata","operatorID"],"properties":{"authorKind":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["system"]},{"type":"string","enum":["user"]}]},"authorUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"caseID":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"operatorID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}},{"type":"object","required":["action","createdAt","id","kind"],"properties":{"action":{"type":"object","required":["actionType","createdAt","id","metadata","operatorID","resourceID","resourceKind","subjectUserID"],"properties":{"actionType":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"operatorID":{"type":"string"},"resourceID":{"type":"string"},"resourceKind":{"type":"string"},"subjectUserID":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"type":"string","enum":["action"]}}}]}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/support/cases/{caseID}/notes":{"post":{"summary":"Operator add support case note","tags":["operator"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body"],"properties":{"body":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"caseID","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"object","required":["authorKind","authorUserID","body","caseID","createdAt","id","metadata","operatorID"],"properties":{"authorKind":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["system"]},{"type":"string","enum":["user"]}]},"authorUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"caseID":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"operatorID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/support/cases/{caseID}/replies":{"post":{"summary":"Operator add customer-visible support case reply","tags":["operator"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body"],"properties":{"body":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"caseID","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"object","required":["authorKind","authorUserID","body","caseID","createdAt","id","metadata","operatorID"],"properties":{"authorKind":{"anyOf":[{"type":"string","enum":["operator"]},{"type":"string","enum":["system"]},{"type":"string","enum":["user"]}]},"authorUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"caseID":{"type":"string"},"createdAt":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"operatorID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/support/saved-replies":{"get":{"summary":"Operator list support saved replies","tags":["operator"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["replies"],"properties":{"replies":{"type":"array","items":{"type":"object","required":["body","createdAt","createdByOperatorID","id","metadata","status","tags","title","updatedAt","updatedByOperatorID"],"properties":{"body":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]}]},"tags":{"type":"array","items":{"type":"string"}},"title":{"type":"string"},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Operator create support saved reply","tags":["operator"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body","title"],"properties":{"body":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"tags":{"type":"array","items":{"type":"string"}},"title":{"type":"string"}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["reply"],"properties":{"reply":{"type":"object","required":["body","createdAt","createdByOperatorID","id","metadata","status","tags","title","updatedAt","updatedByOperatorID"],"properties":{"body":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]}]},"tags":{"type":"array","items":{"type":"string"}},"title":{"type":"string"},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/support/saved-replies/{replyID}":{"patch":{"summary":"Operator update support saved reply","tags":["operator"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"body":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]}]},"tags":{"type":"array","items":{"type":"string"}},"title":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"replyID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["reply"],"properties":{"reply":{"type":"object","required":["body","createdAt","createdByOperatorID","id","metadata","status","tags","title","updatedAt","updatedByOperatorID"],"properties":{"body":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]}]},"tags":{"type":"array","items":{"type":"string"}},"title":{"type":"string"},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/events":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/api/operator/users/{userID}/support-summary":{"get":{"summary":"Operator get user support summary","tags":["operator"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"userID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["summary"],"properties":{"summary":{"type":"object","required":["caseCounts","latestCases","user"],"properties":{"caseCounts":{"type":"object","additionalProperties":{"type":"number"}},"latestCases":{"type":"array","items":{"type":"object","required":["assignedOperatorID","body","createdAt","displayID","hasUnread","id","lastCustomerMessageAt","lastMessageAt","lastOperatorMessageAt","metadata","priority","status","subject","tags","unreadCount","updatedAt","userID"],"properties":{"assignedOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"createdAt":{"type":"string"},"displayID":{"type":"string"},"hasUnread":{"type":"boolean"},"id":{"type":"string"},"lastCustomerMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastOperatorMessageAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"priority":{"anyOf":[{"type":"string","enum":["high"]},{"type":"string","enum":["low"]},{"type":"string","enum":["normal"]},{"type":"string","enum":["urgent"]}]},"status":{"anyOf":[{"type":"string","enum":["closed"]},{"type":"string","enum":["open"]},{"type":"string","enum":["pending"]},{"type":"string","enum":["resolved"]}]},"subject":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"unreadCount":{"type":"number"},"updatedAt":{"type":"string"},"userID":{"type":"string"}}}},"user":{"type":"object","required":["email","name","status","userID"],"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]},{"type":"string","enum":["pending_deletion"]}]},"userID":{"type":"string"}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/integrations/jira/connection":{"get":{"summary":"Operator get managed Jira integration connection","tags":["operator","integrations"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["connection"],"properties":{"connection":{"type":"object","required":["authMode","authUsername","configured","createdAt","createdByOperatorID","defaultIssueType","defaultPriorityName","enabled","id","metadata","name","projectKey","provider","secret","siteUrl","source","status","updatedAt","updatedByOperatorID"],"properties":{"authMode":{"anyOf":[{"type":"string","enum":["basic"]},{"type":"string","enum":["bearer"]},{"type":"null"}]},"authUsername":{"anyOf":[{"type":"string"},{"type":"null"}]},"configured":{"type":"boolean"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultIssueType":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultPriorityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"enabled":{"type":"boolean"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"projectKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider":{"type":"string","enum":["jira"]},"secret":{"anyOf":[{"type":"object","required":["activeVersionID","lastRotatedAt","secretID","status","valueHint","versionCount"],"properties":{"activeVersionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastRotatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"secretID":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]},{"type":"string","enum":["archived"]}]},"valueHint":{"anyOf":[{"type":"string"},{"type":"null"}]},"versionCount":{"type":"number"}}},{"type":"null"}]},"siteUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["environment"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"put":{"summary":"Operator create or update managed Jira integration connection","tags":["operator","integrations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"auth":{"anyOf":[{"type":"object","required":["apiToken","email","mode","reason"],"properties":{"apiToken":{"type":"string"},"email":{"type":"string"},"mode":{"type":"string","enum":["basic"]},"reason":{"type":"string"}}},{"type":"object","required":["bearerToken","mode","reason"],"properties":{"bearerToken":{"type":"string"},"mode":{"type":"string","enum":["bearer"]},"reason":{"type":"string"}}}]},"defaultIssueType":{"type":"string"},"defaultPriorityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"enabled":{"type":"boolean"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"projectKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"siteUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["connection"],"properties":{"connection":{"type":"object","required":["authMode","authUsername","configured","createdAt","createdByOperatorID","defaultIssueType","defaultPriorityName","enabled","id","metadata","name","projectKey","provider","secret","siteUrl","source","status","updatedAt","updatedByOperatorID"],"properties":{"authMode":{"anyOf":[{"type":"string","enum":["basic"]},{"type":"string","enum":["bearer"]},{"type":"null"}]},"authUsername":{"anyOf":[{"type":"string"},{"type":"null"}]},"configured":{"type":"boolean"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultIssueType":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultPriorityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"enabled":{"type":"boolean"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"projectKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider":{"type":"string","enum":["jira"]},"secret":{"anyOf":[{"type":"object","required":["activeVersionID","lastRotatedAt","secretID","status","valueHint","versionCount"],"properties":{"activeVersionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastRotatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"secretID":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]},{"type":"string","enum":["archived"]}]},"valueHint":{"anyOf":[{"type":"string"},{"type":"null"}]},"versionCount":{"type":"number"}}},{"type":"null"}]},"siteUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["environment"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/integrations/jira/connection/test":{"post":{"summary":"Operator test current Jira integration connection","tags":["operator","integrations"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["result"],"properties":{"result":{"type":"object","required":["accountDisplayName","accountID","checkedAt","connection","ok"],"properties":{"accountDisplayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"accountID":{"anyOf":[{"type":"string"},{"type":"null"}]},"checkedAt":{"type":"string"},"connection":{"type":"object","required":["authMode","cloudID","configured","defaultIssueType","defaultPriorityName","enabled","id","name","projectKey","siteUrl","source","updatedAt"],"properties":{"authMode":{"anyOf":[{"type":"string","enum":["basic"]},{"type":"string","enum":["bearer"]},{"type":"null"}]},"cloudID":{"anyOf":[{"type":"string"},{"type":"null"}]},"configured":{"type":"boolean"},"defaultIssueType":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultPriorityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"enabled":{"type":"boolean"},"id":{"type":"string"},"name":{"type":"string"},"projectKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"siteUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string","enum":["environment"]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"ok":{"type":"boolean"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/integrations/jira/connection/credential":{"post":{"summary":"Operator replace managed Jira integration credential","tags":["operator","integrations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","required":["apiToken","email","mode","reason"],"properties":{"apiToken":{"type":"string"},"email":{"type":"string"},"mode":{"type":"string","enum":["basic"]},"reason":{"type":"string"}}},{"type":"object","required":["bearerToken","mode","reason"],"properties":{"bearerToken":{"type":"string"},"mode":{"type":"string","enum":["bearer"]},"reason":{"type":"string"}}}]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["connection"],"properties":{"connection":{"type":"object","required":["authMode","authUsername","configured","createdAt","createdByOperatorID","defaultIssueType","defaultPriorityName","enabled","id","metadata","name","projectKey","provider","secret","siteUrl","source","status","updatedAt","updatedByOperatorID"],"properties":{"authMode":{"anyOf":[{"type":"string","enum":["basic"]},{"type":"string","enum":["bearer"]},{"type":"null"}]},"authUsername":{"anyOf":[{"type":"string"},{"type":"null"}]},"configured":{"type":"boolean"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultIssueType":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultPriorityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"enabled":{"type":"boolean"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"projectKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider":{"type":"string","enum":["jira"]},"secret":{"anyOf":[{"type":"object","required":["activeVersionID","lastRotatedAt","secretID","status","valueHint","versionCount"],"properties":{"activeVersionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastRotatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"secretID":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]},{"type":"string","enum":["archived"]}]},"valueHint":{"anyOf":[{"type":"string"},{"type":"null"}]},"versionCount":{"type":"number"}}},{"type":"null"}]},"siteUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["environment"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/integrations/jira/connection/credential/revoke":{"post":{"summary":"Operator revoke managed Jira integration credential","tags":["operator","integrations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["reason"],"properties":{"disableConnection":{"type":"boolean"},"reason":{"type":"string"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["connection"],"properties":{"connection":{"type":"object","required":["authMode","authUsername","configured","createdAt","createdByOperatorID","defaultIssueType","defaultPriorityName","enabled","id","metadata","name","projectKey","provider","secret","siteUrl","source","status","updatedAt","updatedByOperatorID"],"properties":{"authMode":{"anyOf":[{"type":"string","enum":["basic"]},{"type":"string","enum":["bearer"]},{"type":"null"}]},"authUsername":{"anyOf":[{"type":"string"},{"type":"null"}]},"configured":{"type":"boolean"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultIssueType":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultPriorityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"enabled":{"type":"boolean"},"id":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"name":{"type":"string"},"projectKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider":{"type":"string","enum":["jira"]},"secret":{"anyOf":[{"type":"object","required":["activeVersionID","lastRotatedAt","secretID","status","valueHint","versionCount"],"properties":{"activeVersionID":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastRotatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"secretID":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]},{"type":"string","enum":["archived"]}]},"valueHint":{"anyOf":[{"type":"string"},{"type":"null"}]},"versionCount":{"type":"number"}}},{"type":"null"}]},"siteUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["environment"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["disabled"]}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/support/integrations/jira/status":{"get":{"summary":"Operator get Jira support integration status","tags":["operator","support","integrations"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["jira"],"properties":{"jira":{"type":"object","required":["capabilities","connection","linkedTicketCount","provider"],"properties":{"capabilities":{"type":"object","required":["createIssue","linkIssue","syncIssue","unlinkIssue"],"properties":{"createIssue":{"type":"boolean"},"linkIssue":{"type":"boolean"},"syncIssue":{"type":"boolean"},"unlinkIssue":{"type":"boolean"}}},"connection":{"type":"object","required":["authMode","cloudID","configured","defaultIssueType","defaultPriorityName","enabled","id","name","projectKey","siteUrl","source","updatedAt"],"properties":{"authMode":{"anyOf":[{"type":"string","enum":["basic"]},{"type":"string","enum":["bearer"]},{"type":"null"}]},"cloudID":{"anyOf":[{"type":"string"},{"type":"null"}]},"configured":{"type":"boolean"},"defaultIssueType":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultPriorityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"enabled":{"type":"boolean"},"id":{"type":"string"},"name":{"type":"string"},"projectKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"siteUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string","enum":["environment"]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"linkedTicketCount":{"type":"number"},"provider":{"type":"string","enum":["jira"]}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/support/integrations/jira/test":{"post":{"summary":"Operator test Jira support integration connection","tags":["operator","support","integrations"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["result"],"properties":{"result":{"type":"object","required":["accountDisplayName","accountID","checkedAt","connection","ok"],"properties":{"accountDisplayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"accountID":{"anyOf":[{"type":"string"},{"type":"null"}]},"checkedAt":{"type":"string"},"connection":{"type":"object","required":["authMode","cloudID","configured","defaultIssueType","defaultPriorityName","enabled","id","name","projectKey","siteUrl","source","updatedAt"],"properties":{"authMode":{"anyOf":[{"type":"string","enum":["basic"]},{"type":"string","enum":["bearer"]},{"type":"null"}]},"cloudID":{"anyOf":[{"type":"string"},{"type":"null"}]},"configured":{"type":"boolean"},"defaultIssueType":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultPriorityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"enabled":{"type":"boolean"},"id":{"type":"string"},"name":{"type":"string"},"projectKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"siteUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string","enum":["environment"]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"ok":{"type":"boolean"}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/support/cases/{caseID}/external-tickets":{"get":{"summary":"Operator list external tickets linked to a support case","tags":["operator","support","integrations"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"includeUnlinked","required":false},{"schema":{"type":"string"},"in":"path","name":"caseID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["tickets"],"properties":{"tickets":{"type":"array","items":{"type":"object","required":["assigneeAccountID","assigneeDisplayName","caseID","connectionID","createdAt","createdByOperatorID","externalIssueID","externalIssueKey","externalIssueURL","id","issueTypeName","lastSyncedAt","metadata","priorityName","projectKey","provider","reporterDisplayName","statusCategory","statusColor","statusName","summary","syncError","syncStatus","unlinkedAt","unlinkedByOperatorID","updatedAt","updatedByOperatorID"],"properties":{"assigneeAccountID":{"anyOf":[{"type":"string"},{"type":"null"}]},"assigneeDisplayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"caseID":{"type":"string"},"connectionID":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"externalIssueID":{"type":"string"},"externalIssueKey":{"type":"string"},"externalIssueURL":{"type":"string"},"id":{"type":"string"},"issueTypeName":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSyncedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"priorityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"projectKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider":{"type":"string","enum":["jira"]},"reporterDisplayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"statusCategory":{"anyOf":[{"type":"string"},{"type":"null"}]},"statusColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"statusName":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"type":"string"},"syncError":{"anyOf":[{"type":"string"},{"type":"null"}]},"syncStatus":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["sync_failed"]},{"type":"string","enum":["unlinked"]}]},"unlinkedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"unlinkedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/support/cases/{caseID}/jira-issues":{"post":{"summary":"Operator create and link a Jira issue for a support case","tags":["operator","support","integrations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":"string"},"issueType":{"type":"string"},"labels":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":{}},"priorityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"projectKey":{"type":"string"},"summary":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"caseID","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["ticket"],"properties":{"ticket":{"type":"object","required":["assigneeAccountID","assigneeDisplayName","caseID","connectionID","createdAt","createdByOperatorID","externalIssueID","externalIssueKey","externalIssueURL","id","issueTypeName","lastSyncedAt","metadata","priorityName","projectKey","provider","reporterDisplayName","statusCategory","statusColor","statusName","summary","syncError","syncStatus","unlinkedAt","unlinkedByOperatorID","updatedAt","updatedByOperatorID"],"properties":{"assigneeAccountID":{"anyOf":[{"type":"string"},{"type":"null"}]},"assigneeDisplayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"caseID":{"type":"string"},"connectionID":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"externalIssueID":{"type":"string"},"externalIssueKey":{"type":"string"},"externalIssueURL":{"type":"string"},"id":{"type":"string"},"issueTypeName":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSyncedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"priorityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"projectKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider":{"type":"string","enum":["jira"]},"reporterDisplayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"statusCategory":{"anyOf":[{"type":"string"},{"type":"null"}]},"statusColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"statusName":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"type":"string"},"syncError":{"anyOf":[{"type":"string"},{"type":"null"}]},"syncStatus":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["sync_failed"]},{"type":"string","enum":["unlinked"]}]},"unlinkedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"unlinkedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/support/cases/{caseID}/jira-issues/link":{"post":{"summary":"Operator link an existing Jira issue to a support case","tags":["operator","support","integrations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["issueKey"],"properties":{"issueKey":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"caseID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["ticket"],"properties":{"ticket":{"type":"object","required":["assigneeAccountID","assigneeDisplayName","caseID","connectionID","createdAt","createdByOperatorID","externalIssueID","externalIssueKey","externalIssueURL","id","issueTypeName","lastSyncedAt","metadata","priorityName","projectKey","provider","reporterDisplayName","statusCategory","statusColor","statusName","summary","syncError","syncStatus","unlinkedAt","unlinkedByOperatorID","updatedAt","updatedByOperatorID"],"properties":{"assigneeAccountID":{"anyOf":[{"type":"string"},{"type":"null"}]},"assigneeDisplayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"caseID":{"type":"string"},"connectionID":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"externalIssueID":{"type":"string"},"externalIssueKey":{"type":"string"},"externalIssueURL":{"type":"string"},"id":{"type":"string"},"issueTypeName":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSyncedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"priorityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"projectKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider":{"type":"string","enum":["jira"]},"reporterDisplayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"statusCategory":{"anyOf":[{"type":"string"},{"type":"null"}]},"statusColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"statusName":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"type":"string"},"syncError":{"anyOf":[{"type":"string"},{"type":"null"}]},"syncStatus":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["sync_failed"]},{"type":"string","enum":["unlinked"]}]},"unlinkedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"unlinkedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/support/cases/{caseID}/external-tickets/{ticketID}/sync":{"post":{"summary":"Operator sync support case external ticket from Jira","tags":["operator","support","integrations"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"caseID","required":true},{"schema":{"type":"string"},"in":"path","name":"ticketID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["ticket"],"properties":{"ticket":{"type":"object","required":["assigneeAccountID","assigneeDisplayName","caseID","connectionID","createdAt","createdByOperatorID","externalIssueID","externalIssueKey","externalIssueURL","id","issueTypeName","lastSyncedAt","metadata","priorityName","projectKey","provider","reporterDisplayName","statusCategory","statusColor","statusName","summary","syncError","syncStatus","unlinkedAt","unlinkedByOperatorID","updatedAt","updatedByOperatorID"],"properties":{"assigneeAccountID":{"anyOf":[{"type":"string"},{"type":"null"}]},"assigneeDisplayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"caseID":{"type":"string"},"connectionID":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"externalIssueID":{"type":"string"},"externalIssueKey":{"type":"string"},"externalIssueURL":{"type":"string"},"id":{"type":"string"},"issueTypeName":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSyncedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"priorityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"projectKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider":{"type":"string","enum":["jira"]},"reporterDisplayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"statusCategory":{"anyOf":[{"type":"string"},{"type":"null"}]},"statusColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"statusName":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"type":"string"},"syncError":{"anyOf":[{"type":"string"},{"type":"null"}]},"syncStatus":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["sync_failed"]},{"type":"string","enum":["unlinked"]}]},"unlinkedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"unlinkedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/support/cases/{caseID}/external-tickets/{ticketID}/unlink":{"post":{"summary":"Operator unlink external ticket from support case","tags":["operator","support","integrations"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"caseID","required":true},{"schema":{"type":"string"},"in":"path","name":"ticketID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["ticket"],"properties":{"ticket":{"type":"object","required":["assigneeAccountID","assigneeDisplayName","caseID","connectionID","createdAt","createdByOperatorID","externalIssueID","externalIssueKey","externalIssueURL","id","issueTypeName","lastSyncedAt","metadata","priorityName","projectKey","provider","reporterDisplayName","statusCategory","statusColor","statusName","summary","syncError","syncStatus","unlinkedAt","unlinkedByOperatorID","updatedAt","updatedByOperatorID"],"properties":{"assigneeAccountID":{"anyOf":[{"type":"string"},{"type":"null"}]},"assigneeDisplayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"caseID":{"type":"string"},"connectionID":{"type":"string"},"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"externalIssueID":{"type":"string"},"externalIssueKey":{"type":"string"},"externalIssueURL":{"type":"string"},"id":{"type":"string"},"issueTypeName":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSyncedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"priorityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"projectKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider":{"type":"string","enum":["jira"]},"reporterDisplayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"statusCategory":{"anyOf":[{"type":"string"},{"type":"null"}]},"statusColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"statusName":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"type":"string"},"syncError":{"anyOf":[{"type":"string"},{"type":"null"}]},"syncStatus":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["sync_failed"]},{"type":"string","enum":["unlinked"]}]},"unlinkedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"unlinkedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"},"updatedByOperatorID":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/maintenance/status":{"get":{"summary":"Get public maintenance status","tags":["maintenance"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["active","generatedAt","upcoming","workerPause","writeGate"],"properties":{"active":{"type":"array","items":{"type":"object","required":["affectedDomains","affectedSurfaces","blocksWrites","effectiveStatus","endsAt","id","message","pausesWorkers","retryAfterSeconds","scope","severity","startsAt","status","title","updatedAt","visibleTo"],"properties":{"affectedDomains":{"type":"array","items":{"type":"string"}},"affectedSurfaces":{"type":"array","items":{"type":"string"}},"blocksWrites":{"type":"boolean"},"effectiveStatus":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["scheduled"]}]},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"message":{"type":"string"},"pausesWorkers":{"type":"boolean"},"retryAfterSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["android"]},{"type":"string","enum":["api"]},{"type":"string","enum":["app"]},{"type":"string","enum":["domain"]},{"type":"string","enum":["global"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["public_web"]},{"type":"string","enum":["worker"]}]},"severity":{"anyOf":[{"type":"string","enum":["critical"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"startsAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["scheduled"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"visibleTo":{"anyOf":[{"type":"string","enum":["authenticated"]},{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]}]}}}},"generatedAt":{"type":"string"},"upcoming":{"type":"array","items":{"type":"object","required":["affectedDomains","affectedSurfaces","blocksWrites","effectiveStatus","endsAt","id","message","pausesWorkers","retryAfterSeconds","scope","severity","startsAt","status","title","updatedAt","visibleTo"],"properties":{"affectedDomains":{"type":"array","items":{"type":"string"}},"affectedSurfaces":{"type":"array","items":{"type":"string"}},"blocksWrites":{"type":"boolean"},"effectiveStatus":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["scheduled"]}]},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"message":{"type":"string"},"pausesWorkers":{"type":"boolean"},"retryAfterSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["android"]},{"type":"string","enum":["api"]},{"type":"string","enum":["app"]},{"type":"string","enum":["domain"]},{"type":"string","enum":["global"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["public_web"]},{"type":"string","enum":["worker"]}]},"severity":{"anyOf":[{"type":"string","enum":["critical"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"startsAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["scheduled"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"visibleTo":{"anyOf":[{"type":"string","enum":["authenticated"]},{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]}]}}}},"workerPause":{"type":"object","required":["active","windowIds"],"properties":{"active":{"type":"boolean"},"windowIds":{"type":"array","items":{"type":"string"}}}},"writeGate":{"type":"object","required":["active","retryAfterSeconds","windowIds"],"properties":{"active":{"type":"boolean"},"retryAfterSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"windowIds":{"type":"array","items":{"type":"string"}}}}}}}}}}}},"/api/operator/maintenance/status":{"get":{"summary":"Operator get maintenance status","tags":["operator","maintenance"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["active","generatedAt","upcoming","workerPause","writeGate"],"properties":{"active":{"type":"array","items":{"type":"object","required":["affectedDomains","affectedSurfaces","blocksWrites","effectiveStatus","endsAt","id","message","pausesWorkers","retryAfterSeconds","scope","severity","startsAt","status","title","updatedAt","visibleTo","activatedAt","cancelledAt","cancelledByOperatorID","completedAt","completedByOperatorID","createdAt","createdByOperatorEmail","createdByOperatorID","createdByOperatorRole","internalNotes","metadata","updatedByOperatorEmail","updatedByOperatorID","updatedByOperatorRole"],"properties":{"affectedDomains":{"type":"array","items":{"type":"string"}},"affectedSurfaces":{"type":"array","items":{"type":"string"}},"blocksWrites":{"type":"boolean"},"effectiveStatus":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["scheduled"]}]},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"message":{"type":"string"},"pausesWorkers":{"type":"boolean"},"retryAfterSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["android"]},{"type":"string","enum":["api"]},{"type":"string","enum":["app"]},{"type":"string","enum":["domain"]},{"type":"string","enum":["global"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["public_web"]},{"type":"string","enum":["worker"]}]},"severity":{"anyOf":[{"type":"string","enum":["critical"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"startsAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["scheduled"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"visibleTo":{"anyOf":[{"type":"string","enum":["authenticated"]},{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]}]},"activatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancelledAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancelledByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"createdByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByOperatorID":{"type":"string"},"createdByOperatorRole":{"type":"string"},"internalNotes":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"updatedByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedByOperatorID":{"type":"string"},"updatedByOperatorRole":{"type":"string"}}}},"generatedAt":{"type":"string"},"upcoming":{"type":"array","items":{"type":"object","required":["affectedDomains","affectedSurfaces","blocksWrites","effectiveStatus","endsAt","id","message","pausesWorkers","retryAfterSeconds","scope","severity","startsAt","status","title","updatedAt","visibleTo","activatedAt","cancelledAt","cancelledByOperatorID","completedAt","completedByOperatorID","createdAt","createdByOperatorEmail","createdByOperatorID","createdByOperatorRole","internalNotes","metadata","updatedByOperatorEmail","updatedByOperatorID","updatedByOperatorRole"],"properties":{"affectedDomains":{"type":"array","items":{"type":"string"}},"affectedSurfaces":{"type":"array","items":{"type":"string"}},"blocksWrites":{"type":"boolean"},"effectiveStatus":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["scheduled"]}]},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"message":{"type":"string"},"pausesWorkers":{"type":"boolean"},"retryAfterSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["android"]},{"type":"string","enum":["api"]},{"type":"string","enum":["app"]},{"type":"string","enum":["domain"]},{"type":"string","enum":["global"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["public_web"]},{"type":"string","enum":["worker"]}]},"severity":{"anyOf":[{"type":"string","enum":["critical"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"startsAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["scheduled"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"visibleTo":{"anyOf":[{"type":"string","enum":["authenticated"]},{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]}]},"activatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancelledAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancelledByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"createdByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByOperatorID":{"type":"string"},"createdByOperatorRole":{"type":"string"},"internalNotes":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"updatedByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedByOperatorID":{"type":"string"},"updatedByOperatorRole":{"type":"string"}}}},"workerPause":{"type":"object","required":["active","windowIds"],"properties":{"active":{"type":"boolean"},"windowIds":{"type":"array","items":{"type":"string"}}}},"writeGate":{"type":"object","required":["active","retryAfterSeconds","windowIds"],"properties":{"active":{"type":"boolean"},"retryAfterSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"windowIds":{"type":"array","items":{"type":"string"}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/maintenance/windows":{"get":{"summary":"Operator list maintenance windows","tags":["operator","maintenance"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"includeCancelled","required":false},{"schema":{"type":"string"},"in":"query","name":"includeCompleted","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["scheduled"]}]},"in":"query","name":"status","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["pageInfo","windows"],"properties":{"pageInfo":{"type":"object","required":["limit","nextCursor"],"properties":{"limit":{"type":"number"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"windows":{"type":"array","items":{"type":"object","required":["affectedDomains","affectedSurfaces","blocksWrites","effectiveStatus","endsAt","id","message","pausesWorkers","retryAfterSeconds","scope","severity","startsAt","status","title","updatedAt","visibleTo","activatedAt","cancelledAt","cancelledByOperatorID","completedAt","completedByOperatorID","createdAt","createdByOperatorEmail","createdByOperatorID","createdByOperatorRole","internalNotes","metadata","updatedByOperatorEmail","updatedByOperatorID","updatedByOperatorRole"],"properties":{"affectedDomains":{"type":"array","items":{"type":"string"}},"affectedSurfaces":{"type":"array","items":{"type":"string"}},"blocksWrites":{"type":"boolean"},"effectiveStatus":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["scheduled"]}]},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"message":{"type":"string"},"pausesWorkers":{"type":"boolean"},"retryAfterSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["android"]},{"type":"string","enum":["api"]},{"type":"string","enum":["app"]},{"type":"string","enum":["domain"]},{"type":"string","enum":["global"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["public_web"]},{"type":"string","enum":["worker"]}]},"severity":{"anyOf":[{"type":"string","enum":["critical"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"startsAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["scheduled"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"visibleTo":{"anyOf":[{"type":"string","enum":["authenticated"]},{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]}]},"activatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancelledAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancelledByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"createdByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByOperatorID":{"type":"string"},"createdByOperatorRole":{"type":"string"},"internalNotes":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"updatedByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedByOperatorID":{"type":"string"},"updatedByOperatorRole":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Operator create maintenance window","tags":["operator","maintenance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["message","title"],"properties":{"affectedDomains":{"type":"array","items":{"type":"string"}},"affectedSurfaces":{"type":"array","items":{"type":"string"}},"blocksWrites":{"type":"boolean"},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"internalNotes":{"anyOf":[{"type":"string"},{"type":"null"}]},"message":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"pausesWorkers":{"type":"boolean"},"retryAfterSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["android"]},{"type":"string","enum":["api"]},{"type":"string","enum":["app"]},{"type":"string","enum":["domain"]},{"type":"string","enum":["global"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["public_web"]},{"type":"string","enum":["worker"]}]},"severity":{"anyOf":[{"type":"string","enum":["critical"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"startsAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["scheduled"]}]},"title":{"type":"string"},"visibleTo":{"anyOf":[{"type":"string","enum":["authenticated"]},{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]}]}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["window"],"properties":{"window":{"type":"object","required":["affectedDomains","affectedSurfaces","blocksWrites","effectiveStatus","endsAt","id","message","pausesWorkers","retryAfterSeconds","scope","severity","startsAt","status","title","updatedAt","visibleTo","activatedAt","cancelledAt","cancelledByOperatorID","completedAt","completedByOperatorID","createdAt","createdByOperatorEmail","createdByOperatorID","createdByOperatorRole","internalNotes","metadata","updatedByOperatorEmail","updatedByOperatorID","updatedByOperatorRole"],"properties":{"affectedDomains":{"type":"array","items":{"type":"string"}},"affectedSurfaces":{"type":"array","items":{"type":"string"}},"blocksWrites":{"type":"boolean"},"effectiveStatus":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["scheduled"]}]},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"message":{"type":"string"},"pausesWorkers":{"type":"boolean"},"retryAfterSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["android"]},{"type":"string","enum":["api"]},{"type":"string","enum":["app"]},{"type":"string","enum":["domain"]},{"type":"string","enum":["global"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["public_web"]},{"type":"string","enum":["worker"]}]},"severity":{"anyOf":[{"type":"string","enum":["critical"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"startsAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["scheduled"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"visibleTo":{"anyOf":[{"type":"string","enum":["authenticated"]},{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]}]},"activatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancelledAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancelledByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"createdByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByOperatorID":{"type":"string"},"createdByOperatorRole":{"type":"string"},"internalNotes":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"updatedByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedByOperatorID":{"type":"string"},"updatedByOperatorRole":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/maintenance/windows/{windowID}":{"patch":{"summary":"Operator update maintenance window","tags":["operator","maintenance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"affectedDomains":{"type":"array","items":{"type":"string"}},"affectedSurfaces":{"type":"array","items":{"type":"string"}},"blocksWrites":{"type":"boolean"},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"internalNotes":{"anyOf":[{"type":"string"},{"type":"null"}]},"message":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"pausesWorkers":{"type":"boolean"},"retryAfterSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["android"]},{"type":"string","enum":["api"]},{"type":"string","enum":["app"]},{"type":"string","enum":["domain"]},{"type":"string","enum":["global"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["public_web"]},{"type":"string","enum":["worker"]}]},"severity":{"anyOf":[{"type":"string","enum":["critical"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"startsAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["scheduled"]}]},"title":{"type":"string"},"visibleTo":{"anyOf":[{"type":"string","enum":["authenticated"]},{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"windowID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["window"],"properties":{"window":{"type":"object","required":["affectedDomains","affectedSurfaces","blocksWrites","effectiveStatus","endsAt","id","message","pausesWorkers","retryAfterSeconds","scope","severity","startsAt","status","title","updatedAt","visibleTo","activatedAt","cancelledAt","cancelledByOperatorID","completedAt","completedByOperatorID","createdAt","createdByOperatorEmail","createdByOperatorID","createdByOperatorRole","internalNotes","metadata","updatedByOperatorEmail","updatedByOperatorID","updatedByOperatorRole"],"properties":{"affectedDomains":{"type":"array","items":{"type":"string"}},"affectedSurfaces":{"type":"array","items":{"type":"string"}},"blocksWrites":{"type":"boolean"},"effectiveStatus":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["scheduled"]}]},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"message":{"type":"string"},"pausesWorkers":{"type":"boolean"},"retryAfterSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["android"]},{"type":"string","enum":["api"]},{"type":"string","enum":["app"]},{"type":"string","enum":["domain"]},{"type":"string","enum":["global"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["public_web"]},{"type":"string","enum":["worker"]}]},"severity":{"anyOf":[{"type":"string","enum":["critical"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"startsAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["scheduled"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"visibleTo":{"anyOf":[{"type":"string","enum":["authenticated"]},{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]}]},"activatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancelledAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancelledByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"createdByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByOperatorID":{"type":"string"},"createdByOperatorRole":{"type":"string"},"internalNotes":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"updatedByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedByOperatorID":{"type":"string"},"updatedByOperatorRole":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/maintenance/windows/{windowID}/activate":{"post":{"summary":"Operator activate maintenance window","tags":["operator","maintenance"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"windowID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["window"],"properties":{"window":{"type":"object","required":["affectedDomains","affectedSurfaces","blocksWrites","effectiveStatus","endsAt","id","message","pausesWorkers","retryAfterSeconds","scope","severity","startsAt","status","title","updatedAt","visibleTo","activatedAt","cancelledAt","cancelledByOperatorID","completedAt","completedByOperatorID","createdAt","createdByOperatorEmail","createdByOperatorID","createdByOperatorRole","internalNotes","metadata","updatedByOperatorEmail","updatedByOperatorID","updatedByOperatorRole"],"properties":{"affectedDomains":{"type":"array","items":{"type":"string"}},"affectedSurfaces":{"type":"array","items":{"type":"string"}},"blocksWrites":{"type":"boolean"},"effectiveStatus":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["scheduled"]}]},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"message":{"type":"string"},"pausesWorkers":{"type":"boolean"},"retryAfterSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["android"]},{"type":"string","enum":["api"]},{"type":"string","enum":["app"]},{"type":"string","enum":["domain"]},{"type":"string","enum":["global"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["public_web"]},{"type":"string","enum":["worker"]}]},"severity":{"anyOf":[{"type":"string","enum":["critical"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"startsAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["scheduled"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"visibleTo":{"anyOf":[{"type":"string","enum":["authenticated"]},{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]}]},"activatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancelledAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancelledByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"createdByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByOperatorID":{"type":"string"},"createdByOperatorRole":{"type":"string"},"internalNotes":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"updatedByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedByOperatorID":{"type":"string"},"updatedByOperatorRole":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/maintenance/windows/{windowID}/cancel":{"post":{"summary":"Operator cancel maintenance window","tags":["operator","maintenance"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"windowID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["window"],"properties":{"window":{"type":"object","required":["affectedDomains","affectedSurfaces","blocksWrites","effectiveStatus","endsAt","id","message","pausesWorkers","retryAfterSeconds","scope","severity","startsAt","status","title","updatedAt","visibleTo","activatedAt","cancelledAt","cancelledByOperatorID","completedAt","completedByOperatorID","createdAt","createdByOperatorEmail","createdByOperatorID","createdByOperatorRole","internalNotes","metadata","updatedByOperatorEmail","updatedByOperatorID","updatedByOperatorRole"],"properties":{"affectedDomains":{"type":"array","items":{"type":"string"}},"affectedSurfaces":{"type":"array","items":{"type":"string"}},"blocksWrites":{"type":"boolean"},"effectiveStatus":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["scheduled"]}]},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"message":{"type":"string"},"pausesWorkers":{"type":"boolean"},"retryAfterSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["android"]},{"type":"string","enum":["api"]},{"type":"string","enum":["app"]},{"type":"string","enum":["domain"]},{"type":"string","enum":["global"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["public_web"]},{"type":"string","enum":["worker"]}]},"severity":{"anyOf":[{"type":"string","enum":["critical"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"startsAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["scheduled"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"visibleTo":{"anyOf":[{"type":"string","enum":["authenticated"]},{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]}]},"activatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancelledAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancelledByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"createdByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByOperatorID":{"type":"string"},"createdByOperatorRole":{"type":"string"},"internalNotes":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"updatedByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedByOperatorID":{"type":"string"},"updatedByOperatorRole":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/maintenance/windows/{windowID}/complete":{"post":{"summary":"Operator complete maintenance window","tags":["operator","maintenance"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"windowID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["window"],"properties":{"window":{"type":"object","required":["affectedDomains","affectedSurfaces","blocksWrites","effectiveStatus","endsAt","id","message","pausesWorkers","retryAfterSeconds","scope","severity","startsAt","status","title","updatedAt","visibleTo","activatedAt","cancelledAt","cancelledByOperatorID","completedAt","completedByOperatorID","createdAt","createdByOperatorEmail","createdByOperatorID","createdByOperatorRole","internalNotes","metadata","updatedByOperatorEmail","updatedByOperatorID","updatedByOperatorRole"],"properties":{"affectedDomains":{"type":"array","items":{"type":"string"}},"affectedSurfaces":{"type":"array","items":{"type":"string"}},"blocksWrites":{"type":"boolean"},"effectiveStatus":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["expired"]},{"type":"string","enum":["scheduled"]}]},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"message":{"type":"string"},"pausesWorkers":{"type":"boolean"},"retryAfterSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string","enum":["admin"]},{"type":"string","enum":["android"]},{"type":"string","enum":["api"]},{"type":"string","enum":["app"]},{"type":"string","enum":["domain"]},{"type":"string","enum":["global"]},{"type":"string","enum":["ios"]},{"type":"string","enum":["public_web"]},{"type":"string","enum":["worker"]}]},"severity":{"anyOf":[{"type":"string","enum":["critical"]},{"type":"string","enum":["info"]},{"type":"string","enum":["warning"]}]},"startsAt":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["draft"]},{"type":"string","enum":["scheduled"]}]},"title":{"type":"string"},"updatedAt":{"type":"string"},"visibleTo":{"anyOf":[{"type":"string","enum":["authenticated"]},{"type":"string","enum":["operator"]},{"type":"string","enum":["public"]}]},"activatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancelledAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancelledByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"createdByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdByOperatorID":{"type":"string"},"createdByOperatorRole":{"type":"string"},"internalNotes":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"updatedByOperatorEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedByOperatorID":{"type":"string"},"updatedByOperatorRole":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/admin/projections":{"get":{"summary":"Operator get Admin projections","tags":["operator","operations"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["projection"],"properties":{"projection":{"type":"object","required":["analytics","audit","content","evidence","generatedAt","jobs","notifications","payments","routeIntelligence","runtime","safety","support","users"],"properties":{"analytics":{"type":"object","required":["crashCount","diagnosticCount","errorDiagnosticCount","eventCount","latestDiagnosticAt","latestEventAt"],"properties":{"crashCount":{"type":"number"},"diagnosticCount":{"type":"number"},"errorDiagnosticCount":{"type":"number"},"eventCount":{"type":"number"},"latestDiagnosticAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestEventAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"audit":{"type":"object","required":["anchorCount","chainHeadPosition","eventCount","factPackCompletedCount","factPackFailedCount","factPackQueuedCount","factPackRunningCount","latestEventAt","recentEventCount"],"properties":{"anchorCount":{"type":"number"},"chainHeadPosition":{"type":"number"},"eventCount":{"type":"number"},"factPackCompletedCount":{"type":"number"},"factPackFailedCount":{"type":"number"},"factPackQueuedCount":{"type":"number"},"factPackRunningCount":{"type":"number"},"latestEventAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"recentEventCount":{"type":"number"}}},"content":{"type":"object","required":["documentCount","draftCount","latestPublishedAt","publishedCount","retiredCount"],"properties":{"documentCount":{"type":"number"},"draftCount":{"type":"number"},"latestPublishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedCount":{"type":"number"},"retiredCount":{"type":"number"}}},"evidence":{"type":"object","required":["byEvidenceKind","bySource","latestRecordedAt","linkedAuditEventCount","storedObjectCount","totalCount"],"properties":{"byEvidenceKind":{"type":"array","items":{"type":"object","required":["count","name"],"properties":{"count":{"type":"number"},"name":{"type":"string"}}}},"bySource":{"type":"array","items":{"type":"object","required":["count","name"],"properties":{"count":{"type":"number"},"name":{"type":"string"}}}},"latestRecordedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"linkedAuditEventCount":{"type":"number"},"storedObjectCount":{"type":"number"},"totalCount":{"type":"number"}}},"generatedAt":{"type":"string"},"jobs":{"type":"object","required":["byKind","queues","workflows"],"properties":{"byKind":{"type":"array","items":{"type":"object","required":["cancelledCount","completedCount","dueQueuedCount","failedCount","kind","queuedCount","runningCount","totalCount"],"properties":{"cancelledCount":{"type":"number"},"completedCount":{"type":"number"},"dueQueuedCount":{"type":"number"},"failedCount":{"type":"number"},"kind":{"anyOf":[{"type":"string","enum":["forecast_sync"]},{"type":"string","enum":["identity_auth_delivery"]},{"type":"string","enum":["media_processing"]},{"type":"string","enum":["messaging_notification"]},{"type":"string","enum":["recommendation"]},{"type":"string","enum":["route_export"]},{"type":"string","enum":["route_import"]},{"type":"string","enum":["route_intelligence"]},{"type":"string","enum":["trip_safety_notification"]}]},"queuedCount":{"type":"number"},"runningCount":{"type":"number"},"totalCount":{"type":"number"}}}},"queues":{"type":"object","required":["cancelledCount","completedCount","dueQueuedCount","failedCount","queuedCount","runningCount","totalCount"],"properties":{"cancelledCount":{"type":"number"},"completedCount":{"type":"number"},"dueQueuedCount":{"type":"number"},"failedCount":{"type":"number"},"queuedCount":{"type":"number"},"runningCount":{"type":"number"},"totalCount":{"type":"number"}}},"workflows":{"type":"object","required":["completedCount","failedCount","latestFinishedAt","latestStartedAt","runningCount","totalCount"],"properties":{"completedCount":{"type":"number"},"failedCount":{"type":"number"},"latestFinishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestStartedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"runningCount":{"type":"number"},"totalCount":{"type":"number"}}}}},"notifications":{"type":"object","required":["attemptCount","deferredAttemptCount","failedAttemptCount","messagingFailedCount","messagingQueuedCount","nextMessagingScheduledFor","nextTripSafetyScheduledFor","sentAttemptCount","skippedAttemptCount","terminalFailedAttemptCount","tripSafetyFailedCount","tripSafetyQueuedCount"],"properties":{"attemptCount":{"type":"number"},"deferredAttemptCount":{"type":"number"},"failedAttemptCount":{"type":"number"},"messagingFailedCount":{"type":"number"},"messagingQueuedCount":{"type":"number"},"nextMessagingScheduledFor":{"anyOf":[{"type":"string"},{"type":"null"}]},"nextTripSafetyScheduledFor":{"anyOf":[{"type":"string"},{"type":"null"}]},"sentAttemptCount":{"type":"number"},"skippedAttemptCount":{"type":"number"},"terminalFailedAttemptCount":{"type":"number"},"tripSafetyFailedCount":{"type":"number"},"tripSafetyQueuedCount":{"type":"number"}}},"payments":{"type":"object","required":["activeEntitlementCount","activeGrantCount","activeSubscriptionCount","availableGiftMembershipCount","availableSharedBuddyPassCount","claimedGiftMembershipCount","latestProviderSyncAt","pendingWebhookCount","proEntitlementCount","providerSyncEventCount","reconciliationRunCount"],"properties":{"activeEntitlementCount":{"type":"number"},"activeGrantCount":{"type":"number"},"activeSubscriptionCount":{"type":"number"},"availableGiftMembershipCount":{"type":"number"},"availableSharedBuddyPassCount":{"type":"number"},"claimedGiftMembershipCount":{"type":"number"},"latestProviderSyncAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"pendingWebhookCount":{"type":"number"},"proEntitlementCount":{"type":"number"},"providerSyncEventCount":{"type":"number"},"reconciliationRunCount":{"type":"number"}}},"routeIntelligence":{"type":"object","required":["activePopularRouteCount","activeSkiAreaCount","analysisCompletedCount","analysisFailedCount","analysisIndexedCount","analysisQueuedCount","analysisRunningCount","jobDueQueuedCount","jobFailedCount","jobQueuedCount","jobRunningCount","readinessBlockedCount","readinessNeedsReviewCount","readinessReadyCount"],"properties":{"activePopularRouteCount":{"type":"number"},"activeSkiAreaCount":{"type":"number"},"analysisCompletedCount":{"type":"number"},"analysisFailedCount":{"type":"number"},"analysisIndexedCount":{"type":"number"},"analysisQueuedCount":{"type":"number"},"analysisRunningCount":{"type":"number"},"jobDueQueuedCount":{"type":"number"},"jobFailedCount":{"type":"number"},"jobQueuedCount":{"type":"number"},"jobRunningCount":{"type":"number"},"readinessBlockedCount":{"type":"number"},"readinessNeedsReviewCount":{"type":"number"},"readinessReadyCount":{"type":"number"}}},"runtime":{"type":"object","required":["apiHeartbeatCount","heartbeatCount","latestIncidentAt","latestSeenAt","openCriticalIncidentCount","openIncidentCount","recentIncidentCount","staleHeartbeatCount","workerHeartbeatCount"],"properties":{"apiHeartbeatCount":{"type":"number"},"heartbeatCount":{"type":"number"},"latestIncidentAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"latestSeenAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"openCriticalIncidentCount":{"type":"number"},"openIncidentCount":{"type":"number"},"recentIncidentCount":{"type":"number"},"staleHeartbeatCount":{"type":"number"},"workerHeartbeatCount":{"type":"number"}}},"safety":{"type":"object","required":["activeSessionCount","completedSessionCount","criticalObservationCount","latestHeartbeatAt","openEscalationCount","overdueSessionCount","rescuePacketCount","sessionCount"],"properties":{"activeSessionCount":{"type":"number"},"completedSessionCount":{"type":"number"},"criticalObservationCount":{"type":"number"},"latestHeartbeatAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"openEscalationCount":{"type":"number"},"overdueSessionCount":{"type":"number"},"rescuePacketCount":{"type":"number"},"sessionCount":{"type":"number"}}},"support":{"type":"object","required":["closedCaseCount","highPriorityCaseCount","latestCaseAt","openCaseCount","pendingCaseCount","resolvedCaseCount","totalCaseCount","urgentCaseCount"],"properties":{"closedCaseCount":{"type":"number"},"highPriorityCaseCount":{"type":"number"},"latestCaseAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"openCaseCount":{"type":"number"},"pendingCaseCount":{"type":"number"},"resolvedCaseCount":{"type":"number"},"totalCaseCount":{"type":"number"},"urgentCaseCount":{"type":"number"}}},"users":{"type":"object","required":["activeCount","disabledCount","legacyMigratedCount","legalAcceptanceCount","pendingDeletionCount","pendingDeletionRequestCount","profileCount","totalCount"],"properties":{"activeCount":{"type":"number"},"disabledCount":{"type":"number"},"legacyMigratedCount":{"type":"number"},"legalAcceptanceCount":{"type":"number"},"pendingDeletionCount":{"type":"number"},"pendingDeletionRequestCount":{"type":"number"},"profileCount":{"type":"number"},"totalCount":{"type":"number"}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/provider-readiness":{"get":{"summary":"Operator get provider readiness","tags":["operator","operations"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["readiness"],"properties":{"readiness":{"type":"object","required":["generatedAt","items"],"properties":{"generatedAt":{"type":"string"},"items":{"type":"array","items":{"type":"object","required":["activationHeld","capability","category","checks","configured","notes","provider","status"],"properties":{"activationHeld":{"type":"boolean"},"capability":{"type":"string"},"category":{"type":"string"},"checks":{"type":"array","items":{"type":"object","required":["detail","name","status"],"properties":{"detail":{"type":"string"},"name":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["deferred"]},{"type":"string","enum":["missing"]},{"type":"string","enum":["pass"]}]}}}},"configured":{"type":"boolean"},"notes":{"type":"array","items":{"type":"string"}},"provider":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["blocked"]},{"type":"string","enum":["deferred"]},{"type":"string","enum":["inactive"]},{"type":"string","enum":["ready"]}]}}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/audit-events":{"get":{"summary":"Operator list audit events","tags":["operator","operations"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"actorOperatorID","required":false},{"schema":{"type":"string"},"in":"query","name":"actorUserID","required":false},{"schema":{"type":"string"},"in":"query","name":"eventType","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"anyOf":[{"type":"string","enum":["availability"]},{"type":"string","enum":["forecasts"]},{"type":"string","enum":["identity"]},{"type":"string","enum":["matching"]},{"type":"string","enum":["media_processing"]},{"type":"string","enum":["messaging"]},{"type":"string","enum":["notes"]},{"type":"string","enum":["operations"]},{"type":"string","enum":["payments"]},{"type":"string","enum":["profiles"]},{"type":"string","enum":["recommendations"]},{"type":"string","enum":["route_intelligence"]},{"type":"string","enum":["routes"]},{"type":"string","enum":["social"]},{"type":"string","enum":["support"]},{"type":"string","enum":["trip_safety"]}]},"in":"query","name":"module","required":false},{"schema":{"type":"string"},"in":"query","name":"requestID","required":false},{"schema":{"type":"string"},"in":"query","name":"resourceID","required":false},{"schema":{"type":"string"},"in":"query","name":"subjectUserID","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["events"],"properties":{"events":{"type":"array","items":{"type":"object","required":["actorOperatorID","actorUserID","createdAt","eventType","id","ipAddress","metadata","module","requestID","resourceID","subjectUserID"],"properties":{"actorOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"actorUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"eventType":{"type":"string"},"id":{"type":"string"},"ipAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"module":{"anyOf":[{"type":"string","enum":["availability"]},{"type":"string","enum":["forecasts"]},{"type":"string","enum":["identity"]},{"type":"string","enum":["matching"]},{"type":"string","enum":["media_processing"]},{"type":"string","enum":["messaging"]},{"type":"string","enum":["notes"]},{"type":"string","enum":["operations"]},{"type":"string","enum":["payments"]},{"type":"string","enum":["profiles"]},{"type":"string","enum":["recommendations"]},{"type":"string","enum":["route_intelligence"]},{"type":"string","enum":["routes"]},{"type":"string","enum":["social"]},{"type":"string","enum":["support"]},{"type":"string","enum":["trip_safety"]}]},"requestID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"subjectUserID":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/legal-holds":{"get":{"summary":"Operator list legal holds","tags":["operator","operations"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"includeReleased","required":false},{"schema":{"type":"string"},"in":"query","name":"incidentID","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"subjectUserID","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["holds"],"properties":{"holds":{"type":"array","items":{"type":"object","required":["createdAt","createdByOperatorID","id","incidentID","reason","releasedAt","releasedByOperatorID","subjectUserID","windowEnd","windowStart"],"properties":{"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"id":{"type":"string"},"incidentID":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"type":"string"},"releasedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"releasedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"subjectUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"windowEnd":{"anyOf":[{"type":"string"},{"type":"null"}]},"windowStart":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Operator create legal hold","tags":["operator","operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["reason"],"properties":{"incidentID":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"type":"string"},"subjectUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"windowEnd":{"anyOf":[{"type":"string"},{"type":"null"}]},"windowStart":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["hold"],"properties":{"hold":{"type":"object","required":["createdAt","createdByOperatorID","id","incidentID","reason","releasedAt","releasedByOperatorID","subjectUserID","windowEnd","windowStart"],"properties":{"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"id":{"type":"string"},"incidentID":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"type":"string"},"releasedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"releasedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"subjectUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"windowEnd":{"anyOf":[{"type":"string"},{"type":"null"}]},"windowStart":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/legal-holds/{holdID}/release":{"post":{"summary":"Operator release legal hold","tags":["operator","operations"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"holdID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["hold"],"properties":{"hold":{"type":"object","required":["createdAt","createdByOperatorID","id","incidentID","reason","releasedAt","releasedByOperatorID","subjectUserID","windowEnd","windowStart"],"properties":{"createdAt":{"type":"string"},"createdByOperatorID":{"type":"string"},"id":{"type":"string"},"incidentID":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"type":"string"},"releasedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"releasedByOperatorID":{"anyOf":[{"type":"string"},{"type":"null"}]},"subjectUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"windowEnd":{"anyOf":[{"type":"string"},{"type":"null"}]},"windowStart":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/fact-packs":{"post":{"summary":"Operator request fact pack","tags":["operator","operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["reason","subject_user_id","window_end","window_start"],"properties":{"include":{"type":"array","items":{"anyOf":[{"type":"string","enum":["audit_events"]},{"type":"string","enum":["evidence_records"]},{"type":"string","enum":["heartbeats"]},{"type":"string","enum":["notifications"]},{"type":"string","enum":["forecasts_exposed"]},{"type":"string","enum":["legal_acceptances"]},{"type":"string","enum":["active_docs"]}]}},"reason":{"type":"string"},"subject_user_id":{"type":"string"},"window_end":{"type":"string"},"window_start":{"type":"string"}}}}}},"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["job_id","status"],"properties":{"job_id":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/fact-packs/{jobID}":{"get":{"summary":"Operator get fact pack","tags":["operator","operations"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"jobID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["archive_sha256","created_at","download_url","job_id","signature","status"],"properties":{"archive_sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"job_id":{"type":"string"},"signature":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/fact-packs/{jobID}/download":{"get":{"summary":"Operator download fact pack","tags":["operator","operations"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"jobID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"string"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/jobs/summary":{"get":{"summary":"Operator get job summaries","tags":["operator","operations"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["summaries"],"properties":{"summaries":{"type":"array","items":{"type":"object","required":["cancelledCount","completedCount","dueQueuedCount","failedCount","kind","queuedCount","runningCount","totalCount"],"properties":{"cancelledCount":{"type":"number"},"completedCount":{"type":"number"},"dueQueuedCount":{"type":"number"},"failedCount":{"type":"number"},"kind":{"anyOf":[{"type":"string","enum":["forecast_sync"]},{"type":"string","enum":["identity_auth_delivery"]},{"type":"string","enum":["media_processing"]},{"type":"string","enum":["messaging_notification"]},{"type":"string","enum":["recommendation"]},{"type":"string","enum":["route_export"]},{"type":"string","enum":["route_import"]},{"type":"string","enum":["route_intelligence"]},{"type":"string","enum":["trip_safety_notification"]}]},"queuedCount":{"type":"number"},"runningCount":{"type":"number"},"totalCount":{"type":"number"}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/jobs":{"get":{"summary":"Operator list jobs","tags":["operator","operations"],"parameters":[{"schema":{"anyOf":[{"type":"string","enum":["forecast_sync"]},{"type":"string","enum":["identity_auth_delivery"]},{"type":"string","enum":["media_processing"]},{"type":"string","enum":["messaging_notification"]},{"type":"string","enum":["recommendation"]},{"type":"string","enum":["route_export"]},{"type":"string","enum":["route_import"]},{"type":"string","enum":["route_intelligence"]},{"type":"string","enum":["trip_safety_notification"]}]},"in":"query","name":"kind","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"ownerUserID","required":false},{"schema":{"type":"string"},"in":"query","name":"resourceID","required":false},{"schema":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"in":"query","name":"status","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["jobs"],"properties":{"jobs":{"type":"array","items":{"type":"object","required":["attemptCount","createdAt","id","kind","lastError","metadata","ownerUserID","resourceID","resourceKind","result","scheduledFor","source","status","type","updatedAt"],"properties":{"attemptCount":{"type":"number"},"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["forecast_sync"]},{"type":"string","enum":["identity_auth_delivery"]},{"type":"string","enum":["media_processing"]},{"type":"string","enum":["messaging_notification"]},{"type":"string","enum":["recommendation"]},{"type":"string","enum":["route_export"]},{"type":"string","enum":["route_import"]},{"type":"string","enum":["route_intelligence"]},{"type":"string","enum":["trip_safety_notification"]}]},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"ownerUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"result":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"scheduledFor":{"type":"string"},"source":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"type":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/jobs/{jobKind}/{jobID}":{"get":{"summary":"Operator get job","tags":["operator","operations"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"jobKind","required":true},{"schema":{"type":"string"},"in":"path","name":"jobID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["job"],"properties":{"job":{"type":"object","required":["attemptCount","createdAt","id","kind","lastError","metadata","ownerUserID","resourceID","resourceKind","result","scheduledFor","source","status","type","updatedAt"],"properties":{"attemptCount":{"type":"number"},"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["forecast_sync"]},{"type":"string","enum":["identity_auth_delivery"]},{"type":"string","enum":["media_processing"]},{"type":"string","enum":["messaging_notification"]},{"type":"string","enum":["recommendation"]},{"type":"string","enum":["route_export"]},{"type":"string","enum":["route_import"]},{"type":"string","enum":["route_intelligence"]},{"type":"string","enum":["trip_safety_notification"]}]},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"ownerUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"result":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"scheduledFor":{"type":"string"},"source":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"type":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/jobs/{jobKind}/{jobID}/retry":{"post":{"summary":"Operator retry job","tags":["operator","operations"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"jobKind","required":true},{"schema":{"type":"string"},"in":"path","name":"jobID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["changed","job"],"properties":{"changed":{"type":"boolean"},"job":{"type":"object","required":["attemptCount","createdAt","id","kind","lastError","metadata","ownerUserID","resourceID","resourceKind","result","scheduledFor","source","status","type","updatedAt"],"properties":{"attemptCount":{"type":"number"},"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["forecast_sync"]},{"type":"string","enum":["identity_auth_delivery"]},{"type":"string","enum":["media_processing"]},{"type":"string","enum":["messaging_notification"]},{"type":"string","enum":["recommendation"]},{"type":"string","enum":["route_export"]},{"type":"string","enum":["route_import"]},{"type":"string","enum":["route_intelligence"]},{"type":"string","enum":["trip_safety_notification"]}]},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"ownerUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"result":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"scheduledFor":{"type":"string"},"source":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"type":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/jobs/{jobKind}/{jobID}/cancel":{"post":{"summary":"Operator cancel job","tags":["operator","operations"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"jobKind","required":true},{"schema":{"type":"string"},"in":"path","name":"jobID","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["changed","job"],"properties":{"changed":{"type":"boolean"},"job":{"type":"object","required":["attemptCount","createdAt","id","kind","lastError","metadata","ownerUserID","resourceID","resourceKind","result","scheduledFor","source","status","type","updatedAt"],"properties":{"attemptCount":{"type":"number"},"createdAt":{"type":"string"},"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["forecast_sync"]},{"type":"string","enum":["identity_auth_delivery"]},{"type":"string","enum":["media_processing"]},{"type":"string","enum":["messaging_notification"]},{"type":"string","enum":["recommendation"]},{"type":"string","enum":["route_export"]},{"type":"string","enum":["route_import"]},{"type":"string","enum":["route_intelligence"]},{"type":"string","enum":["trip_safety_notification"]}]},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","additionalProperties":{}},"ownerUserID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resourceKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"result":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"scheduledFor":{"type":"string"},"source":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["cancelled"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]}]},"type":{"type":"string"},"updatedAt":{"type":"string"}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/health":{"get":{"summary":"Health check","tags":["system"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["service","environment","version","status","startedAt","uptimeSeconds"],"properties":{"service":{"type":"string"},"environment":{"type":"string"},"version":{"type":"string"},"commitSha":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["degraded"]}]},"startedAt":{"type":"string"},"uptimeSeconds":{"type":"number"}}}}}}}}},"/api/health":{"get":{"summary":"Legacy health check alias","tags":["system"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["service","environment","version","status","startedAt","uptimeSeconds"],"properties":{"service":{"type":"string"},"environment":{"type":"string"},"version":{"type":"string"},"commitSha":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["degraded"]}]},"startedAt":{"type":"string"},"uptimeSeconds":{"type":"number"}}}}}}}}},"/livez":{"get":{"summary":"Liveness check","tags":["system"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["service","environment","version","status","startedAt","uptimeSeconds"],"properties":{"service":{"type":"string"},"environment":{"type":"string"},"version":{"type":"string"},"commitSha":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["degraded"]}]},"startedAt":{"type":"string"},"uptimeSeconds":{"type":"number"}}}}}}}}},"/readyz":{"get":{"summary":"Readiness check","tags":["system"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["service","environment","version","status","checks"],"properties":{"service":{"type":"string"},"environment":{"type":"string"},"version":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["ready"]},{"type":"string","enum":["not_ready"]}]},"checks":{"type":"object","required":["database","migrations"],"properties":{"database":{"type":"object","required":["status","latencyMs"],"properties":{"status":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["failed"]}]},"latencyMs":{"type":"number"}}},"migrations":{"type":"object","required":["appliedCount","expectedCount","mismatched","pending","status"],"properties":{"appliedCount":{"type":"number"},"expectedCount":{"type":"number"},"mismatched":{"type":"array","items":{"type":"string"}},"pending":{"type":"array","items":{"type":"string"}},"status":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["failed"]}]}}}}}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["service","environment","version","status","checks"],"properties":{"service":{"type":"string"},"environment":{"type":"string"},"version":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["ready"]},{"type":"string","enum":["not_ready"]}]},"checks":{"type":"object","required":["database","migrations"],"properties":{"database":{"type":"object","required":["status","latencyMs"],"properties":{"status":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["failed"]}]},"latencyMs":{"type":"number"}}},"migrations":{"type":"object","required":["appliedCount","expectedCount","mismatched","pending","status"],"properties":{"appliedCount":{"type":"number"},"expectedCount":{"type":"number"},"mismatched":{"type":"array","items":{"type":"string"}},"pending":{"type":"array","items":{"type":"string"}},"status":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["failed"]}]}}}}}}}}}}}}},"/api/operator/system/runtime":{"get":{"summary":"Operator list runtime heartbeats","tags":["operator","system"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"role","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["heartbeats"],"properties":{"heartbeats":{"type":"array","items":{"type":"object","required":["serviceName","instanceID","role","lastSeenAt","metadata"],"properties":{"serviceName":{"type":"string"},"instanceID":{"type":"string"},"role":{"type":"string"},"lastSeenAt":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/telemetry/web-vitals":{"post":{"summary":"Record operator web vitals","tags":["operator","system"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id","name","navigationType","rating","releaseId","value"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"navigationType":{"type":"string"},"rating":{"type":"string"},"releaseId":{"type":"string"},"value":{"type":"number"}}}}}},"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["accepted"],"properties":{"accepted":{"type":"boolean"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/system/incidents":{"get":{"summary":"Operator list runtime incidents","tags":["operator","system"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"eventType","required":false},{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"requestID","required":false},{"schema":{"type":"string"},"in":"query","name":"role","required":false},{"schema":{"type":"string"},"in":"query","name":"serviceName","required":false},{"schema":{"anyOf":[{"type":"string","enum":["critical"]},{"type":"string","enum":["error"]},{"type":"string","enum":["warning"]}]},"in":"query","name":"severity","required":false},{"schema":{"type":"string"},"in":"query","name":"source","required":false},{"schema":{"anyOf":[{"type":"string","enum":["open"]},{"type":"string","enum":["resolved"]}]},"in":"query","name":"status","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["incidents"],"properties":{"incidents":{"type":"array","items":{"type":"object","required":["createdAt","eventType","id","instanceID","message","metadata","occurredAt","requestID","resolvedAt","role","serviceName","severity","source","status","updatedAt"],"properties":{"createdAt":{"type":"string"},"eventType":{"type":"string"},"id":{"type":"string"},"instanceID":{"anyOf":[{"type":"string"},{"type":"null"}]},"message":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}},"occurredAt":{"type":"string"},"requestID":{"anyOf":[{"type":"string"},{"type":"null"}]},"resolvedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"role":{"type":"string"},"serviceName":{"type":"string"},"severity":{"anyOf":[{"type":"string","enum":["critical"]},{"type":"string","enum":["error"]},{"type":"string","enum":["warning"]}]},"source":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["open"]},{"type":"string","enum":["resolved"]}]},"updatedAt":{"type":"string"}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/operator/appearance-preference":{"get":{"summary":"Operator read appearance preference","tags":["appearance","system"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["brand","deviceId","lastSeenAt","theme","updatedAt"],"properties":{"brand":{"anyOf":[{"anyOf":[{"type":"string","enum":["sunset"]},{"type":"string","enum":["auto"]},{"type":"string","enum":["sunrise"]}]},{"type":"null"}]},"deviceId":{"type":"string"},"lastSeenAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"theme":{"anyOf":[{"anyOf":[{"type":"string","enum":["dark"]},{"type":"string","enum":["light"]}]},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"patch":{"summary":"Operator update appearance preference","tags":["appearance","system"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brand":{"anyOf":[{"anyOf":[{"type":"string","enum":["sunset"]},{"type":"string","enum":["auto"]},{"type":"string","enum":["sunrise"]}]},{"type":"null"}]},"theme":{"anyOf":[{"anyOf":[{"type":"string","enum":["dark"]},{"type":"string","enum":["light"]}]},{"type":"null"}]}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["brand","deviceId","lastSeenAt","theme","updatedAt"],"properties":{"brand":{"anyOf":[{"anyOf":[{"type":"string","enum":["sunset"]},{"type":"string","enum":["auto"]},{"type":"string","enum":["sunrise"]}]},{"type":"null"}]},"deviceId":{"type":"string"},"lastSeenAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"theme":{"anyOf":[{"anyOf":[{"type":"string","enum":["dark"]},{"type":"string","enum":["light"]}]},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/api/me/appearance-preference":{"get":{"summary":"Read current user appearance preference","tags":["appearance","system"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["brand","deviceId","lastSeenAt","theme","updatedAt"],"properties":{"brand":{"anyOf":[{"anyOf":[{"type":"string","enum":["sunset"]},{"type":"string","enum":["auto"]},{"type":"string","enum":["sunrise"]}]},{"type":"null"}]},"deviceId":{"type":"string"},"lastSeenAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"theme":{"anyOf":[{"anyOf":[{"type":"string","enum":["dark"]},{"type":"string","enum":["light"]}]},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"patch":{"summary":"Update current user appearance preference","tags":["appearance","system"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brand":{"anyOf":[{"anyOf":[{"type":"string","enum":["sunset"]},{"type":"string","enum":["auto"]},{"type":"string","enum":["sunrise"]}]},{"type":"null"}]},"theme":{"anyOf":[{"anyOf":[{"type":"string","enum":["dark"]},{"type":"string","enum":["light"]}]},{"type":"null"}]}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["brand","deviceId","lastSeenAt","theme","updatedAt"],"properties":{"brand":{"anyOf":[{"anyOf":[{"type":"string","enum":["sunset"]},{"type":"string","enum":["auto"]},{"type":"string","enum":["sunrise"]}]},{"type":"null"}]},"deviceId":{"type":"string"},"lastSeenAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"theme":{"anyOf":[{"anyOf":[{"type":"string","enum":["dark"]},{"type":"string","enum":["light"]}]},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}}}}}}}}},"servers":[{"url":"https://api-staging.aspectavy.com","description":"staging server"}],"tags":[{"name":"analytics","description":"Privacy-gated product analytics ingestion and operator summaries."},{"name":"availability","description":"Shared scheduling windows, constraints, and availability summaries."},{"name":"bootstrap","description":"Public, product-user, and operator launch bootstrap configuration."},{"name":"content","description":"Versioned managed content, support content, campaigns, and runtime surfaces."},{"name":"diagnostics","description":"Client crash, error, log, and performance diagnostic reports."},{"name":"forecasts","description":"Forecast zones, current snapshots, incident catalog records, user overrides, favorites, revision diffs, and sync monitoring."},{"name":"identity","description":"Authentication, sessions, password reset, and magic-link flows."},{"name":"integrations","description":"External provider connection status and support-case ticket workflows."},{"name":"jobs","description":"Shared workflow run telemetry and operator job visibility."},{"name":"matching","description":"Shared compatibility preferences, candidates, decisions, and summaries."},{"name":"media","description":"Media asset records, processing jobs, and renditions."},{"name":"messaging","description":"Shared conversations, messages, and delivery handoff APIs."},{"name":"notes","description":"User notes, field logs, resource associations, and attachment links."},{"name":"notifications","description":"Notification preferences, push devices, inbox, outbox plumbing, delivery attempts, and provider visibility."},{"name":"operations","description":"Operator job controls and cross-domain operational views."},{"name":"payments","description":"Payment catalog, grants, entitlement reconciliation, checkout and portal intents, buddy/gift flows, provider sync capture, and webhook capture."},{"name":"product","description":"Cross-domain product workflows and client bootstrap surfaces."},{"name":"profiles","description":"Shared iOS and web profile, settings, summary, and runtime client APIs."},{"name":"recommendations","description":"AI-ready recommendation jobs, recommendation items, and feedback."},{"name":"route-plans","description":"Route plan records, sharing, and scheduling prep surfaces."},{"name":"route-intelligence","description":"Route analysis, route-plan readiness, and analysis job records."},{"name":"routes","description":"Saved routes, shares, import jobs, and export jobs."},{"name":"secrets","description":"Redacted operator secret inventory, version lifecycle, and revocation APIs."},{"name":"social","description":"Friend connections, friend requests, and invite claiming."},{"name":"support","description":"Authenticated customer support cases and support messages."},{"name":"operator","description":"Operator-protected support summaries, case actions, and internal notes."},{"name":"system","description":"Health, readiness, runtime heartbeat, and runtime incident endpoints."},{"name":"trip-safety","description":"Safety contacts, active trip sessions, heartbeats, and guardian status links."}]}