{"openapi":"3.1.0","info":{"title":"KeyShortcuts Public API","version":"1.0.1","description":"Public API for searching, comparing and retrieving keyboard shortcuts with\nplatform scope, canonical KeyShortcuts links and record-level verification metadata.\nProduct availability is not proof of a platform binding. Confirm critical or\nversion-sensitive commands against vendor documentation.\nREST endpoints use /api; stateless MCP supports JSON over HTTP POST.\nAPI releases use semantic versioning. Backward-compatible additions increment\nthe minor version; compatible fixes and documentation corrections increment\nthe patch version. Breaking contract changes require a new major version and\nmigration guidance. Dataset fingerprints identify content revisions separately.\n","x-versioning-policy":"semantic-versioning"},"servers":[{"url":"/api","description":"Base API path"}],"tags":[{"name":"health","description":"Health operations"},{"name":"copy-counts","description":"Shortcut copy count operations"},{"name":"apps","description":"Supported applications and operating systems"},{"name":"search","description":"Search actions and exact keys"},{"name":"semantic-actions","description":"Curated meanings and equivalent contexts"},{"name":"reverse-lookup","description":"Find commands bound to a key combination"},{"name":"comparison","description":"Compare explicitly documented platform bindings"},{"name":"translation","description":"Translate known bindings without guessing Ctrl-to-Command"},{"name":"sources","description":"Official references and review provenance"},{"name":"mcp","description":"Stateless Model Context Protocol tools over JSON HTTP"},{"name":"stack-export","description":"Free personal shortcut stack PDF export"},{"name":"personalized","description":"Consumer purchases and private receipts"}],"paths":{"/pageviews":{"post":{"operationId":"recordPageView","summary":"Record a raw pageview and optionally begin visitor measurement","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageViewInput"}}}},"responses":{"201":{"description":"Pageview recorded; eligible browsers receive a short-lived activity proof","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageViewReceipt"}}}}}}},"/pageviews/confirm":{"post":{"operationId":"confirmVisitorActivity","summary":"Qualify a pageview as likely human activity without a tracking cookie","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VisitorActivityInput"}}}},"responses":{"200":{"description":"Activity processed idempotently","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageViewReceipt"}}}},"400":{"description":"Invalid, ineligible or expired measurement"},"503":{"description":"Visitor measurement is unavailable"}}}},"/pageviews/summary":{"get":{"operationId":"getTrafficSummary","security":[{"adminAccess":[]}],"summary":"Admin-only raw pageviews and estimated human visitor counts","description":"Requires the existing admin bearer password. Counts estimate active\nnetwork/browser combinations, not verified people. Identifiers rotate\nmonthly. Historical pageviews are never backfilled as human visitors.\n","responses":{"200":{"description":"Traffic report in America/New_York time","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageViewReport"}}}},"401":{"description":"Admin access required"}}}},"/healthz":{"get":{"operationId":"healthCheck","tags":["health"],"summary":"Health check","description":"Returns server health status","responses":{"200":{"description":"Healthy","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthStatus"}}}}}}},"/feedback":{"post":{"operationId":"submitContactFeedback","summary":"Store contact feedback or a manually reviewed commercial API inquiry","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"name":{"type":"string","maxLength":100},"message":{"type":"string","minLength":1,"maxLength":2000},"purpose":{"type":"string","enum":["commercial-api"]},"entryPath":{"type":"string","maxLength":160},"attribution":{"$ref":"#/components/schemas/TrafficLabels"}}}}}},"responses":{"201":{"description":"Inquiry stored; not an email delivery or a paid sale"},"400":{"description":"Invalid message or purpose"},"429":{"description":"Three submissions per ten minutes per IP"}}}},"/copy-counts":{"get":{"operationId":"getCopyCounts","tags":["copy-counts"],"summary":"Get all shortcut copy counts","description":"Returns aggregated copy counts for all shortcuts across all users","responses":{"200":{"description":"Copy counts map","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CopyCountsMap"}}}}}}},"/copy-counts/{shortcutId}/increment":{"post":{"operationId":"incrementCopyCount","tags":["copy-counts"],"summary":"Increment a shortcut's copy count","description":"Increments the global copy count for the given shortcut by 1","parameters":[{"name":"shortcutId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Updated count","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CopyCountEntry"}}}}}}},"/copy-counts/trending":{"get":{"operationId":"getTrendingCounts","summary":"Count successful copies in a recent time window","parameters":[{"name":"days","in":"query","schema":{"type":"integer","minimum":1,"maximum":30,"default":7}}],"responses":{"200":{"description":"Recent counts by original shortcut ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CopyCountsMap"}}}}}}},"/stacks/pdf":{"post":{"operationId":"exportShortcutStack","tags":["stack-export"],"summary":"Export a validated personal shortcut stack as a free PDF","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StackExportInput"}}}},"responses":{"200":{"description":"Personal PDF with platform scope and evidence","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid or unavailable stack records"},"429":{"description":"Export rate limit exceeded"}}}},"/apps":{"get":{"operationId":"listShortcutApplications","tags":["apps"],"summary":"List supported applications and operating systems","responses":{"200":{"description":"Application list and dataset version","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShortcutApiResponse"}}}}}}},"/apps/{slug}":{"get":{"operationId":"getApplicationShortcuts","tags":["apps"],"summary":"Get an application's shortcuts with evidence and pagination","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"platform","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0}}],"responses":{"200":{"description":"Shortcut results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShortcutApiResponse"}}}},"404":{"description":"Unknown application"}}}},"/search":{"get":{"operationId":"searchPublicShortcuts","tags":["search"],"summary":"Search meanings, application labels and exact key combinations","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":160}},{"name":"app","in":"query","schema":{"type":"string"}},{"name":"platform","in":"query","schema":{"type":"string"}},{"name":"mode","in":"query","schema":{"type":"string","enum":["auto","action","keys"]}},{"name":"verified","in":"query","schema":{"type":"boolean"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0}}],"responses":{"200":{"description":"Search results with record-level evidence","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShortcutApiResponse"}}}},"400":{"description":"Invalid filters"}}}},"/actions/{slug}":{"get":{"operationId":"getSemanticAction","tags":["semantic-actions"],"summary":"Get shortcuts for a curated semantic action","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Action results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShortcutApiResponse"}}}},"404":{"description":"Unknown action"}}}},"/keys/{shortcut}":{"get":{"operationId":"lookupPublicKeys","tags":["reverse-lookup"],"summary":"Reverse lookup a literal key combination across contexts","parameters":[{"name":"shortcut","in":"path","required":true,"schema":{"type":"string"}},{"name":"app","in":"query","schema":{"type":"string"}},{"name":"platform","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Exact matches; an empty result is not a guessed translation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShortcutApiResponse"}}}}}}},"/compare":{"get":{"operationId":"compareReviewedShortcuts","tags":["comparison"],"summary":"Compare reviewed bindings for an original record ID","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Reviewed same-context equivalents","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShortcutApiResponse"}}}}}}},"/translate":{"get":{"operationId":"translateReviewedShortcut","tags":["translation"],"summary":"Translate only where a reviewed semantic mapping exists","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"from","in":"query","required":true,"schema":{"type":"string"}},{"name":"to","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Reviewed translations or explicit unknown result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShortcutApiResponse"}}}}}}},"/sources/{id}":{"get":{"operationId":"getShortcutSource","tags":["sources"],"summary":"Return an official source registry entry, not a blanket review","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Source metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShortcutApiResponse"}}}},"404":{"description":"Unknown source"}}}},"/mcp":{"post":{"operationId":"callShortcutMcp","tags":["mcp"],"summary":"Stateless JSON-response Streamable HTTP MCP endpoint","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpInput"}}}},"responses":{"200":{"description":"JSON-RPC 2.0 response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Notification accepted"},"403":{"description":"Origin rejected"},"429":{"description":"Rate limit exceeded"}}}},"/teams/leads":{"post":{"operationId":"submitTeamInquiry","summary":"Submit a team onboarding request for manual fulfillment","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamInquiryInput"}}}},"responses":{"201":{"description":"Request durably stored for administrator review"},"400":{"description":"Invalid inquiry"},"429":{"description":"Submission limit exceeded"}}}},"/personalized/checkout":{"post":{"operationId":"createPersonalizedCheckout","tags":["personalized"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalizedCheckoutRequest"}}}},"responses":{"200":{"description":"Hosted Stripe URL for an immutable, stored stack snapshot.","content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string"}}}}}},"400":{"description":"Invalid stack or no reviewed switcher coverage."},"503":{"description":"Payments or fulfillment storage unavailable."}}}},"/personalized/order":{"get":{"operationId":"getPersonalizedOrder","tags":["personalized"],"parameters":[{"name":"session_id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":255}}],"responses":{"200":{"description":"Purchase-bound receipt; possession of the receipt link grants access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalizedOrder"}}}},"403":{"description":"Invalid entitlement, refund or dispute."},"404":{"description":"Unknown receipt."}}}},"/personalized/pdf":{"get":{"operationId":"downloadPersonalizedPdf","tags":["personalized"],"parameters":[{"name":"session_id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":255}},{"name":"paper","in":"query","required":false,"schema":{"type":"string","enum":["a4","letter"],"default":"a4"}}],"responses":{"200":{"description":"Paid PDF generated only from the stored purchase snapshot.","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"402":{"description":"Payment not complete."},"403":{"description":"Invalid entitlement, refund or dispute."},"404":{"description":"Unknown receipt."}}}},"/outreach":{"get":{"operationId":"getOutreachDashboard","responses":{"200":{"description":"Private outreach dashboard","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachDashboard"}}}}}}},"/outreach/settings":{"patch":{"operationId":"updateOutreachSettings","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachSettingsInput"}}}},"responses":{"200":{"description":"Settings saved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachSettings"}}}}}}},"/outreach/import":{"post":{"operationId":"importOutreachContacts","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachCsvInput"}}}},"responses":{"200":{"description":"Import summary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachImportResult"}}}}}}},"/outreach/preview/{id}":{"get":{"operationId":"getOutreachPreview","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Rendered email, never sent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachPreview"}}}}}}},"/outreach/suppression":{"post":{"operationId":"addOutreachSuppression","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachSuppressionInput"}}}},"responses":{"200":{"description":"Suppression added","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachActionResult"}}}}}}},"/outreach/run":{"post":{"operationId":"runOutreach","responses":{"200":{"description":"One safely gated processing pass","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachActionResult"}}}}}}},"/outreach/gmail/check":{"post":{"operationId":"checkOutreachGmail","responses":{"200":{"description":"Read-only authorization check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachActionResult"}}}}}}},"/outreach/scheduler-key":{"post":{"operationId":"createOutreachSchedulerKey","responses":{"200":{"description":"Restricted scheduler key, displayed once","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachSchedulerKey"}}}}}}},"/outreach/tick":{"post":{"operationId":"tickOutreach","responses":{"200":{"description":"Authenticated scheduler processing pass","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachActionResult"}}}}}}},"/schools/config":{"get":{"operationId":"getSchoolConfig","responses":{"200":{"description":"Approved education offer and current checkout readiness","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchoolConfig"}}}}}}},"/schools/checkout":{"post":{"operationId":"startSchoolCheckout","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchoolCheckoutInput"}}}},"responses":{"200":{"description":"Annual Stripe Checkout URL","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchoolUrl"}}}}}}},"/schools/access":{"post":{"operationId":"redeemSchoolAccess","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchoolAccessInput"}}}},"responses":{"200":{"description":"Validated license and private access cookie","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchoolLicense"}}}}}}},"/schools/license":{"get":{"operationId":"getSchoolLicense","responses":{"200":{"description":"Current private educator entitlement","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchoolLicense"}}}}}}},"/schools/resources/{resourceId}/pdf":{"get":{"operationId":"downloadSchoolResource","parameters":[{"in":"path","name":"resourceId","required":true,"schema":{"type":"string","enum":["office","os"]}}],"responses":{"200":{"description":"Active-license-only classroom PDF","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}}}}},"/schools/portal":{"post":{"operationId":"openSchoolBillingPortal","responses":{"200":{"description":"Purchaser-only Stripe subscription management","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchoolUrl"}}}}}}},"/schools/inquiries":{"post":{"operationId":"submitSchoolInquiry","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchoolInquiryInput"}}}},"responses":{"201":{"description":"Saved inquiry, not a purchase","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchoolUrl"}}}}}}},"/schools/admin":{"get":{"operationId":"getSchoolAdmin","responses":{"200":{"description":"Admin-only organization licenses and inquiry pipeline","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchoolAdmin"}}}}}}},"/schools/admin/inquiries/{inquiryId}":{"patch":{"operationId":"updateSchoolInquiry","parameters":[{"in":"path","name":"inquiryId","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchoolInquiryUpdate"}}}},"responses":{"200":{"description":"Saved inquiry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchoolInquiry"}}}}}}},"/schools/admin/inquiries/{inquiryId}/invoice":{"post":{"operationId":"createDistrictInvoice","parameters":[{"in":"path","name":"inquiryId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Draft invoice only; owner must review and send in Stripe","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchoolUrl"}}}}}}},"/schools/admin/inquiries/{inquiryId}/activate":{"post":{"operationId":"activateDistrictLicense","parameters":[{"in":"path","name":"inquiryId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Verified paid annual District license","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchoolLicense"}}}}}}},"/schools/admin/licenses/{licenseId}":{"patch":{"operationId":"updateSchoolLicense","parameters":[{"in":"path","name":"licenseId","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchoolLicenseUpdate"}}}},"responses":{"200":{"description":"Updated revocation state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SchoolLicense"}}}}}}}},"components":{"securitySchemes":{"adminAccess":{"type":"http","scheme":"bearer"}},"schemas":{"PageViewInput":{"type":"object","required":["path"],"properties":{"path":{"type":"string","maxLength":500,"pattern":"^/"},"referrer":{"type":["string","null"]},"measurement":{"type":"object","required":["automated","excluded"],"properties":{"automated":{"type":"boolean"},"excluded":{"type":"boolean"}}}}},"PageViewReceipt":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"activityToken":{"type":"string"}}},"VisitorActivityInput":{"type":"object","required":["activityToken","visibleMs","interacted"],"properties":{"activityToken":{"type":"string","maxLength":600},"visibleMs":{"type":"integer","minimum":2000},"interacted":{"type":"boolean"}}},"VisitorReport":{"type":"object","required":["today","thisMonth","activePageviewsToday","filteredBotsToday","startedAt","timezone","enabled","method"],"properties":{"today":{"type":"integer","minimum":0},"thisMonth":{"type":"integer","minimum":0},"activePageviewsToday":{"type":"integer","minimum":0},"filteredBotsToday":{"type":"integer","minimum":0},"startedAt":{"type":["string","null"]},"timezone":{"type":"string"},"enabled":{"type":"boolean"},"method":{"type":"string"}}},"PageViewReport":{"type":"object","required":["total","byPath","byDay","visitors"],"properties":{"total":{"type":"integer"},"byPath":{"type":"array","items":{"type":"object","required":["path","views"],"properties":{"path":{"type":"string"},"views":{"type":"integer"}}}},"byDay":{"type":"array","items":{"type":"object","required":["date","views"],"properties":{"date":{"type":"string"},"views":{"type":"integer"}}}},"visitors":{"$ref":"#/components/schemas/VisitorReport"}}},"SchoolUrl":{"type":"object","required":["url","message"],"properties":{"url":{"type":"string"},"message":{"type":"string"}}},"SchoolResource":{"type":"object","required":["id","title","category","description","sourcePath"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"category":{"type":"string"},"description":{"type":"string"},"sourcePath":{"type":"string"}}},"SchoolConfig":{"type":"object","required":["amountCents","currency","interval","checkoutReady","message","resources"],"properties":{"amountCents":{"type":"integer"},"currency":{"type":"string"},"interval":{"type":"string"},"checkoutReady":{"type":"boolean"},"message":{"type":"string"},"resources":{"type":"array","items":{"$ref":"#/components/schemas/SchoolResource"}}}},"SchoolCheckoutInput":{"type":"object","required":["organization","contactName","email","consent"],"properties":{"organization":{"type":"string","minLength":2,"maxLength":200},"contactName":{"type":"string","minLength":2,"maxLength":120},"email":{"type":"string","format":"email","maxLength":254},"consent":{"type":"boolean"}}},"SchoolAccessInput":{"type":"object","properties":{"sessionId":{"type":"string","maxLength":255},"token":{"type":"string","maxLength":255}}},"SchoolLicense":{"type":"object","required":["id","organization","type","scope","active","paymentStatus","startsAt","expiresAt","cancelAtPeriodEnd","revoked","canManageBilling","resources","shareUrl"],"properties":{"id":{"type":"string"},"organization":{"type":"string"},"type":{"type":"string"},"scope":{"type":"string"},"active":{"type":"boolean"},"paymentStatus":{"type":"string"},"startsAt":{"type":"string"},"expiresAt":{"type":"string"},"cancelAtPeriodEnd":{"type":"boolean"},"revoked":{"type":"boolean"},"canManageBilling":{"type":"boolean"},"shareUrl":{"type":"string"},"resources":{"type":"array","items":{"$ref":"#/components/schemas/SchoolResource"}}}},"SchoolInquiryInput":{"type":"object","required":["type","organization","contactName","email","message","consent"],"properties":{"type":{"type":"string","enum":["school","district"]},"organization":{"type":"string","minLength":2,"maxLength":200},"contactName":{"type":"string","minLength":2,"maxLength":120},"email":{"type":"string","format":"email","maxLength":254},"schoolCount":{"type":"integer","minimum":1,"maximum":10000},"teacherCount":{"type":"integer","minimum":1,"maximum":100000},"message":{"type":"string","minLength":10,"maxLength":4000},"consent":{"type":"boolean"}}},"SchoolInquiryUpdate":{"type":"object","properties":{"status":{"type":"string","enum":["New","Contacted","Qualified","Quote Sent","Won","Lost"]},"scope":{"type":"string","maxLength":4000},"quoteAmountCents":{"type":"integer","minimum":100,"maximum":100000000}}},"SchoolInquiry":{"type":"object","required":["id","type","organization","contactName","email","message","status","scope","createdAt"],"properties":{"id":{"type":"string"},"type":{"type":"string"},"organization":{"type":"string"},"contactName":{"type":"string"},"email":{"type":"string"},"message":{"type":"string"},"status":{"type":"string"},"scope":{"type":"string"},"schoolCount":{"type":["integer","null"]},"teacherCount":{"type":["integer","null"]},"quoteAmountCents":{"type":["integer","null"]},"stripeInvoiceId":{"type":["string","null"]},"licenseId":{"type":["string","null"]},"createdAt":{"type":"string"}}},"SchoolLicenseUpdate":{"type":"object","required":["revoked"],"properties":{"revoked":{"type":"boolean"}}},"SchoolAdmin":{"type":"object","required":["inquiries","licenses"],"properties":{"inquiries":{"type":"array","items":{"$ref":"#/components/schemas/SchoolInquiry"}},"licenses":{"type":"array","items":{"$ref":"#/components/schemas/SchoolLicense"}}}},"OutreachSettings":{"type":"object","required":["paused","dryRun","mailingAddress","firstSubject","firstBody","followupBody","credentialMode","senderEmail"],"properties":{"paused":{"type":"boolean"},"dryRun":{"type":"boolean"},"mailingAddress":{"type":"string"},"firstSubject":{"type":"string"},"firstBody":{"type":"string"},"followupBody":{"type":"string"},"credentialMode":{"type":"string","enum":["integration","secrets"]},"senderEmail":{"type":"string"}}},"OutreachSettingsInput":{"type":"object","properties":{"paused":{"type":"boolean"},"dryRun":{"type":"boolean"},"mailingAddress":{"type":"string","maxLength":500},"firstSubject":{"type":"string","minLength":1,"maxLength":250},"firstBody":{"type":"string","minLength":1,"maxLength":20000},"followupBody":{"type":"string","minLength":1,"maxLength":20000},"credentialMode":{"type":"string","enum":["integration","secrets"]},"senderEmail":{"type":"string","maxLength":254}}},"OutreachContact":{"type":"object","required":["id","name","email","org","role","state","matched_page_url","status","sent_at","followup_at","thread_id","last_error"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"email":{"type":"string"},"org":{"type":"string"},"role":{"type":"string"},"state":{"type":"string"},"matched_page_url":{"type":"string"},"status":{"type":"string","enum":["new","sent","followed_up","replied","opted_out","bounced"]},"sent_at":{"type":["string","null"]},"followup_at":{"type":["string","null"]},"thread_id":{"type":["string","null"]},"last_error":{"type":["string","null"]}}},"OutreachLog":{"type":"object","required":["id","contact_id","kind","outcome","subject","body","created_at"],"properties":{"id":{"type":"integer"},"contact_id":{"type":["integer","null"]},"kind":{"type":"string"},"outcome":{"type":"string"},"subject":{"type":"string"},"body":{"type":"string"},"created_at":{"type":"string"}}},"OutreachSuppression":{"type":"object","required":["value","reason"],"properties":{"value":{"type":"string"},"reason":{"type":"string"}}},"OutreachDashboard":{"type":"object","required":["settings","contacts","suppression","logs","sentToday","nextSendAt","lastPollAt","gmailStatus","scheduler","secretsConfigured"],"properties":{"settings":{"$ref":"#/components/schemas/OutreachSettings"},"contacts":{"type":"array","items":{"$ref":"#/components/schemas/OutreachContact"}},"suppression":{"type":"array","items":{"$ref":"#/components/schemas/OutreachSuppression"}},"logs":{"type":"array","items":{"$ref":"#/components/schemas/OutreachLog"}},"sentToday":{"type":"integer"},"nextSendAt":{"type":["string","null"]},"lastPollAt":{"type":["string","null"]},"gmailStatus":{"type":"string"},"scheduler":{"type":"string"},"secretsConfigured":{"type":"boolean"}}},"OutreachCsvInput":{"type":"object","required":["csv"],"properties":{"csv":{"type":"string","minLength":1,"maxLength":1500000}}},"OutreachImportResult":{"type":"object","required":["imported","duplicates","suppressed","invalid","errors"],"properties":{"imported":{"type":"integer"},"duplicates":{"type":"integer"},"suppressed":{"type":"integer"},"invalid":{"type":"integer"},"errors":{"type":"array","items":{"type":"string"}}}},"OutreachPreview":{"type":"object","required":["to","subject","body","followupSubject","followupBody"],"properties":{"to":{"type":"string"},"subject":{"type":"string"},"body":{"type":"string"},"followupSubject":{"type":"string"},"followupBody":{"type":"string"}}},"OutreachSuppressionInput":{"type":"object","required":["value"],"properties":{"value":{"type":"string","minLength":1,"maxLength":254},"reason":{"type":"string","maxLength":500}}},"OutreachActionResult":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}},"OutreachSchedulerKey":{"type":"object","required":["authorization","path","schedule"],"properties":{"authorization":{"type":"string"},"path":{"type":"string"},"schedule":{"type":"string"}}},"AnalyticsEventInput":{"type":"object","additionalProperties":false,"required":["event","placement"],"properties":{"event":{"type":"string","maxLength":40},"placement":{"type":"string","maxLength":120},"pack":{"type":"string","maxLength":40},"pagePath":{"type":"string","maxLength":160},"entryPage":{"type":"string","maxLength":160},"attribution":{"type":"object","additionalProperties":false,"properties":{"utm_source":{"type":"string","maxLength":64},"utm_medium":{"type":"string","maxLength":64},"utm_campaign":{"type":"string","maxLength":64},"referrerHost":{"type":"string","maxLength":253}}},"dimensions":{"type":"object","additionalProperties":false,"properties":{"query":{"type":"string","maxLength":80},"resultCount":{"type":"integer","minimum":0,"maximum":100000},"context":{"type":"string","maxLength":64},"appIds":{"type":"string","maxLength":256},"appCount":{"type":"integer","minimum":0,"maximum":12},"platform":{"type":"string"},"role":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"destination":{"type":"string","maxLength":160,"description":"Allowlisted query-free resource destination; only resource_link_click from /resources."}}}}},"GrowthAnalyticsSummary":{"type":"object","additionalProperties":true,"required":["growth"],"properties":{"growth":{"type":"object","additionalProperties":true,"description":"Period, demand, sources, channels, copied, resource-hub traffic and explicit measurement limitations.","properties":{"resources":{"type":"array","items":{"$ref":"#/components/schemas/ResourceTrafficRow"}},"referrals":{"type":"array","description":"First-touch external hostname, query-free landing page and product/channel event aggregates; excludes recognized organic search.","items":{"$ref":"#/components/schemas/ResourceTrafficRow"}}}}}},"ResourceTrafficRow":{"type":"object","required":["kind","label","event","currency","count","revenueMinor"],"properties":{"kind":{"type":"string","enum":["visits","destination","referrer","outcome"]},"label":{"type":"string"},"event":{"type":"string"},"currency":{"type":["string","null"]},"count":{"type":"integer","minimum":0},"revenueMinor":{"type":"string"}}},"PersonalizedCheckoutRequest":{"type":"object","required":["kind","stack"],"properties":{"kind":{"type":"string","enum":["custom-stack","switcher-pack"]},"stack":{"type":"object","additionalProperties":true},"fromPlatform":{"type":"string","enum":["windows","macos","linux"]},"entryPath":{"type":"string","maxLength":160,"description":"Query-free entry page for aggregate attribution"},"attribution":{"$ref":"#/components/schemas/TrafficLabels"}}},"PersonalizedOrder":{"type":"object","required":["status","kind","title","platform","amountTotal","currency","downloadUrl"],"properties":{"status":{"type":"string","enum":["paid","pending","expired"]},"kind":{"type":"string","enum":["custom-stack","switcher-pack"]},"title":{"type":"string"},"platform":{"type":"string"},"amountTotal":{"type":["integer","null"]},"currency":{"type":"string"},"downloadUrl":{"type":["string","null"]}}},"StackExportInput":{"type":"object","required":["stack"],"additionalProperties":false,"properties":{"stack":{"type":"object","additionalProperties":true,"description":"Version 1 ShortcutStack validated against canonical records; see /developers."}}},"ShortcutApiResponse":{"type":"object","required":["version","attribution","data"],"properties":{"version":{"type":"string","description":"Dataset fingerprint; cache/version identifier, not an API key."},"attribution":{"type":"string"},"data":{"type":"object","additionalProperties":true,"description":"Normalized catalog records, keyVariants, verification, original IDs and canonical links."}}},"McpInput":{"type":"object","required":["jsonrpc","method"],"additionalProperties":false,"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"}]},"method":{"type":"string"},"params":{"type":"object","additionalProperties":true}}},"TeamInquiryInput":{"type":"object","required":["name","email","company","seats","message","consent"],"additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"email":{"type":"string","format":"email","maxLength":254},"company":{"type":"string","minLength":1,"maxLength":100},"seats":{"type":"integer","minimum":1,"maximum":10000},"message":{"type":"string","minLength":1,"maxLength":1200},"consent":{"type":"boolean","enum":[true]},"entryPath":{"type":"string","maxLength":160},"attribution":{"$ref":"#/components/schemas/TrafficLabels"}}},"TrafficLabels":{"type":"object","additionalProperties":false,"properties":{"utm_source":{"type":"string","maxLength":64,"pattern":"^[a-zA-Z0-9_-]+$"},"utm_medium":{"type":"string","maxLength":64,"pattern":"^[a-zA-Z0-9_-]+$"},"utm_campaign":{"type":"string","maxLength":64,"pattern":"^[a-zA-Z0-9_-]+$"},"referrerHost":{"type":"string","maxLength":253,"pattern":"^[a-z0-9.-]+$"}}},"HealthStatus":{"type":"object","properties":{"status":{"type":"string"}},"required":["status"]},"CopyCountsMap":{"type":"object","additionalProperties":{"type":"integer"}},"CopyCountEntry":{"type":"object","properties":{"shortcutId":{"type":"string"},"count":{"type":"integer"}},"required":["shortcutId","count"]}}},"x-keyshortcuts-source-hash":"95d6f47165ee260d8a54de3924d1b5716064d398d90a58a96ae7cc997cdbdb6c"}